Orbit
Página de Estado de Orbit
A status page is a public, no-login URL that shows whether your project is up, how it has performed recently, and what you have deployed. Turning it on also starts an uptime check that pings your…
Una página de estado es una URL pública sin necesidad de iniciar sesión que muestra si tu proyecto está operativo, cómo ha funcionado recientemente y qué has desplegado. Al activarla, también se inicia una verificación de tiempo de actividad que hace ping a tu proyecto cada minuto, por lo que obtienes monitoreo como efecto secundario de publicarla.
Dónde están las configuraciones de la página de estado
Abre Orbit, haz clic en el proyecto y elige Status page bajo el grupo Observability en la pestaña del proyecto. La página se titula Public status page.
Activarla
- Activa Enable public status page.
- Elige un Public slug. Se convierte en parte de la URL pública, así que elige algo reconocible, como el nombre de tu producto.
- Opcionalmente, establece un Ping path. Por defecto es
/. - Rellena el Page title y Tagline que se muestran en la parte superior de la página pública.
- Decide si deseas Show recent deploys y Show recent incidents.
- Haz clic en Save settings.
Una vez guardado, la página muestra un distintivo Live y confirma que tu página de estado está publicada y hace ping cada minuto. Un enlace te lleva a la página pública para que veas lo que ven los visitantes.
Reglas de slug
El slug debe contener solo letras minúsculas, dígitos e guiones, hasta 80 caracteres, y no puede comenzar ni terminar con un guion. Los slugs son únicos en todo Orbit, no solo en tu cuenta, así que es posible que una palabra común ya esté en uso. Si es así, guardar devuelve un mensaje diciendo que el slug ya está en uso y debes elegir otro.
Elige el slug con cuidado: es la dirección pública que pondrás en tu documentación y en tus respuestas de soporte, y cambiarla más tarde rompe cada enlace hacia ella.
Qué ven los visitantes
La página pública se construye a partir de los mismos datos que las pestañas de tu proyecto:
- Current status, desde el despliegue más reciente: Operational, Building, Deploying, Queued, Awaiting Approval, Build Failed, Cancelled o Rolled Back.
- Uptime, calculado en ventanas móviles de 24 horas, 7 días y 30 días a partir de las verificaciones minuto a minuto.
- Recent deployments con una tasa de éxito, si habilitaste esa sección.
- 30-day statistics: tasa de éxito, tiempo promedio de compilación y total de despliegues.
- Core Web Vitals, como p75 en los últimos 30 días, si los estás recopilando.
- Incidents, extraídos de anotaciones que has marcado en la línea de tiempo del proyecto.
La página se actualiza automáticamente, así que un cliente que la deja abierta durante un incidente la ve actualizarse sin recargar.
Todo en la página es datos operativos: estado de despliegue, tiempos de respuesta, tiempo de actividad y vitales. Los mensajes de commit, nombres de rama, variables de entorno y los detalles de tu repositorio no se publican.
Los incidentes provienen de la línea de tiempo
La sección de incidentes no es un editor separado. Muestra anotaciones de tipo Incident de la Timeline del proyecto, así que el flujo de trabajo durante una interrupción es: marcar una anotación de incidente y aparece públicamente.
Esto es intencional. Significa que tu línea de tiempo interna y tu comunicación pública se mantienen sincronizadas sin que nadie tenga que mantener dos registros. Consulta Orbit Timeline Annotations para saber cómo escribir una.
Escribe anotaciones de incidente como si un cliente fuera a leerlas, porque lo hará. Di qué se ve afectado, qué sabes y cuándo darás la próxima actualización. Luego publica una anotación de actualización cuando se resuelva, en lugar de dejar la última palabra pública como "investigando".
La verificación de tiempo de actividad
Habilitar la página de estado inicia una verificación que obtiene la URL de producción de tu proyecto, en el ping path que estableciste, una vez por minuto. Cada resultado se almacena y los porcentajes de tiempo de actividad en la página pública se calculan a partir de esos registros.
Las verificaciones se conservan durante 90 días y las más antiguas se eliminan automáticamente.
Elegir un buen ping path
El predeterminado / funciona para la mayoría de proyectos. Dos razones para elegir algo diferente:
- Tu página de inicio es pesada. Un path ligero es algo más justo y económico de consultar una vez por minuto.
- Tu página de inicio puede estar activa mientras la aplicación está rota. Un shell estático en caché devolverá felizmente 200 mientras tu API está caída. Un path como
/api/healthque realmente ejercita la aplicación dice la verdad.
Si ya tienes una verificación de estado configurada para auto-reversión, usar el mismo path aquí mantiene ambas señales consistentes. Consulta Deploying Your Project para los ajustes de verificación de estado.
No apuntes el ping path a algo costoso, y no lo apuntes a un path detrás de autenticación. Un path que devuelve 401 o 302 a una página de inicio de sesión registrará un fallo cada minuto y tu tiempo de actividad se leerá como cero.
Eliminar la página de estado
Haz clic en Remove page y confirma. La confirmación es explícita: todo el historial de tiempo de actividad se eliminará.
Merece la pena pausar en esto. Eliminar la página no es un botón de pausa. La verificación se detiene, la URL pública deja de funcionar y el registro de tiempo de actividad acumulado se va con ella. Si solo quieres que la página sea temporalmente invisible, no hay un modo oculto: considera si desactivar el botón de alternancia y dejar la configuración en su lugar te conviene más que eliminarla.
El slug se libera cuando se elimina la página, por lo que otra persona puede reclamarlo después.
Consejos prácticos
Publica antes de que la necesites. Una página de estado creada durante una interrupción es una página que nadie ha marcado. Pon el enlace en tu pie de página, tu documentación y tu firma de soporte mientras todo está bien.
No hagas promesas excesivas. La cifra de tiempo de actividad en la página proviene de una verificación de un minuto contra un único path. Es un monitoreo honesto, no un SLA contractual, y no debe presentarse como tal.
Mantén el tagline corto. Se coloca bajo el título en una página que la gente abre cuando ya está frustrada. Una línea diciendo qué es el servicio, y nada más.
Resolución de problemas
El tiempo de actividad muestra 0% o es mucho menor que la realidad. El ping path está devolviendo una respuesta no 2xx. Ábrelo en una ventana de navegación privada: una redirección a una página de inicio de sesión, un 404 de un path que ya no existe o un bloqueo geográfico son las causas habituales.
La URL pública devuelve 404. La página se guardó pero el botón de alternancia está desactivado, o el slug en tu enlace no coincide con el guardado. Copia el enlace de la página de configuración.
El slug es rechazado. Está en uso, contiene un carácter inválido o comienza o termina con un guion.
No aparecen vitales en la página pública. Los vitales provienen del script del recopilador en tu sitio. Consulta Orbit Web Vitals.
No aparecen incidentes aunque hayamos tenido uno. La anotación tiene que ser de tipo Incident y el interruptor Show recent incidents tiene que estar activado.
Dónde ir a continuación
- Orbit Timeline Annotations para publicar actualizaciones de incidentes.
- Orbit Webhooks para recibir notificaciones antes que tus clientes.
- Orbit Web Vitals para las cifras de rendimiento que se muestran públicamente.