Az Application Insights Java-folyamatbeli ügynök használata az Azure Spring Appsben
Feljegyzés
Az Azure Spring Apps az Azure Spring Cloud szolgáltatás új neve. Bár a szolgáltatásnak új neve van, bizonyos helyeken a régi nevet fogja látni egy darabig, miközben az eszközök, például képernyőképek, videók és diagramok frissítésével dolgozunk.
A Spring Boot natív rendszerkép-alkalmazásokkal az Azure Monitor OpenTelemetry Distro/Application Elemzések használata a Spring Boot natív rendszerkép Java-alkalmazásprojektjében az Alkalmazás Elemzések Java-ügynök helyett.
Ez a cikk a következőre vonatkozik: ✔️ Standard felhasználás és dedikált (előzetes verzió) ✔️ Basic/Standard ✔️ Enterprise
Ez a cikk bemutatja, hogyan monitorozhat alkalmazásokat az Alkalmazás Elemzések Java-ügynökkel az Azure Spring Appsben.
Ezzel a funkcióval a következőket teheti:
- Nyomkövetési adatok keresése különböző szűrőkkel.
- A Spring-alkalmazások függőségi térképének megtekintése.
- Ellenőrizze a kérés teljesítményét.
- Valós idejű élő metrikák monitorozása.
- Ellenőrizze a kérelmek hibáit.
- Alkalmazásmetrikák ellenőrzése.
- Ellenőrizze az alkalmazásnaplókat.
Az alkalmazás Elemzések számos megfigyelhető perspektívát biztosíthat, többek között a következőket:
- Alkalmazástérkép
- Teljesítmény
- Hibák
- Mérőszámok
- Élő metrikaadatok
- Elérhetőség
- Naplók
Az Alkalmazás Elemzések funkció használata
Ha az Alkalmazás Elemzések funkció engedélyezve van, a következőket teheti:
A navigációs ablakban válassza az Alkalmazás Elemzések lehetőséget az Alkalmazás Elemzések Áttekintés lapjának megtekintéséhez. Az Áttekintés lapon áttekintheti az összes futó alkalmazást.
Válassza az Alkalmazástérkép lehetőséget az alkalmazások közötti hívások állapotának megtekintéséhez.
Válassza ki az ügyfél-szolgáltatás közötti hivatkozást, és
petclinic
további részletek, például az SQL-lekérdezés megtekintéséhez.Válasszon ki egy végpontot a végpontra irányuló összes kérelmet küldő alkalmazás megtekintéséhez.
A navigációs ablakban válassza a Teljesítmény lehetőséget az alkalmazások műveleteinek, függőségeinek és szerepköreinek teljesítményadatainak megtekintéséhez.
A navigációs ablakban válassza a Hibák lehetőséget az alkalmazások váratlan hibáinak vagy kivételeinek megtekintéséhez.
A navigációs panelen válassza a Metrikák lehetőséget, és válassza ki a névteret a Spring Boot-metrikák és az egyéni metrikák megjelenítéséhez, ha vannak ilyenek.
A navigációs ablakban válassza az Élő metrikák lehetőséget a különböző dimenziók valós idejű metrikáinak megtekintéséhez.
A navigációs ablakban válassza a Rendelkezésre állás lehetőséget a webalkalmazások rendelkezésre állásának és válaszkészségének figyeléséhez az Alkalmazás Elemzések rendelkezésre állási tesztjeinek létrehozásával.
A navigációs ablakban válassza a Naplók lehetőséget az alkalmazások naplóinak megtekintéséhez, vagy egy alkalmazás naplóinak megtekintéséhez a szűrés
cloud_RoleName
során.
Alkalmazás Elemzések kezelése az Azure Portal használatával
Engedélyezze a Java folyamaton belüli ügynököt az alábbi eljárással.
Ugrás a szolgáltatásra | A szolgáltatáspéldány áttekintési lapja, majd a Figyelés szakaszban válassza az Alkalmazás Elemzések lehetőséget.
Válassza az Alkalmazás Elemzések engedélyezése lehetőséget az Alkalmazás Elemzések engedélyezéséhez az Azure Spring Appsben.
Válasszon ki egy meglévő alkalmazáspéldányt Elemzések, vagy hozzon létre egy újat.
Ha az alkalmazás Elemzések engedélyezve van, konfigurálhat egy választható mintavételezési sebességet (alapértelmezett 10,0%).
Kattintson a Mentés gombra a módosítások mentéséhez.
Feljegyzés
Ne használja ugyanazt az alkalmazáspéldányt Elemzések különböző Azure Spring Apps-példányokban, vagy vegyes adatok jelennek meg.
A portálon ellenőrizheti vagy frissítheti az alkalmazás Elemzések aktuális beállításait.
Alkalmazás Elemzések engedélyezése az Azure Portal használatával
Válassza az Application Insights lehetőséget.
Az Alkalmazás Elemzések engedélyezéséhez válassza a Kötés szerkesztése vagy a Kötetlen hivatkozás lehetőséget.
Szerkessze az alkalmazás Elemzések vagy mintavételezési sebességét, majd válassza a Mentés lehetőséget.
Alkalmazás Elemzések letiltása
Válassza az Application Insights lehetőséget.
Válassza a Kötés megszüntetése lehetőséget az alkalmazás Elemzések letiltásához.
Alkalmazás Elemzések Gépház módosítása
Az Alkalmazás Elemzések szakasz megnyitásához válassza ki az Alkalmazás Elemzések oszlop alatti nevet.
Alkalmazás-Elemzések buildpack-kötések szerkesztése a Build Service-ben
Az alkalmazás Elemzések Buildpack-kötések aktuális beállításainak ellenőrzéséhez és frissítéséhez kövesse az alábbi lépéseket:
- Válassza a Build Service lehetőséget.
- Válassza ki a szerkesztőt.
- Válassza a Szerkesztés lehetőséget a Kötések oszlop alatt.
Az alkalmazás Elemzések beállításai az Alkalmazás Elemzések a Kötés típusa oszlopban felsorolt elemben találhatók.
Válassza a Kötött hivatkozást, vagy válassza a Három pont alatti Kötés szerkesztése lehetőséget az alkalmazás Elemzések buildpack kötések megnyitásához és szerkesztéséhez.
Szerkessze a kötési beállításokat, majd válassza a Mentés lehetőséget.
Alkalmazás Elemzések kezelése az Azure CLI használatával
Az Alkalmazás Elemzések Azure CLI-parancsokkal kezelhető. Az alábbi parancsokban mindenképpen cserélje le a <helyőrző> szöveget a leírt értékekre. A <szolgáltatáspéldány-név> helyőrzője az Azure Spring Apps-példány nevére hivatkozik.
Az Application Insights engedélyezése
Az Azure Spring Apps-példány létrehozásakor az alkalmazás Elemzések konfigurálásához használja az alábbi parancsot. app-insights
Az argumentumhoz megadhat egy alkalmazást Elemzések nevet vagy erőforrás-azonosítót.
az spring create \
--resource-group <resource-group-name> \
--name "service-instance-name" \
--app-insights <name-or-resource-ID> \
--sampling-rate <sampling-rate>
az spring create \
--resource-group <resource-group-name> \
--name "service-instance-name" \
--app-insights <name-or-resource-ID> \
--sampling-rate <sampling-rate> \
--sku Enterprise
Az alkalmazás Elemzések kapcsolati sztring (előnyben részesített) vagy rendszerállapotkulcsot is használhat, ahogyan az az alábbi példában is látható.
az spring create \
--resource-group <resource-group-name> \
--name <service-instance-name> \
--app-insights-key <connection-string-or-instrumentation-key> \
--sampling-rate <sampling-rate>
az spring create \
--resource-group <resource-group-name> \
--name <service-instance-name> \
--app-insights-key <connection-string-or-instrumentation-key> \
--sampling-rate <sampling-rate> \
--sku Enterprise
Alkalmazás Elemzések letiltása
Ha le szeretné tiltani az Alkalmazás Elemzések egy Azure Spring Apps-példány létrehozásakor, használja a következő parancsot:
az spring create \
--resource-group <resource-group-name> \
--name <service-instance-name> \
--disable-app-insights
az spring create \
--resource-group <resource-group-name> \
--name <service-instance-name> \
--disable-app-insights \
--sku Enterprise
Alkalmazás Elemzések beállításainak ellenőrzése
Egy meglévő Azure Spring Apps-példány alkalmazás-Elemzések beállításainak ellenőrzéséhez használja a következő parancsot:
az spring app-insights show \
--resource-group <resource-group-name> \
--name <service-instance-name>
Alkalmazás Elemzések frissítése
Az alkalmazás Elemzések kapcsolati sztring (előnyben részesített) vagy rendszerállapot-kulcs használatára való frissítéséhez használja a következő parancsot:
az spring app-insights update \
--resource-group <resource-group-name> \
--name <service-instance-name> \
--app-insights-key <connection-string-or-instrumentation-key> \
--sampling-rate <sampling-rate>
Az alkalmazás Elemzések erőforrásnév vagy -azonosító használatára való frissítéséhez használja a következő parancsot:
az spring app-insights update \
--resource-group <resource-group-name> \
--name <service-instance-name> \
--app-insights <name-or-resource-ID> \
--sampling-rate <sampling-rate>
Alkalmazás Elemzések letiltása a frissítési paranccsal
Ha le szeretné tiltani az Alkalmazás Elemzések egy meglévő Azure Spring Apps-példányon, használja a következő parancsot:
az spring app-insights update \
--resource-group <resource-group-name> \
--name <service-instance-name> \
--disable
Alkalmazás-Elemzések buildpack-kötések kezelése
Ez a szakasz csak a Vállalati csomagra vonatkozik, és az előző szakaszt kiegészítő utasításokat tartalmaz.
Az Azure Spring Apps Enterprise-csomag buildpack kötésekkel integrálja a Azure-alkalmazás Elemzések a típussalApplicationInsights
. További információ: Az APM-integráció és a hitelesítésszolgáltatói tanúsítványok konfigurálása.
Alkalmazás Elemzések buildpack kötés létrehozásához használja a következő parancsot:
az spring build-service builder buildpack-binding create \
--resource-group <your-resource-group-name> \
--service <your-service-instance-name> \
--name <your-binding-name> \
--builder-name <your-builder-name> \
--type ApplicationInsights \
--properties sampling-percentage=<your-sampling-percentage> \
connection-string=<your-connection-string>
Az összes Buildpack-kötés listázásához és az alkalmazás Elemzések típusú kötések ApplicationInsights
megkereséséhez használja a következő parancsot:
az spring build-service builder buildpack-binding list \
--resource-group <your-resource-group-name> \
--service <your-service-resource-name> \
--builder-name <your-builder-name>
Az alkalmazás Elemzések buildpack kötés cseréjéhez használja a következő parancsot:
az spring build-service builder buildpack-binding set \
--resource-group <your-resource-group-name> \
--service <your-service-instance-name> \
--name <your-binding-name> \
--builder-name <your-builder-name> \
--type ApplicationInsights \
--properties sampling-percentage=<your-sampling-percentage> \
connection-string=<your-connection-string>
Az alkalmazás Elemzések buildpack kötés lekéréséhez használja a következő parancsot:
az spring build-service builder buildpack-binding show \
--resource-group <your-resource-group-name> \
--service <your-service-instance-name> \
--name <your-binding-name> \
--builder-name <your-builder-name>
Egy alkalmazás Elemzések buildpack kötés törléséhez használja a következő parancsot:
az spring build-service builder buildpack-binding delete \
--resource-group <your-resource-group-name> \
--service <your-service-instance-name> \
--name <your-binding-name> \
--builder-name <your-builder-name>
Automation
Az alábbi szakaszok bemutatják, hogyan automatizálhatja az üzembe helyezést Bicep, Azure Resource Manager-sablonok (ARM-sablonok) vagy Terraform használatával.
Bicep
Bicep-fájl használatával történő üzembe helyezéshez másolja a következő tartalmat egy main.bicep fájlba. További információ: Microsoft.AppPlatform Spring/monitoring Gépház.
param springName string
param location string = resourceGroup().location
resource spring 'Microsoft.AppPlatform/Spring@2020-07-01' = {
name: springName
location: location
properties: {}
}
resource monitorSetting 'Microsoft.AppPlatform/Spring/monitoringSettings@2020-11-01-preview' = {
parent: spring
name: 'default'
properties: {
appInsightsInstrumentationKey: '00000000-0000-0000-0000-000000000000'
appInsightsSamplingRate: 88
}
}
ARM-sablonok
ARM-sablonnal történő üzembe helyezéshez másolja a következő tartalmat egy azuredeploy.json fájlba. További információ: Microsoft.AppPlatform Spring/monitoring Gépház.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"springName": {
"type": "string"
},
"location": {
"type": "string",
"defaultValue": "[resourceGroup().location]"
}
},
"resources": [
{
"type": "Microsoft.AppPlatform/Spring",
"apiVersion": "2020-07-01",
"name": "[parameters('springName')]",
"location": "[parameters('location')]",
"properties": {}
},
{
"type": "Microsoft.AppPlatform/Spring/monitoringSettings",
"apiVersion": "2020-11-01-preview",
"name": "[format('{0}/{1}', parameters('springName'), 'default')]",
"properties": {
"appInsightsInstrumentationKey": "00000000-0000-0000-0000-000000000000",
"appInsightsSamplingRate": 88
},
"dependsOn": [
"[resourceId('Microsoft.AppPlatform/Spring', parameters('springName'))]"
]
}
]
}
Terraform
Terraform-üzembe helyezéshez használja az alábbi sablont. További információ: azurerm_spring_cloud_service.
provider "azurerm" {
features {}
}
resource "azurerm_resource_group" "example" {
name = "example-resources"
location = "West Europe"
}
resource "azurerm_application_insights" "example" {
name = "tf-test-appinsights"
location = azurerm_resource_group.example.location
resource_group_name = azurerm_resource_group.example.name
application_type = "web"
}
resource "azurerm_spring_cloud_service" "example" {
name = "example-springcloud"
resource_group_name = azurerm_resource_group.example.name
location = azurerm_resource_group.example.location
sku_name = "S0"
config_server_git_setting {
uri = "https://github.com/Azure-Samples/piggymetrics"
label = "config"
search_paths = ["dir1", "dir2"]
}
trace {
connection_string = azurerm_application_insights.example.connection_string
sample_rate = 10.0
}
tags = {
Env = "staging"
}
}
A Nagyvállalati csomag automatizálása függőben van. Amint elérhető, megjelenik a dokumentáció.
Java-ügynök frissítése/frissítése
A Java-ügynök rendszeresen frissül/frissíthető a JDK-val, ami az alábbi forgatókönyveket befolyásolhatja.
Feljegyzés
A JDK-verzió évente negyedévente frissül/frissül.
- A frissítés/frissítés előtt a Java-ügynököt használó meglévő alkalmazásokra nincs hatással.
- A frissítés/frissítés után létrehozott alkalmazások a Java-ügynök új verzióját használják.
- A Java-ügynök új verziójának használatához a java-ügynök új verziójának használatához a meglévő alkalmazások újraindítására vagy ismételt üzembe helyezésére van szükség.
A Buildpack frissítésekor a Java-ügynök frissül/frissíthető.
Java-ügynök konfigurációjának gyakori elérésű betöltése
Az Azure Spring Apps egy gyakori betöltési mechanizmussal rendelkezik az ügynökkonfiguráció beállításainak módosításához az alkalmazások újraindítása nélkül.
Feljegyzés
A gyorstöltési mechanizmus percek alatt késik.
Ha a Java-ügynök már engedélyezve van, az alkalmazás Elemzések példányának vagy
SamplingRate
értékének módosítása nem igényli az alkalmazás újraindítását.Ha engedélyezi a Java-ügynököt, újra kell indítania az alkalmazásokat.
Ha letiltja a Java-ügynököt, az alkalmazások percek múlva nem küldik el az összes monitorozási adatot. Újraindíthatja az alkalmazásokat, hogy eltávolítsa az ügynököt a Java-futtatókörnyezetből.
Koncepcióegyezés az Azure Spring Apps és az Application Elemzések között
Azure Spring Apps | Application Insights |
---|---|
App |
* Alkalmazástérkép/szerepkör * Élő metrikák/szerepkör * Hibák/Szerepkörök/Felhőszerepkör * Teljesítmény/Szerepkörök/Lehetséges szerepkörök |
App Instance |
* Alkalmazástérkép/szerepkörpéldány * Élő metrikák/szolgáltatásnév * Hibák/szerepkörök/felhőpéldány * Teljesítmény/Szerepkörök/Lehetséges példány |
Az Azure Spring Apps neve App Instance
a következő esetekben módosul vagy jön létre:
- Új alkalmazást hoz létre.
- JAR-fájlt vagy forráskódot helyez üzembe egy meglévő alkalmazásban.
- Kék/zöld üzembe helyezést kezdeményez.
- Indítsa újra az alkalmazást.
- Leállítja egy alkalmazás üzembe helyezését, majd újraindítja azt.
Amikor az adatokat az Application Elemzések tárolja, az tartalmazza a Java-ügynök engedélyezése óta létrehozott vagy üzembe helyezett Azure Spring Apps-alkalmazáspéldányok előzményeit. Az Alkalmazás Elemzések portálon például megtekintheti a tegnap létrehozott, de egy adott időtartományon belül törölt alkalmazásadatokat, például az elmúlt 24 órában. A következő forgatókönyvek bemutatják ennek működését:
- Ma reggel 8:00 körül létrehozott egy alkalmazást az Azure Spring Appsből, amelyen engedélyezve van a Java-ügynök, majd a mai napon 8:10 óra körül telepített egy JAR-fájlt erre az alkalmazásra. Némi tesztelés után ma reggel 8:30-kor módosítja a kódot, és üzembe helyez egy új JAR-fájlt az alkalmazásban. Ezután szünetet tart, és amikor 11:00 óra körül visszatér, ellenőrizze az Alkalmazás Elemzések egyes adatait. A következőt látja:
- Az Alkalmazástérkép három példánya az elmúlt 24 órában megadott időtartományokkal, valamint hibákkal, teljesítménnyel és metrikákkal.
- Az Application Map egyik példánya az elmúlt órában megadott időtartománysal, valamint hibákkal, teljesítménnyel és metrikákkal.
- Egy példány az élő metrikákban.
- Ma reggel 8:00 körül létrehozott egy alkalmazást az Azure Spring Appsből, amelyen engedélyezve van a Java-ügynök, majd a mai napon 8:10 óra körül telepített egy JAR-fájlt erre az alkalmazásra. Ma reggel 8:30 körül egy kék/zöld üzembe helyezést próbál ki egy másik JAR-fájllal. Jelenleg két üzemelő példánya van ehhez az alkalmazáshoz. A mai napon 11:00 óra körüli szünet után ellenőrizni szeretne néhány adatot az Alkalmazás Elemzések. A következőt látja:
- Az Alkalmazástérkép három példánya az elmúlt 24 órában megadott időtartományokkal, valamint hibákkal, teljesítménnyel és metrikákkal.
- Az Alkalmazástérkép két példánya az elmúlt órában megadott időtartományokkal, valamint hibákkal, teljesítménnyel és metrikákkal.
- Két példány az élő metrikákban.
Következő lépések
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: