Empezando con las etiquetas (tags)

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.

El etiquetado vincula distintos tipos de datos en Datadog, lo cual hace posible la correlación y la llamada a la acción entre métricas, trazas y logs. Esto se logra con claves de etiquetas reservadas.

Clave de etiquetaQué permite
hostCorrelación entre métricas, trazas, procesos y logs.
deviceSegregación de métricas, trazas, procesos y logs por dispositivo o disco.
sourceFiltrado por tramos y creación automatizada de pipelines para la gestión de logs.
serviceControl sobre datos específicos de la aplicación en métricas, trazas y logs.
envControl sobre datos específicos de la aplicación en métricas, trazas y logs.
versionControl sobre datos específicos de la aplicación en métricas, trazas y logs.

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

    EtiquetaClaveValor
    env:staging:eastenvstaging:east
    env_staging:eastenv_stagingeast
  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:

MétodoAsignación de etiquetas
Archivos de configuraciónManualmente en tu Agent principal o en los archivos de configuración de la integración.
IUEn el sitio de Datadog.
APIAl usar la API de Datadog.
DogStatsDAl enviar métricas con DogStatsD.

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

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.

Utilización

Cuando tengas las etiquetas asignadas en el host y la integración, empieza a usarlas para filtrar y agrupar tus métricas, trazas y logs. Las etiquetas se utilizan en las siguientes áreas de tu plataforma Datadog.

ÁreaUso de las etiquetas para
Events (Eventos)Filtrar el flujo de eventos.
DashboardsFiltrar y agrupar métricas en gráficos.
Infrastructure (Infraestructura)Filtrar y agrupar en el mapa del host, la lista de infraestructuras, los Live Containers y las visualizaciones de Live Processes.
Monitors (Monitores)Crear y gestionar monitores, o controlar caídas del sistema.
Metrics (Métricas)Filtrar y agrupar en el navegador de métricas.
Integrations (Integraciones)Limitar opcionalmente las métricas de AWS, Google Cloud y Azure.
APMFiltrar servicios, trazas y perfiles, o navegar a otras áreas con el Mapa de servicios.
RUM y Session ReplayFiltrar la búsqueda de eventos, análisis, patrones, reproducciones y problemas en el navegador RUM.
Monitorización y pruebas continuas de SyntheticFiltra y agrupa las pruebas de Synthetic o las pruebas que se ejecutan en los pipelines CI con el explorador de monitorización y pruebas continuas de Synthetic.
NotebooksFiltrar y agrupar métricas en gráficos.
LogsFiltrar la búsqueda de logs, análisis, patrones, Live Tail y pipelines.
SLOsBuscar SLOs, SLOs basados en métricas agrupadas y SLOs basados en monitores agrupados.
Developers (Desarrolladores)Obtener información o configurar distintas áreas en la IU con la API.
Billing (Facturación)Generar informes sobre el uso de Datadog eligiendo hasta tres etiquetas, por ejemplo: env, team y account_id.
Visibilidad CIFiltra y agrupa ejecuciones de pruebas o pipelines con el explorador de visibilidad CI.

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

Leer más