Migración a las características de eventos nuevas

El flujo de eventos y los monitores de eventos heredados de Datadog se retirarán el 30 de junio de 2022. Datadog está migrando a todos los clientes a una experiencia de eventos nueva y mejorada. Esta página contiene información importante sobre esta migración. Antes de la fecha de retiro, sigue los pasos de esta página para asegurarte de que tus visualizaciones y monitores de eventos existentes sigan funcionando de manera correcta.

¿Por qué cambiar las características de eventos?

Lanzado hace más de 10 años, el flujo de eventos de Datadog es una de sus primeras características. La experiencia de eventos nueva incluye muchas características nuevas que te permiten obtener aún más valor de los eventos. Estas incluyen el análisis de eventos, la capacidad de generar métricas a partir de tus eventos, la capacidad de crear pipelines para posprocesar eventos y una sintaxis de consulta mucho más fácil de utilizar e intuitiva que está mejor alineada con otros productos de Datadog, como Log Management y APM.

¿Cuál es el cronograma de migración?

Marzo de 2022: se puede acceder a los Events Explore y Analytics nuevos. Datadog comienza a migrar dashboards y monitores de clientes que no se gestionan con las API.

5 de mayo de 2022: el flujo de eventos se retira en favor del Event Explorer.

19 de mayo de 2022: a partir de esta fecha, si bien Datadog sigue evaluando los monitores de eventos que no se han migrado, ya no se pueden editar. Los monitores de eventos nuevos deben utilizar la sintaxis nueva.

30 de junio de 2022: Datadog deja de evaluar los monitores de eventos que no se han migrado. Los monitores de eventos heredados dejan de funcionar.

¿Qué acciones debo tomar?

Si no gestionas tus dashboard o monitores mediante herramientas externas basadas en API (como Terraform o scripts), no tendrás que hacer nada. Datadog migrará tus dashboards y monitores antes del 30 de abril de 2022. Además, dejará tus monitores antiguos, pero se silenciarán y se dejará de evaluarlos a más tardar el 30 de junio de 2022.

Si utilizas Terraform u otros scripts basados en API para gestionar todos o algunos de tus dashboards, Datadog migrará las consultas en los widgets y superposiciones de tus eventos a la sintaxis nueva, pero tendrás que actualizar los scripts para mantenerlos sincronizados antes del 30 de junio de 2022.

Si utilizas Terraform u otros scripts basados en API para gestionar todos o algunos de tus monitores, tienes hasta el 30 de junio de 2022 para actualizarlos. Después de esta fecha, Datadog creará versiones nuevas de cualquier monitor no migrado y silenciará los monitores existentes para garantizar que continúes recibiendo alertas.

Datadog también puede ayudarte a migrar los monitores al sugerirte actualizaciones o al aplicar estas actualizaciones a tus monitores.

¿Qué hay de nuevo?

Events Explorer

El Events Explorer muestra los eventos más recientes generados por tu infraestructura y servicios o alertas de monitorización. Reemplaza el flujo de eventos y proporciona una sintaxis de consulta más fácil de utilizar e intuitiva. Consulta la sección de Events Explorer para obtener más información.

Event Analytics

Visualización de Events Analytics filtrada por 'source:cloudtrail'

Además de ver y buscar eventos en el Explorer, ahora puedes realizar gráficas como la serie temporal, lista principal o tabla y agrupar el número de eventos para una consulta determinada. Consulta la sección de Event Analytics para obtener más información.

También puedes generar métricas con retención de 15 meses a partir de cualquier consulta de búsqueda de eventos para crear monitores y alertas basados en eventos históricos.

Imagen de métricas con la consulta de búsqueda de eventos.

Graficar eventos en dashboards

Events Analytics

Ahora puedes graficar eventos para una consulta determinada en tus dashboards como una gráfica de serie temporal, valor de consulta, lista principal, tabla y mucho más.

Por ejemplo, consulta el dashboard de Información general sobre las notificaciones de monitorización, que analiza las tendencias de los eventos de alerta de monitorización para ayudarte a mejorar la configuración y reducir la fatiga de alertas.

Experiencia de monitores de eventos nueva

Los monitores de eventos se han adaptado para utilizar el mismo conjunto estandarizado de características que otros productos (logs, RUM, APM) y tienen capacidades adicionales.

Al crear monitores de eventos, el campo de búsqueda de consultas nuevo utiliza la función de autocompletar, en lugar de la consulta heredada para completar espacios en blanco.

Interfaz de usuario nueva para la sintaxis de consulta de monitores

La búsqueda de consultas nueva te permite utilizar consultas complejas en monitores de eventos con funcionalidades nuevas, como operadores booleanos o comodines.

Pipelines

Datadog analiza de manera automática los eventos con formato JSON. Cuando los eventos no tienen formato JSON, se analizan y enriquecen al encadenarlos de manera secuencial a través de un pipeline de procesamiento. Los procesadores extraen información o atributos significativos del texto semiestructurado para reutilizarlos como facetas. Cada evento que pasa por los pipelines se prueba con cada filtro de pipeline. Si coincide con un filtro, todos los procesadores se aplican de manera secuencial antes de pasar al siguiente pipeline.

Atributos reservados

En esta lista se describen los atributos reservados ingeridos de manera automática con eventos.

