Quickstart: Toepassingen end-to-end bewaken

Artikel
03/08/2024

Notitie

Azure Spring Apps is de nieuwe naam voor de Azure Spring Cloud-service. Hoewel de service een nieuwe naam heeft, ziet u de oude naam op sommige plaatsen terwijl we werken aan het bijwerken van assets, zoals schermopnamen, video's en diagrammen.

Dit artikel is van toepassing op:❌ Basic/Standard ✔️ Enterprise

In deze quickstart ziet u hoe u apps bewaakt waarop het Azure Spring Apps Enterprise-plan wordt uitgevoerd met behulp van Application Insights en Log Analytics.

Notitie

U kunt uw Spring-workloads end-to-end bewaken met elk hulpprogramma en platform van uw keuze, waaronder App Insights, Log Analytics, New Relic, Dynatrace, AppDynamics, Elastic of Splunk. Zie Werken met andere bewakingshulpprogramma's verderop in dit artikel voor meer informatie.

Vereisten

Een Azure-account met een actief abonnement. Gratis een account maken
Inzicht in en voldoen aan de sectie Vereisten van het Enterprise-plan in Azure Marketplace.
De Azure CLI versie 2.45.0 of hoger.
Git.
De Azure Spring Apps Enterprise-abonnementsextensie. Gebruik de volgende opdracht om eerdere versies te verwijderen en de nieuwste Enterprise-abonnementsextensie te installeren. Als u de extensie eerder hebt geïnstalleerd, verwijdert u deze spring-cloud om te voorkomen dat de configuratie en versie niet overeenkomen.
```
az extension add --upgrade --name spring
az extension remove --name spring-cloud
```
Resources die moeten worden bewaakt, zoals de resources die zijn gemaakt in de volgende quickstarts:

Toepassingen bijwerken

U moet de Application Insights-verbindingsreeks handmatig verstrekken aan de toepassingen Order Service (ASP.NET core) en Cart Service (Python). In de volgende instructies wordt beschreven hoe u deze verbindingsreeks opgeeft en hoe u de steekproeffrequentie verhoogt naar Application Insights.

Notitie

Momenteel ondersteunen alleen de buildpacks voor Java- en NodeJS-toepassingen Application Insights-instrumentatie.

Maak variabelen voor het opslaan van de resourcenamen met behulp van de volgende opdrachten. Vervang de tijdelijke aanduidingen door uw eigen waarden. De naam van uw Azure Spring Apps-service-exemplaar moet tussen 4 en 32 tekens lang zijn en mag alleen kleine letters, cijfers en afbreekstreepjes bevatten. Het eerste teken van de servicenaam moet een letter zijn en het laatste teken moet een letter of een cijfer zijn.
```
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>"
```
Notitie

De APP_INSIGHTS_NAME is standaard hetzelfde als de AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME.

Gebruik de volgende opdrachten om de Application Insights-verbindingsreeks op te halen en in Key Vault in te stellen:

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}

Gebruik de volgende opdracht om de samplingfrequentie voor de Application Insights-binding bij te werken om de beschikbare hoeveelheid gegevens te verhogen:

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}

Gebruik de volgende opdrachten om toepassingen opnieuw te starten om de configuratie opnieuw te laden:

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

Als u eenmalige aanmelding hebt geconfigureerd, gebruikt u de volgende opdrachten om toepassingen opnieuw te starten om de configuratie van identity-service-apps opnieuw te laden:
```
az spring app restart \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --name identity-service
```
Voor de Java- en NodeJS-toepassingen kan het opnieuw opstarten de nieuwe steekproeffrequentie van kracht worden. Voor de niet-Java-toepassingen is het opnieuw opstarten mogelijk om toegang te krijgen tot de zojuist toegevoegde Instrumentatiesleutel vanuit de Key Vault.

Logboeken weergeven

Er zijn twee manieren om logboeken te bekijken in Azure Spring Apps: logboekstreaming van realtime logboeken per app-exemplaar of Log Analytics voor geaggregeerde logboeken met geavanceerde querymogelijkheden

Logboekstreaming gebruiken

Genereer verkeer in de toepassing door de toepassing te doorlopen, de catalogus weer te geven en orders te plaatsen. Gebruik de volgende opdrachten om continu verkeer te genereren totdat het is geannuleerd:

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

Gebruik de volgende opdracht om de meest recente 100 regels met toepassingsconsolelogboeken op te halen uit de Catalogusservicetoepassing:

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

Door de --follow optie toe te voegen, kunt u realtime logboekstreaming krijgen vanuit een app. Gebruik de volgende opdracht om logboekstreaming te proberen voor de Catalogusservicetoepassing:

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

Tip

U kunt az spring app-logboeken --help gebruiken om meer parameters en logboekstreamfunctionaliteiten te verkennen.

Log Analytics gebruiken

Navigeer naar Azure Portal en open het Log Analytics-exemplaar dat u hebt gemaakt. U vindt het Log Analytics-exemplaar in dezelfde resourcegroep waar u het Azure Spring Apps-service-exemplaar hebt gemaakt.

Selecteer op de pagina Log Analytics het deelvenster Logboeken en voer een van de volgende voorbeeldquery's uit voor Azure Spring Apps.

Typ en voer de volgende Kusto-query uit om toepassingslogboeken te bekijken:

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