Configure los seguimientos.
Descripción general
Para comenzar a configurar el seguimiento, complete lo siguiente:
- Define the search query: Construya una consulta para contar eventos, medir métricas, agrupar por una o varias dimensiones y más.
- Set alert conditions: Defina los umbrales de alerta y de advertencia, los periodos de tiempo de evaluación y configure las opciones avanzadas de alerta.
- Configure notifications and automations: Escriba un título y un mensaje de notificación personalizados con variables. Elija cómo se envían las Notifications a sus equipos (correo electrónico, Slack o PagerDuty). Incluya automatizaciones de flujo de trabajo o casos en la notificación de alerta.
- Define permissions and audit notifications: Configure controles de acceso granulares y designe roles y usuarios específicos que puedan editar un seguimiento. Habilite las Notifications de auditoría para alertar si se modifica un seguimiento.
Defina la consulta de búsqueda
Para aprender a construir la consulta de búsqueda, consulte las páginas de tipos de seguimiento individuales.
Vista previa de gráficos
A medida que crea o modifica su consulta, el gráfico de vista previa en la parte superior de la configuración se actualiza dinámicamente para reflejar los resultados en tiempo real.
El gráfico Evaluated Data muestra cómo su seguimiento habría evaluado los datos usando su consulta y umbrales actuales. Con la vista previa de evaluación, puede
- Vea las transiciones de estado históricas (por ejemplo,
OK → ALERT). - Entienda cómo se habría comportado su seguimiento.
- Obtenga una vista previa de quién sería notificado (incluyendo las reglas de notificación)
- Detecte rápidamente configuraciones erróneas antes de guardar.
Esta función es compatible con seguimientos de Metrics, Logs, APM, RUM, Eventos, Auditoría, Base de datos, Agent Observability y Despliegue.
El gráfico Source Data muestra las series temporales sin procesar o el resultado de la consulta para su seguimiento, sin ninguna evaluación de umbral o lógica de alerta aplicada. Esto le permite:
- Visualice los datos subyacentes que su seguimiento está evaluando.
- Correlacione los cambios de estado de alerta con las tendencias de datos reales.
- Identifique anomalías, brechas o patrones inesperados en sus datos antes de configurar las condiciones de alerta.
Utilice el gráfico Source Data para asegurarse de que su consulta devuelva los resultados esperados y para ayudar a refinar sus umbrales de alerta y ventanas de evaluación.
Establezca condiciones de alerta
Las condiciones de alerta varían según el tipo de seguimiento. Configure los seguimientos para que se activen si el valor de la consulta cruza un umbral, o si un cierto número de comprobaciones consecutivas fallaron.
- Activar cuando el average, max, min o sum de la métrica sea
- above, above or equal to, below o below or equal to el umbral
- durante los últimos 5 minutes, 15 minutes, 1 hour o custom para establecer un valor entre 1 minuto y 48 horas (1 mes para seguimientos de métricas)
Método de agregación
La consulta devuelve una serie de puntos, pero se necesita un solo valor para comparar con el umbral. El seguimiento debe reducir los datos en la ventana de evaluación a un solo valor.
| Opción | Descripción |
|---|
| average | La serie se promedia para producir un solo valor que se compara con el umbral. Agrega la función avg() a la consulta de su seguimiento. |
| max | Si cualquier valor individual en la serie generada supera el umbral, se activa una alerta. Agrega la función max() a la consulta de su seguimiento.* |
| min | Si todos los puntos en la ventana de evaluación de su consulta superan el umbral, se activa una alerta. Agrega la función min() a la consulta de su seguimiento.* |
| sum | Si la suma de cada punto en la serie supera el umbral, se activa una alerta. Agrega la función sum() a la consulta de su seguimiento. |
- Estas descripciones de máx. y mín. asumen que el seguimiento alerta cuando la métrica supera el umbral. Para los seguimientos que alertan cuando está por debajo del umbral, el comportamiento de máx. y mín. se invierte.
Nota: Existen diferentes comportamientos al utilizar as_count(). Consulte as_count() en Evaluaciones de seguimiento para obtener más detalles.
Ventana de evaluación
Un seguimiento puede evaluarse utilizando ventanas de tiempo acumulativas o ventanas de tiempo móviles. Las ventanas de tiempo acumulativas son más adecuadas para preguntas que requieren contexto histórico, como: “¿Cuál es la suma de todos los datos disponibles hasta este momento?” Las ventanas de tiempo móviles son más adecuadas para responder preguntas que no requieren este contexto, como: “¿Cuál es el promedio de los últimos N puntos de datos?”
La siguiente figura ilustra la diferencia entre las ventanas de tiempo acumulativas y móviles.
Ventanas de tiempo móviles
Una ventana de tiempo móvil tiene un tamaño fijo y desplaza su punto de inicio con el paso del tiempo. Los seguimientos pueden analizar los últimos 5 minutes, 15 minutes, 1 hour, o una ventana de tiempo personalizada de hasta 1 mes.
Nota: Los monitores de Logs tienen una ventana de tiempo móvil máxima de 2 days.
Ventanas de tiempo acumulativas
Una ventana de tiempo acumulativa tiene un punto de inicio fijo y se expande con el paso del tiempo. Los seguimientos admiten tres ventanas de tiempo acumulativas diferentes:
Current hour: Una ventana de tiempo con un máximo de una hora que comienza en un minuto configurable de la hora. Por ejemplo, haga un seguimiento de la cantidad de llamadas que recibe un punto de conexión HTTP en una hora comenzando en el minuto 0.
Current day: Una ventana de tiempo con un máximo de 24 horas que comienza en una hora y un minuto configurables del día. Por ejemplo, haga un seguimiento de una cuota de índice de registros diaria usando la ventana de tiempo Current day y permitiendo que comience a las 2:00pm UTC.
Current month: Analiza el mes actual comenzando en un día configurable del mes a una hora y un minuto configurables. Esta opción representa una ventana de tiempo de mes a la fecha y solo está disponible para seguimientos de métricas.
Una ventana de tiempo acumulativa se restablece después de alcanzar su tramo de tiempo máximo. Por ejemplo, una ventana de tiempo acumulativa que observa el Current month se restablece el primer día de cada mes a la medianoche UTC. Alternativamente, una ventana de tiempo acumulativa de Current hour, que comienza en el minuto 30, se restablece cada hora. Por ejemplo, a las 6:30am, 7:30am, 8:30am.
Frecuencia de evaluación
La frecuencia de evaluación define con qué frecuencia Datadog realiza la consulta del seguimiento. Para la mayoría de las configuraciones, la frecuencia de evaluación es 1 minute, lo que significa que cada minuto, el seguimiento consulta los datos seleccionados durante la ventana de evaluación seleccionada y compara el valor agregado con los umbrales definidos.
De forma predeterminada, las frecuencias de evaluación dependen de la ventana de evaluación que se utilice. Una ventana más larga resulta en frecuencias de evaluación más bajas. La siguiente tabla ilustra cómo la frecuencia de evaluación es controlada por ventanas de tiempo más grandes:
| Rangos de ventana de evaluación | Frecuencia de evaluación |
|---|
| ventana < 24 horas | 1 minuto |
| 24 horas <= ventana < 48 horas | 10 minutos |
| ventana >= 48 horas | 30 minutos |
La frecuencia de evaluación también se puede configurar para que la condición de alerta del seguimiento se verifique de forma diaria, semanal o mensual. En esta configuración, la frecuencia de evaluación ya no depende de la ventana de evaluación, sino del horario configurado.
Para obtener más información, consulte la guía sobre cómo Personalizar las frecuencias de evaluación del seguimiento.
Umbrales
Utilice umbrales para establecer un valor numérico para activar una alerta. Dependiendo de la métrica elegida, el editor muestra la unidad utilizada (byte, kibibyte, gibibyte, etc.).
Datadog tiene dos tipos de notificaciones (alerta y advertencia). Los seguimientos se recuperan automáticamente según el umbral de alerta o advertencia, pero se pueden especificar condiciones adicionales. Para obtener información adicional sobre los umbrales de recuperación, consulte ¿Qué son los umbrales de recuperación?. Por ejemplo, si un seguimiento alerta cuando la métrica está por encima de 3 y no se especifican umbrales de recuperación, el seguimiento se recupera una vez que el valor de la métrica vuelve a estar por debajo de 3.
| Opción | Descripción |
|---|
| Alert threshold (obligatorio) | El valor utilizado para activar una notificación de alerta. |
| Warning threshold | El valor utilizado para activar una notificación de advertencia. |
| Alert recovery threshold | Un umbral opcional para indicar una condición adicional para la recuperación de la alerta. |
| Warning recovery threshold | Un umbral opcional para indicar una condición adicional para la recuperación de la alerta. |
A medida que cambia un umbral, el gráfico de vista previa en el editor muestra un marcador que indica el punto de corte.
Nota: Al ingresar valores decimales para los umbrales, si su valor es <1, agregue un 0 inicial al número. Por ejemplo, use 0.5, no .5.
Una alerta de verificación rastrea los estados consecutivos enviados por grupo de verificación y los compara con sus umbrales. Configure la alerta de verificación para:
Activar la alerta después de las fallas consecutivas seleccionadas: <NUMBER>
Cada ejecución de verificación envía un único estado de OK, WARN o CRITICAL. Elija cuántas ejecuciones consecutivas con el estado WARN y CRITICAL activan una notificación. Por ejemplo, su proceso podría tener una pequeña interrupción donde la conexión falla. Si establece este valor en > 1, la interrupción se ignora, pero un problema con más de una falla consecutiva activa una notificación.
Resolver la alerta después de los éxitos consecutivos seleccionados: <NUMBER>
Elija cuántas ejecuciones consecutivas con el estado OK resuelven la alerta.
Consulte la documentación de los seguimientos de verificación de proceso, verificación de integración y verificación personalizada para obtener más información sobre la configuración de alertas de verificación.
Condiciones de alerta avanzadas
Sin datos
Las notificaciones de datos faltantes son útiles si espera que una métrica siempre reporte datos en circunstancias normales. Por ejemplo, si un servidor con el Agent debe estar activo continuamente, puede esperar que la métrica system.cpu.idle siempre reporte datos.
En este caso, debe habilitar las notificaciones de datos faltantes. Las secciones a continuación explican cómo lograr esto con cada opción.
Nota: El seguimiento debe poder evaluar los datos antes de alertar sobre los datos faltantes. Por ejemplo, si crea un seguimiento para service:abc y los datos de ese service no se están reportando, el seguimiento no envía alertas.
Si faltan datos durante N minutos, seleccione una opción del menú desplegable:
- Evaluate as zero / Show last known status
- Show NO DATA
- Show NO DATA and notify
- Show OK.
El comportamiento seleccionado se aplica cuando la consulta de un seguimiento no devuelve ningún dato. A diferencia de la opción Do not notify, la ventana de datos faltantes no es configurable.
| Opción | Estado del seguimiento y notificación |
|---|
| Evaluate as zero | El resultado vacío se reemplaza con cero y se compara con los umbrales de alerta/advertencia. Por ejemplo, si el umbral de alerta está establecido en > 10, un cero no activaría esa condición y el estado del seguimiento se establecería en OK. |
| Show last known status | Se establece el último estado conocido del grupo o seguimiento. |
| Show NO DATA | El estado del seguimiento se establece en NO DATA. |
| Show NO DATA and notify | El estado del seguimiento se establece en NO DATA y se envía una notificación. |
| Show OK | El seguimiento se resuelve y el estado se establece en OK. |
El uso de default_zero() en una consulta bloquea el comportamiento de datos faltantes al valor predeterminado de ese tipo de consulta y deshabilita las otras opciones:
- Para consultas con
default_zero(), los datos faltantes siempre se evalúan como cero y los otros comportamientos de datos faltantes no están disponibles. - Para consultas sin
default_zero(), las consultas Count tienen como valor predeterminado Evaluate as zero, mientras que otros tipos de consulta tienen como valor predeterminado Show last known status. Todos los comportamientos de datos faltantes permanecen disponibles.
Resolución automática
[Never], After 1 hour, After 2 hours y así sucesivamente. resolver automáticamente este evento desde un estado activado.
La resolución automática funciona cuando ya no se envían datos. Los seguimientos no se resuelven automáticamente desde un estado de ALERTA o ADVERTENCIA si los datos siguen reportándose. Si los datos siguen enviándose, la función renotify puede utilizarse para informar a su equipo cuando un problema no se ha resuelto.
Para algunas métricas que se reportan periódicamente, puede tener sentido que las alertas activadas se resuelvan automáticamente después de un cierto período de tiempo. Por ejemplo, si tiene un contador que solo reporta cuando se registra un error, la alerta nunca se resuelve porque la métrica nunca reporta 0 como el número de errores. En este caso, configure su alerta para que se resuelva después de un cierto tiempo de inactividad en la métrica. Nota: Si un seguimiento se resuelve automáticamente y el valor de la consulta no cumple con el umbral de recuperación en la siguiente evaluación, el seguimiento activa una alerta nuevamente.
En la mayoría de los casos, esta configuración no es útil porque solo desea que una alerta se resuelva después de que realmente se haya solucionado. Por lo tanto, en general, tiene sentido dejar esto como [Never] para que las alertas solo se resuelvan cuando la métrica esté por encima o por debajo del umbral establecido.
Tiempo de retención del grupo
La retención de grupo controla cuánto tiempo se mantiene un grupo de seguimiento en el estado del seguimiento después de que los datos dejan de reportarse. Después de que pasa el período de retención, el grupo caduca y se elimina del estado del seguimiento.
De forma predeterminada, un grupo mantiene el estado durante 24 horas antes de ser eliminado. Los seguimientos de servidor y las comprobaciones de servicio que notifican sobre la falta de datos mantienen el estado durante 48 horas.
Para los seguimientos con muchos grupos, la retención dinámica de grupos está habilitada de forma predeterminada. Datadog acorta automáticamente el período de retención para los grupos que dejan de reportar datos. Cuanto más frecuentemente aparecen y desaparecen los grupos, más corto se vuelve el período de retención, ayudando a mantener el seguimiento rápido y eficiente. Este comportamiento afecta solo a los grupos que han dejado de reportar datos; los grupos que están reportando activamente nunca se eliminan.
Para los tipos de seguimiento de alertas múltiples que admiten retención personalizada, puede establecer un valor entre 1 hora y 72 horas. Seleccione Remove the non-reporting group after N (length of time).
Similar a la opción de resolución automática, la retención de grupo funciona cuando ya no se envían datos. La hora de inicio de la retención de grupo y la opción de resolución automática son idénticas tan pronto como la consulta del seguimiento no devuelve datos.
Algunos casos de uso para definir un tiempo de retención de grupo personalizado incluyen:
- Cuando desee eliminar el grupo inmediatamente o poco después de que los datos dejen de reportarse
- Cuando desee mantener el grupo en el estado durante el tiempo que usualmente le toma solucionar problemas
Nota: La opción de tiempo de retención de grupo personalizado requiere un seguimiento de alertas múltiples que admita la opción On missing data. Estos tipos de seguimiento son APM Trace Analytics, Audit Logs, CI Pipelines, Error Tracking, Events, Logs y seguimientos RUM.
Retraso de grupo nuevo
Retrase el inicio de la evaluación por N segundos para grupos nuevos.
El tiempo (en segundos) de espera antes de comenzar con Alerting, para permitir que los grupos recién creados inicien y que las aplicaciones arranquen por completo. Este debe ser un número entero no negativo.
Por ejemplo, si utiliza una arquitectura en contenedores, establecer un retraso de grupo evita que los grupos de seguimiento basados en contenedores se activen debido al alto uso de recursos o a la alta latencia cuando se crea un nuevo contenedor. El retraso se aplica a cada grupo nuevo (que no se ha visto en las últimas 24 horas) y es de 60 segundos de forma predeterminada.
La opción está disponible con el modo de alerta múltiple.
Retraso en la evaluación
Datadog recomienda un retraso de 15 minutos para las métricas de la nube, las cuales son rellenadas por los proveedores de servicios. Además, al usar una fórmula de división, un retraso de 60 segundos es útil para asegurar que su seguimiento evalúe valores completos. Consulte la página
Cloud Metric Delay para ver los tiempos de retardo estimados.
Retrase la evaluación por N segundos.
El tiempo (en segundos) para retrasar la evaluación. Este debe ser un número entero no negativo. Entonces, si el retraso se establece en 900 segundos (15 minutos), la evaluación del seguimiento es durante los últimos 5 minutes, y la hora es las 7:00, el seguimiento evalúa los datos de 6:40 a 6:45. El retraso de evaluación máximo configurable es de 86400 segundos (24 horas).
Configure sus mensajes de Notifications para incluir la información que más le interesa. Especifique a qué equipos enviar estas alertas, así como los atributos para activar las alertas.
Mensaje
Utilice esta sección para configurar las Notifications para su equipo y configurar cómo enviar estas alertas:
Para obtener más información sobre las opciones de configuración del mensaje de notificación, consulte Alerting Notifications.
Las etiquetas de seguimiento son independientes de las etiquetas enviadas por el Agent o las integraciones. Consulte la documentación de
Administrar seguimientos.
- Use el menú desplegable Tags para asociar etiquetas con su seguimiento.
- Use el menú desplegable Teams para asociar equipos con su seguimiento.
- Elija un Priority.
Establecer agregación de alertas
Las Alerts se agrupan automáticamente según su selección de la agregación seleccionada para su consulta (por ejemplo, avg by service). Si la consulta no tiene agrupación, se establece de forma predeterminada en Simple Alert. Si la consulta está agrupada por cualquier dimensión, la agrupación cambia a Multi Alert.
Alerta simple
Simple AlertEl modo activa una notificación agregando todos los orígenes que informan. Usted recibe una alerta cuando el valor agregado cumple con las condiciones establecidas. Por ejemplo, puede configurar un seguimiento para que le notifique si el uso promedio de CPU de todos los servidores supera un cierto umbral. Si se alcanza ese umbral, recibirá una sola notificación, independientemente de la cantidad de servidores individuales que hayan alcanzado el umbral. Esto puede ser útil para supervisar tendencias o comportamientos generales del sistema.
Alerta múltiple
Un seguimiento Multi Alert activa notificaciones individuales para cada entidad en un seguimiento que cumple con el umbral de alerta.
Por ejemplo, al configurar un seguimiento para que le notifique si la latencia P99, agregada por servicio, supera un cierto umbral, recibiría una alerta separada para cada servicio individual cuya latencia P99 superara el umbral de alerta. Esto puede ser útil para identificar y abordar instancias específicas de problemas del sistema o de la aplicación. Le permite hacer un seguimiento de los problemas a un nivel más granular.
Agrupación de notificaciones
Al hacer un seguimiento de un grupo grande de entidades, las alertas múltiples pueden generar seguimientos ruidosos. Para mitigar esto, personalice qué dimensiones activan las alertas. Esto reduce el ruido y le permite concentrarse en las alertas que más importan. Por ejemplo, está haciendo un seguimiento del uso promedio de CPU de todos sus hosts. Si agrupa su consulta por service y host pero solo desea que se envíen alertas una vez por cada atributo service que cumpla con el umbral, elimine el atributo host de sus opciones de alerta múltiple y reduzca la cantidad de notificaciones que se envían.
Al agregar notificaciones en Multi Alertmodo, las dimensiones que no se agregan se vuelven Sub Groups en la interfaz de usuario.
Nota: Si su métrica solo informa por host sin ninguna etiqueta service, el seguimiento no la detecta. Las métricas con etiquetas host y service son detectadas por el seguimiento.
Si configura etiquetas o dimensiones en su consulta, estos valores estarán disponibles para cada grupo evaluado en la alerta múltiple para completar dinámicamente las notificaciones con contexto útil. Consulte Variables de atributo y etiqueta para aprender cómo hacer referencia a los valores de etiqueta en el mensaje de notificación.
| Agrupar por | Modo de alerta simple | Modo de alerta múltiple |
|---|
| (todo) | Un solo grupo que activa una notificación | N/A |
| 1 o más dimensiones | Una notificación si uno o más grupos cumplen las condiciones de alerta | Una notificación por grupo que cumpla las condiciones de alerta |
Permisos
Todos los usuarios pueden visualizar todos los seguimientos, independientemente del equipo o rol con el que estén asociados. De forma predeterminada, solo los usuarios vinculados a roles con el permiso de escritura de seguimientos pueden editar seguimientos. El rol de Datadog Admin y el rol estándar de Datadog tienen el permiso de escritura de seguimientos de forma predeterminada. Si su organización utiliza roles personalizados, otros roles personalizados pueden tener el permiso de escritura de seguimientos. Para obtener más información sobre cómo configurar RBAC para seguimientos y migrar seguimientos de la configuración bloqueada al uso de restricciones de roles, consulte la guía sobre Cómo configurar RBAC para seguimientos.
Puede restringir aún más su seguimiento especificando una lista de equipos, roles o usuarios autorizados para editarlo o silenciarlo. El creador del seguimiento tiene derechos de edición sobre el seguimiento de forma predeterminada.
Nota: Las limitaciones se aplican tanto en la interfaz de usuario como en la API.
Niveles de acceso
Preview
El nivel de acceso Muter y los controles de acceso a tiempos de inactividad están en Preview.
Cada equipo, rol o usuario en un seguimiento restringido tiene uno de los siguientes niveles de acceso:
| Nivel de acceso | Permisos |
|---|
| Viewer | Visualizar el seguimiento. |
| Muter | Visualizar y silenciar el seguimiento. Los usuarios con nivel Muter no pueden editar ni eliminar el seguimiento. |
| Editor | Visualizar, silenciar, editar y eliminar el seguimiento. |
Utilice el nivel de acceso Muter para permitir que los ingenieros de guardia u otros miembros del equipo de respuesta silencien un seguimiento durante un incidente o una ventana de mantenimiento sin darles acceso para cambiar su configuración. Si su organización no tiene el nivel de acceso Muter, solo los usuarios con nivel Editor pueden silenciar un seguimiento.
Para silenciar un seguimiento, un usuario también necesita el permiso Manage Downtimes. Un tiempo de inactividad solo silencia los seguimientos a los que su creador tiene acceso de tipo Muter o Editor. Para obtener más información, consulte Downtimes.
Nota: Restringir el acceso de edición a un seguimiento también impide que los usuarios con acceso Viewer lo silencien, incluso mediante tiempos de inactividad. Para permitir que estos usuarios silencien el seguimiento, asígneles el nivel de acceso Muter.
Controles de acceso granulares
Utilice controles de acceso granulares para limitar los equipos, roles o usuarios que pueden editar o silenciar un seguimiento:
- Mientras edita o configura un seguimiento, busque la sección Define permissions and audit notifications.
- Haga clic en Edit Access.
- Haga clic en Restrict Access.
- El cuadro de diálogo se actualiza para mostrar que los miembros de su organización tienen acceso Viewer de forma predeterminada.
- Use el menú desplegable para seleccionar uno o más equipos, roles o usuarios que puedan editar o silenciar el seguimiento.
- Haga clic en Add.
- El cuadro de diálogo se actualiza para mostrar que el rol que seleccionó tiene el permiso Editor. Para otorgar a la selección acceso solo para silenciar, cambie Editor a Muter.
- Haga clic en Done.
Nota: Para mantener su acceso de edición al seguimiento, el sistema requiere que incluya al menos un rol o equipo del que usted sea miembro, con acceso de Editor, antes de guardar.
Para restaurar el acceso general a un seguimiento con acceso restringido, siga los pasos a continuación:
- Mientras visualiza un seguimiento, haga clic en el menú desplegable More.
- Seleccione Permissions.
- Haga clic en Restore Full Access.
- Haga clic en Save.
Lecturas adicionales
Documentación, enlaces y artículos útiles adicionales:
