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

2025-04-04

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: Azure Spring Apps Standard fogyasztás és dedikált terv migrálása az Azure Container Appsbe.

Spring Boot natív kép alkalmazások esetén az Application Insights Java-ügynök helyett használja az Azure Monitor OpenTelemetry Distro / Application Insights in Spring Boot natív kép Java-alkalmazás projektet.

Ez a cikk a következőre vonatkozik:✅ Standard felhasználás és dedikált (előzetes verzió) ✅ Basic/Standard ✅ Enterprise

Ez a cikk azt ismerteti, hogyan monitorozhat alkalmazásokat az Application Insights 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 Application Insights számos megfigyelhető perspektívát kínál, többek között az alábbiakat:

Alkalmazástérkép
Teljesítmény
Hibák
Mérőszámok
Élő metrikaadatok
Elérhetőség
Naplók

Az Application Insights szolgáltatás használata

Ha az Application Insights szolgáltatás engedélyezve van, a következőket teheti:

A navigációs panelen válassza az Application Insights lehetőséget az Application Insights áttekintési oldalá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 a customers-service és petclinic közötti kapcsolatot, hogy további részleteket láthasson, például egy SQL-lekérdezést.
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 Application Insights 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, amikor cloud_RoleName szűr.

Az Application Insights kezelése az Azure Portal használatával

Engedélyezze a Java folyamaton belüli ügynököt az alábbi eljárással.

Navigáljon a szolgáltatási példány Áttekintés oldalára, majd a Figyelés szakaszban válassza a Application Insights lehetőséget.
Válassza az Application Insights engedélyezése lehetőséget az Azure Spring Apps alkalmazásban az Application Insights engedélyezéséhez.
Válasszon ki egy meglévő Application Insights-példányt, vagy hozzon létre egy újat.
Ha az Application Insights 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 Application Insights-példányt a különböző Azure Spring Apps-példányokban, vagy vegyes adatok jelennek meg.

A Portál használatával ellenőrizheti vagy frissítheti az Application Insights aktuális beállításait.

Az Application Insights engedélyezése az Azure Portal használatával

Válassza az Application Insights lehetőséget.
Az Application Insights engedélyezéséhez válassza a Kötés szerkesztése vagy a Nincs kötés hivatkozást.
Szerkessze az Application Insights vagy a mintavételezési arányt, majd válassza a Mentés lehetőséget.

Az Application Insights letiltása

Válassza az Application Insights lehetőséget.
Válassza a Kötés megszüntetése lehetőséget az Application Insights letiltásához.

Az Application Insights beállításainak módosítása

Válassza ki a nevet az Application Insights oszlopban az Application Insights szakasz megnyitásához.

Képernyőkép az Azure Portalról, amelyen az Azure Spring Apps-példány látható az Application Insights oldallal.

Application Insights buildpack-kötések szerkesztése a Build Service-ben

Az Application Insights buildpack kötéseinek aktuális beállításainak a Build Service-ben való 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 az építőt.
Válassza a Szerkesztés lehetőséget a Kötések oszlop alatt.

Az Application Insights beállításai a Kötés típusa oszlop alatt felsorolt ApplicationInsights elemben találhatók.

Jelölje ki a Kötés hivatkozást, vagy válassza a Kötés szerkesztése lehetőséget a három pontra kattintva az Application Insights buildpack kötéseinek 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.

Application Insights kezelése az Azure CLI használatával

Az Application Insights azure CLI-parancsokkal kezelhető. Az alábbi parancsokban mindenképpen cserélje le a szöveget a <placeholder> leírt értékekre. A <service-instance-name> helyőrző az Azure Spring Apps-példány nevére hivatkozik.

Az Application Insights engedélyezése

Az Application Insights Azure Spring Apps-példány létrehozásakor történő konfigurálásához használja az alábbi parancsot. app-insights Az argumentumhoz megadhat egy Application Insights-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 alábbi példában látható módon az Application Insights kapcsolati sztringet (előnyben részesített) vagy az instrumentációs kulcsot is használhatja.

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

