Metriche
Panoramica
La sezione APM > Metriche visualizza i punti dati delle metriche raccolti dalle applicazioni e dai servizi.
Una metrica è una misurazione (ad esempio, la durata di una richiesta, il numero di ordini elaborati o l'utilizzo della memoria). Le applicazioni inviano i relativi valori come punti dati che contengono il valore (o i valori aggregati) misurato in un momento specifico. Una metrica è simile a un item di Zabbix e un punto dati è simile a un valore di tale item.
Un punto dati può essere di uno dei seguenti tipi:
- Gauge - un valore misurato in un momento specifico (ad esempio, l'utilizzo corrente della memoria).
- Sum - una somma delle misurazioni effettuate in un determinato periodo di tempo (ad esempio, il numero totale di richieste).
- Histogram - il numero di misurazioni effettuate in un determinato periodo di tempo che rientrano in ciascuno di diversi intervalli di valori fissi, chiamati bucket (ad esempio, quante richieste hanno richiesto 0-100 ms, 100-250 ms o 250-500 ms).
- Exponential histogram - come un istogramma, ma ogni bucket è più ampio del precedente dello stesso fattore (ad esempio, 1-2 ms, 2-4 ms, 4-8 ms).
Ogni punto dati è prodotto da un servizio (ad esempio, zabbix-frontend; denominato dall'attributo della risorsa OpenTelemetry service.name) e da un ambito di strumentazione, ovvero la parte di codice che lo ha creato (ad esempio, una libreria che misura la durata delle richieste HTTP).
Per fornire il contesto relativo a ogni misurazione, i punti dati hanno anche attributi chiave-valore: gli attributi dei punti dati descrivono cosa è stato misurato e distinguono i punti dati della stessa metrica (ad esempio, http.request.method: POST), mentre gli attributi delle risorse descrivono il servizio e l'ambiente in cui viene eseguito (ad esempio, host.name: eabf8c2a5ddc).
Per ulteriori informazioni sulle metriche, consultare la documentazione di OpenTelemetry.
La sezione APM > Metriche contiene i seguenti elementi:
- Pulsante Modalità chiosco - visualizza solo il contenuto della pagina, senza il menu e l'intestazione.
- Selettore del periodo di tempo - seleziona il periodo di tempo per il quale visualizzare i punti dati.
- Filtro - visualizza solo i punti dati di interesse.
- Elenco delle metriche - visualizza i punti dati.
- Dettagli della metrica - visualizza i dettagli del punto dati selezionato.
Elenco delle metriche
Ogni riga nell'elenco delle metriche rappresenta un punto dati.
I punti dati vengono visualizzati in una tabella personalizzabile.
Il pulsante 
Personalizza tabella nell'intestazione della tabella consente di mostrare, nascondere o riordinare le colonne e di ripristinare il layout predefinito.
È inoltre possibile ridimensionare ogni colonna trascinandone il bordo destro; fare doppio clic sul bordo per ripristinare le dimensioni.
Tutte le personalizzazioni vengono applicate immediatamente e memorizzate per l'utente corrente.
L'elenco delle metriche può contenere le seguenti colonne:
Ogni colonna, ad eccezione di Tipo, corrisponde a una colonna nelle tabelle delle metriche (otel_metrics_gauge, otel_metrics_sum, otel_metrics_histogram e otel_metrics_exponential_histogram) dell'origine dati di telemetria; per l'elenco delle colonne, vedere Colonne di dati di telemetria supportate.
La maggior parte delle colonne ha lo stesso nome utilizzato nell'origine dati (ad esempio, Nome metrica corrisponde alla colonna MetricName).
Quando i nomi differiscono, nella tabella seguente viene specificata la colonna dell'origine dati.
| Colonna | Descrizione |
|---|---|
| Nome metrica | Metrica a cui appartiene il punto dati (ad esempio, http.server.duration). |
| Tipo | Tipo di punto dati: Gauge, Sum, Histogram o Exponential histogram. Determinato dalla tabella delle metriche che contiene il punto dati. |
| Unità | Unità, se presente, dei valori della metrica (ad esempio, s o By; vedere UCUM).Colonna dell'origine dati: MetricUnit. |
| Nome del servizio | Servizio che ha prodotto il punto dati. |
| Nome dell'ambito | Ambito di strumentazione che ha prodotto il punto dati. |
| Ora di inizio | Data e ora di inizio del periodo di misurazione del punto dati. Colonna dell'origine dati: StartTimeUnix. |
| Somma/Valore | Somma di tutte le misurazioni (Histogram, Exponential histogram) o valore (Gauge, Sum) del punto dati. |
| Conteggio | Numero di misurazioni in un punto dati Histogram o Exponential histogram. |
| Ora | Data e ora del punto dati; per i punti dati Sum, Histogram ed Exponential histogram, indica la fine del periodo di misurazione. Colonna dell'origine dati: TimeUnix. |
| Flag | Flag del punto dati: 0 - non è impostato alcun flag. 1 - non è stato registrato alcun valore per il punto dati. |
| Temporaneità dell'aggregazione | Modalità di aggregazione nel tempo dei valori di un punto dati Sum, Histogram o Exponential histogram: Unspecified - non specificata. Delta - aggregati nel periodo trascorso dal punto dati precedente. Cumulative - aggregati nel periodo trascorso dall'ora di inizio. |
| Descrizione della metrica | Descrizione, se presente, della metrica. |
| Attributi | Attributi del punto dati. Fare clic sul pulsante con tre puntini  per visualizzare tutti gli attributi. |
| Attributi della risorsa | Attributi della risorsa del punto dati. Fare clic sul pulsante con tre puntini per visualizzare tutti gli attributi. |
| Attributi dell'ambito | Attributi dell'ambito di strumentazione. Fare clic sul pulsante con tre puntini per visualizzare tutti gli attributi. |
Dettagli della metrica
Fare clic su un punto dati nell'elenco delle metriche per aprire il pannello dei dettagli della metrica, che mostra tutte le informazioni sul punto dati.
Il pannello dei dettagli della metrica può contenere le seguenti sezioni:
| Sezione | Descrizione |
|---|---|
| Informazioni di base | Nome della metrica, tipo, unità, nome del servizio e ora di inizio. |
| Istogramma | Bucket (ad esempio, > 5 - 10), ciascuno con il numero di misurazioni contenute.Visualizzato solo per i punti dati di tipo Istogramma. |
| Istogramma esponenziale | Bucket (ad esempio, >= 249.7885 - 249.7887), ciascuno con il numero di misurazioni contenute.Visualizzato solo per i punti dati di tipo Istogramma esponenziale. |
| Informazioni sulla metrica | Valori del punto dati, che dipendono dal relativo tipo, nonché descrizione della metrica, ora, flag e URL dello schema della risorsa. |
| Attributi | Attributi del punto dati. |
| Attributi della risorsa | Attributi della risorsa. |
| Attributi dell'ambito | Attributi, se presenti, dell'ambito di strumentazione. |
| Ambito | Nome, versione e URL dello schema dell'ambito di strumentazione. |
Utilizzo del filtro
È possibile utilizzare il filtro per visualizzare solo i punti dati di interesse.
Per filtrare in base agli attributi, immettere la chiave dell'attributo, selezionare l'operatore e immettere il valore dell'attributo.
Sono supportati i seguenti operatori:
- Contiene - (predefinito) il valore dell'attributo contiene la stringa immessa.
- È uguale a - il valore dell'attributo è uguale alla stringa immessa.
- Non contiene - il valore dell'attributo non contiene la stringa immessa.
- Non è uguale a - il valore dell'attributo non è uguale alla stringa immessa.
- Esiste - esiste l'attributo con la chiave immessa.
- Non esiste - non esiste l'attributo con la chiave immessa.
Se si aggiungono più condizioni, selezionare come valutarle:
- And/Or - (predefinito) tutte le condizioni devono essere soddisfatte; le condizioni con la stessa chiave dell'attributo vengono combinate con Or.
- Or - deve essere soddisfatta almeno una condizione.