Información general

Una vez que hayas asignado las etiquetas, podrás empezar a utilizarlas para filtrar y agrupar los datos en tu plataforma de Datadog. Las etiquetas sirven para incluir o excluir datos.

Cuándo incluir o excluir varias etiquetas:

  • Para incluirlas, se emplea la lógica AND
  • Para excluirlas, se emplea la lógica OR

Eventos

El explorador de eventos muestra los eventos de tu entorno que tienen lugar durante un determinado periodo de tiempo. Utiliza etiquetas para filtrar la lista de eventos y centrarte en un subconjunto de eventos. Introduce tags: seguido de una etiqueta para ver todos los eventos procedentes de un host, una integración o un servicio que tengan esa misma etiqueta. Por ejemplo, puedes utilizar tags:service:coffee-house para buscar la etiqueta service:coffee-house.

Para buscar varias etiquetas de forma inclusiva, haz uso de los paréntesis y separa las etiquetas entre sí con OR: tags:(service:coffee-house OR host:coffeehouseprod). Para buscar varias etiquetas de forma exclusiva, sepáralas entre sí con AND: tags:(service:coffee-house AND host:coffeehouseprod).

Dashboards

Utiliza etiquetas para filtrar métricas y mostrarlas en un dashboard gráfico o para crear grupos añadidos de métricas para mostrar. Para filtrar las métricas que se van a mostrar, introduce la etiqueta en el cuadro de texto from (desde). Esta métrica se muestra en todas las fuentes que tienen asignada esa etiqueta particular (service:web-store, en el ejemplo de abajo).

Filtra métricas en dashboards añadiendo una etiqueta en el campo 'from'. En este ejemplo, la métrica se filtra por 'service:web-store'

También se pueden filtrar valores de etiquetas de forma avanzada con filtros booleanos. Se admite la siguiente sintaxis booleana:

  • NOT, !
  • AND, ,
  • OR
  • key IN (tag_value1, tag_value2,...)
  • key NOT IN (tag_value1, tag_value2,...)

Utiliza AND y ORs para consultar una métrica en varias etiquetas concretas:

Filtro booleano con AND/OR

Utiliza IN y NOT IN para filtrar rápidamente una métrica en función de varias etiquetas concretas:

Filtro booleano con IN/NOT IN

Para crear un grupo conjunto utilizando etiquetas, introduce la parte clave de la etiqueta en el cuadro de texto avg by. Por ejemplo, si tienes un gráfico de series temporales que muestra una métrica etiquetada con la clave service, como service:web-store, introduce service en el cuadro de texto avg by para mostrar una línea por cada valor de etiqueta service. Cada línea representa el valor promedio de métrica en todas las fuentes que comparten ese valor de etiqueta service.

Etiquetas en cuadros de texto avg by de dashboards

Las etiquetas también pueden utilizarse para superponer eventos en el dashboard. Esto funciona de la misma manera que en el explorador de eventos. Las coincidencias de eventos se superponen como barras verticales en el gráfico. En el ejemplo siguiente se utiliza service:web-store.

Utiliza etiquetas para añadir superposiciones de eventos en dashboards

Utiliza las variables de plantilla para ahorrar tiempo al cambiar la etiqueta from (desde) en los gráficos de tu dashboard. En el ejemplo de abajo, se utiliza service para representar la clave de la etiqueta service. Para utilizar la variable de plantilla, añade la variable $service en el campo de texto from de tu consulta del gráfico.

Variables de plantillas de dashboards

Este es un ejemplo de etiquetas que utilizan el editor de gráficos de series temporales. En la primera captura de pantalla no se han aplicado etiquetas y se muestra el uso promedio de CPU en todos los hosts:

Editor de gráficos de series temporales sin etiquetas añadidas

Luego, el editor se actualiza para incluir una etiqueta (region:eastus) en el cuadro de texto from (desde), que permite a Datadog ver el uso de CPU en toda la región este de los EE. UU. Aquí, la etiqueta region se utiliza como ejemplo, pero puedes usar cualquier etiqueta arbitraria que se envíe a tu plataforma Datadog, incluyendo application, service o environment.

