Spring Boot-alkalmazások monitorozása a Dynatrace Java OneAgenttel

  • Cikk

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.

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 monitorozhatja a Spring Boot-alkalmazásokat az Azure Spring Appsben a Dynatrace OneAgent használatával.

A Dynatrace OneAgenttel a következőt teheti:

  • Alkalmazások monitorozása a Dynatrace OneAgenttel.
  • Konfigurálja a Dynatrace OneAgentet környezeti változók használatával.
  • Ellenőrizze az összes monitorozási adatot a Dynatrace irányítópultjáról.

Az alábbi videó a Dynatrace OneAgentet mutatja be.


Előfeltételek

Dynatrace OneAgent aktiválása

A következő szakaszok a Dynatrace OneAgent aktiválását ismertetik.

Az Azure Spring Apps-környezet előkészítése

  1. Hozzon létre egy Azure Spring Apps-példányt.
  2. Az alábbi parancs futtatásával hozzon létre egy alkalmazást, amelyet jelenteni szeretne a Dynatrace-nek. Cserélje le a helyőrzőket <...> a saját értékeire. 
    az spring app create \
    --resource-group <your-resource-group-name> \
    --service <your-Azure-Spring-Apps-name> \
    --name <your-application-name> \
    --is-public true

A szükséges környezeti változók értékeinek meghatározása

A Dynatrace OneAgent Azure Spring Apps-példányon való aktiválásához négy környezeti változót kell konfigurálnia: DT_TENANT, DT_TENANTTOKEN, DT_CONNECTION_POINTés DT_CLUSTER_ID. További információ: OneAgent integrálása az Azure Spring Appsszel.

Több példányt tartalmazó alkalmazások esetén a Dynatrace többféleképpen csoportosíthatja őket. DT_CLUSTER_ID az egyik módszer. További információ: Folyamatcsoport-észlelés.

Környezeti változók hozzáadása az alkalmazáshoz

A környezeti változókulcs/érték párok az Azure Portalon vagy az Azure CLI-n keresztül is hozzáadhatók az alkalmazáshoz.

1. lehetőség: Azure CLI

A kulcs-érték párok Azure CLI-vel való hozzáadásához futtassa a következő parancsot, és cserélje le a helyőrzőket <...> az előző lépésekben meghatározott értékekre.

az spring app deploy \
    --resource-group <your-resource-group-name> \
    --service <your-Azure-Spring-Apps-name> \
    --name <your-application-name> \
    --artifact-path app.jar \
    --env \
        DT_TENANT=<your-environment-ID> \
        DT_TENANTTOKEN=<your-tenant-token> \
        DT_CONNECTION_POINT=<your-communication-endpoint>

2. lehetőség: Azure Portal

A kulcs-érték párok Azure Portalon való hozzáadásához kövesse az alábbi lépéseket:

  1. Az Azure Spring Apps-példányban válassza az Alkalmazások lehetőséget a navigációs panelen.

    Képernyőkép az Azure Portalról, amelyen egy Azure Spring Apps-példány Alkalmazások lapja látható.

  2. Válassza ki az alkalmazást a listából, majd a navigációs panelen válassza a Konfiguráció lehetőséget .

  3. A Környezeti változók lapon hozzáadhatja vagy frissítheti az alkalmazás által használt változókat.

    Képernyőkép az Azure Portalról, amelyen egy alkalmazás Konfiguráció lapja látható, amelyen a Környezeti változók lap van kiválasztva.

Kiépítés automatizálása

Terraform-, Bicep- vagy Azure Resource Manager-sablon (ARM-sablon) használatával kiépítési automatizálási folyamatot is futtathat. Ez a folyamat teljes körű gyakorlati élményt nyújt a létrehozott és üzembe helyezhető új alkalmazások eszközzéséhez és monitorozásához.

Kiépítés automatizálása a Terraform használatával

A környezeti változók Terraform-sablonban való konfigurálásához adja hozzá a következő kódot a sablonhoz, és cserélje le a <...> helyőrzőket a saját értékeire. További információ: Active Azure Spring Apps-telepítés kezelése.

environment_variables = {
  "DT_TENANT": "<your-environment-ID>",
  "DT_TENANTTOKEN": "<your-tenant-token>",
  "DT_CONNECTION_POINT": "<your-communication-endpoint>",
  "DT_CLUSTER_ID": "<your-cluster-ID>"
}

Kiépítés automatizálása Bicep-fájl használatával

Egy Bicep-fájl környezeti változóinak konfigurálásához adja hozzá a következő kódot a fájlhoz, és cserélje le a <...> helyőrzőket a saját értékeire. További információ: Microsoft.AppPlatform Spring/apps/deployments.

environmentVariables: {
  DT_TENANT: '<your-environment-ID>'
  DT_TENANTTOKEN: '<your-tenant-token>'
  DT_CONNECTION_POINT: '<your-communication-endpoint>'
  DT_CLUSTER_ID: '<your-cluster-ID>'
}

Kiépítés automatizálása ARM-sablonnal

A környezeti változók ARM-sablonban való konfigurálásához adja hozzá a következő kódot a sablonhoz, és cserélje le a <...> helyőrzőket a saját értékeire. További információ: Microsoft.AppPlatform Spring/apps/deployments.

"environmentVariables": {
  "DT_TENANT": "<your-environment-ID>",
  "DT_TENANTTOKEN": "<your-tenant-token>",
  "DT_CONNECTION_POINT": "<your-communication-endpoint>",
  "DT_CLUSTER_ID": "<your-cluster-ID>"
}

