Alertas

Las alertas Telemetry le permiten monitorear el resultado de la consulta y recibir notificaciones por correo electrónico cuando una métrica cruza un umbral.

Utilice Alerta API para enumerar, crear, actualizar o eliminar estas definiciones de alerta mediante programación.

Por qué las alertas comienzan con una línea de serie temporal

Telemetry hace que Crear alertaesté disponible intencionalmente para una forma de resultado estrecha: un gráfico de líneas con el tiempo en el eje x, una métrica numérica en el eje y y sin dimensiónAgrupar poroDividir por. Esto es parte del modelo de alerta, no solo una limitación del gráfico.

Una única línea de serie temporal le da a la alerta una definición que una persona puede explicar y revisar:

• Cada punto plantea la misma pregunta sobre un período de tiempo sucesivo.
• Cada valor tiene la misma métrica, unidad, filtros y población.
• Los "Últimos N puntos de datos" se asignan a un conjunto ordenado de depósitos recientes.
• El umbral produce un estado: la señal está dentro del rango esperado o no.

Un gráfico de series múltiples es útil para la investigación, pero deja sin definir un comportamiento de alerta importante. ¿Debería activarse la alerta cuando alguna línea cruza el umbral o solo cuando todas las líneas lo hacen? ¿Cada ruta, cliente, región o versión debería tener estados y notificaciones separados? ¿Qué debería pasar cuando una serie desaparece, aparece un nuevo valor o un umbral no se ajusta a todos los grupos? Telemetry no elige silenciosamente esa semántica por usted.

Los paneles pueden preservar comparaciones de varias líneas y un contexto amplio. Una alerta debe ser una afirmación pequeña y determinista con un propietario y una respuesta. La consulta detrás de esa línea aún puede contener uniones, filtros, proporciones, protecciones de volumen mínimo u otra lógica compleja; su resultado final debería reducir esa lógica a una señal ordenada.

Convertir un gráfico agrupado en una alerta

Si un gráfico de panel útil tiene varias líneas:

1. Mantenga la versión multiserie en el tablero para comparación y diagnóstico.
2. Elija la condición específica que tiene propietario y respuesta.
3. Filtre a una población o agregue los grupos deliberadamente en SQL.
4. Devuelve un período de tiempo explícito y un valor numérico para cada período.
5. Seleccione un gráfico de líneasy elimineAgrupar poroDividir por.
6. Cree alertas separadas cuando diferentes grupos necesiten diferentes umbrales, propietarios o procedimientos de respuesta.

Si Crear alertano está visible, primero verifique la forma del resultado. En Explorar, utilice un gráfico de líneas sinDividir por. Para obtener un resultado SQL, utilice un gráfico de líneas, seleccione una columna de tiempo para el eje x y un valor numérico para el eje y, y establezca Agrupar porenNinguno.

Cómo funcionan las alertas

Cada evaluación de alerta sigue el mismo flujo:

1. Ejecute la consulta guardada (desde Explorar o una consulta SQL).
2. Ordene las filas por marca de tiempo (las más recientes primero).
3. Para omitir la última fila, active Ignore the last data point.
4. Tome los últimos puntos de datos N.
5. Calcule una agregación (avg, sum, p95, etc.).
6. Compare el valor con su umbral.
7. Enviar notificaciones cuando el estado cambie (activado o resuelto).

Crear una alerta desde Explorar

1. Abra /team/{team}/table/{table}?tab=explore.
2. Seleccione un gráfico de líneas, una métrica, un rango de tiempo y cualquier filtro.
3. Deje Dividir por vacío para que el resultado sea una línea.
4. Haga clic en Ejecutar.
5. En la barra de herramientas de resultados encima del gráfico, haga clic en Crear alerta.
6. Configure la condición, el intervalo y los destinatarios.
7. Haga clic en Crear alerta para guardar.

Después de ejecutar una consulta de Explore, el botón de alerta aparece en el lado derecho de la barra de herramientas de resultados junto a Agregar al panel:

Después de la creación, accederá a /team/{team}/alert/{alertSlug}, donde podrá inspeccionar el estado y el historial de eventos.

Crear una alerta a partir de los resultados de la consulta SQL

1. Abra una consulta guardada que devuelva una columna de tiempo y una señal numérica.
2. Ejecute la consulta y cambie a la pestaña Gráfico.
3. Seleccione un gráfico de líneas, establezca la columna de tiempo como el eje x, establezca la señal numérica como el eje y y deje Agrupar porcomoNinguno.
4. Haga clic en Crear alertaen la pestañaResultadosoGráfico.
5. Elija lógica de agregación y umbral.
6. Guarde y verifique la página de detalles de la alerta.

Campos de condición de alerta

Ejemplos interactivos en línea

/team/{team}/table/{table}?tab=explore&graphType=line&agg=p95&metric=latency_ms&time=7d

SELECT
  date_trunc('minute', timestamp_utc) AS time_bucket,
  COUNT(*) AS errors
FROM
  http_logs
WHERE
  status_code >= 500
  AND timestamp_utc >= now() - INTERVAL '2 hours'
GROUP BY
  time_bucket
ORDER BY
  time_bucket DESC;

Solución de problemas

1. Sin notificaciones: verifique que los correos electrónicos de los destinatarios sean válidos y que la alerta esté habilitada.
2. Falsos positivos: aumente Last N data points o mantenga habilitado Ignore last data point.
3. La alerta nunca se activa: reduzca el umbral o confirme que la columna de métrica seleccionada sea numérica.