Oggetto di traccia APM
I seguenti oggetti sono direttamente correlati all'API apmtrace.
Ogni proprietà, ad eccezione di span_count e error_count, corrisponde a una colonna nella tabella otel_traces dell'origine dati di telemetria.
La maggior parte delle proprietà corrisponde alla colonna con lo stesso nome (ad esempio, la proprietà span_name corrisponde alla colonna SpanName).
Quando i nomi differiscono, le colonne dell'origine dati sono specificate nelle tabelle seguenti.
Per l'elenco delle colonne, vedere Colonne di dati di telemetria supportate.
Traccia APM
L'oggetto traccia APM rappresenta una traccia (il percorso seguito da una richiesta attraverso le applicazioni e i servizi). Una traccia è costituita da uno o più span; ogni span rappresenta una singola operazione.
L'oggetto traccia APM si basa sullo span radice della traccia (lo span che avvia la traccia e non ha uno span padre).
Tutte le proprietà contengono i dati dello span radice, ad eccezione di span_count e error_count, che vengono calcolati da tutti gli span della traccia.
L'oggetto traccia APM presenta le seguenti proprietà:
| Property | Type | Description |
|---|---|---|
| timestamp | integer | Ora Unix (in nanosecondi) di avvio dello span radice. Comportamento della proprietà: - sola lettura |
| traceid | string | ID della traccia, condiviso da tutti gli span appartenenti alla traccia. Comportamento della proprietà: - sola lettura |
| spanid | string | ID dello span radice. Comportamento della proprietà: - sola lettura |
| trace_state | string | Dati aggiuntivi, se presenti, associati alla traccia dagli strumenti di tracing (vedere W3C Trace Context). Comportamento della proprietà: - sola lettura |
| span_name | string | Nome dell'operazione rappresentata dallo span radice (ad esempio, POST /zabbix.php).Comportamento della proprietà: - sola lettura |
| span_kind | string | Ruolo dello span radice. Valori possibili: Unspecified - il tipo di span non è specificato;Internal - operazione eseguita all'interno di un'applicazione;Server - gestione di una richiesta in ingresso;Client - richiesta in uscita;Producer - creazione di un'operazione asincrona (ad esempio, l'invio di un messaggio);Consumer - elaborazione di un'operazione asincrona.Comportamento della proprietà: - sola lettura |
| service_name | string | Nome del servizio che ha prodotto lo span radice (ad esempio, zabbix-nginx), ricavato dall'attributo della risorsa OpenTelemetry service.name.Comportamento della proprietà: - sola lettura |
| resource_attributes | object | Attributi della risorsa chiave-valore dello span radice (ad esempio, host.name: eabf8c2a5ddc).Comportamento della proprietà: - sola lettura |
| scope_name | string | Nome dell'ambito di strumentazione che ha prodotto lo span radice. Comportamento della proprietà: - sola lettura |
| scope_version | string | Versione dell'ambito di strumentazione. Comportamento della proprietà: - sola lettura |
| span_attributes | object | Attributi dello span chiave-valore dello span radice (ad esempio, http.method: POST).Comportamento della proprietà: - sola lettura |
| duration | integer | Durata della traccia in nanosecondi. Comportamento della proprietà: - sola lettura |
| status_code | string | Stato dell'operazione rappresentata dallo span radice. Valori possibili: Unset - non è stato assegnato alcuno stato esplicito allo span radice;Ok - l'operazione è stata completata correttamente;Error - l'operazione è stata completata con un errore.Comportamento della proprietà: - sola lettura |
| status_message | string | Informazioni aggiuntive, se presenti, sullo stato dello span radice. Comportamento della proprietà: - sola lettura |
| events | array | Array di oggetti evento dello span radice, ovvero momenti significativi durante l'operazione (ad esempio, eccezioni). Comportamento della proprietà: - sola lettura |
| links | array | Array di oggetti link dello span radice, che fanno riferimento a span correlati nella stessa traccia o in un'altra traccia. Comportamento della proprietà: - sola lettura |
| span_count | integer | Numero totale di span nella traccia. Comportamento della proprietà: - sola lettura |
| error_count | integer | Numero di span nella traccia con status_code impostato su Error.Comportamento della proprietà: - sola lettura |
Evento
L'oggetto evento ha le seguenti proprietà.
| Property | Type | Description |
|---|---|---|
| timestamp | integer | Ora Unix (in nanosecondi) in cui si è verificato l'evento. Colonna dell'origine dati: Events.Timestamp |
| name | string | Nome dell'evento. Colonna dell'origine dati: Events.Name |
| attributes | object | Attributi chiave-valore con informazioni aggiuntive sull'evento, se presenti. Colonna dell'origine dati: Events.Attributes |
Collegamento
L'oggetto collegamento presenta le seguenti proprietà.
| Proprietà | Tipo | Descrizione |
|---|---|---|
| traceid | string | ID della traccia che contiene lo span collegato. Colonna dell'origine dati: Links.TraceId |
| spanid | string | ID dello span collegato. Insieme a traceid, identifica in modo univoco lo span collegato.Colonna dell'origine dati: Links.SpanId |
| trace_state | string | Stato della traccia, se presente, dello span collegato (vedere W3C Trace Context). Colonna dell'origine dati: Links.TraceState |
| attributes | object | Attributi chiave-valore con informazioni aggiuntive sul collegamento. Colonna dell'origine dati: Links.Attributes |