Centro de ayuda / Desarrolladores

Herramienta de línea de comandos (CLI)

El comando pingerer para tu terminal y tu CI: instalarlo, iniciar sesión y los comandos.

Instalación

Un pequeño programa para macOS, Linux y Windows, sin nada más que instalar. En un Mac o en Linux con Homebrew:

brew install pingerer-app/tap/pingerer

O con el script de instalación (macOS y Linux):

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/pingerer-app/pingerer/releases/latest/download/pingerer-installer.sh | sh

En Windows, en PowerShell:

powershell -ExecutionPolicy Bypass -c "irm https://github.com/pingerer-app/pingerer/releases/latest/download/pingerer-installer.ps1 | iex"

O descárgalo para tu computadora desde la página de versiones. ¿Despliegas con GitHub? La acción de Pingerer abre una ventana de mantenimiento y comprueba que tu sitio ha vuelto, sin instalar nada.

Iniciar sesión

Crea un token de API (API) y luego:

pingerer login     # pide el token, lo comprueba y lo guarda
pingerer whoami

El token se guarda en ~/.config/pingerer/config.json, y solo tú puedes leerlo. En CI, define PINGERER_TOKEN en su lugar. pingerer logout lo olvida.

Cuentas

pingerer accounts
pingerer use "Your Bakery"        # a partir de ahora
pingerer status --account 42      # solo esta vez

Sitios y monitores

pingerer status                                   # sale con 3 cuando algo está caído
pingerer sites
pingerer sites add yourbakery.com --checks http,ssl,domain --every 1m
pingerer sites show yourbakery.com
pingerer sites pause yourbakery.com
pingerer sites rm yourbakery.com --yes

pingerer monitors --site yourbakery.com
pingerer monitors test mon_8xKq2                  # una comprobación ahora; sale con 3 si falla
pingerer results mon_8xKq2 --since 24h --failed

Algunos registros mantienen en privado las fechas de renovación (la mayoría en el Golfo, como .kw, .sa y .ae, y algunos otros como .io). Dinos la tuya y te lo recordaremos antes de que venza:

pingerer monitors set mon_3Hq7 --renews-on 2027-03-02   # "none" la borra

Salud del sitio y vistas previas de enlaces

Consulta la nota de salud de un sitio y qué arreglar, o vuelve a revisarlo ahora. Ambos salen con 3 cuando hay un problema crítico, así que puedes detener un despliegue por ello.

pingerer health yourbakery.com
pingerer health yourbakery.com --now              # vuelve a revisar y espera un par de minutos
pingerer link-preview yourbakery.com/menu         # cómo se ve la página al compartirla

Incidentes

pingerer incidents --open
pingerer incidents show INC-0042
pingerer incidents ack INC-0042
pingerer incidents note INC-0042 Restarted the web server
pingerer incidents resolve INC-0042 -m "Fixed by the host"

Heartbeats

pingerer heartbeats add "Nightly backup" --every 1d --grace 30m
pingerer heartbeats ping "Nightly backup"
pingerer heartbeats ping YOUR-TOKEN --fail        # por token, sin iniciar sesión

Horas de silencio

Retén durante la noche las alertas que pueden esperar (SSL, dominio, DNS, configuración del correo y lentitud), y todo el fin de semana si quieres. Las caídas y los heartbeats perdidos siempre llegan al momento.

pingerer quiet-hours
pingerer quiet-hours set --on --from 22:00 --to 07:00 --time-zone Asia/Kuwait --weekends
pingerer quiet-hours set --weekend fri_sat        # o auto para seguir tu zona horaria

Clima de internet

¿Eres tú o es tu proveedor? Mira qué empresas de hosting, CDN y creadores de sitios web tienen problemas ahora mismo. Con el nombre de una empresa, sale con 3 cuando esa empresa los tiene.

pingerer weather
pingerer weather cloudflare

Páginas de estado y mantenimiento

pingerer status-pages list
pingerer status-pages show your-bakery            # con las direcciones de su insignia
pingerer updates post your-bakery --state investigating --title "Checkout errors" \
  --message "We're looking into it." --component "Online shop=partial_outage"
pingerer updates post your-bakery --state resolved --message "Fixed." --follow-up su_8Fk2
pingerer maintenance list

En CI y scripts

export PINGERER_TOKEN=...   # basta con un token de solo lectura
pingerer status || echo "Something is down"

Todos los comandos aceptan --json, --account y --[no-]color (el color se desactiva cuando NO_COLOR está definido). Códigos de salida: 0 todo bien, 1 un error, 2 uso incorrecto, 3 algo está caído. pingerer help y pingerer <command> --help enumeran el resto.

¿Sigues atascado? Escríbenos y te responderá una persona.