Ir al contenido

Documentación

Documentación de Pingio

Cómo encajan entre sí los monitores, las incidencias, los canales de notificación y las páginas de estado públicas.

Primeros pasos

Crea una cuenta, añade tu primer monitor y conecta un canal de notificación. Pingio empieza a comprobar de inmediato y muestra el primer resultado dentro del primer intervalo.

Cada monitor necesita un objetivo, un tipo de comprobación y un intervalo. Todo lo demás tiene un valor por defecto razonable que puedes ajustar más adelante.

  • Añade un monitor desde el panel de control o mediante la API.
  • Conecta al menos un canal para que las alertas tengan a dónde ir.
  • Abre la página de detalle del monitor para ver el historial de comprobaciones en bruto.

Tipos de monitor

Pingio admite comprobaciones HTTP(S), de palabra clave, de puerto TCP, de ping, de certificado SSL y de agente de servidor. Cada tipo tiene sus propias aserciones y su política de tiempo de espera.

  • HTTP(S): código de estado, tiempo de respuesta, redirecciones y cabeceras de la petición.
  • Palabra clave: comprueba que una frase esté presente o ausente en el cuerpo de la respuesta.
  • TCP y ping: accesibilidad de un host y un puerto desde varias regiones.
  • SSL: caducidad del certificado, validez de la cadena y coincidencia del nombre de host.
  • Agente de servidor: métricas de CPU, memoria y disco que informa un agente instalado.

Programación y verificación

Los monitores se encolan por intervalo y se reparten entre los workers. Cuando una comprobación falla, Pingio la repite desde otra región antes de abrir una incidencia, de modo que una sola ruta con problemas nunca avisa a tu equipo por sí sola.

Una vez abierta la incidencia, Pingio sigue comprobando con la programación habitual y la cierra automáticamente tras el número de comprobaciones correctas que hayas configurado.

Incidencias y notificaciones

Los fallos repetidos se agrupan en una única incidencia con su cronología. Las notificaciones se envían al abrirse la incidencia, cuando toca un recordatorio y cuando se resuelve.

El intervalo de los recordatorios y su número máximo se configuran por equipo, para que las caídas largas sigan siendo visibles sin inundar tus canales.

  • Correo, Telegram, Slack, SMS y webhooks genéricos.
  • Enrutado de canales por monitor y horas de silencio.
  • Deduplicación para que una caída nunca genere alertas repetidas.

Páginas de estado públicas

Cada equipo puede publicar una o varias páginas de estado que muestran el estado actual de los monitores, el historial de incidencias y los mantenimientos programados. Las páginas de estado están localizadas y las indexan los buscadores.

Acceso por API

La API REST replica el panel de control. Úsala para crear monitores desde tu código de infraestructura, llevar el historial de comprobaciones a tus propios paneles o abrir ventanas de mantenimiento durante un despliegue.

{
  "name": "Primary website",
  "type": "http",
  "target": "https://example.com",
  "intervalSeconds": 60,
  "regions": ["eu-central", "us-east"],
  "assertions": {
    "status": 200,
    "contains": "Welcome"
  }
}