Configurar la página de estado pública
Cada entidad puede publicar una página de estado para personas sin cuenta: los clientes de un cliente, el personal de una sucursal, un socio. Responde a una sola pregunta, ¿funciona el servicio que uso?, con el nombre, el logotipo y los colores propios de la entidad. Esta guía muestra cómo crear la página, construir sus componentes, publicar incidencias y publicarla.
Antes de empezar
- Necesitas el rol Administrador de entidad en la entidad que representa la página.
- La función
ui.public_status_pagedebe estar activada. Mientras está desactivada, la página no se puede abrir y la pantalla lo indica; un superadministrador la activa en Configuración › Instancia. - Decide qué deben reconocer los visitantes: servicios como Portal de clientes o Pagos con tarjeta, no nombres de servidores.
Lo que ven los visitantes y lo que nunca ven
La página se construye campo por campo a partir de una lista de permitidos, nunca filtrando datos internos.
| En la página | Nunca en la página |
|---|---|
| El título, la introducción, el logotipo, el tema y el color de acento | Nombres de recursos, nombres de host, tipos, etiquetas o ID |
| Los componentes con los nombres que les das, en grupos y en tu orden | Comprobaciones, métricas, valores o umbrales |
| El estado de cada componente y su barra de disponibilidad de 90 días | Alertas, sus títulos, severidades o recuentos |
| Las incidencias que publicas, con cada actualización y su hora | Quién publicó, quién está asignado, nada de la bandeja de alertas |
| Los mantenimientos que decides anunciar, con su título y su descripción públicos | El motivo interno de una ventana de mantenimiento |
| Enlaces a RSS, Atom y JSON Feed, y un discreto enlace Iniciar sesión | Rutas de entidades, otras entidades, o el nombre y el logotipo del producto |
Crear la página
-
Abre Configuración › Página de estado y elige la entidad en el selector, por ejemplo Ciguapa Inc..
-
Selecciona Crear una página de estado para Ciguapa Inc.. La página se crea sin publicar.
-
En Página, completa la configuración:
Configuración Notas Título También da nombre a la pestaña del navegador y a los feeds Introducción Un texto breve debajo del título Dirección del logotipo https://…o una ruta de este servidor, como/logos/ciguapa.svg. Si está vacía, se usa el logotipo de la rama, si tiene uno; nunca el del productoTema Cualquiera de los temas de la consola; Luz de día de forma predeterminada Color de acento Un color para los enlaces y los anillos de foco, o Usar el del tema Zona horaria de las barras diarias Dónde empieza y termina cada día de las barras de disponibilidad. Las horas de las incidencias y los mantenimientos se muestran en la zona horaria de cada visitante Dominio propio Opcional, como status.ciguapa.example; consulta más abajo -
Selecciona Guardar.
La Dirección pública es https://<server>/status/<entity short name>. Abrir la página pública la abre; Ver vista previa la muestra aquí, esté publicada o no.
Agregar componentes
Un componente es algo que los visitantes reconocen. Sigue recursos de la entidad de la página o de las entidades que están debajo: un recurso completo, o una sola comprobación de un recurso cuando solo esa comprobación importa para el servicio.
- En Componentes, selecciona Añadir un componente.
- Escribe el Nombre, por ejemplo Pagos con tarjeta, y, si quieres, una Descripción y un Grupo. Los componentes con el mismo grupo se muestran juntos.
- En Sigue, elige un Recurso y El recurso completo o una Comprobación, y selecciona Seguir. Repite para cada recurso del que dependa el servicio.
- Deja seleccionada la opción Mostrar la barra de disponibilidad de 90 días, salvo que un porcentaje signifique poco para este componente.
- Deja Estado que se muestra en Según lo que sigue.
- Selecciona Guardar componente.
Usa las flechas para cambiar el orden. La pantalla muestra junto a cada componente lo que dicen los recursos que sigue, para que un estado manual desactualizado sea fácil de detectar.
| Lo que dice lo que sigue | Estado del componente |
|---|---|
| Todos los recursos seguidos están sanos; una comprobación en información cuenta como sana | Operativo |
| Uno está en advertencia | Rendimiento degradado |
| Algunos están en estado crítico o no se puede llegar a ellos | Interrupción parcial |
| Todos los que informan están en estado crítico | Interrupción grave |
| Todos están en una ventana de mantenimiento | En mantenimiento |
| Nada ha informado todavía | Operativo en la página, Sin datos en las barras |
Los recursos en mantenimiento no cuentan ni a favor ni en contra: un nodo de base de datos en mantenimiento y el otro sano da Operativo. Un recurso silenciado cuenta según el estado real de sus comprobaciones, porque silenciar cambia las notificaciones, no el servicio.
Para establecer el estado a mano, por ejemplo Interrupción grave cuando sabes más que las comprobaciones, elígelo en Estado que se muestra. Después, vuelve a ponerlo en Según lo que sigue.
Publicar la página
- Revisa la página con Ver vista previa.
- En Página, selecciona Publicada y luego Guardar.
Mientras la página no está publicada, su dirección responde no encontrado; la vista previa sigue funcionando.
Informar de una incidencia
- En Incidencias, selecciona Informar de una incidencia.
- Escribe el Título, el Impacto (Sin impacto, Impacto leve, Impacto alto o Impacto crítico), los Componentes afectados, el Estado y un primer Mensaje.
- Selecciona Informar. La incidencia y su primera actualización aparecen en la página y en los feeds con su hora.
- A medida que sepas más, publica actualizaciones con Publicar actualización, cada una con un estado (Investigando, Identificado, En observación o Resuelta) y un mensaje.
Una incidencia abierta eleva el estado de los componentes que afecta al menos hasta su impacto: leve a Rendimiento degradado, alto a Interrupción parcial, crítico a Interrupción grave. Publicar Resuelta la cierra; permanece en Incidencias anteriores durante 30 días.
Mediante la API también puedes corregir el texto de una actualización anterior, aunque no su hora ni su estado, e informar de una incidencia a posteriori con la hora en que empezó.
Anunciar un mantenimiento
Cuando crees una ventana de mantenimiento, selecciona Anunciar en la página de estado y escribe un Título público y, si quieres, una Descripción pública; consulta Planificar una ventana de mantenimiento. La ventana aparece en la página de cada entidad cuyos componentes siguen recursos que ella cubre: en Mantenimiento mientras está en curso y, en caso contrario, su siguiente repetición dentro de 30 días. Una ventana semanal indica que se repite en lugar de enumerar cada semana. Solo se muestran el título y la descripción públicos, nunca el motivo interno.
Servir la página en su propio dominio
Para publicar la página como https://status.ciguapa.example/status/ciguapa:
- Apunta el DNS del nombre al servidor, con un registro
CNAMEoA. - Pide a un superadministrador que agregue el nombre como alias en Configuración › Servidor y certificados y, con un certificado de Let's Encrypt o propio, que lo mantenga entre los nombres del certificado. Consulta Configurar nombres y TLS.
- Escribe el nombre en el Dominio propio de la página y selecciona Guardar.
Los enlaces de la página y de sus feeds usan entonces ese nombre cuando la página se abre a través de él. La raíz de ese nombre, https://status.ciguapa.example/, sigue abriendo la página de inicio de sesión de la consola, así que comparte la dirección completa con /status/<short name>.
Configurar la apariencia de una rama
Configuración › Apariencia de la rama establece un Tema por defecto y una Dirección del logotipo en una entidad; todas las entidades que están debajo los heredan hasta que establecen los suyos. En vigor muestra el resultado y de dónde viene. Una página de estado sin logotipo propio usa el logotipo de su entidad. En esta versión, la consola en sí todavía no aplica el tema de una rama; en cualquier caso, el tema que elige cada persona tendría prioridad sobre él.
Disponibilidad
Cada componente registra cuánto tiempo pasó en cada estado, por día de la zona horaria de la página. Los días con un cambio de horario de verano tienen 23 o 25 horas. La barra muestra una celda por día, 90 en una computadora, 60 en una tableta y 30 en un teléfono, coloreada según el peor estado que duró un minuto o más ese día, con detalles al pasar el puntero, al tocar o con el foco del teclado.
- Disponibilidad diaria = 1 − (interrupción grave + 0.3 × interrupción parcial) ÷ tiempo conocido. El rendimiento degradado cuenta como disponible. El mantenimiento y Sin datos quedan fuera del tiempo conocido, así que el trabajo planificado nunca reduce la cifra.
- El porcentaje principal usa la misma fórmula sobre 90 días. Un componente creado recientemente muestra la disponibilidad desde su primer día.
- Un periodo con cualquier tiempo de inactividad muestra 99.99% como máximo, nunca 100%.
- El historial se conserva 400 días. Una zona horaria nueva se aplica a los días nuevos; los días ya registrados conservan sus límites.
Feeds y caché
La página enlaza a tres feeds de las actualizaciones de sus incidencias y de los mantenimientos anunciados: RSS 2.0, Atom 1.0 y JSON Feed 1.1, en /api/v1/status/<short name>/feed.rss, feed.atom y feed.json. Agrega ?lang=es para tener las etiquetas en español. Las suscripciones por correo electrónico todavía no están disponibles.
Las direcciones públicas no requieren iniciar sesión y son baratas de servir. La página responde con Cache-Control: public, max-age=30 y un ETag, y los feeds con max-age=300, así que una CDN o el proxy que está delante pueden almacenarlas en caché tal cual. Las respuestas llevan Access-Control-Allow-Origin: *, para que otros sitios puedan leer el JSON.
Desconectar la página
- Para ocultarla durante un tiempo, desmarca Publicada y guarda. Su dirección responde no encontrado de inmediato.
- Desactivar la función
ui.public_status_pagehace lo mismo con todas las páginas. - Eliminar la página la quita junto con sus componentes, sus incidencias y su historial de disponibilidad. No se puede deshacer.