Avvio rapido: Monitorare le applicazioni end-to-end

Note

I piani Basic, Standard ed Enterprise sono entrati in un periodo di ritiro il 17 marzo 2025. Per altre informazioni, vedere l'annuncio di ritiro di Azure Spring Apps.

Questo articolo si applica a: ❎ Basic/Standard ✅ Enterprise

Questa guida di avvio rapido illustra come monitorare le app che eseguono il piano Enterprise di Azure Spring Apps usando Application Insights e Log Analytics.

Note

È possibile monitorare i carichi di lavoro Spring end-to-end usando qualsiasi strumento e piattaforma preferita, tra cui App Insights, Log Analytics, New Relic, Dynatrace, AppDynamics, Elastic o Splunk. Per altre informazioni, vedere Uso di altri strumenti di monitoraggio descritti più avanti in questo articolo.

Prerequisiti

Un account Azure con una sottoscrizione attiva. Creare un account gratuitamente.
Interfaccia della riga di comando di Azure versione 2.45.0 o successiva.
Git.
Estensione del piano Enterprise di Azure Spring Apps. Usare il comando seguente per rimuovere le versioni precedenti e installare l'estensione del piano Enterprise più recente. Se l'estensione spring-cloud è stata installata in precedenza, disinstallarla per evitare la mancata corrispondenza della configurazione e della versione.
```
az extension add --upgrade --name spring
az extension remove --name spring-cloud
```
Risorse da monitorare, ad esempio quelle create nelle guide introduttive seguenti:

Aggiornare le applicazioni

È necessario fornire manualmente la stringa di connessione Application Insights alle applicazioni Order Service (ASP.NET core) e Cart Service (python). Le istruzioni seguenti descrivono come fornire questa stringa di connessione e aumentare la frequenza di campionamento per Application Insights.

Note

Attualmente solo i buildpack per Java e le applicazioni Node.js supportano la strumentazione di Application Insights.

Creare variabili per contenere i nomi delle risorse usando i comandi seguenti. Assicurarsi di sostituire i segnaposto con i propri valori. Il nome dell'istanza del servizio Azure Spring Apps deve avere una lunghezza compresa tra 4 e 32 caratteri e può contenere solo lettere minuscole, numeri e trattini. Il primo carattere del nome del servizio deve essere una lettera e l'ultimo deve essere una lettera o un numero.
```
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>"
```
Note

Per impostazione predefinita, il APP_INSIGHTS_NAME è uguale al AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME.

Usare i comandi seguenti per recuperare la stringa di connessione di Application Insights e impostarla in 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}

Usare il comando seguente per aggiornare la frequenza di campionamento per l'associazione di Application Insights per aumentare la quantità di dati disponibili:

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}

Usare i comandi seguenti per riavviare le applicazioni per ricaricare la configurazione:

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

Se è stato configurato l'accesso Single Sign-On, usare i comandi seguenti per riavviare le applicazioni per ricaricare la configurazione dell'app del servizio identità:
```
az spring app restart \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --name identity-service
```
Per le applicazioni Java e Node.js, il riavvio consentirà di rendere effettiva la nuova frequenza di campionamento. Per le applicazioni non Java, il riavvio consentirà loro di accedere alla chiave di strumentazione appena aggiunta dall'insieme di credenziali delle chiavi.

Visualizzare i log

Ci sono modi per visualizzare i log in Azure Spring Apps: lo streaming di log per i log in tempo reale per istanza dell'app o con Log Analytics per i log aggregati con funzionalità di query avanzate

Usare lo streaming di log

Generare traffico nell'applicazione spostandosi attraverso l'applicazione, visualizzando il catalogo e inserendo ordini. Usare i comandi seguenti per generare il traffico in modo continuo, fino a quando non viene annullato:

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

Usare il comando seguente per ottenere le 100 righe più recenti dei log della console dell'applicazione dal servizio catalogo:

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

Aggiungendo l'opzione --follow, è possibile ottenere lo streaming dei log in tempo reale da un'app. Usare il comando seguente per tentare lo streaming di log per l'applicazione servizio catalogo:

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

Suggerimento

È possibile usare az spring app logs --help per esplorare altri parametri e funzionalità del flusso di log.

Usare Log Analytics

Passare al portale di Azure e aprire l'istanza di Log Analytics creata. È possibile trovare l'istanza di Log Analytics nello stesso gruppo di risorse in cui è stata creata l'istanza del servizio Azure Spring Apps.

Nella pagina Log Analytics selezionare il riquadro Logs ed eseguire una delle seguenti query di esempio per Azure Spring Apps.

Digitare ed eseguire la seguente query Kusto per visualizzare i log dell'applicazione:

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