Szybki start: kompleksowe monitorowanie aplikacji

Artykuł
10/01/2024

Uwaga

Plany Podstawowa, Standardowa i Enterprise zostaną wycofane od połowy marca 2025 r. z 3-letnim okresem emerytalnym. Zalecamy przejście do usługi Azure Container Apps. Aby uzyskać więcej informacji, zobacz ogłoszenie o wycofaniu usługi Azure Spring Apps.

Zużycie standardowe i dedykowany plan zostaną wycofane od 30 września 2024 r. z całkowitym zamknięciem po sześciu miesiącach. Zalecamy przejście do usługi Azure Container Apps. Aby uzyskać więcej informacji, zobacz Migrowanie użycia usługi Azure Spring Apps w warstwie Standardowa i dedykowanego planu do usługi Azure Container Apps.

Ten artykuł dotyczy:❌ Podstawowa/Standardowa ✔️ Enterprise

W tym przewodniku Szybki start pokazano, jak monitorować aplikacje z planem Azure Spring Apps Enterprise przy użyciu usługi Application Insights i usługi Log Analytics.

Uwaga

Możesz monitorować kompleksowe obciążenia platformy Spring przy użyciu dowolnego wybranego narzędzia i platformy, w tym usługi App Insights, Log Analytics, New Relic, Dynatrace, AppDynamics, Elastic lub Splunk. Aby uzyskać więcej informacji, zobacz Praca z innymi narzędziami do monitorowania w dalszej części tego artykułu.

Wymagania wstępne

Konto platformy Azure z aktywną subskrypcją. Utwórz konto bezpłatnie.
Zapoznaj się z sekcją Wymagania planu Enterprise w witrynie Azure Marketplace i spełnij je.
Interfejs wiersza polecenia platformy Azure w wersji 2.45.0 lub nowszej.
Git.
Rozszerzenie planu Usługi Azure Spring Apps Enterprise. Użyj następującego polecenia, aby usunąć poprzednie wersje i zainstalować najnowsze rozszerzenie planu Enterprise. Jeśli wcześniej zainstalowano spring-cloud rozszerzenie, odinstaluj je, aby uniknąć niezgodności konfiguracji i wersji.
```
az extension add --upgrade --name spring
az extension remove --name spring-cloud
```
Zasoby do monitorowania, takie jak te utworzone w następujących przewodnikach Szybki start:

Aktualizowanie aplikacji

Musisz ręcznie podać parametry połączenia usługi Application Insights do aplikacji Order Service (ASP.NET Core) i Cart Service (Python). W poniższych instrukcjach opisano sposób podawania tego parametry połączenia i zwiększania częstotliwości próbkowania do usługi Application Insights.

Uwaga

Obecnie tylko pakiety buildpack dla aplikacji Java i NodeJS obsługują instrumentację usługi Application Insights.

Utwórz zmienne do przechowywania nazw zasobów przy użyciu następujących poleceń. Pamiętaj, aby zastąpić symbole zastępcze własnymi wartościami. Nazwa wystąpienia usługi Azure Spring Apps musi mieć długość od 4 do 32 znaków i może zawierać tylko małe litery, cyfry i łączniki. Pierwszy znak nazwy usługi musi być literą, a ostatni znak musi być literą lub cyfrą.
```
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>"
```
Uwaga

Domyślnie APP_INSIGHTS_NAME jest taka sama jak AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME.

Użyj następujących poleceń, aby pobrać parametry połączenia usługi Application Insights i ustawić je w usłudze 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}

Użyj następującego polecenia, aby zaktualizować częstotliwość próbkowania powiązania usługi Application Insights, aby zwiększyć ilość dostępnych danych:

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}

Użyj następujących poleceń, aby ponownie uruchomić aplikacje w celu ponownego załadowania konfiguracji:

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

Jeśli skonfigurowano logowanie jednokrotne, użyj następujących poleceń, aby ponownie uruchomić aplikacje w celu ponownego załadowania konfiguracji aplikacji usługi tożsamości:
```
az spring app restart \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --name identity-service
```
W przypadku aplikacji Java i NodeJS ponowne uruchomienie umożliwi zastosowanie nowego współczynnika próbkowania. W przypadku aplikacji innych niż Java ponowne uruchomienie umożliwi im dostęp do nowo dodanego klucza instrumentacji z usługi Key Vault.

Wyświetlanie dzienników

Istnieją dwa sposoby wyświetlenia dzienników w usłudze Azure Spring Apps: przesyłanie strumieniowe dzienników dzienników w czasie rzeczywistym dla wystąpienia aplikacji lub usługi Log Analytics w przypadku zagregowanych dzienników z zaawansowaną możliwością wykonywania zapytań

Korzystanie z przesyłania strumieniowego dzienników

Generuj ruch w aplikacji, przechodząc przez aplikację, wyświetlając katalog i umieszczając zamówienia. Użyj następujących poleceń, aby stale generować ruch do momentu anulowania:

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

Użyj następującego polecenia, aby pobrać najnowsze 100 wierszy dzienników konsoli aplikacji z aplikacji usługi katalogu:

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

--follow Dodając tę opcję, możesz pobrać przesyłanie strumieniowe dzienników w czasie rzeczywistym z aplikacji. Użyj następującego polecenia, aby spróbować wykonać przesyłanie strumieniowe dzienników dla aplikacji usługi katalogu:

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

Napiwek

Aby poznać więcej parametrów i funkcji strumienia dzienników, możesz użyć polecenia az spring app logs --help .

Korzystanie z usługi Log Analytics

Przejdź do witryny Azure Portal i otwórz utworzone wystąpienie usługi Log Analytics. Wystąpienie usługi Log Analytics można znaleźć w tej samej grupie zasobów, w której utworzono wystąpienie usługi Azure Spring Apps.

Na stronie Log Analytics wybierz okienko Dzienniki i uruchom dowolne z następujących przykładowych zapytań dotyczących usługi Azure Spring Apps.

Wpisz i uruchom następujące zapytanie Kusto, aby wyświetlić dzienniki aplikacji:

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