Gyors kezdés: Alkalmazások monitorozása végponttól végpontig

2025-04-10

Feljegyzés

A Alapszintű, Standardés Enterprise tervek 2025. március 17-én nyugdíjazási időszakba léptek. További információkért lásd az Azure Spring Apps kivonási bejelentését.

A Standard felhasználási és a dedikált-terv 2024. szeptember 30-án lépett a visszavonulási időszakba, amely teljes leállással fejeződik be 2025. március végén. További információért lásd: Az Azure Spring Apps Standard fogyasztási és dedikált csomagok migrálása az Azure Container Appsbe.

Ez a cikk a következőre vonatkozik: ❎ Basic/Standard ✅ Enterprise

Ez a rövid útmutató bemutatja, hogyan monitorozza az Azure Spring Apps Enterprise-csomagot futtató alkalmazásokat az Application Insights és a Log Analytics használatával.

Feljegyzés

A Spring-számítási feladatok végponttól végpontig monitorozhatók bármilyen tetszőleges eszközzel és platformmal, beleértve az App Insightst, a Log Analyticset, a New Relicet, a Dynatrace-t, az AppDynamicst, az Elastic-t vagy a Splunkot. További információt a jelen cikk későbbi, más monitorozási eszközökkel való használata című témakörben talál.

Előfeltételek

Egy Azure-fiók, aktív előfizetéssel. Fiók ingyenes létrehozása.
A Nagyvállalati csomag Követelmények szakaszának megismerése és teljesítése az Azure Marketplace-en.
Az Azure CLI 2.45.0-s vagy újabb verziója.
Git.
Az Azure Spring Apps Enterprise csomagbővítménye. A következő paranccsal távolítsa el a korábbi verziókat, és telepítse a legújabb Enterprise-csomagbővítményt. Ha korábban telepítette a spring-cloud bővítményt, távolítsa el a bővítményt a konfiguráció és a verzióeltérések elkerülése érdekében.
```
az extension add --upgrade --name spring
az extension remove --name spring-cloud
```
Figyelendő erőforrások, például az alábbi rövid útmutatókban létrehozott erőforrások:

Alkalmazások frissítése

Manuálisan kell megadnia az Application Insights kapcsolati karakterláncot a Megrendelési szolgáltatás (ASP.NET Core) és a Kosár szolgáltatás (Python) alkalmazásainak. Az alábbi utasítások bemutatják, hogyan adhatja meg ezt a kapcsolati karakterláncot, és hogyan növelheti a mintavételezési arányt az Application Insights számára.

Feljegyzés

Jelenleg csak a Java- és Node.js-alkalmazások buildcsomagjai támogatják az Application Insights rendszerezését.

Hozzon létre változókat az erőforrásnevek tárolásához az alábbi parancsokkal. Feltétlenül cserélje le a helyőrzőket a saját értékeire. Az Azure Spring Apps-szolgáltatáspéldány nevének 4 és 32 karakter közötti hosszúságúnak kell lennie, és csak kisbetűket, számokat és kötőjeleket tartalmazhat. A szolgáltatásnév első karakterének betűnek kell lennie, az utolsó karakternek pedig betűnek vagy számnak kell lennie.
```
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>"
```
Feljegyzés

Alapértelmezés szerint a APP_INSIGHTS_NAME megegyezik a AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME.

Az Application Insights kapcsolati sztring lekéréséhez és a Key Vaultban való beállításához használja az alábbi parancsokat:

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}

Az alábbi paranccsal frissítheti az Application Insights-kötés mintavételezési sebességét a rendelkezésre álló adatok számának növeléséhez:

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}

A konfiguráció újratöltéséhez használja az alábbi parancsokat az alkalmazások újraindításához:

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

Ha az egyszeri bejelentkezést konfigurálta, az alábbi parancsokkal indítsa újra az alkalmazásokat az identity-service alkalmazás konfigurációjának újratöltéséhez:
```
az spring app restart \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --name identity-service
```
A Java- és Node.js-alkalmazások esetében az újraindítás lehetővé teszi az új mintavételezési sebesség érvénybe lépését. A nem Java-alkalmazások esetében az újraindítás lehetővé teszi számukra, hogy hozzáférjenek az újonnan hozzáadott Instrumentation-kulcshoz a Key Vaultból.

Naplók megtekintése

Az Azure Spring Apps naplói kétféleképpen jeleníthetők meg: alkalmazáspéldányonkénti valós idejű naplók naplóstreamelése vagy a Log Analytics az összesített naplókhoz speciális lekérdezési képességgel

Naplóstreamelés használata

Forgalmat generálhat az alkalmazásban az alkalmazáson áthaladva, a katalógus megtekintésével és a megrendelések leadásával. A következő parancsokkal folyamatosan generálhat forgalmat, amíg meg nem szakítja:

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

Az alábbi paranccsal lekérheti az alkalmazáskonzol-naplók legújabb 100 sorát a Catalog Service alkalmazásból:

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

A --follow opció hozzáadásával valós idejű naplóadat-streamelést kaphat egy alkalmazásból. A katalógusszolgáltatás-alkalmazás naplóstreamelésének kipróbálásához használja az alábbi parancsot:

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

Tipp.

Az spring app logs --help használatával további paramétereket és naplóstream-funkciókat vizsgálhat meg.

A Log Analytics használata

Lépjen az Azure Portalra, és nyissa meg a létrehozott Log Analytics-példányt. A Log Analytics-példány ugyanabban az erőforráscsoportban található, ahol létrehozta az Azure Spring Apps szolgáltatáspéldányt.

A Log Analytics lapon válassza a Naplók panelt, és futtassa a következő minta lekérdezéseket az Azure Spring Appshez.

Írja be és futtassa a következő Kusto-lekérdezést az alkalmazásnaplók megtekintéséhez:

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