Sémantique des tags de span

Présentation

Les bibliothèques de tracing de Datadog fournissent une assistance pour l’instrumentation d’un grand nombre de bibliothèques. Ces instrumentations génèrent des spans pour représenter des unités de travail logiques dans les systèmes distribués. Chaque span comporte des tags de span pour fournir des informations supplémentaires sur l’unité de travail qui survient dans le système. Des conventions de nommage décrivent le nom et le contenu pouvant être utilisés dans les évènements de spans.

Vous trouverez une liste complète de tous les tags de span, tous les attributs réservés et toutes les conventions de nommage dans la section Default Standard Attributes (en anglais).

Conventions de nommage pour les tags de span

Il existe un grand nombre de tags de span permettant de décrire ce qui se passe dans le système. Il existe par exemple des tags de span décrivant les domaines suivants :

  • Reserved : les attributs qui sont toujours présents dans chaque span.
  • Core : l’instrumentation utilisée et le type d’opération.
  • Network communications : les unités de travail correspondant aux communications du réseau.
  • HTTP requests : le client HTTP et les spans du serveur.
  • Database : les spans de la base de données.
  • Message queue : les spans du système de messagerie.
  • Remote procedure calls : les spans correspondant aux appels de procédure à distance, comme RMI ou gRPC.
  • Errors : les erreurs associées aux spans.

Pour en savoir plus, consultez la section Default Standard Attributes (en anglais).

Tags de span et attributs de span

Les tags de span et les attributs de span sont similaires mais leurs concepts sont différents :

Tags de span

Les tags de span correspondent au contexte de la span. Voici quelques exemples :

  • Tags de host : hostname, availability-zone, cluster-name
  • Tags de conteneur : container_name, kube_deployment, pod_name

Les tags sont généralement enrichis par d’autres sources de données, comme des tags provenant du catalogue d’hôte, de conteneur ou de service. Ces tags sont ajoutés à la span pour décrire le contexte. Par exemple, les tags peuvent décrire les propriétés de l’hôte et la provenance du conteneur de la span, ou les propriétés des services par lesquels la span est émise.

Pour rechercher des tags de span dans Datadog, accédez à l’onglet Infrastructure dans le volet latéral Trace :

Tags de span dans l'onglet Infrastructure.

Attributs de span

Les attributs de span correspondent au contenu de la span. voici quelques exemples :

  • http.url
  • http.status_code
  • error.message

Pour effectuer une requête d’attributs de span, utilisez le caractère @, suivi par le nom de l’attribut dans la zone de recherche. Par exemple, @http.url.

Pour rechercher des attributs de span dans Datadog, accédez à l’onglet Info du volet latéral Trace :

Attributs de span dans l'onglet Info.

Pour aller plus loin

PREVIEWING: brett0000FF/node-compatibility