Editor de gráficos de series temporales filtrado por la etiqueta region:us-east-1

Por último, se utiliza el segundo campo vacío (el campo de texto avg by) para mostrar una línea cronológica independiente por cada host. Por tanto, podemos ver la CPU del servidor de todos los hosts activos en el este de EE. UU.

Editor de gráficos de series temporales filtrado por 'region:us-east-1' y agrupado por 'host'

Si es necesario, añade más etiquetas para acotar aún más el contexto; por ejemplo, hosts en region:eastus y env:production. Las etiquetas pueden utilizarse en toda la plataforma de Datadog y aplicarse a todos los elementos principales (métricas, trazas y logs).

Infraestructura

Para filtrar el mapa de hosts, la lista de infraestructuras, los contenedores y los procesos, introduce una etiqueta en el campo de texto Filter by (Filtrar por), situado en la parte superior de la página. Los hosts y los contenedores se pueden agrupar por clave de etiqueta mediante el campo de texto Group by (Agrupar por). Si introduces service en el campo de grupo, verás cada servicio como un encabezado de grupo.

En esta sección, utiliza etiquetas para filtrar o agrupar hosts:

Etiquetas de mapa de hosts

O contenedores:

Etiquetas de mapa de contenedores

Estos son los campos de texto para filtrar o agrupar de la página de la lista de infraestructuras:

Etiquetas de la lista de infraestructuras

Estos son los campos de texto para filtrar o agrupar de la página de Live Containers:

Etiquetas de Live Containers

Estos son los campos de texto para filtrar o agrupar de la página de Live Processes:

Etiquetas de Live Processes

Monitores

Para filtrar monitores y tiempos de inactividad de monitores por etiquetas asignadas, utiliza la barra de búsqueda o las casillas de verificación de facetas. El formato de la barra de búsqueda es tag:<KEY>:<VALUE>; por ejemplo: tag:service:coffee-house. Para excluir de tu búsqueda monitores con etiquetas específicas, utiliza -, for example: tag:-service:coffee-house.

Filtra monitores en la barra de búsqueda con etiquetas

Nota: Las etiquetas de monitores son diferentes y están separadas de las etiquetas de métricas. Para más información, consulta la documentación sobre etiquetas de monitores.

Al crear un nuevo monitor, utiliza etiquetas de métricas en:

  • el campo de texto from (desde), para limitar el contexto del monitor solo a las métricas que tengan esas etiquetas.
  • el campo de texto excluding (excluido), para eliminar las métricas correspondientes del contexto del monitor.
  • el campo de texto avg by, para transformar el monitor en un monitor multi-alerta en cada valor de la etiqueta.

Métricas

Utiliza etiquetas en el explorador de métricas para filtrar métricas por etiquetas o para mostrar múltiples gráficos por clave de etiqueta. En el siguiente ejemplo se representa un gráfico de métrica sobre service:web-store.

Gráfico de métricas centrado en una etiqueta individual

Integraciones

Algunas integraciones te ofrecen la opción de limitar las métricas utilizando etiquetas.

El cuadro de integración de AWS tiene los filtros de etiquetas to hosts with tag y to Lambdas with tag.

Estos campos aceptan una lista de etiquetas separadas por comas (en formato <KEY>:<VALUE>), que defina un filtro, el cual se utiliza para recopilar tus recursos de EC2 o Lambda. Puedes utilizar <KEY>:<VALUE>, tanto para incluir como para excluir funciones de monitorización basadas en etiquetas. Para indicar qué etiqueta debe excluirse, añade un signo ! antes de la clave de etiqueta. También puedes utilizar comodines, como ? (para caracteres únicos) y * (para varios caracteres).

Los filtros pueden incluir recursos mediante una sentencia OR siempre que haya una etiqueta de inclusión presente. El filtro del siguiente ejemplo recopila instancias de EC2 que contienen la etiqueta datadog:monitored o env:production:

datadog:monitored,env:production

