Semántica de etiquetas de tramo

Información general

Las bibliotecas de rastreo de Datadog proporcionan compatibilidad predefinida para instrumentar una variedad de bibliotecas. Estas instrumentaciones generan tramos (spans) para representar unidades lógicas de trabajo en sistemas distribuidos. Cada tramo (span) consta de etiquetas (tags) de tramo para proporcionar información adicional sobre la unidad de trabajo que se realiza en el sistema. Las convenciones de nomenclatura describen el nombre y el contenido que puedes utilizar en eventos de tramo.

Para encontrar una lista completa de todas las etiquetas de tramo, atributos reservados y convenciones de nomenclatura, consulta Atributos estándar por defecto.

Convenciones de nomenclatura de etiqueta de tramo

Existe una gran variedad de etiquetas de tramo para describir el trabajo que se realiza en el sistema. Por ejemplo, existen etiquetas de tramo para describir los siguientes ámbitos:

  • Reservados: atributos que siempre están presentes en todos los tramos.
  • Principal: instrumentación utilizada y el tipo de operación.
  • Comunicaciones de red: unidades de trabajo correspondientes a comunicaciones de red.
  • Solicitudes HTTP: tramos de cliente HTTP y servidor.
  • Base de datos: tramos de base de datos.
  • Cola de mensajes: tramos de sistema de mensajería.
  • Llamadas a procedimientos remotos: tramos correspondiente a llamadas a procedimientos remotos, como RMI o gRPC.
  • Errores: errores asociados a tramos.

Para más información, consulta Atributos estándar por defecto.

Etiquetas de tramo y atributos de tramo

Las etiquetas de tramo y los atributos de tramo son conceptos similares, pero distintos:

Etiquetas de tramo

Las etiquetas de tramo son el contexto que rodea al tramo. Algunos ejemplos son:

  • Etiquetas de host: hostname, availability-zone, cluster-name
  • Etiquetas de contenedor: container_name, kube_deployment, pod_name

Las etiquetas suelen enriquecerse a partir de otras fuentes de datos, como etiquetas procedentes de host, contenedor o catálogo de servicios. Estas etiquetas se añaden al tramo para describir el contexto. Por ejemplo, las etiquetas pueden describir las propiedades de host y contenedor de las que procede el tramo, o las propiedades de servicio de las que se emite el tramo.

Para encontrar etiquetas de tramo en Datadog, ve a la pestaña Infrastructure (Infraestructura) en el panel lateral Trace (traza):

Etiquetas de tramo en la pestaña Infraestructura.

Atributos de tramo

Los atributos de tramo son el contenido del tramo. Algunos ejemplos son:

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

Para consultar los atributos de tramo, utiliza el carácter @ seguido del nombre del atributo en la casilla de búsqueda. Por ejemplo, @http.url.

Para encontrar los atributos de tramo en Datadog, ve a la pestaña Info (Información) en el panel lateral Trace (Traza):

Atributos de tramo en la pestaña Información.

Leer más