Inicio rápido: Supervisión de aplicaciones de un extremo a otro

Artículo
02/02/2024

Nota

Azure Spring Apps es el nuevo nombre del servicio Azure Spring Cloud. Aunque el servicio tiene un nuevo nombre, verá el nombre antiguo en algunos lugares durante un tiempo mientras trabajamos para actualizar recursos, como capturas de pantalla, vídeos y diagramas.

Este artículo se aplica a:❌ Básico o Estándar ✔️ Enterprise

En este inicio rápido se muestra cómo supervisar las aplicaciones que ejecutan el plan Enterprise de Azure Spring Apps mediante Application Insights y Log Analytics.

Nota

Puede supervisar las cargas de trabajo de Spring de un extremo a otro con la herramienta y plataforma que prefiera, incluidos App Insights, Log Analytics, New Relic, Dynatrace, AppDynamics, Elastic o Splunk. Para más información, vea Trabajo con otras herramientas de supervisión más adelante en este artículo.

Requisitos previos

Una cuenta de Azure con una suscripción activa. Cree una cuenta gratuita.
Comprenda y cumpla la sección Requisitos del plan Enterprise en Azure Marketplace.
La versión 2.45.0 o superior de la CLI de Azure.
Git.
La extensión del plan Enterprise de Azure Spring Apps. Use el siguiente comando para eliminar las versiones anteriores e instalar la extensión del plan Enterprise más reciente. Si ya ha instalado la extensión spring-cloud, desinstálela para evitar errores de coincidencia de la configuración y la versión.
```
az extension add --upgrade --name spring
az extension remove --name spring-cloud
```
Recursos para supervisar, como los creados en los siguientes inicios rápidos:

Actualización de aplicaciones

Debe proporcionar manualmente la cadena de conexión de Application Insights a las aplicaciones Order Service (ASP.NET Core) y Cart Service (Python). En las instrucciones siguientes se describe cómo proporcionar esta cadena de conexión y aumentar la frecuencia de muestreo a Application Insights.

Nota

Actualmente, solo los paquetes de compilación para aplicaciones de Java y NodeJS admiten la instrumentación de Application Insights.

Cree variables para contener los nombres del recurso mediante los siguientes comandos. Asegúrese de reemplazar los marcadores de posición por sus propios valores. El nombre de la instancia de servicio de Azure Spring Apps debe tener entre 4 y 32 caracteres y solo puede contener letras minúsculas, números y guiones. El primer carácter del nombre del servicio debe ser una letra y el último debe ser una letra o un número.
```
export RESOURCE_GROUP="<resource-group-name>"
export APP_INSIGHTS_NAME="<app-insights-name>"
export KEY_VAULT_NAME="<key-vault-name>"
export AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME="<Azure-Spring-Apps-service-instance-name>"
```
Nota:

De manera predeterminada, el nombre APP_INSIGHTS_NAME es el mismo que AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME.

Use los comandos siguientes para recuperar la cadena de conexión de Application Insights y establecerla en Key Vault:

export CONNECTION_STRING=$(az monitor app-insights component show \
    --resource-group ${RESOURCE_GROUP} \
    --app ${APP_INSIGHTS_NAME} \
    --query "connectionString" \
    --output tsv)

az keyvault secret set \
    --vault-name ${KEY_VAULT_NAME} \
    --name "ApplicationInsights--ConnectionString" \
    --value ${CONNECTION_STRING}

Use el comando siguiente para actualizar la frecuencia de muestreo del enlace de Application Insights para aumentar la cantidad de datos disponibles:

az spring build-service builder buildpack-binding set \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --builder-name default \
    --name default \
    --type ApplicationInsights \
    --properties sampling-rate=100 connection_string=${CONNECTION_STRING}

Use los comandos siguientes a fin de reiniciar las aplicaciones para volver a cargar la configuración:

az spring app restart \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --name cart-service

az spring app restart \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --name order-service

az spring app restart \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --name catalog-service

az spring app restart \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --name frontend

az spring app restart \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --name payment-service

Si ha configurado el inicio de sesión único, use los siguientes comandos para reiniciar las aplicaciones y volver a cargar la configuración de la aplicación identity-service:
```
az spring app restart \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --name identity-service
```
En el caso de las aplicaciones de Java y NodeJS, el reinicio permitirá que la nueva frecuencia de muestreo surta efecto. En el caso de las aplicaciones que no son de Java, el reinicio les permitirá acceder a la clave de instrumentación recién agregada desde Key Vault.

Ver registros

Hay dos maneras de ver los registros en Azure Spring Apps: streaming de registro de registros en tiempo real por instancia de aplicación o Log Analytics para registros agregados con la funcionalidad de consulta avanzada

Uso de streaming de registro

Para generar tráfico en la aplicación, recórrala, vea el catálogo y realice pedidos. Use los comandos siguientes para generar tráfico de forma continuada, hasta que se cancele:

export GATEWAY_URL=$(az spring gateway show \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --query "properties.url" \
    --output tsv)

export GATEWAY_URL=https://${GATEWAY_URL} 

cd azure-spring-apps-enterprise/load-test/traffic-generator
./gradlew gatlingRun-com.vmware.acme.simulation.GuestSimulation.java

Use el comando siguiente para obtener las últimas 100 líneas de registros de consola de aplicación de la aplicación Servicio de catálogo:

az spring app logs \
    --resource-group ${RESOURCE_GROUP} \
    --name catalog-service \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --lines 100

Al agregar la opción --follow, puede obtener el streaming de registro en tiempo real de una aplicación. Use el comando siguiente para probar el streaming de registro para la aplicación Servicio de catálogo:

az spring app logs \
    --resource-group ${RESOURCE_GROUP} \
    --name catalog-service \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --follow

Sugerencia

Puede usar az spring app logs --help para explorar más parámetros y funcionalidades de flujo de registro.

Uso de Log Analytics

Vaya a Azure Portal y abra la instancia de Log Analytics que ha creado. Puede encontrar la instancia de Log Analytics en el mismo grupo de recursos donde ha creado la instancia de servicio de Azure Spring Apps.

En la página Log Analytics, seleccione el panel Registros y ejecute cualquiera de las siguientes consultas de ejemplo para Azure Spring Apps.

Escriba y ejecute la siguiente consulta Kusto para ver los registros de aplicación:

AppPlatformLogsforSpring
| where TimeGenerated > ago(24h)
| limit 500
| sort by TimeGenerated
| project TimeGenerated, AppName, Log