Schnellstart: End-to-End-Überwachung von Anwendungen

Artikel
08/28/2024

Hinweis

Die Pläne Basic, Standard und Enterprise gelten ab Mitte März 2025 als veraltet und werden über einen Zeitraum von drei (3) Jahren eingestellt. Es wird empfohlen, auf Azure Container Apps umzustellen. Weitere Informationen finden Sie in der Ankündigung zur Einstellung von Azure Spring Apps.

Der Plan Standardverbrauch und dediziert gilt ab dem 30. September 2024 als veraltet und wird nach sechs Monaten vollständig eingestellt. Es wird empfohlen, auf Azure Container Apps umzustellen. Weitere Informationen finden Sie unter Migrieren des Plans „Standardverbrauch und dediziert“ von Azure Spring Apps zu Azure Container Apps.

Dieser Artikel gilt für:❌ Basic/Standard ✔️ Enterprise

Diese Schnellstartanleitung zeigt Ihnen, wie Sie Anwendungen, die Azure Spring Apps im Enterprise-Plan ausführen, mithilfe von Application Insights und Log Analytics überwachen.

Hinweis

Für die End-to-End-Überwachung Ihrer Spring-Workloads können Sie ein Tool und eine Plattform Ihrer Wahl einsetzen, einschließlich App Insights, Log Analytics, New Relic, Dynatrace, AppDynamics, Elastic oder Splunk. Weitere Informationen finden Sie unter Arbeiten mit anderen Überwachungstools weiter unten in diesem Artikel.

Voraussetzungen

Ein Azure-Konto mit einem aktiven Abonnement. Sie können kostenlos ein Konto erstellen.
Verstehen und Erfüllen des Abschnitts Anforderungen des Enterprise-Plans in Azure Marketplace.
Die Azure CLI Version 2.45.0 oder höher.
Git.
Die Erweiterung des Azure Spring Apps Enterprise-Plans. Verwenden Sie den folgenden Befehl, um frühere Versionen zu entfernen und die neueste Erweiterung des Enterprise-Plans zu installieren. Wenn Sie zuvor die spring-cloud-Erweiterung installiert hatten, deinstallieren Sie diese Erweiterung, um Konfigurations- und Versionskonflikte zu vermeiden.
```
az extension add --upgrade --name spring
az extension remove --name spring-cloud
```
Zu überwachende Ressourcen, beispielsweise diejenigen, die in den folgenden Schnellstartanleitungen erstellt wurden:

Aktualisieren von Anwendungen

Sie müssen den Anwendungen „Order Service“ (ASP.NET Core) und „Cart Service“ (Python) die Verbindungszeichenfolge für Application Insights manuell bereitstellen. In den folgenden Anweisungen wird beschrieben, wie Sie diese Verbindungszeichenfolge bereitstellen und die Samplingrate für Application Insights erhöhen.

Hinweis

Derzeit unterstützen nur die Buildpacks für Java- und NodeJS-Anwendungen die Application Insights Instrumentierung.

Erstellen Sie Variablen zur Aufnahme der Ressourcennamen, indem Sie die folgenden Befehle verwenden. Ersetzen Sie die Platzhalter durch Ihre eigenen Werte. Der Name Ihrer Azure Spring Apps-Dienstinstanz muss zwischen 4 und 32 Zeichen lang sein und darf nur Kleinbuchstaben, Zahlen und Bindestriche enthalten. Das erste Zeichen des Dienstnamens muss ein Buchstabe und das letzte Zeichen entweder ein Buchstabe oder eine Ziffer sein.
```
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>"
```
Hinweis

Standardmäßig ist die APP_INSIGHTS_NAME mit dem AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME identisch.

Verwenden Sie die folgenden Befehle, um die Verbindungszeichenfolge für Application Insights abzurufen und in Key Vault festzulegen:

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}

Mit dem folgenden Befehl aktualisieren Sie die Samplingrate für die Application Insights Bindung, um die verfügbare Datenmenge zu erhöhen:

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}

Mit den folgenden Befehlen starten Sie Anwendungen neu, um die Konfiguration neu zu 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

Wenn Sie einmaliges Anmelden konfiguriert haben, verwenden Sie die folgenden Befehle, um Anwendungen neu zu starten, um die Konfiguration der Identitäts-Service-App neu zu laden:
```
az spring app restart \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --name identity-service
```
Für die Java- und NodeJS-Anwendungen wird die neue Samplingrate nach dem Neustart wirksam. Nicht-Java-Anwendungen ermöglicht der Neustart den Zugriff auf den neu hinzugefügten Instrumentierungsschlüssel aus dem Key Vault.

Anzeigen von Protokollen

Es gibt zwei Möglichkeiten, um Protokolle in Azure Spring Apps anzuzeigen: Protokollstreaming von Echtzeitprotokollen für jede App-Instanz oder Log Analytics für aggregierte Protokolle mit erweiterter Abfragefunktion.

Verwenden des Protokollstreamings

Generieren Sie Datenverkehr in der Anwendung, indem Sie sich in der Anwendung bewegen, den Katalog anzeigen und Bestellungen aufgeben. Verwenden Sie die folgenden Befehle, um kontinuierlich Datenverkehr zu generieren, bis der Vorgang abgebrochen wird:

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

Verwenden Sie den folgenden Befehl, um die letzten 100 Zeilen der Anwendungskonsolenprotokolle aus der Anwendung „Catalog Service“ abzurufen:

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

Durch Hinzufügen der Option --follow können Sie Echtzeit-Protokollstreaming aus einer App erzielen. Verwenden Sie den folgenden Befehl, um das Protokollstreaming für die Anwendung „Catalog Service“ zu testen:

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

Tipp

Sie können „az spring app logs --help“ verwenden, um weitere Parameter und Funktionen des Protokollstreams zu erkunden.

Verwenden von Log Analytics

Navigieren Sie zum Azure-Portal, und öffnen Sie die von Ihnen erstellte Log Analytics-Instanz. Sie finden die Log Analytics-Instanz in derselben Ressourcengruppe, in der Sie die Azure Spring Apps-Dienstinstanz erstellt haben.

Wählen Sie auf der Seite „Log Analytics“ den Bereich Protokolle aus, und führen Sie eine der folgenden Beispielabfragen für Azure Spring Apps aus.

Geben Sie die folgende Kusto-Abfrage ein, und führen Sie sie aus, um Anwendungsprotokolle anzuzeigen:

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