KEPLIN Docs

Alertas por correo

Qué genera una alerta, qué dice el correo, quién lo recibe, y cómo activar los avisos y afinar los umbrales.

El Radar cuenta lo que pasa a quien abre la pantalla. Las alertas hacen lo contrario: avisan sin que nadie tenga que mirar. Es la diferencia entre saber que una app estuvo caída y saber que lo está.

Una alerta solo llega cuando alguien tiene que actuar, y dice qué falló, dónde, cuántas veces, a cuántas personas y desde cuándo, con un enlace para verlo en el Radar.

Se activan y se afinan en los Ajustes de la plataforma, al final de la barra lateral.

Nota

Estos ajustes son de quien administra la instalación. Con perfil de developer, el menú Ajustes no aparece.

Qué genera una alerta

Situación Cuándo avisa
Problema nuevo Aparece un problema en una app publicada: un error en una pantalla, en un workflow o en una ruta del servidor, una API que falla en el servidor, o una prueba que falla en una ejecución programada (ver Ejecutar y leer los resultados).
Problema que volvió Un problema dado por resuelto vuelve a ocurrir.
Problema abierto que volvió Un problema abierto, del que nadie había sido avisado, vuelve a ocurrir.
Fallo generalizado El porcentaje de peticiones que fallan en el servidor supera el umbral, con al menos 5 fallos y el mínimo de peticiones.
Scripts fallidos Las ejecuciones fallidas de scripts superan el umbral.
Cola del índice y Disco La cola del índice se retrasa o el disco se queda con poco espacio libre.
Antivirus El antivirus rechaza un archivo enviado, o pone en cuarentena un archivo ya guardado (ver Antivirus).
Secreto de un proveedor a punto de caducar El secreto de un proveedor Microsoft Entra ID caduca en menos de 30 días, o ya caducó (ver Entrar con proveedores de autenticación).

Los problemas siguen el estado que tienen en el Radar (consulta Investigar un problema):

  • Mientras un problema esté abierto, no llegan más correos sobre él.
  • Resolver un problema cierra la alerta sin correo: quien lo resolvió ya lo sabe. Si el problema vuelve a ocurrir, llega un correo nuevo que dice que volvió.
  • Ignorar un problema lo silencia: nunca genera alertas.
  • Lo que ocurre en el estudio, mientras alguien construye o prueba la app, no avisa a nadie.

Para el fallo generalizado, solo cuentan los fallos del servidor (estado 500 o superior). Los rechazos de permisos, las peticiones canceladas por quien las hizo y los errores de validación de lo que alguien escribió no cuentan. Cuando una app no tiene tráfico suficiente para decidir, la alerta se queda como estaba: no se cierra solo porque la gente dejó de usar la app.

Qué dice un correo

Cada persona recibe un correo con las alertas que le conciernen, en el idioma con el que usa la plataforma. En un problema, el correo dice:

  • El nombre de la app y el mensaje del error, en el asunto.
  • Dónde: la API, la pantalla, el workflow o la ruta del servidor.
  • Cuántas ocurrencias hubo en la ventana, y cuántas en total.
  • Cuántos usuarios se vieron afectados.
  • Cuándo se vio por primera vez el problema y, en un problema que volvió, cuándo se había dado por resuelto.
  • Abrir en el Radar: el enlace que abre el problema en el Radar de la app.

Las alertas de fallo generalizado y de scripts dicen qué APIs o scripts fallaron, cuántas veces y el último mensaje de error de cada uno.

Activar los avisos

  1. Abre Ajustes en la barra lateral.
  2. Elige Alarmas, en el grupo Avisos.
  3. Activa Avisos por email. La ayuda dice lo que está en juego: «Avisa cuando aparece un problema nuevo en una app, cuando un problema resuelto vuelve a ocurrir y cuando algo supera los límites de abajo. Sin esto, solo lo sabes al abrir la pantalla.»
  4. Haz clic en Guardar, en la cabecera. La confirmación dice «Ajustes guardados.»

La sección Alarmas, con el interruptor Avisos por email
La sección Alarmas, con el interruptor Avisos por email

La sección Procesos, en el grupo Plataforma, tiene otros tres interruptores que vale la pena conocer, porque la mitad de las «alertas que no llegan» viene de que uno de ellos esté desactivado:

Interruptor Qué hace
Programador Ejecuta las programaciones, los informes programados y los temporizadores de los workflows.
Índice de observabilidad Lleva lo que las apps registran al índice central y aplica los plazos de retención de cada app. Desactivado, las pantallas muestran datos viejos.
Notificaciones en tiempo real Servidor de tiempo real de las notificaciones. Sin él, las notificaciones se entregan en la próxima visita.

Adónde van los avisos

La sección Email, en el grupo Avisos, tiene el servidor de salida y los destinatarios: «El servidor por el que salen los avisos de la plataforma. Distinto del email de cada app.»

La sección Email, con el servidor de salida y los destinatarios
La sección Email, con el servidor de salida y los destinatarios

Campo Qué es
Servidor La dirección del servidor de correo de salida.
Puerto Su puerto.
Seguridad SSL/TLS (puerto 465), STARTTLS si el servidor lo ofrece (puerto 587) o Ninguna (puerto 25).
Usuario La cuenta de autenticación en el servidor.
Contraseña «Queda cifrada y nunca vuelve a esta pantalla. Dejarla en blanco mantiene la que está.»
Remitente La dirección de quien envía. Es obligatorio.
Destinatarios Quién recibe todos los avisos, en lugar de la elección automática.

