Saltar al contenido
Telemetry
Explorar documentación
GuíasActualizado el 30 de julio de 2026Revisado por los equipos editorial y de producto de Telemetry2 min de lectura

Usa esta documentación con tu agente de programación

Abra un paquete de mensajes enfocados para Claude Code, Codex, Cursor u otro agente de codificación, luego adáptelo al flujo de trabajo que se describe aquí.

En esta página
  1. Verificar la consulta manualmente
  2. Verificar la condición
  3. Inspeccionar el historial de evaluación
  4. Verificar destinatarios y entrega de correo electrónico
  5. Reducir el ruido de forma segura

Entrega de alertas y solución de problemas

Una alerta tiene cuatro partes independientes: la consulta, los puntos evaluados, el estado del umbral y la entrega de notificación. Verifíquelos en ese orden para que un problema de correo electrónico no se confunda con una consulta que no arrojó datos elegibles.

Diagrama de las acciones de Explorar: Ejecutar, revisar SQL y resultados, y después Agregar al panel o Crear alerta.

Diagrama: crea la alerta a partir de un resultado ejecutado y revisado. Después, comprueba la evaluación y la entrega como etapas separadas.

Verificar la consulta manualmente

Abra la consulta Explore o SQL guardada y ejecute el mismo rango de tiempo utilizado por la alerta. Confirme que devuelve un valor numérico y una columna de marca de tiempo cronológica cuando la alerta evalúa una serie.

Utilice cubos completos. Es posible que el punto más nuevo aún esté cambiando, así que habilite Ignorar el último punto de datos cuando un depósito parcialmente lleno pueda cruzar el umbral.

Verificar la condición

Comprobar:

  • agregación como promedio, máximo, suma o p95
  • número de puntos recientes
  • operador de comparación
  • umbral y unidad
  • intervalo de evaluación
  • tráfico mínimo o salvaguardias del denominador en la consulta

Una alerta de tasa de error debería devolver tanto errores como solicitudes antes de calcular el porcentaje. Una alerta de latencia debe indicar si el valor es milisegundos o segundos.

Inspeccionar el historial de evaluación

Abra la página de detalles de la alerta y revise el estado y los eventos de la evaluación reciente. Distinguir:

  • no se devuelven datos
  • la ejecución de la consulta falló
  • puntos evaluados pero no incumplidos
  • incumplimiento detectado
  • intento de entrega de notificación

Si la consulta falla, ejecútela en el espacio de trabajo Consulta e inspeccione los nombres de las tablas, los tipos de campos, la compatibilidad con SQL y la columna de marca de tiempo configurada.

Verificar destinatarios y entrega de correo electrónico

Confirme que las direcciones de los destinatarios estén actualizadas y no contengan espacios ni elementos de copiar y pegar. Verifique el filtrado de spam y permita mensajes del remitente Telemetry configurado. Utilice un umbral de prueba controlado durante la configuración y luego restaure el umbral de producción una vez confirmada la entrega.

No baje repetidamente un umbral de alerta de producción simplemente para probarlo. Clone o aísle temporalmente la prueba cuando los flujos de trabajo de paginación o de ingresos puedan verse afectados.

Reducir el ruido de forma segura

Exija múltiples puntos completos, un volumen mínimo o un umbral de impacto absoluto antes de notificar. Enviar cambios informativos en el ciclo de vida para una revisión programada; Reserve alertas inmediatas para condiciones con un propietario y una respuesta claros.

Lea Alertas y luego utilice la guía de alerta incluida con cada Receta SQL.

Función relacionada del producto

Promocionar el SQL revisado en un umbral propio y un flujo de trabajo de respuesta.

Responsabilidad y referencias técnicas

El equipo editorial de Telemetry es responsable de esta explicación; el equipo de producto revisa el comportamiento, los ejemplos y las limitaciones.

Consultar los criterios editoriales