Información general

Las bibliotecas de rastreo de Datadog proporcionan compatibilidad predefinida para instrumentar una variedad de librerías. 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.

Convenciones de nomenclatura de etiqueta de tramo

Existe una gran variedad de span tags para describir el trabajo que se realiza en el sistema. Por ejemplo, existen span tags 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 span tags y los atributos de tramo son conceptos similares, pero distintos:

• Las span tags son el contexto alrededor del tramo.
• Los atributos de tramo son el contenido del tramo.

Etiquetas de tramo

Las span tags 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 span tags en Datadog, ve a la pestaña Infrastructure (Infraestructura) en el panel lateral Trace (traza):

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):

Leer más

Más enlaces, artículos y documentación útiles:

Más información sobre los atributos estándar de Log ManagementDOCUMENTACIÓN Datos recopilados para el navegador RUMDOCUMENTACIÓN Aprender a explorar tus trazasDOCUMENTACIÓN