Monitorování aplikací Spring Boot pomocí agenta AppDynamics Java

Článek
10/01/2024

Poznámka:

Plány Basic, Standard a Enterprise budou od poloviny března 2025 vyřazeny ze 3letého období vyřazení. Doporučujeme přejít na Azure Container Apps. Další informace najdete v oznámení o vyřazení Azure Spring Apps.

Od 30. září 2024 bude od 30. září 2024 zastaralý plán s úplným vypnutím po šesti měsících. Doporučujeme přejít na Azure Container Apps. Další informace najdete v tématu Migrace spotřeby Azure Spring Apps Úrovně Standard a vyhrazeného plánu do Azure Container Apps.

Tento článek se vztahuje na:✅ Využití standardu a vyhrazené (Preview) ✅ Basic/Standard ❎️ Enterprise

Tento článek vysvětluje, jak pomocí agenta AppDynamics Java monitorovat aplikace Spring Boot v Azure Spring Apps.

Pomocí agenta AppDynamics Java můžete:

Monitorování aplikací
Konfigurace agenta AppDynamics Java pomocí proměnných prostředí
Kontrola všech dat monitorování z řídicího panelu AppDynamics

Následující video představuje agenta v procesu v javě AppDynamics.

Požadavky

Aktivace agenta v procesu v Javě v AppDynamics

Pro celý pracovní postup potřebujete:

Aktivujte agenta in-process v Javě AppDynamics v Azure Spring Apps a vygenerujte data metrik aplikací.
Připojte agenta AppDynamics ke kontroleru AppDynamics, abyste mohli shromažďovat a vizualizovat data v kontroleru.

Diagram znázorňující agenta AppDynamics s obousměrnou šipkou do aplikace Spring Boot v Azure Spring Apps a šipkou ukazující na agenta AppDynamics

Aktivace aplikace pomocí agenta AppDynamics pomocí Azure CLI

Pokud chcete aktivovat aplikaci prostřednictvím Azure CLI, postupujte následovně.

Vytvořte skupinu prostředků.
Vytvořte instanci Azure Spring Apps.

Pomocí následujícího příkazu vytvořte aplikaci. Zástupné symboly <...> nahraďte vlastními hodnotami.

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

Vytvořte nasazení pomocí agenta AppDynamics pomocí proměnných prostředí.

az spring app deploy \
    --resource-group "<your-resource-group-name>" \
    --service "<your-Azure-Spring-Apps-instance-name>" \
    --name "<your-app-name>" \
    --artifact-path app.jar \
    --jvm-options="-javaagent:/opt/agents/appdynamics/java/javaagent.jar" \
    --env APPDYNAMICS_AGENT_APPLICATION_NAME=<your-app-name> \
          APPDYNAMICS_AGENT_ACCOUNT_ACCESS_KEY=<your-agent-access-key> \
          APPDYNAMICS_AGENT_ACCOUNT_NAME=<your-agent-account-name> \
          APPDYNAMICS_JAVA_AGENT_REUSE_NODE_NAME=true \
          APPDYNAMICS_JAVA_AGENT_REUSE_NODE_NAME_PREFIX=<your-agent-node-name> \
          APPDYNAMICS_AGENT_TIER_NAME=<your-agent-tier-name> \
          APPDYNAMICS_CONTROLLER_HOST_NAME=<your-AppDynamics-controller-host-name> \
          APPDYNAMICS_CONTROLLER_SSL_ENABLED=true \
          APPDYNAMICS_CONTROLLER_PORT=443

Azure Spring Apps předinstaluje agenta AppDynamics Java do cesty /opt/agents/appdynamics/java/javaagent.jar. Agenta můžete aktivovat z možností prostředí JVM vašich aplikací a pak nakonfigurovat agenta pomocí proměnných prostředí. Hodnoty těchto proměnných najdete ve službě Monitor Azure Spring Apps pomocí agenta Java. Další informace o tom, jak tyto proměnné pomáhají zobrazovat a organizovat sestavy v uživatelském rozhraní AppDynamics, najdete v tématu Vrstvy a uzly.

Aktivace aplikace pomocí agenta AppDynamics pomocí webu Azure Portal

Pokud chcete aktivovat aplikaci prostřednictvím webu Azure Portal, postupujte následovně.

Na webu Azure Portal přejděte k vaší instanci Azure Spring Apps.
V části Nastavení navigačního podokna vyberte Aplikace.
Vyberte aplikaci a pak v navigačním podokně vyberte Konfigurace .
K aktualizaci hodnot, jako jsou možnosti JVM, použijte kartu Obecné nastavení.
Výběrem proměnných prostředí přidejte nebo aktualizujte proměnné používané vaší aplikací.

Automatizace zřizování

Kanál automatizace zřizování můžete spustit také pomocí Terraformu, Bicep nebo šablony Azure Resource Manageru (šablona ARM). 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.