Si has definido la exclusión de una etiqueta, esta preferencia tendrá prioridad y dará lugar a una sentencia AND. El filtro del siguiente ejemplo recopila instancias de EC2 que contienen las etiquetas datadog:monitored o env:production, o bien una etiqueta instance-type con un valor c1.*, y no una etiqueta region:us-east-1:

datadog:monitored,env:production,instance-type:c1.*,!region:us-east-1

Obtén más información sobre el etiquetado de AWS en la documentación acerca de EC2 y Lambda.

El cuadro de integración de Azure tiene el filtro de etiqueta Optionally filter to VMs with tag.

Este campo acepta una lista de etiquetas separadas por comas (en formato <KEY>:<VALUE>), que defina un filtro, el cual se utiliza para recopilar métricas de las máquinas virtuales de Azure. También puedes utilizar comodines, como ? (para caracteres únicos) y * (para varios caracteres). Solo se importarán a Datadog las máquinas virtuales que coincidan con una de las etiquetas definidas y se ignorarán las demás.

También se podrán excluir las máquinas virtuales que coincidan con una etiqueta determinada, siempre que se añada ! antes de la etiqueta. Por ejemplo:

datadog:monitored,env:production,!env:staging,instance-type:c1.*

El cuadro de integración de Google Cloud tiene el filtro de etiqueta to hosts with tag.

Este campo acepta una lista de etiquetas (labels) de GCP separadas por comas (en formato <KEY>:<VALUE>) que defina un filtro, el cual se utiliza para recopilar métricas de las máquinas virtuales de GCP. También puedes utilizar comodines, como ? (para caracteres únicos) y * (para varios caracteres). Solo se importarán a Datadog los hosts que coincidan con una de las etiquetas definidas y se ignorarán los demás.

Puedes excluir los hosts que coincidan con una etiqueta (label) determinada, siempre que añadas ! antes de la etiqueta (tag). Ejemplo:

datadog:monitored,env:production,!env:staging,instance-type:c1.*

Obtén más información sobre cómo crear y gestionar etiquetas (labels) en la documentación de Google Cloud.

APM

En Trace Explorer, puedes filtrar las trazas con etiquetas utilizando la barra de búsqueda o las casillas de verificación de facetas. El formato de la barra de búsqueda es <KEY>:<VALUE>; por ejemplo, service:coffee-house. Para realizar una búsqueda avanzada, consulta la sección Sintaxis de las consultas.

Etiquetas del Trace Explorer

Tras asignar las etiquetas, utiliza el mapa de servicios para navegar a distintas partes de la aplicación haciendo clic en un servicio concreto. En el ejemplo de abajo, puedes consultar los análisis, los monitores, los logs y el mapa de host filtrados en función de la etiqueta service:coffee-house.

Etiquetas de mapa de servicios

Notebooks

Al crear un gráfico del notebook, utiliza etiquetas en el campo de texto from (from) para limitar las métricas. Utilízalas también en el campo de texto avg by para agrupar las métricas. En el ejemplo de abajo, las métricas están limitadas por service:coffee-house y agrupadas por host.

Etiquetas de notebooks

Si quieres excluir etiquetas, edita el texto con </> y, a continuación, añade la etiqueta en cuestión en formato !<KEY>:<VALUE>. En el ejemplo de abajo, se utiliza !service:coffeehouse para excluir service:coffeehouse.

Logs

Para la búsqueda (Search), el análisis (Analytics), los patrones (Patterns) y Live Tail de los logs, filtra las trazas con etiquetas utilizando la barra de búsqueda o las casillas de verificación de facetas. El formato de la barra de búsqueda es <KEY>:<VALUE>; por ejemplo, service:coffee-house. Para realizar una búsqueda avanzada, consulta la página Buscar logs.

Etiquetas de búsqueda de logs
Etiquetas de análisis de logs
Etiquetas de patrones de logs

Las etiquetas también se pueden utilizar para filtrar un pipeline de logs. En el ejemplo de abajo, el pipeline filtra los logs en función de la etiqueta service:coffee-house.

Etiquetas de pipeline

RUM y Session Replay