Con los Destinatarios en blanco, la plataforma elige a quién avisa:

  • Las alertas de una app van a las personas asignadas a esa app.
  • Las alertas de una app sin nadie asignado, y las de la plataforma (la cola del índice y el disco), van a los administradores activos.

Consejo

Deja los Destinatarios en blanco. Cada app avisa a quien trabaja en ella, y la lista se actualiza sola cuando alguien entra o sale del equipo. Una lista escrita a mano recibe todo de todas las apps y queda desactualizada el día en que alguien cambia de trabajo.

El estado de la contraseña aparece bajo el campo: Definida — escribe para cambiar o Por definir.

A partir de cuándo avisar

Los Umbrales están en la sección Alarmas, debajo del interruptor: «Los problemas nuevos avisan siempre. Los valores de abajo deciden cuándo un fallo generalizado, los scripts, la cola del índice o el disco envían un email.»

Los umbrales de la sección Alarmas, con la ventana
Los umbrales de la sección Alarmas, con la ventana

Umbral Qué mide Nota
Fallos del servidor en las APIs (%) «Porcentaje de peticiones que fallan en el servidor (5xx), por app, con al menos 5 fallos en la ventana.» Se cuenta app a app, no en la suma de todas.
Peticiones mínimas Cuántas llamadas hacen falta para que el porcentaje cuente «Por debajo de esto el porcentaje no dice nada: 1 error en 3 son 33%.»
Scripts fallidos Cuántas ejecuciones de scripts pueden fallar antes de avisar
Retraso de la cola (s) Cuánto puede retrasarse la cola del índice «Mientras la cola esté retrasada, las pantallas muestran datos viejos.»
Disco libre (%) Por debajo de qué porcentaje de disco libre se avisa
Ventana (min) El periodo en que todo esto se cuenta «Periodo en que los números de arriba se cuentan.»

Las Peticiones mínimas evitan que una app con poco tráfico dispare alertas de fallo generalizado: con tres peticiones y un fallo, el porcentaje es 33% y no quiere decir nada. Cada fallo del servidor ya genera su propia alerta de problema; el porcentaje sirve para el día en que fallan muchas cosas a la vez.

Cómo elegir los valores

No hay números universales, pero hay un método que funciona:

  1. Deja la plataforma correr una semana con los valores de origen.
  2. Abre Observabilidad → Vista general con el periodo en 7d y mira la Tasa de error y la Respuesta (p95) reales.
  3. Pon el umbral de Fallos del servidor en las APIs (%) un poco por encima de lo que es normal en esa instalación — el objetivo es cazar lo anormal, no confirmar lo normal.
  4. Ajusta las Peticiones mínimas al tráfico de la app más tranquila.

Atención

Un umbral demasiado apretado es peor que ninguno. Las alertas que se disparan todos los días dejan de leerse al cabo de una semana — y el día en que llegue la importante, va a llegar en medio de las demás.

Confirmar que las alertas funcionan de verdad

La sección Estado de la Observabilidad tiene, arriba, una frase que dice la verdad sobre las alertas en esta instalación. Es el sitio para confirmar después de tocar los ajustes.

El aviso del estado de las alertas, arriba de la sección Estado de la Observabilidad
El aviso del estado de las alertas, arriba de la sección Estado de la Observabilidad

Son tres frases posibles:

Qué hay ahí Qué significa
«Alertas activadas: avisa a quien trabaja en cada app cuando aparece un problema nuevo y cuando un problema resuelto vuelve a ocurrir, y también cuando más del 5% de las peticiones falla en el servidor, a partir de 20 peticiones.» Todo funcionando — y con tus umbrales a la vista.
«Las alertas están desactivadas. Nadie es avisado cuando algo sale mal — esta página solo cuenta lo que pasa a quien la abre.» Falta activar Avisos por correo.
«Alertas activadas, pero sin envío de correo: … Las alarmas se registran y nadie es avisado.» El aviso se dispara, pero no sale — falta configurar el servidor de correo.

La tercera es la más traicionera, porque todo parece configurado. Si la ves, vuelve a la sección Email y completa lo que falta.

Sesiones y límites

Aún en los Ajustes, la sección Límites, en el grupo Plataforma, tiene dos valores que no son alertas pero suelen buscarse al mismo tiempo:

  • Duración de la sesión (h) — «Una sesión activa se renueva sola; esto es el tiempo de inactividad que la expira.»
  • Archivo máximo (MB) — el tamaño máximo de un archivo subido.

¿Por qué no veo…?

  • …alertas llegando, con todo activado? Confirma el panel Estado: si dice «sin envío de correo», falta el servidor de salida. Si dice «desactivadas», falta guardar.
  • …la sección Alarmas? Estás en los ajustes de una app, no en los de la plataforma. Los de la plataforma se abren por el menú Ajustes de la barra lateral.
  • …mis umbrales valiendo? Sin Guardar, en la cabecera, nada se guarda. La confirmación es «Ajustes guardados.»
  • …las alertas de una app? Las alertas de una app van a quien está asignado a ella. Confirma en Usuarios que estás asignado a la app.
  • …otro correo del mismo problema? Un problema abierto solo avisa una vez. Vuelve a avisar si se da por resuelto y vuelve a ocurrir.
  • …la alerta de un error que vi en el estudio? Lo que ocurre en el estudio, a quien está construyendo la app, no avisa a nadie. Solo la app publicada genera alertas.