Spring Boot-alkalmazások monitorozása az AppDynamics Java-ügynökkel

Cikk
04/23/2024

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 azt ismerteti, hogyan használhatja az AppDynamics Java-ügynököt Spring Boot-alkalmazások figyelésére az Azure Spring Appsben.

Az AppDynamics Java-ügynökkel a következőt teheti:

Alkalmazások figyelése
Az AppDynamics Java-ügynök konfigurálása környezeti változók használatával
Az AppDynamics irányítópult összes monitorozási adatának ellenőrzése

Az alábbi videó az AppDynamics Java folyamatban lévő ügynökét mutatja be.

Előfeltételek

Az AppDynamics Java folyamaton belüli ügynök aktiválása

A teljes munkafolyamat esetében a következőkre van szükség:

Aktiválja az AppDynamics Java folyamaton belüli ügynökét az Azure Spring Appsben az alkalmazásmetrikák adatainak létrehozásához.
Csatlakozás az AppDynamics-ügynököt az AppDynamics-vezérlőhöz, hogy összegyűjtse és megjelenítse a vezérlőben lévő adatokat.

Az AppDynamics Agentet az Azure Spring Apps Spring Boot Appsre mutató kétirányú nyíllal és az AppDynamics Agentre mutató nyíllal ábrázoló ábra.

Alkalmazás aktiválása az AppDynamics-ügynökkel az Azure CLI használatával

Ha az Azure CLI-vel szeretne aktiválni egy alkalmazást, kövesse az alábbi lépéseket.

Hozzon létre egy erőforráscsoportot.
Hozzon létre egy Azure Spring Apps-példányt.

Hozzon létre egy alkalmazást az alábbi paranccsal. 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-instance-name>" \
    --name "<your-app-name>" \
    --is-public true

Hozzon létre egy üzembe helyezést az AppDynamics-ügynökkel környezeti változók használatával.

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

Az Azure Spring Apps előre telepíti az AppDynamics Java-ügynököt az /opt/agents/appdynamics/java/javaagent.jar útvonalra. Az ügynököt az alkalmazások JVM-beállításaiból aktiválhatja, majd környezeti változók használatával konfigurálhatja az ügynököt. Ezeknek a változóknak az értékeit az Azure Spring Apps Monitorozása Java-ügynökkel című témakörben találja. Ha többet szeretne tudni arról, hogy ezek a változók hogyan segítik a jelentések megtekintését és rendszerezését az AppDynamics felhasználói felületén, olvassa el a Rétegek és csomópontok című témakört.

Alkalmazás aktiválása az AppDynamics-ügynökkel az Azure Portal használatával

Ha az Azure Portalon keresztül szeretne aktiválni egy alkalmazást, kövesse az alábbi lépéseket.

Lépjen az Azure Spring Apps-példányra az Azure Portalon.
Válassza az Alkalmazások lehetőséget a navigációs ablak Gépház szakaszában.
Válassza ki az alkalmazást, majd a navigációs ablakban válassza a Konfiguráció lehetőséget .
Az Általános beállítások lapon frissítheti az értékeket, például a JVM-beállításokat.
Válassza ki a környezeti változókat az alkalmazás által használt változók hozzáadásához vagy frissítéséhez.

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

Kiépítési automatizálási folyamatot terraform, Bicep vagy Azure Resource Manager-sablon (ARM-sablon) használatával 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.

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"
  }
}

Kiépítés automatizálása a Bicep 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.

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'
}

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.

"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",
  ...
}

Jelentések áttekintése az AppDynamics irányítópultján

Ez a szakasz az AppDynamics különböző jelentéseit mutatja be.

Az alábbi képernyőképen az appok áttekintése látható az AppDynamics irányítópultján:

Az Alkalmazások lap az egyes alkalmazások általános adatait jeleníti meg, ahogyan az alábbi képernyőképeken látható, példaalkalmazások használatával:

api-gateway
customers-service

Az alábbi képernyőkép bemutatja, hogyan kérhet le alapszintű információkat az Adatbázis-hívások irányítópultról.

A leglassabb adatbázis-hívásokról az alábbi képernyőképeken látható módon is tájékozódhat:

Az alábbi képernyőképen a memóriahasználat elemzése látható a Memória lap Halom szakaszában:

A szemétgyűjtési folyamat az alábbi képernyőképen látható módon is látható:

Az alábbi képernyőképen a Lassú tranzakciók lap látható:

A JVM-hez további metrikákat is definiálhat, ahogyan az a Metric Browser képernyőképén látható:

AppDynamics Agent-naplók megtekintése

Alapértelmezés szerint az Azure Spring Apps kinyomtatja az AppDynamics Agent 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.

Az AppDynamics Agent naplóit az alábbi helyekről is lekérheti:

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

Tudnivalók az AppDynamics Agent frissítéséről

Az AppDynamics Agent rendszeresen frissül JDK-val (negyedévente). Az ügynökfrissítés a következő forgatókönyveket érintheti:

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

Virtuális hálózati injektálási példány kimenő forgalmának konfigurálása

Az Azure Spring Apps virtuális hálózati injektálási példányai esetében győződjön meg arról, hogy a kimenő forgalom megfelelően van konfigurálva az AppDynamics Agenthez. További részletekért lásd a Cisco AppDynamics SaaS-tartományait és IP-tartományait , valamint az Azure Spring Apps virtuális hálózaton való futtatásával kapcsolatos ügyfél-felelősségeket.

A korlátozások ismertetése

Az AppDynamics-ügynök korlátainak megismeréséhez lásd : Azure Spring Apps monitorozása Java-ügynökkel.

Következő lépések

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