Come monitorare le app Spring Boot con l'agente Java AppDynamics

Note

I piani Basic, Standard ed Enterprise sono entrati in un periodo di ritiro il 17 marzo 2025. Per altre informazioni, vedere l'annuncio di ritiro di Azure Spring Apps.

Questo articolo si applica a:✅ Basic/Standard ❎️ Enterprise

Questo articolo illustra come usare l'agente Java AppDynamics per monitorare le applicazioni Spring Boot in Azure Spring Apps.

Con l'agente Java AppDynamics è possibile:

  • Monitorare le applicazioni
  • Configurare l'agente Java AppDynamics usando le variabili di ambiente
  • Controllare tutti i dati di monitoraggio dal dashboard AppDynamics

Il video seguente presenta l'agente In-Process di AppDynamics Java.


Prerequisiti

Attivare l'agente In-Process di AppDynamics Java

Per l'intero flusso di lavoro, è necessario:

  • Attivare l'agente In-Process di AppDynamics Java in Azure Spring Apps per generare i dati delle metriche dell'applicazione.
  • Connettere l'agente AppDynamics al controller AppDynamics per raccogliere e visualizzare i dati nel controller.

Diagramma che mostra l'agente AppDynamics con una freccia bidirezionale per le app Spring Boot in Azure Spring Apps e la freccia che punta all'agente AppDynamics.

Attivare un'applicazione con l'agente AppDynamics usando l'interfaccia della riga di comando di Azure

Per attivare un'applicazione tramite l'interfaccia della riga di comando di Azure, seguire i passi seguenti.

  1. Creare un gruppo di risorse.

  2. Creare un'istanza di Azure Spring Apps.

  3. Creare un'applicazione usando il comando seguente. Sostituire i segnaposto <...> con i valori personalizzati.

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

  4. Creare una distribuzione con l'agente AppDynamics usando le variabili di ambiente.

    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 preinstalla l'agente Java AppDynamics nel percorso /opt/agents/appdynamics/java/javaagent.jar. È possibile attivare l'agente dalle opzioni JVM delle applicazioni, quindi configurare l'agente usando le variabili di ambiente. È possibile trovare i valori per queste variabili in Monitorare Azure Spring Apps con l'agente Java. Per altre informazioni su come queste variabili consentono di visualizzare e organizzare i report nell'interfaccia utente di AppDynamics, vedere Livelli e nodi.

Attivare un'applicazione con l'agente AppDynamics usando il portale di Azure

Per attivare un'applicazione tramite il portale di Azure, seguire i passi seguenti.

  1. Passare all'istanza di Azure Spring Apps nel portale di Azure.

  2. Selezionare App nella sezione Impostazioni del riquadro di spostamento.

    Screenshot del portale di Azure che mostra la pagina App per un'istanza di Azure Spring Apps.

  3. Selezionare l'app e quindi selezionare Configurazione nel riquadro di spostamento.

  4. Usare la scheda Impostazioni generali per aggiornare i valori, ad esempio le opzioni JVM.

    Screenshot del portale di Azure che mostra la pagina Configurazione per un'app in un'istanza di Azure Spring Apps, con la scheda Impostazioni generali selezionata.

  5. Selezionare Variabili di ambiente per aggiungere o aggiornare le variabili usate dall'applicazione.

    Screenshot del portale di Azure che mostra la pagina Configurazione con la scheda Variabili di ambiente selezionata.

Automatizzare il provisioning

È anche possibile eseguire una pipeline di automazione del provisioning usando il modello Terraform, Bicep o Azure Resource Manager (modello ARM). Questa pipeline può offrire un'esperienza pratica completa per instrumentare e monitorare tutte le nuove applicazioni create e distribuite.

Automatizzare il provisioning con Terraform

Per configurare le variabili di ambiente in un modello Terraform, aggiungere il codice seguente al modello, sostituendo i segnaposto <...> con i propri valori. Per altre informazioni, vedere Gestire una distribuzione di Azure Spring Apps attiva.

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

Automatizzare il provisioning con Bicep

