Integración domótica Kener, gratuita y de código abierto
Su página de estado Kener en Gladys: monitores, disponibilidad, incidentes y escenas si hay caída.
Publicado por guim31
- Dispositivos
- Versión 1.0.0
- Requiere Gladys >=5.1.0
- ★ 0
Kener es una página de estado autoalojada: comprueba sus servicios (sitios web, API, puertos, DNS…) cada minuto y publica su estado y sus incidentes. Esta integración la lleva a Gladys: cada monitor se convierte en un dispositivo con su estado, tiempo de respuesta y disponibilidad, las escenas reaccionan cuando uno cae, vuelve o cuando se abre un incidente, y un widget del panel muestra de un vistazo los incidentes y los monitores.
Gladys lee Kener: no comprueba sus servicios por sí misma.
Probada con un Kener real en Docker (Kener 4.1.10): monitores en línea, caídos y degradados, un monitor sin datos, incidentes abiertos y terminados, una clave de API errónea. Sus comentarios son bienvenidos en las issues.
Lo que necesita
- Gladys Assistant 5.1.0 o posterior.
- Kener 4 (la API v4), accesible desde Gladys: en su red (puerto 3000 por defecto) o en Internet. Kener 3 no es compatible.
- Una clave de API de Kener.
Primeros pasos
1. Crear una clave de API en Kener
En Kener, abra Manage → API Keys, cree una clave (por ejemplo «Gladys») y cópiela: Kener solo la muestra una vez. Una clave de API de Kener también permite escribir (crear incidentes, monitores): esta integración solo lee, pero guarde la clave para usted.
2. Configurar la integración
En Gladys, Integraciones → Kener → Configuración:
- Dirección de Kener: la dirección de su página de estado, por ejemplo
http://192.168.1.2:3000ohttps://status.example.com. También sirve una URL copiada del navegador (…/monitors/mi-api). Si Kener funciona bajo una subruta (KENER_BASE_PATH), inclúyala. - Clave de API: la clave del paso 1.
- Intervalo de actualización: 1, 2 o 5 minutos. Kener escribe un punto por minuto.
- Incluir los monitores ocultos: desactivado por defecto, los monitores ocultos en la página de estado se omiten.
- Idioma de los nombres: el idioma de los nombres de las funciones y de los resultados de escena.
Probar la conexión lee Kener enseguida e indica cuántos monitores encontró, cuántos están caídos y los incidentes en curso.
3. Añadir los monitores
En la pestaña Descubrir, añada los monitores que desea seguir y el dispositivo «Kener» para toda la instancia. Los monitores en pausa no se proponen. Un monitor se identifica por su tag: cambiarle el nombre en Kener conserva el dispositivo, cambiar su tag crea uno nuevo.
Los dispositivos
Cada monitor:
| Función | Valor |
|---|---|
| En línea | Sí en línea o degradado, No caído |
| Degradado | Sí cuando Kener lo muestra degradado |
| Tiempo de respuesta | Latencia de la última comprobación no caída, en ms |
| Disponibilidad 24 h | En las últimas 24 horas, con la fórmula de Kener |
El dispositivo «Kener»: Monitores caídos, Monitores degradados, Incidentes en curso.
El tiempo de respuesta y la disponibilidad se envían como mucho cada 5 minutos (enseguida cuando cambia el estado), para que una página de estado grande no cargue a Gladys. Los dispositivos llevan la insignia cloud cuando Kener está en Internet, la local cuando está en su red.
Panel
El widget Kener muestra cuatro mosaicos (monitores caídos, degradados, incidentes en curso, disponibilidad media), luego los incidentes en curso con su estado, luego los monitores, primero los caídos, con tiempo de respuesta y disponibilidad. A partir de diez monitores, se agrupan por categoría de Kener («Caídos: 1 / 7»).
Ajustes: una categoría, o monitores elegidos (solo los dispositivos añadidos a Gladys); Mostrar los incidentes en curso; Mostrar el botón Actualizar. El botón Actualizar lee Kener enseguida. Con una categoría o monitores elegidos, solo se cuentan sus incidentes.
Escenas
Disparadores
- Un monitor cae: Kener registra un monitor como caído. Ya confirma un estado antes de escribirlo (su «confirmation threshold»). Filtro: los monitores (vacío: todos, añadidos a Gladys o no). Variables: nombre del monitor, categoría.
- Un monitor vuelve a estar en línea: un monitor caído vuelve a estar en línea o degradado. Variables: nombre del monitor, categoría, duración de la caída en minutos (desde su primer punto caído).
- Se abre un nuevo incidente: aparece un incidente en curso en la página de estado, creado a mano, por la API o por una alerta de Kener. Variables: título, monitores afectados, página del incidente.
Un cambio ocurrido mientras Gladys o la integración estaba parada se anuncia igualmente, una vez, en la lectura siguiente.
Acciones
- Estado de un monitor: en línea, degradado, estado en palabras, nombre, categoría, tiempo de respuesta, disponibilidad 24 h y una frase como «NAS: Caído, 97,5 % en 24 h.»
- Resumen de la página de estado: monitores caídos, degradados y en total, nombres de los caídos, incidentes en curso y sus títulos, y una frase como «Caídos: NAS. Incidentes en curso: Servidor de copias inaccesible.» Campo opcional: una categoría.
Ambas vuelven a leer Kener cuando la última lectura tiene más de 15 segundos.
Ideas de escenas
- Un monitor cae → enviar un mensaje con el nombre del monitor.
- Cada mañana, Resumen de la página de estado → leer la frase en el altavoz solo si hay un monitor caído.
- Se abre un nuevo incidente → avisar con el título y el enlace de la página.
Solución de problemas
- «Kener no responde»: compruebe la dirección y el puerto desde el equipo de Gladys, y que un cortafuegos no lo bloquee.
- «Clave de API rechazada»: cree una nueva clave en Manage → API Keys; una clave desactivada también se rechaza.
- «No hay ningún Kener 4 en esta dirección»: la dirección no es un Kener, o es un Kener 3 (sin API v4). Compruebe la subruta si Kener tiene una.
- «La dirección redirige»: introduzca directamente la dirección
https://. - «Certificado rechazado»: no se acepta un certificado autofirmado; use la
dirección
http://en su red. - Un monitor se queda sin valor: Kener todavía no tiene ningún punto para él.
Límites
- Gladys lee Kener al intervalo elegido: una caída más corta puede escapar a los disparadores (la disponibilidad la cuenta igualmente).
- La disponibilidad se calcula con los puntos de las últimas 24 horas, con la fórmula del monitor cuando es una suma simple (la predeterminada si no). Las ventanas de mantenimiento no se leen.
- Los mantenimientos, los comentarios de incidentes y las páginas no se leen.
- La integración solo lee: no crea incidentes en Kener.
- El estado de un monitor es su punto más reciente: si Kener deja de comprobar (Kener o su Redis parado), el último estado se mantiene hasta que sus puntos tengan más de 24 horas. Un monitor en pausa, oculto o eliminado en Kener deja su dispositivo inaccesible.
- Sin relación con Kener ni con su autor.
Parámetros de configuración
Estos son los parámetros que Kener te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Su Kener | section | No | Introduzca la dirección de su Kener (versión 4) y una clave de API. Después añada los monitores que desea seguir desde la pestaña Descubrir: Gladys lee Kener, no comprueba sus servicios por sí misma. |
| Dirección de Kener | string | Sí | Dirección de su página de estado (puerto 3000 por defecto), con su subruta si Kener tiene una. |
| Clave de API | secret | Sí | Se crea en Kener: Manage → API Keys. Kener solo la muestra una vez: cópiela enseguida. |
| Opciones | section | No | |
| Intervalo de actualización | select | No | Con qué frecuencia se lee Kener: una petición para la lista, una por monitor y una para los incidentes. |
| Incluir los monitores ocultos | boolean | No | Los monitores ocultos en la página de estado se omiten por defecto. |
| Idioma de los nombres | select | No | Idioma de los nombres de las funciones (fijados al añadir un dispositivo) y de los resultados de escena. |
Cómo instalar Kener en Gladys
- En Gladys, abre Integraciones: Kener aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/guim31/gladys-kener:1.0.0), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/guim31/gladys-kener.
Kener requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Sobre las integraciones externas
Kener es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene guim31, no el equipo principal de Gladys.
- Explorar todas las integraciones, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación