Semántica de etiquetas de tramo
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):
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
Additional helpful documentation, links, and articles: