Cree su primer panel y alerta

Un panel debe conservar una respuesta revisada. Una alerta debe identificar una condición que tiene un dueño y una respuesta útil. No promueva una consulta no verificada simplemente porque su gráfico parece plausible.

Este tutorial comienza con el volumen de solicitudes y la tasa de errores SQL en Escribe tu primera consulta SQL en Telemetry.

Cree un widget orientado a la toma de decisiones

Ejecute la consulta en Telemetry, elija un gráfico que coincida con el resultado y seleccione Agregar al panel.

Para obtener un resultado de tasa de error API:

• Utilice un gráfico de líneas cuando el tiempo sea la dimensión principal.
• Utilice un gráfico de barras al comparar un pequeño conjunto de plantillas de ruta.
• Utilice una tabla cuando los valores exactos, los umbrales de volumen y varias medidas deban permanecer visibles.

Nombra el widget después de la decisión, no de la implementación. La “tasa de error del servidor API por ruta” es más clara que la “Consulta 7”.

Mantenga el denominador visible. Una ruta con un error en una solicitud no debería superar silenciosamente a una ruta con 500 errores en 10.000 solicitudes. Incluya el volumen de solicitudes y el porcentaje de error o aplique una condición de volumen mínimo en SQL.

Mantenga pequeño el primer tablero

Un primer panel de confiabilidad útil podría contener:

1. Solicitar volumen en el tiempo.
2. Porcentaje de error del servidor a lo largo del tiempo.
3. Latencia p95 por ruta.
4. Principales categorías de errores o huellas dactilares.
5. Una tabla de cuentas afectadas solo cuando se aprueba ese acceso.

Cada widget debe vincularse a filas inspeccionables o al SQL guardado. Evite repetir la misma métrica en varios estilos de gráficos.

Consulte Crear paneles para obtener orientación sobre diseño y propiedad.

Crear una alerta acotada

Comience con una línea de serie temporal: tiempo en el eje x, una métrica numérica en el eje y y sin agrupación ni división. Telemetry solo ofrece Crear alerta para esta forma de gráfico estrecha porque el umbral, la ventana de punto reciente, el estado y la notificación se refieren a una señal ordenada. Un gráfico agrupado no dejaría claro si alguna línea, cada línea o cada línea controla la alerta de forma independiente.

Mantenga comparaciones de varias líneas en el panel. Para una alerta, filtre a una población, agregue los grupos deliberadamente o cree alertas separadas cuando los grupos necesiten umbrales o propietarios diferentes. Consulte Alertas para conocer todos los fundamentos y ejemplos.

Abra el gráfico de una sola línea validado o el resultado de la consulta y seleccione Crear alerta. Definir:

• La agregación y la medida.
• El último número de puntos de datos a evaluar.
• La comparación y el umbral.
• El intervalo de evaluación.
• Si se debe ignorar un depósito más nuevo incompleto.
• El destinatario propietario de la respuesta.

Para una tabla de desarrollo sintética, comience con una alerta de correo electrónico sin paginación. Un ejemplo de producción podría ser:

p95 of the last 5 completed data points is greater than 850 ms

o:

server_error_pct is greater than 5% and requests is at least 100

El umbral exacto depende del objetivo del servicio, el patrón de tráfico y la política de respuesta. Un número copiado no sustituye a una línea de base.

Pruebe ambos lados de la condición

Enviar eventos sintéticos controlados que deberían:

1. Deje la alerta por debajo del umbral.
2. Mueva el resultado por encima del umbral.
3. Producir una notificación al destinatario esperado.
4. Regresar por debajo del umbral después de la recuperación.

Registre la consulta, el umbral, el destinatario y el enlace de respuesta. Luego elimine o aísle claramente las filas sintéticas de los informes de producción.

Definir la respuesta

Cada alerta necesita una acción breve:

• Abra el panel correspondiente.
• Inspeccionar rutas, lanzamientos y cuentas afectadas.
• Correlacionar con una solicitud o identificador de flujo de trabajo.
• Decida si mitigar, retroceder o continuar observando.
• Registre el tiempo de recuperación y el impacto en el cliente por separado.

Para conocer el comportamiento de alerta y la solución de problemas, lea Alertas y Entrega de alertas y solución de problemas. Antes de implementar ampliamente la instrumentación, complete el Lista de verificación de instrumentación en producción.