Monitorování aplikací Spring Boot pomocí dynatrace Java OneAgent

Článek
06/27/2024

Poznámka:

Azure Spring Apps je nový název služby Azure Spring Cloud. Přestože má služba nový název, na některých místech uvidíte starý název, protože pracujeme na aktualizaci prostředků, jako jsou snímky obrazovky, videa a diagramy.

Tento článek se vztahuje na: ✔️ Spotřeba standardu a vyhrazená (Preview) ✔️ Basic/Standard ❌️ Enterprise

V tomto článku se dozvíte, jak pomocí Dynatrace OneAgent monitorovat aplikace Spring Boot v Azure Spring Apps.

S dynatrace OneAgent můžete:

Monitorujte aplikace pomocí dynatrace OneAgent.
Nakonfigurujte Dynatrace OneAgent pomocí proměnných prostředí.
Zkontrolujte všechna data monitorování z řídicího panelu Dynatrace.

Následující video představuje Dynatrace OneAgent.

Požadavky

Aktivace dynatrace OneAgent

Následující části popisují, jak aktivovat Dynatrace OneAgent.

Příprava prostředí Azure Spring Apps

Vytvořte instanci Azure Spring Apps.

Spuštěním následujícího příkazu vytvořte aplikaci, kterou chcete nahlásit do dynatrace. Zástupné symboly <...> nahraďte vlastními hodnotami.

az spring app create \
    --resource-group <your-resource-group-name> \
    --service <your-Azure-Spring-Apps-name> \
    --name <your-application-name> \
    --is-public true

Určení hodnot požadovaných proměnných prostředí

Pokud chcete aktivovat Dynatrace OneAgent v instanci Azure Spring Apps, musíte nakonfigurovat čtyři proměnné prostředí: DT_TENANT, DT_TENANTTOKEN, DT_CONNECTION_POINTa DT_CLUSTER_ID. Další informace najdete v tématu Integrace OneAgentu s Azure Spring Apps.

Pro aplikace s více instancemi má Dynatrace několik způsobů, jak je seskupit. DT_CLUSTER_ID je jedním ze způsobů. Další informace naleznete v tématu Detekce skupin procesů.

Přidání proměnných prostředí do aplikace

Ke své aplikaci můžete přidat páry klíč/hodnota proměnné prostředí pomocí webu Azure Portal nebo Azure CLI.

Možnost 1: Azure CLI

Pokud chcete přidat páry klíč/hodnota pomocí Azure CLI, spusťte následující příkaz a nahraďte zástupné symboly <> hodnotami určenými v předchozích krocích.

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>

Možnost 2: Azure Portal

Pokud chcete přidat páry klíč/hodnota pomocí webu Azure Portal, postupujte následovně:

V instanci Azure Spring Apps vyberte Aplikace v navigačním podokně.
V seznamu vyberte aplikaci a pak v navigačním podokně vyberte Možnost Konfigurace .
Pomocí karty Proměnné prostředí můžete přidat nebo aktualizovat proměnné používané vaší aplikací.

Automatizace zřizování

Pomocí Terraformu, Bicep nebo šablony Azure Resource Manageru (šablona ARM) můžete také spustit kanál automatizace zřizování. Tento kanál může poskytovat kompletní praktické prostředí pro instrumentaci a monitorování všech nových aplikací, které vytvoříte a nasadíte.

Automatizace zřizování pomocí Terraformu

Pokud chcete nakonfigurovat proměnné prostředí v šabloně Terraformu, přidejte do šablony následující kód a nahraďte <> zástupné symboly vlastními hodnotami. Další informace najdete v tématu Správa aktivního nasazení služby Azure Spring Apps.

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

Automatizace zřizování pomocí souboru Bicep

Pokud chcete nakonfigurovat proměnné prostředí v souboru Bicep, přidejte do souboru následující kód a nahraďte <> zástupné symboly vlastními hodnotami. Další informace najdete v tématu 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>'
}

Automatizace zřizování pomocí šablony ARM

Pokud chcete nakonfigurovat proměnné prostředí v šabloně ARM, přidejte do šablony následující kód a zástupné symboly ...> nahraďte <vlastními hodnotami. Další informace najdete v tématu 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>"
}

