Objet de trace APM
Les objets suivants sont directement liés à l’API apmtrace.
Chaque propriété, à l’exception de span_count et error_count, correspond à une colonne de la table otel_traces de la source de données de télémétrie.
La plupart des propriétés correspondent à la colonne portant le même nom (par exemple, la propriété span_name correspond à la colonne SpanName).
Lorsque les noms diffèrent, les colonnes de la source de données sont indiquées dans les tableaux ci-dessous.
Pour obtenir la liste des colonnes, consultez la page Colonnes de données de télémétrie prises en charge.
Trace APM
L'objet de trace APM représente une trace (le chemin qu'une requête suit à travers vos applications et services). Une trace se compose d'un ou plusieurs spans ; chaque span représente une opération unique.
L'objet de trace APM est basé sur le span racine de la trace (le span qui démarre la trace et qui n'a pas de span parent).
Toutes les propriétés contiennent les données du span racine, à l'exception de span_count et error_count, qui sont calculées à partir de tous les spans de la trace.
L'objet de trace APM possède les propriétés suivantes :
| Property | Type | Description |
|---|---|---|
| timestamp | integer | Heure Unix (en nanosecondes) à laquelle le span racine a démarré. Comportement de la propriété : - lecture seule |
| traceid | string | ID de la trace, partagé par tous les spans appartenant à la trace. Comportement de la propriété : - lecture seule |
| spanid | string | ID du 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 racine (par exemple, POST /zabbix.php).Comportement de la propriété : - lecture seule |
| span_kind | string | Rôle du span racine. 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 racine (par exemple, zabbix-nginx), 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 racine (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 racine. 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 racine (par exemple, http.method: POST).Comportement de la propriété : - lecture seule |
| duration | integer | Durée de la trace en nanosecondes. Comportement de la propriété : - lecture seule |
| status_code | string | État de l'opération représentée par le span racine. Valeurs possibles : Unset - aucun état explicite n'a été attribué au span racine ;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, sur l'état du span racine. Comportement de la propriété : - lecture seule |
| events | array | Tableau d'objets event du span racine, 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 link du span racine, qui pointent vers des spans associés dans la même trace ou dans une autre trace. Comportement de la propriété : - lecture seule |
| span_count | integer | Nombre total de spans dans la trace. Comportement de la propriété : - lecture seule |
| error_count | integer | Nombre de spans dans la trace dont status_code est défini sur Error.Comportement de la propriété : - lecture seule |
Événement
L'objet événement possède les propriétés suivantes.
| Property | Type | Description |
|---|---|---|
| timestamp | integer | Heure Unix (en nanosecondes) à laquelle l'événement s'est produit. Colonne de la source de données : Events.Timestamp |
| name | string | Nom de l'événement. Colonne de la source de données : Events.Name |
| attributes | object | Attributs clé-valeur contenant, le cas échéant, des informations supplémentaires sur l'événement. Colonne de la source de données : Events.Attributes |
Lien
L’objet lien possède les propriétés suivantes.
| Propriété | Type | Description |
|---|---|---|
| traceid | string | ID de la trace contenant le span lié. Colonne de la source de données : Links.TraceId |
| spanid | string | ID du span lié. Avec traceid, identifie de manière unique le span lié.Colonne de la source de données : Links.SpanId |
| trace_state | string | État de la trace, le cas échéant, du span lié (voir W3C Trace Context). Colonne de la source de données : Links.TraceState |
| attributes | object | Attributs clé-valeur contenant des informations supplémentaires sur le lien. Colonne de la source de données : Links.Attributes |