Per configurare le variabili di ambiente in un file Bicep, aggiungere il codice seguente al file, sostituendo i segnaposto <...> con i propri valori. Per altre informazioni, vedere 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'
}

Automatizzare il provisioning usando un modello di Resource Manager

Per configurare le variabili di ambiente in un modello di Resource Manager, aggiungere il codice seguente al modello, sostituendo i segnaposto <...> con i propri valori. Per altre informazioni, vedere 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",
  ...
}

Esaminare i report nel dashboard AppDynamics

Questa sezione illustra vari report in AppDynamics.

Lo screenshot seguente mostra una panoramica delle app nel dashboard AppDynamics:

Screenshot di AppDynamics che mostra il dashboard Applicazioni.

La scheda Applicazioni mostra le informazioni generali per ognuna delle app, come illustrato negli screenshot seguenti usando applicazioni di esempio:

  • api-gateway

    Screenshot di AppDynamics che mostra il dashboard dell'applicazione per l'app api-gateway di esempio.

  • customers-service

    Screenshot di AppDynamics che mostra il dashboard dell'applicazione per l'app customers-service di esempio.

Lo screenshot seguente mostra come ottenere informazioni di base dal dashboard Chiamate database.

Screenshot di AppDynamics che mostra il dashboard Chiamate database.

È anche possibile ottenere informazioni sulle chiamate di database più lente, come illustrato in questi screenshot:

Screenshot di AppDynamics che mostra la pagina Chiamate di database più lente.

Screenshot di AppDynamics che mostra la pagina con gli snapshot correlati a cui si accede dalla pagina Chiamate di database più lente.

Lo screenshot seguente mostra l'analisi dell'utilizzo della memoria nella sezione Heap della pagina Memoria:

Screenshot di AppDynamics che mostra la sezione Heap della pagina Memoria.

È anche possibile visualizzare il processo GC, come illustrato in questo screenshot:

Screenshot di AppDynamics che mostra la sezione Garbage Collection della pagina Memoria.

Lo screenshot seguente mostra la pagina Transazioni lente:

Screenshot di AppDynamics che mostra la pagina Transazioni lente.

È possibile definire altre metriche per la JVM, come illustrato in questa schermata del Browser metriche:

Screenshot di AppDynamics che mostra il Browser metriche.

Visualizzare i log dell'agente AppDynamics

Per impostazione predefinita, Azure Spring Apps stampa i log di livello info dell'Agente AppDynamics in STDOUT. I log vengono mixati con i log dell'applicazione. È possibile trovare la versione esplicita dell'agente dai log applicazione.

È anche possibile ottenere i log dell'agente AppDynamics dalle posizioni seguenti:

  • Log di Azure Spring Apps
  • Application Insights per Azure Spring Apps
  • LogStream di Azure Spring Apps

Informazioni sull'aggiornamento dell'agente AppDynamics

L'agente AppDynamics viene aggiornato regolarmente con JDK (trimestrale). L'aggiornamento dell'agente potrebbe influire sugli scenari seguenti:

  • Le applicazioni esistenti che usano l'agente AppDynamics prima dell'aggiornamento non vengono modificate, ma richiedono il riavvio o successiva distribuzione per attivare la nuova versione dell'agente AppDynamics.
  • Le applicazioni create dopo l'aggiornamento usano la nuova versione di AppDynamics Agent.

Configurare il traffico in uscita dell'istanza di inserimento della rete virtuale

Per le istanze di inserimento di rete virtuale di Azure Spring Apps, assicurarsi che il traffico in uscita sia configurato correttamente per AppDynamics Agent. Per informazioni dettagliate, vedere Domini SaaS AppDynamics Cisco e intervalli IP e Responsabilità del cliente per l'esecuzione di Azure Spring Apps in una rete virtuale.

Riconoscere le limitazioni

Per riconoscere le limitazioni dell'agente AppDynamics, vedere Monitorare Azure Spring Apps con l'agente Java.

Passaggi successivi

Usare l'agente Java In-Process di Application Insights in Azure Spring Apps

  • Last updated on