El navegador RUM muestra los eventos de tu entorno que tienen lugar durante un determinado periodo de tiempo.

Para filtrar los datos de los eventos de RUM por etiquetas, utiliza la barra de búsqueda o las casillas de verificación de facetas. El formato de la barra de búsqueda es <KEY>:<VALUE>; por ejemplo, service:shopist. Para realizar una búsqueda avanzada, consulta la sección Buscar eventos de RUM.

Etiquetas de RUM

Synthetics

Puedes ver tus pruebas de Synthetic en la página Pruebas de Synthetic.

Para filtrar las pruebas por etiquetas, utiliza la barra de búsqueda o las casillas de verificación de facetas. El formato de la barra de búsqueda es <KEY>:<VALUE>; por ejemplo, tag:mini-website. Para realizar una búsqueda avanzada, consulta la sección Buscar y gestionar pruebas de Synthetic.

Etiquetas de Synthetics

El explorador de monitorización y prueba continua de Synthetic muestra tus ejecuciones y lotes de ejecuciones de pruebas en un pipeline CI.

Para filtrar las pruebas por etiquetas, utiliza la barra de búsqueda o las casillas de verificación de facetas. El formato de la barra de búsqueda es <KEY>:<VALUE>; por ejemplo: @ci.provider.name:github. Para realizar una búsqueda avanzada, consulta Buscar lotes de pruebas.

Etiquetas de Synthetics y CI

Objetivos de nivel de servicio (SLOs)

Para filtrar los SLOs según sus etiquetasasignadas, puedes utilizar la barra de búsqueda o las casillas de verificación de facetas. El formato de la barra de búsqueda es <KEY>:<VALUE>; por ejemplo, journey:add_item. Para excluir de tu búsqueda los SLOs que tengan una etiqueta específica, utiliza -, for example: -journey:add_item.

Etiquetas de SLOs

Las etiquetas de SLOs son diferentes e independientes de las etiquetas de métricas y monitores que se emplean en las métricas o monitores subyacentes de un SLO.

Al crear un SLO basado en métricas, utiliza las etiquetas de métricas en las consultas de métricas sobre el porcentaje de éxito del SLO (todas las métricas deben utilizar el mismo conjunto de etiquetas de métricas):

  • el campo de texto from (desde), para limitar el contexto de la métrica solo a esas etiquetas.
  • el campo de texto sum by (sumar por), para crear un SLO basado en métricas y agrupado para mostrar un porcentaje de estado, así como el presupuesto restante para subsanar errores del SLO general y de cada valor de etiqueta.

Al crear un SLO basado en monitores con un solo monitor agrupado, utiliza la opción Calculate on selected groups (Calcular según los grupos seleccionados) para seleccionar hasta 20 valores de etiquetas de monitores subyacentes y mostrar un porcentaje de estado, así como el presupuesto restante para subsanar errores del SLO general y de cada valor de etiqueta:

Etiquetas de SLO basadas en monitores

CI Visibility

El explorador de visibilidad CI muestra tus pruebas ejecutadas en un pipeline CI.

Para filtrar las pruebas por etiquetas, utiliza la barra de búsqueda o las casillas de verificación de facetas. El formato de la barra de búsqueda es <KEY>:<VALUE>; por ejemplo: @test.status:failed. Para realizar una búsqueda avanzada, consulta Buscar y gestionar pruebas de CI.

Ejecuta pruebas en el explorador de visibilidad CI

El explorador de visibilidad CI muestra las ejecuciones de tu pipeline CI.

Para filtrar las ejecuciones de pipeline por etiquetas, utiliza la barra de búsqueda o las casillas de verificación de facetas. El formato de la barra de búsqueda es <KEY>:<VALUE>; por ejemplo: @ci.provider.name:gitlab. Para realizar una búsqueda avanzada, consulta Buscar y gestionar pipelines CI.

Ejecuciones de pipelines en el explorador de visibilidad CI

Desarrolladores

Las etiquetas pueden utilizarse de diferentes formas con la API.

Consulta esta lista para encontrar los enlaces a cada una de las siguientes secciones:

Lectura adicional