Oggetto metrica APM

I seguenti oggetti sono direttamente correlati all'API apmmetric.

Ogni proprietà, ad eccezione di type, corrisponde a una colonna nelle tabelle delle metriche (otel_metrics_gauge, otel_metrics_sum, otel_metrics_histogram e otel_metrics_exponential_histogram) della sorgente dati di telemetria. La maggior parte delle proprietà corrisponde alla colonna con lo stesso nome (ad esempio, la proprietà metric_name corrisponde alla colonna MetricName). Quando i nomi differiscono, le colonne della sorgente dati sono specificate nelle tabelle seguenti. Per l'elenco delle colonne, vedere Colonne di dati di telemetria supportate.

Metrica APM

L'oggetto metrica APM rappresenta un punto dati di una metrica (il valore o i valori aggregati di una misurazione in un momento specifico).

L'oggetto metrica APM ha le seguenti proprietà:

Proprietà Tipo Descrizione
type integer Tipo del punto dati.

Valori possibili:
0 - Gauge;
1 - Sum;
2 - Histogram;
3 - Exponential histogram.

Il tipo è determinato dalla tabella che contiene il punto dati: otel_metrics_gauge, otel_metrics_sum, otel_metrics_histogram o otel_metrics_exponential_histogram.

Comportamento della proprietà:
- sola lettura
resource_attributes object Attributi della risorsa chiave-valore del punto dati (ad esempio, host.name: eabf8c2a5ddc).

Comportamento della proprietà:
- sola lettura
resource_schema_url string URL, se presente, dello schema OpenTelemetry degli attributi della risorsa.

Comportamento della proprietà:
- sola lettura
scope_name string Nome dell'ambito di strumentazione che ha prodotto il punto dati.

Comportamento della proprietà:
- sola lettura
scope_version string Versione, se presente, dell'ambito di strumentazione.

Comportamento della proprietà:
- sola lettura
scope_attributes object Attributi chiave-valore dell'ambito di strumentazione.

Comportamento della proprietà:
- sola lettura
scope_schema_url string URL, se presente, dello schema OpenTelemetry dell'ambito di strumentazione e dei relativi attributi.

Comportamento della proprietà:
- sola lettura
service_name string Nome del servizio che ha prodotto il punto dati (ad esempio, zabbix-frontend), ricavato dall'attributo della risorsa OpenTelemetry service.name.

Comportamento della proprietà:
- sola lettura
metric_name string Nome della metrica a cui appartiene il punto dati (ad esempio, http.server.request.duration).

Comportamento della proprietà:
- sola lettura
metric_description string Descrizione, se presente, della metrica.

Comportamento della proprietà:
- sola lettura
metric_unit string Unità, se presente, dei valori della metrica (ad esempio, s o By; vedere UCUM).

Comportamento della proprietà:
- sola lettura
attributes object Attributi del punto dati chiave-valore (ad esempio, http.request.method: POST).

Comportamento della proprietà:
- sola lettura
start_time_unix integer Ora Unix (in nanosecondi) di inizio del periodo di misurazione del punto dati.

Comportamento della proprietà:
- sola lettura
time_unix integer Ora Unix (in nanosecondi) del punto dati.
Per i punti dati Sum, Histogram ed Exponential histogram, indica la fine del periodo di misurazione.

Comportamento della proprietà:
- sola lettura
value float Valore del punto dati.
Si applica ai punti dati Gauge e Sum.

Predefinito: 0.

Comportamento della proprietà:
- sola lettura
flags integer Maschera di bit dei flag del punto dati.
Se il bit meno significativo è impostato (valore 1), non è stato registrato alcun valore per il punto dati.

Comportamento della proprietà:
- sola lettura
exemplars array Array di oggetti exemplar, ovvero singole misurazioni conservate come esempi, con il trace e lo span durante i quali sono state registrate.

Comportamento della proprietà:
- sola lettura
aggregation_temporality integer Modalità di aggregazione nel tempo dei valori del punto dati.
Si applica ai punti dati Sum, Histogram ed Exponential histogram.