AtributoDescripción
hostEl nombre del host de origen como se define en las métricas. Datadog recupera de manera automática las etiquetas de host correspondientes del host coincidente en Datadog y las aplica a tus eventos. El Agent establece este valor de manera automática.
sourceCorresponde al nombre de la integración, o a la tecnología de la que procede el evento. Cuando coincide con el nombre de una integración, Datadog instala de manera automática los analizadores y facetas correspondientes. Por ejemplo: nginx y postgresql, entre otros.
statusCorresponde al nivel o gravedad de un evento.
serviceEl nombre de la aplicación o servicio que genera los eventos.
messageDe manera predeterminada, Datadog ingiere el valor del atributo message como el cuerpo de la entrada del evento.

¿Qué ha cambiado?

Nota: El proceso para enviar eventos sigue siendo el mismo. Puedes continuar enviando eventos mediante la API, el Agent o la característica de eventos por correo electrónico como antes.

Las agregaciones de eventos ya no se realizan ni se muestran en la interfaz de usuario

Datadog ya no realiza la agregación de eventos de manera automática, y ya no agrupa los eventos por el atributo aggregation_key. La interfaz de usuario ya no muestra la agregación de eventos.

Los comentarios de los eventos ya no se admiten ni se muestran en la interfaz de usuario

Los comentarios creados mediante la API con el tipo de evento user_update se mostrarán como eventos normales.

Reasignación de estados en las consultas

Algunos valores de estado han cambiado:

Estado heredadoEstado nuevo
success (correcto)ok (correcto)
warning (advertencia)warn (advertencia)
info (información)info (información)
errorerror

Reasignación de fuentes en las consultas

Muchos nombres de fuentes de eventos han cambiado. Consulta la lista completa de nombres de fuentes afectados.

El período de evaluación de monitores se ha limitado a 48 horas

Tus monitores no se evalúan más allá de un período de 48 horas. Si necesitas utilizar un período de evaluación más largo, puedes generar métricas personalizadas a partir de eventos y utilizar un monitor de métricas, en el que el período de evaluación puede ser de hasta un mes.

Solo puedes agrupar un máximo de 4 facetas

(Anteriormente: grupos ilimitados) Los valores principales, los valores de mayor frecuencia de un grupo, se limitan en función de la cantidad total de grupos. Por ejemplo, si un monitor se activa más veces que el límite de facetas, se ordena por grupo principal y solo muestra los grupos N principales. Por ejemplo, N = 30 hosts resultantes si se agrupa por dos facetas y una faceta es host.

  • Una faceta da lugar a un límite de 1000 valores principales.
  • Dos facetas dan como resultado un límite de 30 valores principales por faceta (como máximo 900 grupos)
  • Tres facetas dan como resultado un límite de 10 valores principales por faceta (como máximo 1000 grupos)
  • Cuatro facetas dan como resultado un límite de 5 valores principales por grupo (como máximo 625 grupos)

Ya no se admiten umbrales de recuperación en los monitores

Los umbrales de los monitores de eventos ya no admiten los tipos de umbral warning_recovery y critical_recovery. Se deben eliminar los umbrales de recuperación en los monitores de eventos nuevos.

Si utilizas estas características, ponte en contacto con el equipo de asistencia para que te ayude a encontrar una solución alternativa.

Ejemplos

Ejemplos del antes y después de la sintaxis de consulta de eventos

Mostrar eventos de GitHub o Chef
Sintaxis heredada
sources:github,chef
Sintaxis nueva
source:(github OR chef)
Mostrar eventos etiquetados con env-prod
Sintaxis heredada
tags:env-prod
Sintaxis nueva
tags:env-prod
Mostrar eventos etiquetados con #env-prod o #db
Sintaxis heredada
tags:env-prod,db, tags:env-prod OR db
Sintaxis nueva
tags:(env-prod OR db)
Mostrar eventos etiquetados con #security-group:sg-123 y #role:common-node
Sintaxis heredada
tags:security-group:sg-123 AND role:common-node
Sintaxis nueva
tags:(security-group:sg-123 AND role:common-node)
Utilizar comodines para buscar prefijos y sufijos
Sintaxis heredada
No disponible
Sintaxis nueva
*web coincide con todos los mensajes de eventos que terminan en web
source:amazon* coincide con todos los eventos cuya fuente comienza con amazon

Ejemplos del antes y después de la sintaxis de la API de los monitores de eventos

La API de los monitores de eventos tiene una sintaxis de consulta de monitores nueva (repasa la sección de «Consulta de alertas de eventos V2»), con métodos de rollup de promedio y cardinalidad y menos atributos requeridos.

Ningún evento de Slack en las últimas 24 horas
Sintaxis heredada
events('priority:all sources:slack').rollup('count').last('1d') < 1
Sintaxis nueva
events("source:slack").rollup("count").last("1d") < 1
Instancia EC2 marcada para mantenimiento
Sintaxis heredada
events('priority:all "Upcoming AWS maintenance event"').by('name,host').rollup('count').last('2d') >= 1
Sintaxis nueva
events("Upcoming AWS maintenance event").rollup("count").by("name,host").last("2d") >= 1
Zabbix o Prometheus han activado una alerta por un servicio hoy
Sintaxis heredada
events('tags:service priority:all status:error sources:prometheus sources:zabbix).rollup('count').last('1d') > 0
Sintaxis nueva
events("source:(prometheus OR zabbix) status:error tags:service").rollup("count").last("1d") > 0
No se recibieron eventos en un centro de datos para el servicio datadog-agent
Sintaxis heredada
Los monitores de eventos heredados no admiten el rollup de cardinalidad.
Sintaxis nueva
events("service:datadog-agent").rollup("cardinality", "datacenter").by("service").last("15m") < 1

Leer más

Additional helpful documentation, links, and articles: