Monitoraggio Micrometer
Una volta installato l'agente host di Instana, il sensore Micrometer viene installato e attivato automaticamente. È possibile visualizzare le metriche relative a " Micrometer " nell'interfaccia utente di " Instana ".
Informazioni sul supporto
Per assicurarti che il sensore Micrometer sia compatibile con la tua configurazione attuale, consulta le seguenti sezioni delle informazioni di supporto:
Versioni supportate
Supporto confermato per le metriche personalizzate per 1.0.0x.
Sensore (raccolta dati)
Micrometer è una semplice interfaccia di metrica applicativa per l' JVM. È lo standard di fatto nell'ecosistema dell' Java ed è integrato nell' SpringBoot. Per ulteriori informazioni, consultare il sito Micrometer.
Instana supporta Micrometer senza alcuna configurazione aggiuntiva. Il sensore rileva l'utilizzo di Micrometer e raccoglie automaticamente i dati statistici. Non sono necessarie ulteriori dipendenze da Maven.
Un errore di tipo " Micrometer " ( MeterRegistry ) viene rilevato solo quando viene chiamato un metodo pubblico sull'oggetto MeterRegistry, una volta che l' JVM è stato strumentato. Quando si inizializza un registro delle metriche utilizzando un costruttore pubblico, viene eseguito solo il metodo pubblico prima che l'agente Instana venga avviato. Pertanto, quando viene chiamato un metodo pubblico di tipo ` MeterRegistry's ` dopo l'avvio dell'agente, l'agente rileva il registro.
Tutti i grafici relativi alle metriche vengono visualizzati nella dashboard di JVM.
Visualizzazione delle metriche
Per visualizzare le metriche, procedere come segue:
- Nella barra laterale dell'interfaccia utente di Instana, seleziona "Infrastruttura".
- Clicca su un host monitorato specifico per visualizzare la dashboard dell'host con tutte le metriche raccolte e i processi monitorati.
Dati di configurazione
Se l' JVM e ha caricato la libreria delle metriche Micrometer, le metriche personalizzate vengono raccolte automaticamente e visualizzate nella dashboard JVM. Per evitare un sovraccarico del backend, è stato impostato un limite predefinito di 200 metriche per ogni JVM. È possibile utilizzare il tagExtractionMetricPatterns parametro per estrarre i tag relativi a determinate metriche. È possibile fornire un elenco di espressioni regolari per filtrare le metriche ai fini dell'estrazione dei tag. I tag vengono estratti solo dalle metriche che corrispondono ai modelli specificati, ovvero tagExtractionMetricPatterns. Se si estraggono i tag da un numero elevato di metriche, il volume dei dati acquisiti potrebbe aumentare.
Per disattivare il monitoraggio di " Micrometer " o modificare il limite delle metriche, utilizzare la seguente configurazione:
com.instana.plugin.java:
micrometerMetricCollection:
enabled: false
limit: 200
tagExtractionMetricPatterns:
- '^my_metric'
- 'abc+'
Se i parametri non vengono visualizzati dopo il caricamento della libreria, imposta la tua io.micrometer.core.instrument.MeterRegistry istanza come predefinita. Ad esempio:
import io.micrometer.core.instrument.Metrics;
Metrics.globalRegistry.add(meterRegistry)
Metriche
La tabella seguente illustra il sensore che raccoglie tutti i tipi di metriche:
| Tipo di metrica | Descrizione |
|---|---|
| Inversa | Il conteggio cumulativo da quando è stato creato questo contatore |
| DistributionSummary | La quantità totale di tutti gli eventi registrati |
| FunctionCounter | Il conteggio cumulativo da quando è stato creato questo contatore |
| FunctionTimer | Il tempo totale di tutte le ricorrenze dell'evento a tempo |
| Misuratore radiale | Il valore corrente |
| LongTaskTimer | Il numero corrente di attività eseguite |
| Timer | Il tempo totale degli eventi registrati scalati in millisecondi |
| TimeGauge | Il valore corrente, scalato all'unità di base appropriata |
Per ulteriori informazioni, consultare le metriche su Micrometer.
L'esempio seguente mostra i nomi delle metriche che contengono tag concatenati quando i tag non vengono estratti:
exception=None, method=GET, outcome=SUCCESS,
status=200, version=1.0, maintainer=instana
L'esempio seguente mostra i nomi delle metriche quando vengono estratti i tag:
{action="hello",name="fabian",}
I parametri che iniziano con "jvm", "process", "tomcat", "system", "logback" vengono automaticamente esclusi dal monitoraggio.
Micrometer Prometheus Registro
Il Registro dei contatori Prometheus è un sottoprogetto dell'ecosistema Micrometer finalizzato all'esportazione di dati metrici nel formato Prometheus. Se utilizzi questa estensione e desideri mantenere il tuo attuale formato metrico, puoi integrare il monitoraggio della libreria client Java di Instana, disponibile all'indirizzo Prometheus. Tuttavia, è necessario aggiungere una riga di codice come descritto su github.com/instana/prometheus-java-library-integration.