Información general

Las etiquetas son una forma de añadir dimensiones a las telemetrías de Datadog para que puedan filtrarse, agregarse y compararse en las visualizaciones de Datadog. Usar etiquetas te permite observar el rendimiento conjunto en varios hosts y, de manera opcional, reducir ese conjunto en función de ciertos elementos. En resumen, el etiquetado es un método para observar puntos de datos de manera conjunta.

Las etiquetas son pares key:value que contienen dos partes:

• La clave de etiqueta es el identificador. La clave de etiqueta sólo puede existir una vez en cada recurso y distingue entre mayúsculas y minúsculas.
• El valor de etiqueta son los datos específicos o la información asociada a la clave. Los valores de etiqueta no son únicos por recurso y pueden utilizarse en muchos recursos en un par key-value.

El etiquetado vincula distintos tipos de datos en Datadog, lo que permite la correlación y las llamadas a la acción entre métricas, trazas (traces) y logs. Esto se consigue con claves de etiqueta reservadas:

Datadog recomienda analizar los contenedores, las máquinas virtuales y la infraestructura en la nube de forma conjunta a nivel de service. Por ejemplo, puedes observar el uso de la CPU en una serie de hosts que represente un servicio, en lugar del uso de la CPU para el servidor A o B por separado.

Puesto que los contenedores y entornos en la nube se renuevan con frecuencia en los hosts, es importante usar etiquetas para agregar las métricas.

Definir etiquetas

Estos son los requisitos de etiquetado de Datadog:

1. Las etiquetas deben empezar por una letra y pueden incluir lo siguiente:

   • Caracteres alfanuméricos
   • Guiones bajos
   • Signos de resta
   • Dos puntos
   • Puntos
   • Barras

   Los demás caracteres especiales se convertirán en guiones bajos.

2. Las etiquetas pueden tener hasta 200 caracteres y admiten letras Unicode (que incluyen la mayoría de conjuntos de caracteres, incluidos idiomas como el japonés).

3. Las etiquetas se cambiarán a minúsculas. Por tanto, no se recomiendan las etiquetas CamelCase. Las integraciones basadas en (un rastreador de) autenticación convierten ese tipo de ortografía en guiones bajos. Ejemplo: TestTag –> test_tag.

4. Una etiqueta puede estar en formato value o <KEY>:<VALUE>. Las claves de etiquetas más utilizadas son env, instance y name. La clave siempre precede a los primeros dos puntos de la definición de la etiqueta global. Ejemplo:

   Etiqueta	Clave	Valor
   env:staging:east	env	staging:east
   env_staging:east	env_staging	east

5. Las etiquetas no deben originarse en fuentes sin enlazar, como marcas de tiempo epoch, ID de usuario o ID de solicitud. De ser así, la cantidad de métricas podría aumentar infinitamente en tu organización y afectar a tu facturación.

6. Las limitaciones (como el cambio a minúsculas) solo se aplican a las etiquetas de métricas, no a los atributos de logs ni a las etiquetas de tramos.

Asignación de etiquetas

Métodos de etiquetado

Las etiquetas se pueden asignar con cualquiera de los siguientes métodos o con todos ellos:

Para más información, consulta la sección Asignar etiquetas.

Etiquetado de servicios unificado

Datadog recomienda utilizar el etiquetado de servicios unificado al asignar etiquetas. Este sistema asocia toda la telemetría de Datadog mediante el uso de tres etiquetas estándar: env, service y version. Para saber cómo configurar tu entorno con el etiquetado unificado, consulta la sección Etiquetado de servicios unificado.

Herencia de etiquetas

Todas las métricas, logs, trazas e integraciones pasan por un proceso de herencia de host-tag a medida que los datos se introducen en Datadog. Dado que los datos están asociados a un nombre de host determinado, esos componentes heredan todas las etiquetas host-level asociadas a ese host. Estas etiquetas son visibles en la lista de infraestructura de un host determinado, y proceden del proveedor de la nube o del Datadog Agent. Consulta las etiquetas host-level faltantes en nuevos hosts o nodos para más información.

Precedencia de las etiquetas

El Datadog Agent no impone un orden de precedencia para las etiquetas establecidas a partir de diferentes fuentes. En su lugar, el Agent recopila todas las etiquetas de cada fuente disponible, almacena cada valor único para una clave de etiqueta determinada y los emite todos con la telemetría.

Esto significa que una misma clave de etiqueta puede tener varios valores si está configurada de forma diferente en las distintas fuentes. Por ejemplo, si la etiqueta service se establece como payments en una variable de entorno, checkout en el YAML Agent y orders en una configuración de cliente de rastreo, la telemetría para ese servicio podría incluir:

service:payments
service:checkout
service:orders

Los filtros o dashboards descendentes deben filtrar explícitamente el valor deseado si solo se espera uno.

Utilización

Después de haber asignado etiquetas a nivel de host e integración, comienza a utilizarlas para filtrar y agrupar tus métricas, trazas y logs. Las etiquetas se utilizan en las siguientes áreas de tu plataforma Datadog.

Para obtener más información, consulta la sección Uso de etiquetas.

Referencias adicionales

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

Descubre cómo asignar etiquetasDOCUMENTACIÓN Descubre cómo configurar el etiquetado de servicios unificadoDOCUMENTACIÓN Descubre cómo usar las etiquetasDOCUMENTACIÓN Participa en una sesión interactiva sobre la eficacia del etiquetado con DatadogHABILITAR LOS FUNDAMENTOS