resource "azurerm_spring_cloud_java_deployment" "example" {
  ...
  jvm_options = "-javaagent:/opt/agents/appdynamics/java/javaagent.jar"
  ...
    environment_variables = {
      "APPDYNAMICS_AGENT_APPLICATION_NAME" : "<your-app-name>",
      "APPDYNAMICS_AGENT_ACCOUNT_ACCESS_KEY" : "<your-agent-access-key>",
      "APPDYNAMICS_AGENT_ACCOUNT_NAME" : "<your-agent-account-name>",
      "APPDYNAMICS_JAVA_AGENT_REUSE_NODE_NAME" : "true",
      "APPDYNAMICS_JAVA_AGENT_REUSE_NODE_NAME_PREFIX" : "<your-agent-node-name>",
      "APPDYNAMICS_AGENT_TIER_NAME" : "<your-agent-tier-name>",
      "APPDYNAMICS_CONTROLLER_HOST_NAME" : "<your-AppDynamics-controller-host-name>",
      "APPDYNAMICS_CONTROLLER_SSL_ENABLED" : "true",
      "APPDYNAMICS_CONTROLLER_PORT" : "443"
  }
}

Automatizace zřizování pomocí 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.

deploymentSettings: {
  environmentVariables: {
    APPDYNAMICS_AGENT_APPLICATION_NAME : '<your-app-name>'
    APPDYNAMICS_AGENT_ACCOUNT_ACCESS_KEY : '<your-agent-access-key>'
    APPDYNAMICS_AGENT_ACCOUNT_NAME : '<your-agent-account-name>'
    APPDYNAMICS_JAVA_AGENT_REUSE_NODE_NAME : 'true'
    APPDYNAMICS_JAVA_AGENT_REUSE_NODE_NAME_PREFIX : '<your-agent-node-name>'
    APPDYNAMICS_AGENT_TIER_NAME : '<your-agent-tier-name>'
    APPDYNAMICS_CONTROLLER_HOST_NAME : '<your-AppDynamics-controller-host-name>'
    APPDYNAMICS_CONTROLLER_SSL_ENABLED : 'true'
    APPDYNAMICS_CONTROLLER_PORT : '443'
  }
  jvmOptions: '-javaagent:/opt/agents/appdynamics/java/javaagent.jar'
}

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.

"deploymentSettings": {
  "environmentVariables": {
    "APPDYNAMICS_AGENT_APPLICATION_NAME" : "<your-app-name>",
    "APPDYNAMICS_AGENT_ACCOUNT_ACCESS_KEY" : "<your-agent-access-key>",
    "APPDYNAMICS_AGENT_ACCOUNT_NAME" : "<your-agent-account-name>",
    "APPDYNAMICS_JAVA_AGENT_REUSE_NODE_NAME" : "true",
    "APPDYNAMICS_JAVA_AGENT_REUSE_NODE_NAME_PREFIX" : "<your-agent-node-name>",
    "APPDYNAMICS_AGENT_TIER_NAME" : "<your-agent-tier-name>",
    "APPDYNAMICS_CONTROLLER_HOST_NAME" : "<your-AppDynamics-controller-host-name>",
    "APPDYNAMICS_CONTROLLER_SSL_ENABLED" : "true",
    "APPDYNAMICS_CONTROLLER_PORT" : "443"
  },
  "jvmOptions": "-javaagent:/opt/agents/appdynamics/java/javaagent.jar",
  ...
}

Kontrola sestav na řídicím panelu AppDynamics

Tato část ukazuje různé sestavy v AppDynamics.

Následující snímek obrazovky ukazuje přehled aplikací na řídicím panelu AppDynamics:

Karta Aplikace zobrazuje celkové informace pro každou z vašich aplikací, jak je znázorněno na následujících snímcích obrazovky s ukázkovými aplikacemi:

api-gateway
customers-service

Následující snímek obrazovky ukazuje, jak získat základní informace z řídicího panelu Volání databáze.

Můžete také získat informace o nejpomalejších voláních databáze, jak je znázorněno na těchto snímcích obrazovky:

Následující snímek obrazovky ukazuje analýzu využití paměti v části Haldy na stránce Paměť :

Můžete také vidět proces uvolňování paměti, jak je znázorněno na tomto snímku obrazovky:

Následující snímek obrazovky ukazuje stránku Pomalé transakce :

Můžete definovat další metriky pro JVM, jak je znázorněno na tomto snímku obrazovky prohlížeče metrik:

Zobrazení protokolů agenta AppDynamics

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

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

Protokoly Azure Spring Apps
Azure Spring Apps Application Insights
Azure Spring Apps LogStream

Další informace o upgradu agenta AppDynamics

Agent AppDynamics se pravidelně upgraduje pomocí sady JDK (čtvrtletně). Upgrade agenta může mít vliv na následující scénáře:

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

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

V případě instancí injektáže virtuální sítě služby Azure Spring Apps se ujistěte, že je odchozí provoz správně nakonfigurovaný pro agenta AppDynamics. Podrobnosti najdete v tématu Cisco AppDynamics SaaS Domains and IP Ranges and Customer responsibilities for running Azure Spring Apps in a virtual network.

Vysvětlení omezení

Informace o omezeních agenta AppDynamics najdete v tématu Monitorování azure Spring Apps pomocí agenta Java.

Další kroky

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

Sdílet prostřednictvím