Alertas

Tu workspace puede detectar problemas por sí solo. Los eventos llegan de tus herramientas de monitoreo o de un asistente que notó algo durante una ejecución. Un paso de triage lee cada evento y decide si alguien necesita saber, cuán urgente es y quién debería escuchar al respecto. Lo que mantiene se convierte en una alerta en la pestaña de Alertas, y se notifican a las personas adecuadas.

De dónde provienen los eventos

Tus herramientas, a través de una fuente. En Configuración → Workspace → Alertas, el propietario del workspace agrega una fuente, por ejemplo grafana. Obtienes una URL con un secreto: cópiala de inmediato, ya que solo se muestra una vez. Apunta el webhook de tu herramienta de monitoreo a ella. Si la URL se filtra, elige Nuevo token y el antiguo dejará de funcionar de inmediato. Desactivar pausa una fuente.
Tus asistentes. Un asistente con la herramienta raise_alert adjunta puede marcar algo que notó mientras trabajaba, como un flujo de datos que se volvió obsoleto o un cambio en el precio de un competidor. Su señal pasa por el mismo triage que todo lo demás.

Una fuente acepta un POST JSON con un subject, un body y un external_id opcional. Si tu herramienta envía el mismo external_id dos veces (un reintento), la segunda se ignora, así que una conexión inestable no cuenta como dos eventos. Los mensajes muy largos se acortan en lugar de ser rechazados. Tu herramienta también puede enviar occurred_at (cuándo sucedió), un objeto payload con detalles adicionales, y un locale (como fr) que establece el idioma en el que se escribe la alerta.

Lo que decide el triage

Para cada evento, el triage responde a cuatro preguntas:

¿Vale la pena informarle a alguien? Los latidos, mensajes de prueba y repeticiones de algo ya abierto, usualmente no lo son.
¿Qué tan severo es? Bajo, Medio, Alto o Urgente.
¿Quién debería enterarse? Se dirige por rol o responsabilidad, utilizando lo que el perfil de tu workspace dice sobre su gente. Si nadie coincide, los propietarios del workspace lo reciben, y la alerta lo indica.
¿Es lo mismo que una alerta abierta? Entonces se agrega a esa alerta en lugar de crear una nueva. La alerta cuenta cuántas veces se ha visto. Solo se te notifica nuevamente si se vuelve más severa.

El triage escribe el titular y resumen de la alerta en el idioma que envió la fuente (su locale), o en inglés cuando no envió ninguno.

Ajustándolo

El triage es un agente como los demás, así que lo ajustas en Configuración → Agentes → Triage. Agrega instrucciones en términos sencillos, por ejemplo “Un movimiento de línea de 3 puntos o más en un juego de la NHL es de alta severidad; dirígelo a los operadores”, o elige un modelo diferente. Los cambios se aplican al siguiente evento.

Trabajando en una alerta

Abre la pestaña de Alertas. Las alertas se agrupan por severidad, comenzando por las más severas. Activa Dirigidas a mí para ver solo las tuyas. Selecciona una alerta para ver qué ocurrió, a quién se envió, y cada evento archivado bajo ella. A partir de ahí:

Acción	Qué hace
Reconocer	Dice que la tienes.
Posponer	La oculta durante una hora, cuatro horas, un día o una semana. Vuelve por sí sola.
Resolver — útil / Resolver — ruido	La cierra. Tu veredicto ayuda al triage: se le muestran las alertas que tu workspace consideró ruido, y se aleja de ellas.
Silenciar…	La cierra como ruido y detiene las alertas similares: esta alerta exacta, uno de sus temas, o todo lo proveniente de su fuente, hasta una fecha que elijas o hasta que alguien levante el silencio.

Un veredicto de ruido por sí solo nunca silencia nada. Silenciar siempre es algo que una persona eligió hacer. Los silencios se enumeran en Configuración → Workspace → Alertas, donde quien añadió uno, o el propietario del workspace, puede levantarlos.

Mostrar retenidos añade lo que el triage decidió no decirte, con la razón: coincidió con un silencio, una alerta abierta ya la cubría, o no valía la pena una notificación. Úsalo para verificar que el triage no sea demasiado estricto.

Cómo se te notifica

Las alertas te alcanzan a través de tus canales habituales: correo electrónico, SMS o Slack, según se establece en Configuración → Notificaciones. La fila Se levantó una alerta tiene una Severidad mínima para cada canal. El valor predeterminado es Medio: las alertas bajas permanecen en la pestaña de Alertas sin notificarte. Podrías configurar Slack en Bajo y SMS en Urgente, por ejemplo.

Te notifican una vez por alerta en cada severidad que alcance. Las repeticiones en la misma severidad y los silencios que finalizan no te notifican nuevamente.

Buen saber

Las alertas pertenecen al workspace. Cada miembro puede verlas y trabajarlas. Solo el propietario del workspace gestiona las fuentes.
Si la suscripción del workspace ha caducado, las fuentes dejan de aceptar eventos y nada es triado hasta que haya un plan activo nuevamente.
Cada triage es una llamada de modelo, facturada a tu workspace como uso. Los eventos retenidos por un silencio de fuente no se envían al modelo, por lo que no tienen costo. Consulta Uso y facturación.
Tu organización puede desactivar las Alertas. La pestaña y la sección de configuración desaparecen.