Leggere in inglese

Condividi tramite

Metriche Java per le app Java nelle App contenitore di Azure

  • 29/05/2025

Le metriche di Java Virtual Machine (JVM) sono fondamentali per monitorare l'integrità e le prestazioni delle applicazioni Java. I dati raccolti includono informazioni dettagliate sull'utilizzo della memoria, la Garbage Collection, il numero di thread della JVM. Usare le seguenti metriche per garantire l'integrità e la stabilità delle applicazioni.

Metriche raccolte

Categoria Posizione Descrizione ID metrica Unità
Giava jvm.memory.total.used Quantità totale di memoria usata dall'heap o dal nonheap JvmMemoryTotalUsed Byte
Giava jvm.memory.total.committed Quantità totale di memoria garantita per heap o nonheap JvmMemoryTotalCommitted Byte
Giava jvm.memory.total.limit Quantità totale di memoria massima ottenibile per heap o nonheap JvmMemoryTotalLimit Byte
Giava jvm.memory.used Quantità di memoria usata da ogni pool JvmMemoryUsed Byte
Giava jvm.memory.committed Quantità di memoria garantita per ogni pool JvmMemoryCommitted Byte
Giava jvm.memory.limit Quantità massima di memoria recuperabile per ogni pool JvmMemoryLimit Byte
Giava jvm.buffer.memory.usage Quantità di memoria usata dai buffer, ad esempio memoria diretta JvmBufferMemoryUsage Byte
Giava jvm.buffer.memory.limit Quantità di capacità totale di memoria dei buffer JvmBufferMemoryLimit Byte
Giava jvm.buffer.count Numero di buffer nel pool di memoria JvmBufferCount n/d
Giava jvm.gc.count Conteggio delle azioni di Garbage Collection di JVM JvmGcCount n/d
Giava jvm.gc.duration Durata delle azioni di Garbage Collection JVM JvmGcDuration millisecondi
Giava jvm.thread.count Numero di thread della piattaforma in esecuzione JvmThreadCount n/d

Impostazione

Per rendere disponibile la raccolta di metriche Java per l'app, configurare l'app contenitore con alcune impostazioni specifiche.

Nella finestra Crea nella scheda Informazioni di base, se si seleziona per Origine di distribuzione l'opzione Immagine contenitore, è possibile accedere alle funzionalità specifiche dello stack.

Nella scheda Contenitore , in Funzionalità specifiche dello stack di sviluppo impostare Stack di sviluppo su Java.

Screenshot del portale di Azure in cui è possibile selezionare funzionalità specifiche di Java per l'app contenitore.

Dopo aver selezionato lo stack di sviluppo Java, viene visualizzata l'opzione Personalizza funzionalità Java per l'app . Selezionare Personalizza funzionalità Java per l'app e quindi in Funzionalità Java abilitare le metriche principali di JVM.

Esistono due opzioni dell'interfaccia della riga di comando correlate al runtime dell'app e alle metriche Java:

Opzione Descrizione
--runtime Runtime dell'app contenitore. I valori supportati sono generic e java.
--enable-java-metrics Opzione booleana che abilita o disabilita le metriche Java per l'app. Applicabile solo per il runtime Java.

Nota

Il parametro --enable-java-metrics=<true|false> imposta --runtime=java in modo implicito. Il parametro --runtime=generic reimposta tutte le informazioni di runtime Java.

Abilitare le metriche Java

È possibile abilitare le metriche Java tramite i comandi create o update.

az containerapp create \
  --name <CONTAINER_APP_NAME> \
  --resource-group <RESOURCE_GROUP> \
  --image <CONTAINER_IMAGE_LOCATION> \
  --enable-java-metrics=true

Visualizzare le metriche Java

Usare la procedura seguente per visualizzare le visualizzazioni delle metriche per l'app contenitore.

  1. Vai al portale di Azure.

  2. Passare all'app contenitore.

  3. Nella sezione Monitoraggio selezionare Metriche.

    Da qui viene visualizzato un grafico che traccia le metriche monitorate nell'applicazione.

    Screenshot della visualizzazione delle metriche Java.

È possibile visualizzare i nomi delle metriche Java in Monitoraggio di Azure, ma i set di dati vengono visualizzati come vuoti a meno che la funzionalità non sia abilitata. Per informazioni su come abilitarlo, vedere la sezione Configurazione.

Passaggi successivi