Objet span APM

Les objets suivants sont directement liés à l’API apmspan.

Chaque propriété correspond à une colonne de la table otel_traces de la source de données de télémétrie. Pour obtenir la liste des colonnes, consultez Colonnes de données de télémétrie prises en charge.

Span APM

L’objet span APM représente un span (une opération unique au sein d’une trace, telle qu’une requête HTTP, une requête de base de données ou un appel de fonction).

Les spans forment une hiérarchie qui commence par le span racine, représentant la première opération de la requête. Chaque autre span est un span enfant du span pendant lequel son opération a été démarrée.

L’objet span APM possède les propriétés suivantes :

Property Type Description
timestamp integer Heure Unix (en nanosecondes) à laquelle le span a démarré.

Comportement de la propriété :
- lecture seule
traceid string ID de la trace à laquelle appartient le span.

Comportement de la propriété :
- lecture seule
spanid string ID du span.

Comportement de la propriété :
- lecture seule
parent_spanid string ID du span parent.
Vide pour le span racine.

Comportement de la propriété :
- lecture seule
trace_state string Données supplémentaires, le cas échéant, que les outils de traçage associent à la trace (voir W3C Trace Context).

Comportement de la propriété :
- lecture seule
span_name string Nom de l’opération représentée par le span (par exemple, mysqli_query).

Comportement de la propriété :
- lecture seule
span_kind string Rôle du span.

Valeurs possibles :
Unspecified - le type de span n’est pas spécifié ;
Internal - opération effectuée au sein d’une application ;
Server - traitement d’une requête entrante ;
Client - requête sortante ;
Producer - création d’une opération asynchrone (par exemple, l’envoi d’un message) ;
Consumer - traitement d’une opération asynchrone.

Comportement de la propriété :
- lecture seule
service_name string Nom du service ayant produit le span (par exemple, zabbix-frontend), extrait de l’attribut de ressource OpenTelemetry service.name.

Comportement de la propriété :
- lecture seule
resource_attributes object Attributs de ressource clé-valeur du span (par exemple, host.name: eabf8c2a5ddc).

Comportement de la propriété :
- lecture seule
scope_name string Nom de la portée d’instrumentation ayant produit le span.

Comportement de la propriété :
- lecture seule
scope_version string Version de la portée d’instrumentation.

Comportement de la propriété :
- lecture seule
span_attributes object Attributs du span clé-valeur du span (par exemple, db.system: mysql).

Comportement de la propriété :
- lecture seule
duration integer Durée du span en nanosecondes.

Comportement de la propriété :
- lecture seule
status_code string État de l’opération représentée par le span.

Valeurs possibles :
Unset - aucun état explicite n’a été attribué au span ;
Ok - l’opération s’est terminée avec succès ;
Error - l’opération s’est terminée avec une erreur.

Comportement de la propriété :
- lecture seule
status_message string Informations supplémentaires, le cas échéant, concernant l’état du span.

Comportement de la propriété :
- lecture seule
events array Tableau d’objets événement du span, c’est-à-dire les moments importants survenus pendant l’opération (par exemple, des exceptions).

Comportement de la propriété :
- lecture seule
links array Tableau d’objets lien du span, qui pointent vers des spans associés dans la même trace ou dans une autre trace.

Comportement de la propriété :
- lecture seule