In questa pagina

Oggetto span APM

I seguenti oggetti sono direttamente correlati all'API apmspan.

Ogni proprietà corrisponde a una colonna nella tabella otel_traces dell'origine dati di telemetria. Per l'elenco delle colonne, vedere Colonne dei dati di telemetria supportate.

Span APM

L'oggetto span APM rappresenta uno span (una singola operazione all'interno di una trace, ad esempio una richiesta HTTP, una query al database o una chiamata di funzione).

Gli span formano una gerarchia che inizia dallo span radice, che rappresenta la prima operazione della richiesta. Ogni altro span è uno span figlio dello span durante il quale è stata avviata la relativa operazione.

L'oggetto span APM ha le seguenti proprietà:

Property Type Description
timestamp integer Ora Unix (in nanosecondi) di avvio dello span.

Comportamento della proprietà:
- sola lettura
traceid string ID della trace a cui appartiene lo span.

Comportamento della proprietà:
- sola lettura
spanid string ID dello span.

Comportamento della proprietà:
- sola lettura
parent_spanid string ID dello span padre.
Vuoto per lo span radice.

Comportamento della proprietà:
- sola lettura
trace_state string Dati aggiuntivi, se presenti, associati alla trace dagli strumenti di tracing (vedere W3C Trace Context).

Comportamento della proprietà:
- sola lettura
span_name string Nome dell'operazione rappresentata dallo span (ad esempio, mysqli_query).

Comportamento della proprietà:
- sola lettura
span_kind string Ruolo dello span.

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 (ad esempio, zabbix-frontend), ricavato dall'attributo della risorsa OpenTelemetry service.name.

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

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

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 (ad esempio, db.system: mysql).

Comportamento della proprietà:
- sola lettura
duration integer Durata dello span in nanosecondi.

Comportamento della proprietà:
- sola lettura
status_code string Stato dell'operazione rappresentata dallo span.

Valori possibili:
Unset - allo span non è stato assegnato alcuno stato esplicito;
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.

Comportamento della proprietà:
- sola lettura
events array Array di oggetti event dello span, ovvero momenti significativi durante l'operazione (ad esempio, eccezioni).

Comportamento della proprietà:
- sola lettura
links array Array di oggetti link dello span, che fanno riferimento a span correlati nella stessa trace o in un'altra trace.

Comportamento della proprietà:
- sola lettura