Dela via

Övervaka Spring Boot-appar med Dynatrace Java OneAgent

  • Artikel

Kommentar

Basic-, Standard- och Enterprise-planerna kommer att vara inaktuella från och med mitten av mars 2025, med en 3-årig pensionsperiod. Vi rekommenderar att du övergår till Azure Container Apps. Mer information finns i meddelandet om azure Spring Apps-pensionering.

Standardförbrukningen och den dedikerade planen kommer att vara inaktuell från och med den 30 september 2024, med en fullständig avstängning efter sex månader. Vi rekommenderar att du övergår till Azure Container Apps. Mer information finns i Migrera Azure Spring Apps Standard-förbrukning och dedikerad plan till Azure Container Apps.

Den här artikeln gäller för: ✔️ Standardförbrukning och dedikerad (förhandsversion) ✔️ Basic/Standard ❌️ Enterprise

Den här artikeln visar hur du använder Dynatrace OneAgent för att övervaka Spring Boot-program i Azure Spring Apps.

Med Dynatrace OneAgent kan du:

  • Övervaka appar med Dynatrace OneAgent.
  • Konfigurera Dynatrace OneAgent med hjälp av miljövariabler.
  • Kontrollera alla övervakningsdata från Dynatrace-instrumentpanelen.

Följande video introducerar Dynatrace OneAgent.


Förutsättningar

Aktivera Dynatrace OneAgent

I följande avsnitt beskrivs hur du aktiverar Dynatrace OneAgent.

Förbereda din Azure Spring Apps-miljö

  1. Skapa en instans av Azure Spring Apps.
  2. Skapa ett program som du vill rapportera till Dynatrace genom att köra följande kommando. Ersätt platshållarna <...> med dina egna värden. 
    az spring app create \
    --resource-group <your-resource-group-name> \
    --service <your-Azure-Spring-Apps-name> \
    --name <your-application-name> \
    --is-public true

Fastställa värdena för de miljövariabler som krävs

Om du vill aktivera Dynatrace OneAgent på din Azure Spring Apps-instans måste du konfigurera fyra miljövariabler: DT_TENANT, DT_TENANTTOKEN, DT_CONNECTION_POINToch DT_CLUSTER_ID. Mer information finns i Integrera OneAgent med Azure Spring Apps.

För program med flera instanser har Dynatrace flera sätt att gruppera dem. DT_CLUSTER_ID är ett av sätten. Mer information finns i Processgruppidentifiering.

Lägga till miljövariablerna i ditt program

Du kan lägga till nyckel/värde-par för miljövariabeln i ditt program med hjälp av antingen Azure Portal eller Azure CLI.

Alternativ 1: Azure CLI

Om du vill lägga till nyckel/värde-paren med hjälp av Azure CLI kör du följande kommando och ersätter platshållarna ...> med de värden som fastställdes <i föregående steg.

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>

Alternativ 2: Azure Portal

Om du vill lägga till nyckel/värde-paren med hjälp av Azure Portal använder du följande steg:

  1. I din Azure Spring Apps-instans väljer du Appar i navigeringsfönstret.

    Skärmbild av Azure Portal som visar sidan Appar för en Azure Spring Apps-instans.

  2. Välj programmet i listan och välj sedan Konfiguration i navigeringsfönstret.

  3. Använd fliken Miljövariabler för att lägga till eller uppdatera de variabler som används av ditt program.

    Skärmbild av Azure Portal som visar sidan Konfiguration för en app med fliken Miljövariabler markerad.

Automatisera etablering

Med hjälp av Terraform, Bicep eller Azure Resource Manager-mallen (ARM-mall) kan du också köra en pipeline för etableringsautomatisering. Den här pipelinen kan ge en fullständig praktisk upplevelse för att instrumentera och övervaka alla nya program som du skapar och distribuerar.

Automatisera etablering med Terraform

Om du vill konfigurera miljövariablerna i en Terraform-mall lägger du till följande kod i mallen och ersätter <platshållarna ...> med dina egna värden. Mer information finns i Hantera en aktiv Azure Spring Apps-distribution.

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

Automatisera etablering med hjälp av en Bicep-fil

Om du vill konfigurera miljövariablerna i en Bicep-fil lägger du till följande kod i filen och ersätter <platshållarna ...> med dina egna värden. Mer information finns i 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>'
}

Automatisera etablering med hjälp av en ARM-mall

Om du vill konfigurera miljövariablerna i en ARM-mall lägger du till följande kod i mallen och ersätter <platshållarna ...> med dina egna värden. Mer information finns i 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>"
}

Visa rapporter i Dynatrace

