Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Raccolta delle metriche di Java Management Extensions (JMX)
Puoi utilizzare l' CloudWatch agente per raccogliere i parametri Java Management Extensions (JMX) dalle tue applicazioni Java.
L' CloudWatch agente supporta la raccolta di queste metriche dalle seguenti versioni:
-
JVM 8 e versioni successive
-
Kafka 0.8.2.x e versioni successive
-
Tomcat 9, 10.1 e 11 (beta)
Per iniziare a raccogliere le metriche JMX, aggiungi una jmx sezione all'interno della sezione del file di configurazione dell'metrics_collectedagente. CloudWatch La sezione jmx può contenere i seguenti campi.
-
jvm: Opzionale. Specifica che desideri recuperare le metriche di Java Virtual Machine (JVM) dall'istanza. Per ulteriori informazioni, consulta Raccolta di metriche di JVM.Questa sezione può includere i seguenti campi.
-
measurement: specifica l'array di metriche JVM da raccogliere. Per un elenco dei possibili valori da utilizzare, consulta la colonna Metric (Parametri) della tabella in Raccolta di metriche di JVM.Nelle voci di ciascun parametro individuale, puoi definire uno o più dei seguenti valori:
-
rename: specifica un nome diverso per questo parametro. -
unit: specifica l'unità di misura da utilizzare per questo parametro, che sostituisce l'unità di misura predefinita per il parametro. L'unità specificata deve essere un'unità CloudWatch metrica valida, come elencato nellaUnitdescrizione in. MetricDatum
-
-
-
kafka: Opzionale. Specifica che desideri recuperare le metriche del broker Apache Kafka dall'istanza. Per ulteriori informazioni, consulta Raccolta di metriche di Kafka.Questa sezione può includere i seguenti campi.
-
measurement: specifica l'array di metriche del broker Kafka da raccogliere. Per un elenco dei valori che è possibile utilizzare in questo campo, consulta la colonna Metrica della prima tabella in Raccolta di metriche di Kafka.Nelle voci di ciascun parametro individuale, puoi definire uno o più dei seguenti valori:
-
rename: specifica un nome diverso per questo parametro. -
unit: specifica l'unità di misura da utilizzare per questo parametro, che sostituisce l'unità di misura predefinita per il parametro. L'unità specificata deve essere un'unità CloudWatch metrica valida, come elencato nellaUnitdescrizione in. MetricDatum
-
-
-
kafka-consumer: Opzionale. Specifica che desideri recuperare le metriche del consumatore di Apache Kafka dall'istanza. Per ulteriori informazioni, consulta Raccolta di metriche di Kafka.Questa sezione può includere i seguenti campi.
-
measurement: specifica l'array di metriche del broker Kafka da raccogliere. Per un elenco dei valori che è possibile utilizzare in questo campo, consulta la colonna Metrica della seconda tabella delle metriche in Raccolta di metriche di Kafka.Nelle voci di ciascun parametro individuale, puoi definire uno o più dei seguenti valori:
-
rename: specifica un nome diverso per questo parametro. -
unit: specifica l'unità di misura da utilizzare per questo parametro, che sostituisce l'unità di misura predefinita per il parametro. L'unità specificata deve essere un'unità CloudWatch metrica valida, come elencato nellaUnitdescrizione in. MetricDatum
-
-
-
kafka-producer: Opzionale. Specifica che desideri recuperare le metriche del produttore di Apache Kafka dall'istanza. Per ulteriori informazioni, consulta Raccolta di metriche di Kafka.Questa sezione può includere i seguenti campi.
-
measurement: specifica l'array di metriche del broker Kafka da raccogliere. Per un elenco dei valori che è possibile utilizzare in questo campo, consulta la colonna Metrica della terza tabella delle metriche in Raccolta di metriche di Kafka.Nelle voci di ciascun parametro individuale, puoi definire uno o più dei seguenti valori:
-
rename: specifica un nome diverso per questo parametro. -
unit: specifica l'unità di misura da utilizzare per questo parametro, che sostituisce l'unità di misura predefinita per il parametro. L'unità specificata deve essere un'unità CloudWatch metrica valida, come elencato nellaUnitdescrizione in. MetricDatum
-
-
-
tomcat: Opzionale. Specifica che desideri recuperare le metriche di Tomcat dall'istanza. Per ulteriori informazioni, consulta Raccolta di metriche di Tomcat.Questa sezione può includere i seguenti campi.
-
measurement: specifica l'array di metriche di Tomcat da raccogliere. Per un elenco dei possibili valori da utilizzare, consulta la colonna Metric (Parametri) della tabella in Raccolta di metriche di Tomcat.Nelle voci di ciascun parametro individuale, puoi definire uno o più dei seguenti valori:
-
rename: specifica un nome diverso per questo parametro. -
unit: specifica l'unità di misura da utilizzare per questo parametro, che sostituisce l'unità di misura predefinita per il parametro. L'unità specificata deve essere un'unità CloudWatch metrica valida, come elencato nellaUnitdescrizione in. MetricDatum
-
-
La sezione jmx può includere anche il campo facoltativo append_dimensions:
-
append_dimensionsFacoltativo. Le dimensioni aggiuntive da utilizzare solo per i parametri di processo. Se specifichi questo campo, viene utilizzato in aggiunta alle dimensioni specificate nel campoappend_dimensions, usato per tutti i tipi di parametri raccolti dall'agente.
I seguenti campi sono EC2 solo per Amazon.
-
endpoint: l'indirizzo a cui il client JMX deve connettersi. Il formato èip:port. Se l'endpoint non è il localhost, è necessario abilitare l'autenticazione tramite password e SSL. -
metrics_collection_intervalFacoltativo. Specifica la frequenza di raccolta dei parametri di processo, sostituendo il valore dimetrics_collection_intervalglobale specificato nella sezioneagentdel file di configurazione.Questo valore è specificato in secondi. Ad esempio, il valore 10 causa la raccolta dei parametri ogni 10 secondi; il valore 300 specifica che i parametri devono essere raccolti ogni 5 minuti.
Se imposti questo valore al di sotto di 60 secondi, ogni parametro viene raccolto come parametro ad alta risoluzione. Per ulteriori informazioni, consulta Parametri ad alta risoluzione.
Se JMX è stato abilitato con l'autenticazione tramite password o SSL per l'accesso remoto, puoi utilizzare i seguenti campi.
-
password_file: Opzionale. Specifica un file di proprietà Java contenente le chiavi delle password. Il file deve essere di sola lettura e riservato all'utente che esegue l' CloudWatch agente. Se l'autenticazione tramite password è abilitata, è necessaria la stessa coppia di nome utente e password della voce nel file di password JMX fornito nella proprietàcom.sun.management.jmxremote.password.file. Se SSL è abilitato, è necessario specificarekeystoreetruststore, corrispondenti rispettivamente ajavax.net.ssl.keyStorePasswordejavax.net.ssl.trustStorePassword. -
username: se l'autenticazione con password è abilitata, specifica il nome utente che corrisponde al nome utente nel file di password fornito. -
keystore_path: se SSL è abilitato, specifica il percorso completo del keystore Java, che consiste in una chiave privata e un certificato per la chiave pubblica. Corrisponde alla proprietàjavax.net.ssl.keyStore. -
keystore_type: se SSL è abilitato, specifica il tipo di keystore utilizzato. Corrisponde alla proprietàjavax.net.ssl.keyStoreType. -
truststore_path: se SSL è abilitato, specifica il percorso completo del truststore Java, che deve contenere il certificato pubblico del server JMX remoto. Corrisponde alla proprietàjavax.net.ssl.trustStore. -
truststore_type: se SSL è abilitato, specifica il tipo di truststore utilizzato. Corrisponde alla proprietàjavax.net.ssl.trustStoreType. -
remote_profile: Opzionale. I profili remoti JMX supportati sono TLS in combinazione con i profili SASL:SASL/PLAIN,SASL/DIGEST-MD5eSASL/CRAM-MD5. Dovrebbe essere uno dei seguenti:SASL/PLAIN,SASL/DIGEST-MD5,SASL/CRAM-MD5,TLS SASL/PLAIN,TLS SASL/DIGEST-MD5oTLS SASL/CRAM-MD5 -
realm: Opzionale. Il realm richiesto dal profilo remotoSASL/DIGEST-MD5. -
registry_ssl_enabled: se l'autenticazione del registro RMI è abilitata. Impostato su true se la JVM è stata configurata concom.sun.management.jmxremote.registry.ssl=true. -
insecureImposta il valore sutrueper disattivare la convalida richiesta se l'agente è configurato per un endpoint non localhost.
Di seguito è riportato un esempio della jmx sezione del file di configurazione dell' CloudWatch agente.
{ "metrics": { "metrics_collected": { "jmx": [ { "endpoint": "remotehost:1314", "jvm": { "measurement": [ "jvm.memory.heap.init", "jvm.memory.nonheap.used" ] }, "kafka": { "measurement": [ "kafka.request.count", { "name": "kafka.message.count", "rename": "KAFKA_MESSAGE_COUNT", "unit": "Count" } ] }, "username": "cwagent", "keystore_path": "/path/to/keystore", "keystore_type": "PKCS12", "truststore_path": "/path/to/truststore", "truststore_type": "PKCS12" }, { "endpoint": "localhost:1315", "kafka-producer": { "measurement": [ "kafka.producer.request-rate" ] }, "append_dimensions": { "service.name": "kafka/1" } } ] } } }
Raccolta di metriche di JVM
Puoi utilizzare l' CloudWatch agente per raccogliere i parametri della Java Virtual Machine (JVM). Per configurarlo, aggiungi una jvm sezione all'interno della jmx sezione del file di configurazione dell' CloudWatchagente.
È possibile raccogliere i seguenti parametri.
| Metrica | Dimensioni | Description |
|---|---|---|
|
|
[DEFAULT] |
Il numero totale di classi caricate. Unità: nessuna Statistiche significative: minimo, massimo, media |
|
|
[DEFAULT], |
Il numero totale di rimozioni di oggetti inutili che si sono verificate. Unità: nessuna Statistiche significative: minimo, massimo, media |
|
|
[DEFAULT], |
Il tempo cumulativo e approssimativo trascorso di rimozione di oggetti inutili. Unità: millisecondi Statistiche significative: minimo, massimo, media |
|
|
[DEFAULT] |
La quantità iniziale di memoria richiesta dalla JVM al sistema operativo per l'heap. Unità: byte Statistiche significative: minimo, massimo, media |
|
|
[DEFAULT] |
La quantità massima di memoria che può essere utilizzata per l'heap. Unità: byte Statistiche significative: massimo |
|
|
[DEFAULT] |
L'attuale utilizzo della memoria heap. Unità: byte Statistiche significative: minimo, massimo, media |
|
|
[DEFAULT] |
La quantità di memoria la cui disponibilità è garantita per l'heap. Unità: byte Statistiche significative: minimo, massimo, media |
|
|
[DEFAULT] |
La quantità iniziale di memoria richiesta dalla JVM al sistema operativo per scopi diversi dall'heap. Unità: byte Statistiche significative: minimo, massimo, media |
|
|
[DEFAULT] |
La quantità massima di memoria che può essere utilizzata per scopi diversi dall'heap. Unità: byte Statistiche significative: massimo |
|
|
[DEFAULT] |
L'attuale utilizzo della memoria non heap. Unità: byte Statistiche significative: minimo, massimo, media |
|
|
[DEFAULT] |
La quantità di memoria la cui disponibilità è garantita per scopi diversi dall'heap. Unità: byte Statistiche significative: minimo, massimo, media |
|
|
[DEFAULT], |
La quantità iniziale di memoria richiesta dalla JVM al sistema operativo per il pool di memoria. Unità: byte Statistiche significative: minimo, massimo, media |
|
|
[DEFAULT], |
La quantità massima di memoria che può essere utilizzata per il pool di memoria. Unità: byte Statistiche significative: massimo |
|
|
[DEFAULT], |
L'attuale utilizzo di memoria del pool di memoria. Unità: byte Statistiche significative: minimo, massimo, media |
|
|
[DEFAULT], |
La quantità di memoria la cui disponibilità è garantita per il pool di memoria. Unità: byte Statistiche significative: minimo, massimo, media |
|
|
[DEFAULT] |
Il numero corrente di thread. Unità: nessuna Statistiche significative: minimo, massimo, media |
Le metriche JVM vengono raccolte con le seguenti dimensioni:
| Dimensione | Description |
|---|---|
[DEFAULT] |
Su Amazon, EC2 per impostazione predefinita, l'host viene pubblicato anche come dimensione delle metriche raccolte dall' CloudWatch agente, a meno che tu non stia utilizzando il Su Amazon EKS, per impostazione predefinita, il contesto relativo a k8s viene pubblicato anche come dimensioni delle metriche ( |
|
Per le metriche Per le metriche |
Raccolta di metriche di Kafka
Puoi utilizzare l' CloudWatch agente per raccogliere i parametri di Apache Kafka. Per configurarlo, aggiungi una o più delle seguenti sottosezioni all'interno della jmx sezione del file di configurazione dell'agente. CloudWatch
-
Utilizza una sezione
kafkaper raccogliere le metriche del broker Kafka. -
Utilizza una sezione
kafka-consumerper raccogliere le metriche del consumatore di Kafka. -
Utilizza una sezione
kafka-producerper raccogliere le metriche del produttore di Kafka.
Metriche del broker Kafka
È possibile raccogliere le seguenti metriche per i broker Kafka.
| Metrica | Dimensioni | Description |
|---|---|---|
|
|
[DEFAULT] |
Il numero di messaggi ping ricevuti dal broker Kafka. Unità: nessuna Statistiche significative: minimo, massimo, media |
|
|
[DEFAULT], |
Il numero di richieste ricevute dal broker Kafka. Unità: nessuna Statistiche significative: minimo, massimo, media |
|
|
[DEFAULT], |
Il numero di richieste al broker Kafka che hanno portato a un errore. Unità: nessuna Statistiche significative: minimo, massimo, media |
|
|
[DEFAULT], |
Il tempo totale impiegato dal broker Kafka per soddisfare le richieste di servizio. Unità: millisecondi Statistiche significative: minimo, massimo, media |
|
|
[DEFAULT], |
Il 50° percentile impiegato dal broker Kafka per rispondere alle richieste di servizio. Unità: millisecondi Statistiche significative: minimo, massimo, media |
|
|
[DEFAULT], |
Il 99° percentile impiegato dal broker Kafka per rispondere alle richieste di servizio. Unità: millisecondi Statistiche significative: minimo, massimo, media |
|
|
[DEFAULT], |
Il tempo medio impiegato dal broker Kafka per soddisfare le richieste di servizio. Unità: millisecondi Statistiche significative: media |
|
|
[DEFAULT], |
Il numero di byte ricevuti o inviati dal broker Kafka. Unità: byte Statistiche significative: minimo, massimo, media |
|
|
[DEFAULT], |
Il numero di richieste in attesa in purgatorio. Unità: nessuna Statistiche significative: minimo, massimo, media |
|
|
[DEFAULT] |
Il numero di partizioni del broker Kafka. Unità: nessuna Statistiche significative: minimo, massimo, media |
|
|
[DEFAULT] |
Il numero di partizioni che sono offline. Unità: nessuna Statistiche significative: minimo, massimo, media |
|
|
[DEFAULT] |
Il numero di partizioni sottoreplicate. Unità: nessuna Statistiche significative: minimo, massimo, media |
|
|
[DEFAULT], |
Il numero di operazioni di riduzione ed espansione delle repliche sincronizzate. Unità: nessuna Statistiche significative: minimo, massimo, media |
|
|
[DEFAULT] |
Il ritardo massimo nei messaggi tra le repliche del follower e del leader. Unità: nessuna Statistiche significative: massimo |
|
|
[DEFAULT] |
Il numero di controller attivi sul broker. Unità: nessuna Statistiche significative: minimo, massimo, media |
|
|
[DEFAULT] |
Il tasso di elezione dei leader. Se questo aumenta, indica gli errori del broker. Unità: nessuna Statistiche significative: minimo, massimo, media |
|
|
[DEFAULT] |
Il tasso di elezione non corretto per i leader. Se questo aumenta, indica gli errori del broker. Unità: nessuna Statistiche significative: minimo, massimo, media |
|
|
[DEFAULT] |
La dimensione della coda delle richieste. Unità: nessuna Statistiche significative: minimo, massimo, media |
|
|
[DEFAULT] |
Il numero di svuotamenti dei log. Unità: millisecondi Statistiche significative: minimo, massimo, media |
|
|
[DEFAULT] |
Il valore del 50° percentile del numero di svuotamenti dei log. Unità: millisecondi Statistiche significative: minimo, massimo, media |
|
|
[DEFAULT] |
Il valore del 99° percentile del numero di svuotamenti dei log. Unità: millisecondi Statistiche significative: minimo, massimo, media |
Le metriche del broker Kafka vengono raccolte con le seguenti dimensioni:
| Dimensione | Description |
|---|---|
[DEFAULT] |
Su Amazon, EC2 per impostazione predefinita, l'host viene pubblicato anche come dimensione delle metriche raccolte dall' CloudWatch agente, a meno che tu non stia utilizzando il Su Amazon EKS, per impostazione predefinita, il contesto relativo a k8s viene pubblicato anche come dimensioni delle metriche ( |
|
Il tipo di richiesta. I valori possibili sono |
|
La direzione del traffico di rete. I valori possibili sono |
|
Il tipo di operazione per la replica sincronizzata. I valori possibili sono |
Metriche dei consumatori di Kafka
È possibile raccogliere le seguenti metriche per i consumatori di Kafka.
| Metrica | Dimensioni | Description |
|---|---|---|
|
|
[DEFAULT], |
Il numero di richieste di recupero per tutti gli argomenti al secondo. Unità: nessuna Statistiche significative: minimo, massimo, media |
|
|
[DEFAULT], |
Il numero di messaggi di ritardo del consumatore rispetto al produttore. Unità: nessuna Statistiche significative: minimo, massimo, media |
|
|
[DEFAULT], |
Il numero medio di byte consumati al secondo per tutti gli argomenti. Unità: byte Statistiche significative: media |
|
|
[DEFAULT], |
Il numero di byte recuperati per richiesta per tutti gli argomenti. Unità: byte Statistiche significative: minimo, massimo, media |
|
|
[DEFAULT], |
Il numero medio di record consumati al secondo per tutti gli argomenti. Unità: nessuna Statistiche significative: media |
|
|
[DEFAULT], |
Il numero medio di byte consumati al secondo. Unità: byte Statistiche significative: media |
|
|
[DEFAULT], |
Il numero di byte recuperati per richiesta. Unità: byte Statistiche significative: minimo, massimo, media |
|
|
[DEFAULT], |
Il numero medio di record consumati al secondo. Unità: nessuna Statistiche significative: media |
Le metriche del consumatore Kafka vengono raccolte con le seguenti dimensioni:
| Dimensione | Description |
|---|---|
[DEFAULT] |
Su Amazon, EC2 per impostazione predefinita, l'host viene pubblicato anche come dimensione delle metriche raccolte dall' CloudWatch agente, a meno che tu non stia utilizzando il Su Amazon EKS, per impostazione predefinita, il contesto relativo a k8s viene pubblicato anche come dimensioni delle metriche ( |
|
ID del client. |
|
L'argomento Kafka. |
Metriche dei produttori di Kafka
È possibile raccogliere le seguenti metriche per i produttori di Kafka.
| Metrica | Dimensioni | Description |
|---|---|---|
|
|
[DEFAULT], |
Il tempo medio impiegato dal I/O thread in attesa che un socket fosse pronto per la lettura o la scrittura. Unità: nessuna Statistiche significative: media |
|
|
[DEFAULT], |
Il numero medio di byte in uscita inviati al secondo a tutti i server. Unità: byte Statistiche significative: media |
|
|
[DEFAULT], |
La latenza media delle richieste. Unità: millisecondi Statistiche significative: media |
|
|
[DEFAULT], |
Il numero medio di richieste inviate al secondo. Unità: nessuna Statistiche significative: media |
|
|
[DEFAULT], |
Il numero di risposte ricevute al secondo. Unità: nessuna Statistiche significative: minimo, massimo, media |
|
|
[DEFAULT], |
Il numero medio di byte inviati al secondo per un argomento. Unità: byte Statistiche significative: media |
|
|
[DEFAULT], |
Il tasso di compressione medio dei batch di record per un argomento. Unità: nessuna Statistiche significative: media |
|
|
[DEFAULT], |
Il numero medio al secondo di invio di record che hanno generato errori per un argomento. Unità: nessuna Statistiche significative: media |
|
|
[DEFAULT], |
Il numero medio al secondo di record ritentati inviati per un argomento. Unità: nessuna Statistiche significative: media |
|
|
[DEFAULT], |
Il numero medio di record inviati al secondo per un argomento. Unità: nessuna Statistiche significative: media |
Le metriche del produttore Kafka vengono raccolte con le seguenti dimensioni:
| Dimensione | Description |
|---|---|
[DEFAULT] |
Su Amazon, EC2 per impostazione predefinita, l'host viene pubblicato anche come dimensione delle metriche raccolte dall' CloudWatch agente, a meno che tu non stia utilizzando il Su Amazon EKS, per impostazione predefinita, il contesto relativo a k8s viene pubblicato anche come dimensioni delle metriche ( |
|
ID del client. |
|
L'argomento Kafka. |
Raccolta di metriche di Tomcat
Puoi utilizzare l' CloudWatch agente per raccogliere le metriche di Apache Tomcat. Per configurarlo, aggiungi una tomcat sezione all'interno della metrics_collected sezione del file di configurazione dell' CloudWatch agente.
È possibile raccogliere i seguenti parametri.
| Metrica | Dimensioni | Description |
|---|---|---|
|
|
[DEFAULT] |
Il numero di sessioni attive nel dominio. Unità: nessuna Statistiche significative: minimo, massimo, media |
|
|
[DEFAULT], |
Il numero di errori riscontrati. Unità: nessuna Statistiche significative: minimo, massimo, media |
|
|
[DEFAULT], |
Il tempo totale di elaborazione. Unità: millisecondi Statistiche significative: minimo, massimo, media |
|
|
[DEFAULT], |
Il numero di byte inviati e ricevuti. Unità: byte Statistiche significative: minimo, massimo, media |
|
|
[DEFAULT], |
Il numero di thread. Unità: nessuna Statistiche significative: minimo, massimo, media |
|
|
[DEFAULT], |
Tempo massimo per elaborare una richiesta. Unità: millisecondi Statistiche significative: massimo |
|
|
[DEFAULT], |
Il totale delle richieste. Unità: nessuna Statistiche significative: minimo, massimo, media |
Le metriche Tomcat vengono raccolte con le seguenti dimensioni:
| Dimensione | Description |
|---|---|
[DEFAULT] |
Su Amazon, EC2 per impostazione predefinita, l'host viene pubblicato anche come dimensione delle metriche raccolte dall' CloudWatch agente, a meno che tu non stia utilizzando il Su Amazon EKS, per impostazione predefinita, il contesto relativo a k8s viene pubblicato anche come dimensioni delle metriche ( |
|
|
|
La direzione del traffico. I valori possibili sono |