Az Application Insights Java-folyamatbeli ügynök használata az Azure Spring Appsben

Cikk
02/02/2024

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_RoleNamesorá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.

Képernyőkép az Azure Portalról, amelyen az Azure Spring Apps-példány látható az Alkalmazás Elemzések oldallal.

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 ApplicationInsightsmegkeresé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.

Az Application Insights Java-folyamatbeli ügynök használata az Azure Spring Appsben

Az Alkalmazás Elemzések funkció használata

Alkalmazás Elemzések kezelése az Azure Portal használatával

Alkalmazás Elemzések engedélyezése az Azure Portal használatával

Alkalmazás Elemzések letiltása

Alkalmazás Elemzések Gépház módosítása

Alkalmazás-Elemzések buildpack-kötések szerkesztése a Build Service-ben

Alkalmazás Elemzések kezelése az Azure CLI használatával

Az Application Insights engedélyezése

Alkalmazás Elemzések letiltása

Alkalmazás Elemzések beállításainak ellenőrzése

Alkalmazás Elemzések frissítése

Alkalmazás Elemzések letiltása a frissítési paranccsal

Alkalmazás-Elemzések buildpack-kötések kezelése

Automation

Bicep

ARM-sablonok

Terraform

Java-ügynök frissítése/frissítése

Java-ügynök konfigurációjának gyakori elérésű betöltése

Koncepcióegyezés az Azure Spring Apps és az Application Elemzések között

Következő lépések

További források