Zobrazení sestav v dynatrace

Tato část popisuje, jak najít různé sestavy v dynatrace.

Poznámka:

Nabídka Dynatrace a uživatelské rozhraní se budou postupně vyvíjet. Z tohoto důvodu se řídicí panel může přesunout do jiných oddílů na webu Dynatrace a následující snímky obrazovky nemusí odrážet aktuální verzi uživatelského rozhraní.

Po přidání proměnných prostředí do aplikace začne Dynatrace shromažďovat data. Pokud chcete zobrazit sestavy, použijte nabídku Dynatrace, přejděte na Služby a pak vyberte aplikaci.

Tok služby najdete z <názvu vaší aplikace>, podrobností nebo toku služby:

Hotspoty metody najdete v <hotspotech vaší aplikace, podrobnosti> nebo hotspoty metody:

Příkazy databáze najdete v <analýze doby odezvy vaší aplikace, názvu> aplikace, podrobností nebo doby odezvy:

Dále přejděte do části Multidimenzionální analýza .

Hlavní databázové příkazy najdete v multidimenzionální analýze nebo příkazech top databáze:

Přehledvýjimekch

Dále přejděte do části Profilace a optimalizace .

Analýzu procesoru najdete z profilace a optimalizace / analýzy procesoru:

Dále přejděte do části Databáze .

Backtrace najdete z databází, podrobností nebo backtrace:

Zobrazení protokolů Dynatrace OneAgent

Azure Spring Apps ve výchozím nastavení vytiskne protokoly na úrovni informací dynatrace OneAgent do STDOUT. Protokoly jsou smíšené s protokoly aplikace. Explicitní verzi agenta najdete v protokolech aplikace.

Protokoly agenta Dynatrace můžete získat také z následujících umístění:

Protokoly Azure Spring Apps
Přehledy aplikace Azure Spring Apps
Azure Spring Apps LogStream

Některé proměnné prostředí, které poskytuje Dynatrace, můžete použít ke konfiguraci protokolování pro Dynatrace OneAgent. DT_LOGLEVELCON Například řídí úroveň protokolů. Výchozí hodnota je DT_LOGLEVELCONinfo. Protokoly agenta můžete zakázat nastavením DT_LOGLEVELCON na off. Pokud je protokolování zakázané, dynatrace podporuje žádosti, které nejprve povolíte protokolování, aby bylo možné efektivně diagnostikovat případné problémy s agenty. Potom musíte aplikaci restartovat, což je nezbytné, aby se změna projevila. Další úrovně protokolů najdete v týmu podpory Dynatrace.

Upozornění

Důrazně doporučujeme nepřepsat výchozí chování protokolování poskytované službou Azure Spring Apps for Dynatrace. Pokud to uděláte, dříve popsané scénáře protokolování se zablokují a soubory protokolů můžou být ztraceny. Například byste neměli výstupní proměnnou DT_LOGLEVELFILE prostředí do svých aplikací.

Upgrade dynatrace OneAgent

Automatický upgrade Dynatrace OneAgent je zakázaný a upgraduje se čtvrtletně pomocí sady JDK. Upgrade agenta může mít vliv na následující scénáře:

Stávající aplikace používající Dynatrace OneAgent před upgradem se nezmění, ale vyžadují restartování nebo opětovné nasazení, aby se zapojila nová verze Dynatrace OneAgent.
Aplikace vytvořené po upgradu používají novou verzi Dynatrace OneAgent.

Konfigurace odchozího provozu instance injektáže virtuální sítě

V případě instance injektáže virtuální sítě služby Azure Spring Apps je potřeba zajistit, aby odchozí provoz pro koncové body komunikace Dynatrace byl správně nakonfigurovaný pro Dynatrace OneAgent. Informace o tom, jak získat communicationEndpoints, naleznete v tématu Rozhraní API pro nasazení – ZÍSKÁNÍ informací o připojení pro OneAgent. Další informace najdete v tématu Odpovědnost zákazníka za spouštění azure Spring Apps ve virtuální síti.

Model podpory Dynatrace

Informace oomezeních

Další kroky

Používání vnitroprocesového agenta Java Application Insights ve službě Azure Spring Apps

Sdílet prostřednictvím