I det här avsnittet beskrivs hur du hittar olika rapporter i Dynatrace.

Kommentar

Dynatrace-menyn och användargränssnittet utvecklas gradvis. Därför kan instrumentpanelen flyttas till andra avsnitt på Dynatrace-webbplatsen, och följande skärmbilder kanske inte återspeglar den aktuella versionen av användargränssnittet.

När du har lagt till miljövariablerna i ditt program börjar Dynatrace samla in data. Om du vill visa rapporter använder du Dynatrace-menyn, går till Tjänster och väljer sedan ditt program.

Du hittar tjänstflödet från <ditt-app-namn>/informations-/tjänstflöde:

Skärmbild av dynatrace-tjänstens flödesrapport.

Du hittar metod hotspots från <din app-namn>/Information/Metod hotspots:

Skärmbild av rapporten med hotspots för Dynatrace-metoden.

Du hittar databasinstruktionerna från< tidsanalysen your-app-name>/Details/Response:

Skärmbild av analysrapporten för Dynatrace-svarstid och avsnittet Databasinstruktioner.

Gå sedan till avsnittet Flerdimensionell analys .

Du hittar de översta databasinstruktionerna från flerdimensionell analys/topdatabasinstruktioner:

Skärmbild av rapporten Dynatrace Top database statements (De främsta databasuttrycken i Dynatrace).

Du hittar undantagsöversikten från översikten över flerdimensionell analys/undantag:

Skärmbild av översiktsrapporten för Dynatrace-undantag.

Gå sedan till avsnittet Profilering och optimering .

Du hittar CPU-analysen från profilering och optimering/CPU-analys:

Skärmbild av dynatrace-cpu-analysrapporten.

Gå sedan till avsnittet Databaser .

Du hittar Backtrace från databaser/information/backtrace:

Skärmbild av Dynatrace Backtrace-rapporten.

Visa Dynatrace OneAgent-loggar

Som standard skriver Azure Spring Apps ut informationsnivåloggarna för Dynatrace OneAgent till STDOUT. Loggarna blandas med programloggarna. Du hittar den explicita agentversionen från programloggarna.

Du kan också hämta loggarna för Dynatrace-agenten från följande platser:

  • Azure Spring Apps-loggar
  • Azure Spring Apps Application Insights
  • Azure Spring Apps LogStream

Du kan använda vissa miljövariabler som tillhandahålls av Dynatrace för att konfigurera loggning för Dynatrace OneAgent. Styr DT_LOGLEVELCON till exempel loggnivån. Standardvärdet för DT_LOGLEVELCON är info. Du kan inaktivera loggarna för agenten genom att ange DT_LOGLEVELCON till off. Om loggning är inaktiverad stöder Dynatrace begäranden om att du först aktiverar loggning för att diagnostisera eventuella agentproblem effektivt. Du måste sedan starta om appen, vilket är nödvändigt för att ändringen ska börja gälla. Andra loggnivåer finns i Dynatrace-supportteamet.

Varning

Vi rekommenderar starkt att du inte åsidosätter standardloggningsbeteendet som tillhandahålls av Azure Spring Apps för Dynatrace. Om du gör det blockeras loggningsscenarierna som beskrivits tidigare och loggfilerna kan gå förlorade. Du bör till exempel inte mata ut DT_LOGLEVELFILE miljövariabeln till dina program.

Dynatrace OneAgent-uppgradering

Den automatiska uppgraderingen av Dynatrace OneAgent är inaktiverad och uppgraderas kvartalsvis med JDK: et. Agentuppgradering kan påverka följande scenarier:

  • Befintliga program som använder Dynatrace OneAgent före uppgraderingen är oförändrade, men kräver omstart eller omdistribution för att aktivera den nya versionen av Dynatrace OneAgent.
  • Program som skapats efter uppgraderingen använder den nya versionen av Dynatrace OneAgent.

Utgående trafikkonfiguration för virtuell nätverksinmatningsinstans

För en virtuell nätverksinmatningsinstans av Azure Spring Apps måste du se till att utgående trafik för Dynatrace-kommunikationsslutpunkter är korrekt konfigurerad för Dynatrace OneAgent. Information om hur du hämtar communicationEndpointsfinns i Distributions-API – GET-anslutningsinformation för OneAgent. Mer information finns i Kundens ansvar för att köra Azure Spring Apps i ett virtuellt nätverk.

Dynatrace-stödmodell

Information om begränsningar när du distribuerar Dynatrace OneAgent i endast programläge finns i avsnittet Molnprogramplattformar i supportmatrisen för OneAgent-plattformen och funktioner.

Nästa steg

Använda Application Insights Java In-Process Agent i Azure Spring Apps