Jelentések megtekintése a Dynatrace-ban

Ez a szakasz bemutatja, hogyan kereshet különböző jelentéseket a Dynatrace-ben.

Feljegyzés

A Dynatrace menü és a felhasználói felület fokozatosan fejlődik. Emiatt előfordulhat, hogy az irányítópult a Dynatrace webhely más szakaszaiba kerül, és az alábbi képernyőképek nem feltétlenül tükrözik a felhasználói felület aktuális verzióját.

Miután hozzáadta a környezeti változókat az alkalmazáshoz, a Dynatrace megkezdi az adatok gyűjtését. A jelentések megtekintéséhez használja a Dynatrace menüt, nyissa meg a Szolgáltatások lehetőséget, majd válassza ki az alkalmazást.

A szolgáltatásfolyamatot az alkalmazásnév>/Részletek/Szolgáltatás folyamatából <találja:

Képernyőkép a Dynatrace Szolgáltatás folyamatjelentéséről.

A metódus-hotspotok az alkalmazás neve>/Részletek/Metódus hotspotok között < találhatók:

Képernyőkép a Dynatrace Method hotspots jelentéséről.

Az adatbázis-utasításokat az alkalmazás neve>/Részletek/Válaszidő elemzése alapján találja:<

Képernyőkép a Dynatrace válaszidő-elemzési jelentéséről és az Adatbázis-utasítások szakaszról.

Ezután nyissa meg a Többdimenziós elemzés szakaszt.

A többdimenziós elemzésekből/top adatbázis-utasításokból származó top adatbázis-utasítások megtalálhatók:

Képernyőkép a Dynatrace Top adatbázis-utasítások jelentéséről.

A Kivételek áttekintését a többdimenziós elemzés/Kivételek áttekintésből találja:

Képernyőkép a Dynatrace Exceptions áttekintési jelentéséről.

Ezután nyissa meg a Profilkészítés és optimalizálás szakaszt .

A cpu-elemzést a profilkészítés és az optimalizálás/CPU-elemzés segítségével találja meg:

Képernyőkép a Dynatrace CPU-elemzési jelentéséről.

Ezután lépjen az Adatbázisok szakaszra.

A Backtrace a Databases/Details/Backtrace oldalról érhető el:

Képernyőkép a Dynatrace Backtrace jelentésről.

Dynatrace OneAgent-naplók megtekintése

Alapértelmezés szerint az Azure Spring Apps kinyomtatja a Dynatrace OneAgent STDOUTinformációs szintű naplóit. A naplók keverednek az alkalmazásnaplókkal. Az explicit ügynök verzióját az alkalmazásnaplókban találja.

A Dynatrace-ügynök naplóit a következő helyekről is lekérheti:

  • Azure Spring Apps-naplók
  • Azure Spring Apps-alkalmazás Elemzések
  • Azure Spring Apps LogStream

A Dynatrace által biztosított környezeti változókat alkalmazhatja a Dynatrace OneAgent naplózásának konfigurálásához. Például DT_LOGLEVELCON a naplók szintjét szabályozza. Az alapértelmezett érték a DT_LOGLEVELCON következő info: . Az ügynök naplóit letilthatja a következő beállítással DT_LOGLEVELCONoff: . Ha a naplózás le van tiltva, a Dynatrace támogatási kérései először engedélyezik a naplózást az ügynökkel kapcsolatos problémák hatékony diagnosztizálásához. Ezután újra kell indítania az alkalmazást, ami a módosítás érvénybe lépéséhez szükséges. További naplószintekért tekintse meg a Dynatrace támogatási csapatát.

Figyelemfelhívás

Határozottan javasoljuk, hogy ne bírálja felül az Azure Spring Apps for Dynatrace által biztosított alapértelmezett naplózási viselkedést. Ha így tesz, a korábban ismertetett naplózási forgatókönyvek le lesznek tiltva, és a naplófájl(ok) elveszhetnek. Például nem szabad a környezeti változót DT_LOGLEVELFILE kiírni az alkalmazásoknak.

Dynatrace OneAgent frissítés

A Dynatrace OneAgent automatikus frissítése le van tiltva, és negyedévente frissül a JDK-val. Az ügynök frissítése a következő forgatókönyveket érintheti:

  • A Frissítés előtt a Dynatrace OneAgentet használó meglévő alkalmazások változatlanok, de újraindítást vagy ismételt üzembe helyezést igényelnek a Dynatrace OneAgent új verziójának használatához.
  • A frissítés után létrehozott alkalmazások a Dynatrace OneAgent új verzióját használják.

Virtuális hálózati injektálási példány kimenő forgalmi konfigurációja

Az Azure Spring Apps virtuális hálózati injektálási példányához meg kell győződnie arról, hogy a Dynatrace kommunikációs végpontok kimenő forgalma megfelelően van konfigurálva a Dynatrace OneAgenthez. További információ a lekérés communicationEndpointsmódjáról: Deployment API – GET kapcsolati információk a OneAgenthez. További információkért lásd az Azure Spring Apps virtuális hálózaton való futtatásával kapcsolatos ügyfél-felelősségeket.

Dynatrace támogatási modell

A Dynatrace OneAgent csak alkalmazás módban történő üzembe helyezésekor érvényes korlátozásokról a OneAgent platform és a képességtámogatási mátrix felhőalkalmazási platformokkalfoglalkozó szakaszában olvashat.

Következő lépések

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