Beta: solo Managed ClickStackLas alertas de detección de anomalías están en Beta y disponibles en Managed ClickStack. No están disponibles en ClickStack Open Source. El comportamiento y los valores predeterminados pueden cambiar mientras la funcionalidad esté en Beta.
- El umbral adecuado varía según el servicio, el endpoint o el cliente, y agrupa la alerta por esa dimensión.
- Los valores normales fluctúan a lo largo del día, de modo que cualquier umbral fijo genera demasiado ruido en horas pico o no detecta nada fuera de ellas.
- Le importan más los cambios repentinos, como picos de errores, saltos de latencia o tráfico que cae a cero, que los niveles absolutos.
Alertas compatibles
La detección de anomalías es un modo de detección que se aplica a una alerta existente, no un tipo de alerta independiente. Está disponible en:- Alertas de búsqueda, que puntúan el recuento de eventos coincidentes.
- Alertas de gráficos del panel en gráficos creados con el creador de gráficos.
Creación de una alerta de anomalías
1
Abrir el editor de alertas
Abra el editor de alertas de una búsqueda guardada o de un gráfico del panel de control, como se describe en Alertas.
2
Seleccionar la detección de anomalías
En Alert type, seleccione Anomaly detection. El valor predeterminado es Static threshold.
3
Configurar la condición
La condición se lee como una frase: Alert when z-score is at least
3 when value is outside expected range compared to the past 2 hours checked every 5 minute.- z-score is at least (predeterminado:
3): cuántas desviaciones estándar debe alejarse un valor del valor esperado para considerarse anómalo. El mínimo es 0,5 y las flechas lo modifican en pasos de 0,5. Cuanto más bajo sea el valor, mayor será la sensibilidad y más a menudo se activará la alerta. - When value is (predeterminado:
outside expected range): la dirección en la que se genera la alerta:above expected,below expecteduoutside expected range. Useabove expectedpara recuentos de errores y latencia, ybelow expectedpara el caudal o los registros de usuarios. - Compared to the past (predeterminado: 2 horas): cuánto historial utiliza ClickStack para medir la variación normal: 30 minutos, o 1, 2, 4, 6, 12 o 24 horas. Un valor de referencia más amplio ofrece un rango más estable, pero tarda más en adaptarse a una nueva normalidad.
- Checked every (predeterminado: 5 minutos): con qué frecuencia se evalúa la alerta: 5, 15 o 30 minutos, o 1 hora. Las alertas de anomalías no admiten intervalos más cortos ni más largos.
4
Revisar la prueba retrospectiva y la vista previa
La línea situada bajo el resumen es una prueba retrospectiva: vuelve a aplicar los ajustes actuales sobre el historial reciente e indica cuántas veces habría notificado la alerta; por ejemplo: «Would have notified 6 times in the past 24 hours, firing on 12 of 288 checks.» En las alertas de búsqueda, la prueba retrospectiva abarca las últimas 24 horas. En las alertas de gráficos del panel, abarca el intervalo de tiempo seleccionado en el gráfico, con un máximo de 24 horas. El recuento se muestra en amarillo cuando la alerta notificaría más de 10 veces al día.El Anomaly detection chart, situado debajo del formulario, representa el mismo rango:
- La línea continua es la serie.
- La línea discontinua es el valor de referencia esperado.
- El área sombreada es la zona de disparo de la alerta. Cualquier valor que caiga en ella, fuera del rango esperado, activa la alerta.
- Los marcadores Notify indican dónde la alerta habría enviado una notificación.
5
Elegir un canal de notificación y guardar
Elija un webhook u otro canal, como con cualquier otra alerta. Consulte Añadir un webhook. Guarde la alerta para que empiece a evaluarse.
Advertencias de idoneidad
Algunas series no son adecuadas para la detección de anomalías. Antes de guardar, aparece una advertencia debajo del gráfico de vista previa, aunque no impide guardar:Cómo funciona la detección de anomalías
En cada evaluación, ClickStack puntúa la ventana de evaluación bucket por bucket. Cada bucket abarca 60 segundos. Para cada bucket:- Valor esperado. ClickStack calcula la media móvil de los 7 buckets que finalizaron una ventana de evaluación antes. Los valores esperados nunca son negativos.
- Dispersión. ClickStack calcula en ClickHouse la desviación estándar de la serie a lo largo del valor de referencia que haya seleccionado en Compared to the past. El valor de referencia nunca es inferior a una ventana de evaluación.
- z-score. El z-score es
(value − expected) / standard deviation. - Decisión. El bucket se activa cuando el z-score supera el umbral configurado en la dirección configurada y, además, el valor difiere del valor esperado en al menos un 5 % de este, o en 0,01 cuando el valor esperado es 0. Este mínimo del 5 % evita que las series casi constantes se activen por fluctuaciones insignificantes.
expected ± z-score × standard deviation, ampliado por el mínimo del 5 %. En la versión preliminar, todo lo que queda fuera de él se sombrea como zona de activación de la alerta.
Una ventana de evaluación se activa si se activa cualquiera de sus buckets.
Buckets vacíos
La forma en que ClickStack trata un minuto sin datos depende de la agregación:- Recuentos y sumas (incluidas las alertas de búsqueda): un bucket vacío se evalúa como cero. Esto significa que una alerta con dirección
below expectedooutside expected rangese activa cuando el tráfico se detiene por completo. - Promedios, percentiles, mínimo, máximo, proporciones y fuentes de métricas: un bucket vacío indica que no había nada que medir, por lo que se omite en lugar de evaluarse como cero.
Alertas agrupadas
Cuando una alerta se agrupa por un campo, comoServiceName, cada grupo constituye una serie independiente con su propio rango esperado y su propio estado de alerta. ClickStack puntúa hasta 100 series por alerta y prioriza las series con más datos. Una serie que ya está en estado de alerta se sigue puntuando hasta que se resuelve, aunque quede fuera de las 100 primeras.
Notificaciones y resolución
Las alertas de anomalías envían una notificación por incidente y por serie:- Cuando una serie empieza a dispararse, ClickStack envía una notificación y marca la serie como en alerta.
- Mientras la serie siga disparándose en evaluaciones posteriores, no se envían más notificaciones.
- Cuando una ventana de evaluación no tiene buckets disparados, la serie se resuelve y ClickStack envía una notificación de resolución.
- Título:
Alert for "Checkout errors" - value 142 is above the expected range (z-score 4.4) - Cuerpo:
Value 142 is above the expected range — z-score 4.4 vs sensitivity 3; expected 120 ± 5 (expected range 105 to 135).
{{anomaly.value}}, {{anomaly.expectedValue}}, {{anomaly.expectedStddev}}, {{anomaly.lowerBound}}, {{anomaly.upperBound}} y {{anomaly.zScore}}. Estos valores solo se definen en las notificaciones de disparo. Las notificaciones de resolución no los incluyen, así que enciérrelos en {{#if anomaly}}...{{/if}} si utiliza el mismo nombre o mensaje para ambos tipos de notificación.
Monitorización de alertas de anomalías
En la página Alerts, establezca Filter by type en Anomaly para mostrar solo las alertas de anomalías. Cada fila describe la condición, por ejemplo, «If value is above expected with z-score at least 3». Seleccione una alerta para abrir su página de detalles. Debajo del resumen de la condición, que incluye el intervalo y el valor de referencia, ClickStack muestra cuántas veces se activó la alerta durante el periodo de historial conservado, por ejemplo, «Fired 2 times in the past 2 days.». Seleccione el rango para visualizarlo en el gráfico y en el historial de evaluación. La tabla Evaluation History muestra cada comprobación con su estado, el valor más reciente y el número de series que estaban en alerta. Las filas que incluyen una duración de notificación corresponden a comprobaciones en las que se envió una notificación, tanto al activarse la alerta como al resolverse. Si una alerta permanece en estado de alerta durante 20 o más ventanas consecutivas, la página de detalles indica que probablemente la serie presenta un nuevo comportamiento normal y no una anomalía. Aumente el z-score o actualice la alerta para que se compare con un valor de referencia más adecuado.Prueba retrospectiva con MCP
Con el servidor MCP de ClickStack, un asistente de IA puede hacer una prueba retrospectiva de los ajustes de detección de anomalías antes de que usted los guarde. La herramientaclickstack_backtest_anomaly_alert vuelve a aplicar una configuración sobre un historial de hasta 24 horas e informa, para cada serie, de las notificaciones que se habrían enviado, junto con advertencias sobre la calidad de los datos. La herramienta es de solo lectura.
Consejos de ajuste
- La alerta genera demasiado ruido: aumente el z-score en incrementos de 0.5 o cambie la dirección de
outside expected rangeal lado que le interese. - La alerta no detectó un incidente real: reduzca el z-score o acorte el valor de referencia para que el rango refleje el comportamiento reciente.
- La alerta se activa durante todo el día tras un despliegue: la serie tiene una nueva normalidad, y los valores de referencia más largos tardan más en adaptarse que los más cortos.
- Series de bajo volumen: agrupe por menos dimensiones o defina la alerta sobre una búsqueda más amplia, de modo que cada serie tenga al menos un evento por minuto.