Az Application Insights letiltása

Ha le szeretné tiltani az Application Insightst 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

Az Application Insights beállításainak ellenőrzése

Egy meglévő Azure Spring Apps-példány Application Insights-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>

Application Insights frissítése

Az Application Insights használatának frissítéséhez kapcsolati láncot (előnyben részesített) vagy instrumentációs kulcsot használjon 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 Application Insights 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>

Az Application Insights letiltása a frissítési paranccsal

Ha le szeretné tiltani az Application Insightst 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

Application Insights 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 terv buildpack kötésekkel integrálja az Azure-alkalmazás Insightst a következő típussal: ApplicationInsights. További információ: Az APM-integráció és a hitelesítésszolgáltatói tanúsítványok konfigurálása.

Application Insights 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 Application Insights-kötések típusának 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 Application Insights buildpack-kötésének 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 Application Insights buildpack-kötésének 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>

Az Application Insights buildpack-kötésének 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>

Automatizálás

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.

Bicepsz

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/monitoringSettings.

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/monitoringSettings.

{
  "$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/bővítése

A Java ügynököt rendszeresen frissítik/fejlesztik tovább a JDK-val, ami az alábbi szcenáriókat befolyásolhatja.

Feljegyzés

A JDK-verzió negyedévente frissül.

A frissítés/korszerűsítés előtt a Java-ügynököt használó meglévő alkalmazásokat nem érintik.
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 korábban Java-ügynököt nem használt meglévő alkalmazásokat újra kell indítani vagy ismételt üzembe kell helyezni.

A buildpack frissítésekor a Java-ügynök frissül.

Java-ügynök konfigurációjának dinamikus 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 percekkel késik.

Ha a Java-ügynök már engedélyezve van, az Application Insights-példány vagy SamplingRate -érték 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 Insights között

Azure Spring Apps	Application Insights
`App`	* Alkalmazástérkép/szerepkör * Élő metrikák/Szerep * 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/Példány lehetőségek

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.
Kezdeményezi a kék/zöld üzembe helyezést.
Indítsa újra az alkalmazást.
Leállítja egy alkalmazás üzembe helyezését, majd újraindítja azt.

Az Application Insightsban tárolt adatok a Java-ügynök engedélyezése óta létrehozott vagy üzembe helyezett Azure Spring Apps-alkalmazáspéldányok előzményeit tartalmazzák. Az Application Insights portálon például megtekintheti a tegnap létrehozott alkalmazásadatokat, majd törölhetők egy adott időtartományon belül, 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 Application Insights néhány adatát. A következőt látja:
- Az Alkalmazástérkép három eleme az elmúlt 24 óra időtartományaival, valamint hibákkal, teljesítménnyel és mérőszámokkal.
- 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ában.
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 szeretné az Application Insights néhány adatát. A következőt látja:
- Az Alkalmazástérkép három példánya az elmúlt 24 órából származó időtartományokkal, 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 a Live Metricsben.

Megosztás a következőn keresztül:

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

Az Application Insights szolgáltatás használata

Az Application Insights kezelése az Azure Portal használatával

Az Application Insights engedélyezése az Azure Portal használatával

Az Application Insights letiltása

Az Application Insights beállításainak módosítása

Application Insights buildpack-kötések szerkesztése a Build Service-ben

Application Insights kezelése az Azure CLI használatával

Az Application Insights engedélyezése

Az Application Insights letiltása

Az Application Insights beállításainak ellenőrzése

Application Insights frissítése

Az Application Insights letiltása a frissítési paranccsal

Application Insights buildpack-kötések kezelése

Automatizálás

Bicepsz

ARM-sablonok

Terraform

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

Java-ügynök konfigurációjának dinamikus betöltése

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

Következő lépések

Visszajelzés

További források