Valori possibili:
0 - (predefinito) Non specificato;
1 - Delta (aggregato sul periodo trascorso dal punto dati precedente);
2 - Cumulativo (aggregato sul periodo trascorso da start_time_unix).

Comportamento della proprietà:
- sola lettura
is_monotonic boolean Indica se la somma può solo aumentare o rimanere invariata nel tempo.
Si applica ai punti dati Sum.

Predefinito: false.

Comportamento della proprietà:
- sola lettura
count integer Numero di misurazioni nel punto dati.
Si applica ai punti dati Histogram ed Exponential histogram.

Predefinito: 0.

Comportamento della proprietà:
- sola lettura
sum float Somma di tutte le misurazioni nel punto dati.
Si applica ai punti dati Histogram ed Exponential histogram.

Predefinito: 0.

Comportamento della proprietà:
- sola lettura
bucket_counts array Array di interi contenente il numero di misurazioni in ciascun bucket dell'istogramma.
I bucket sono definiti da explicit_bounds.
Si applica ai punti dati Histogram.

Predefinito: [].

Comportamento della proprietà:
- sola lettura
explicit_bounds array Array di numeri a virgola mobile contenente i limiti tra i bucket dell'istogramma.
Si applica ai punti dati Histogram.

Predefinito: [].

Comportamento della proprietà:
- sola lettura
min float Valore minimo delle misurazioni nel punto dati.
Si applica ai punti dati Histogram ed Exponential histogram.

Predefinito: 0.

Comportamento della proprietà:
- sola lettura
max float Valore massimo delle misurazioni nel punto dati.
Si applica ai punti dati Histogram ed Exponential histogram.

Predefinito: 0.

Comportamento della proprietà:
- sola lettura
scale integer Scala dell'istogramma esponenziale, che determina i limiti e la risoluzione dei bucket.
Una scala maggiore produce bucket più stretti e una risoluzione più fine; una scala minore produce bucket più ampi e una risoluzione più grossolana.
Si applica ai punti dati Exponential histogram.

Predefinito: 0.

Comportamento della proprietà:
- sola lettura
zero_count integer Numero di misurazioni nel bucket zero dell'istogramma esponenziale.
Si applica ai punti dati Exponential histogram.

Predefinito: 0.

Comportamento della proprietà:
- sola lettura
positive_bucket_counts array Array di interi contenente il numero di misurazioni positive in ciascun bucket dell'istogramma esponenziale.
I limiti dei bucket sono determinati da scale; l'indice del primo bucket è impostato in positive_offset.
Si applica ai punti dati Exponential histogram.

Predefinito: [].

Comportamento della proprietà:
- sola lettura
positive_offset integer Indice del primo bucket in positive_bucket_counts.
Si applica ai punti dati Exponential histogram.

Predefinito: 0.

Comportamento della proprietà:
- sola lettura
negative_bucket_counts array Array di interi contenente il numero di misurazioni negative in ciascun bucket dell'istogramma esponenziale.
I limiti dei bucket sono determinati da scale; l'indice del primo bucket è impostato in negative_offset.
Si applica ai punti dati Exponential histogram.

Predefinito: [].

Comportamento della proprietà:
- sola lettura
negative_offset integer Indice del primo bucket in negative_bucket_counts.
Si applica ai punti dati Exponential histogram.

Predefinito: 0.

Comportamento della proprietà:
- sola lettura

Esemplare

L'oggetto esemplare presenta le seguenti proprietà:

Proprietà Tipo Descrizione
traceid string ID, se presente, della traccia durante la quale è stata registrata la misurazione.
Colonna dell'origine dati: Exemplars.TraceId.
spanid string ID, se presente, dello span durante il quale è stata registrata la misurazione.
Colonna dell'origine dati: Exemplars.SpanId.
value float Valore della misurazione.
Colonna dell'origine dati: Exemplars.Value.
time_unix integer Ora Unix (in nanosecondi) in cui è stata registrata la misurazione.
Colonna dell'origine dati: Exemplars.TimeUnix.
filtered_attributes object Attributi chiave-valore della misurazione che non sono inclusi negli attributes del punto dati.
Colonna dell'origine dati: Exemplars.FilteredAttributes.