Empezando con las etiquetas (tags)
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 etiqueta | Qué permite |
|---|
host | Correlación entre métricas, trazas, procesos y logs. |
device | Segregación de métricas, trazas, procesos y logs por dispositivo o disco. |
source | Filtrado por tramos y creación automatizada de pipelines para la gestión de logs. |
service | Control sobre datos específicos de la aplicación en métricas, trazas y logs. |
env | Control sobre datos específicos de la aplicación en métricas, trazas y logs. |
version | Control 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:
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.
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).
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.
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 |
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.
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étodo | Asignación de etiquetas |
|---|
| Archivos de configuración | Manualmente en tu Agent principal o en los archivos de configuración de la integración. |
| IU | En el sitio de Datadog. |
| API | Al usar la API de Datadog. |
| DogStatsD | Al 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.
| Área | Uso de las etiquetas para |
|---|
| Events (Eventos) | Filtrar el flujo de eventos. |
| Dashboards | Filtrar 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. |
| APM | Filtrar servicios, trazas y perfiles, o navegar a otras áreas con el Mapa de servicios. |
| RUM y Session Replay | Filtrar la búsqueda de eventos, análisis, patrones, reproducciones y problemas en el navegador RUM. |
| Monitorización y pruebas continuas de Synthetic | Filtra 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. |
| Notebooks | Filtrar y agrupar métricas en gráficos. |
| Logs | Filtrar la búsqueda de logs, análisis, patrones, Live Tail y pipelines. |
| SLOs | Buscar 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 CI | Filtra 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
Más enlaces, artículos y documentación útiles:
