Outil en ligne de commande (CLI)
La commande pingerer pour votre terminal et votre CI : l'installer, se connecter et les commandes.
Installation
Un seul petit programme pour macOS, Linux et Windows, sans rien d'autre à installer. Sur un Mac ou sous Linux avec Homebrew :
brew install pingerer-app/tap/pingerer
Ou avec le script d'installation (macOS et Linux) :
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/pingerer-app/pingerer/releases/latest/download/pingerer-installer.sh | sh
Sous Windows, dans PowerShell :
powershell -ExecutionPolicy Bypass -c "irm https://github.com/pingerer-app/pingerer/releases/latest/download/pingerer-installer.ps1 | iex"
Ou téléchargez-le pour votre ordinateur depuis la page des versions. Vous déployez avec GitHub ? L'action Pingerer ouvre une fenêtre de maintenance et vérifie que votre site est revenu, sans rien installer.
Se connecter
Créez un jeton d'API (API), puis :
pingerer login # demande le jeton, le vérifie et l'enregistre
pingerer whoami
Le jeton est enregistré dans ~/.config/pingerer/config.json, lisible par vous seul. En CI, définissez plutôt PINGERER_TOKEN. pingerer logout l'oublie.
Comptes
pingerer accounts
pingerer use "Your Bakery" # à partir de maintenant
pingerer status --account 42 # juste pour cette fois
Sites et surveillances
pingerer status # se termine avec le code 3 si quelque chose est hors ligne
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 # une vérification maintenant ; code 3 en cas d'échec
pingerer results mon_8xKq2 --since 24h --failed
Certains registres gardent les dates de renouvellement privées (la plupart dans le Golfe, comme .kw, .sa et .ae, et quelques autres comme .io). Indiquez-nous la vôtre et nous vous préviendrons avant l'échéance :
pingerer monitors set mon_3Hq7 --renews-on 2027-03-02 # « none » l'efface
Santé du site et aperçus de liens
Consultez la note de santé d'un site et ce qu'il faut corriger, ou relancez la vérification maintenant. Les deux commandes se terminent avec le code 3 en cas de problème critique, pour que vous puissiez arrêter un déploiement.
pingerer health yourbakery.com
pingerer health yourbakery.com --now # revérifie et attend une minute ou deux
pingerer link-preview yourbakery.com/menu # l'apparence de la page quand elle est partagée
Incidents
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 # par jeton, sans connexion
Heures calmes
Retenez la nuit les alertes qui peuvent attendre (SSL, domaine, DNS, configuration e-mail et lenteurs), et tout le week-end si vous le souhaitez. Les pannes et les heartbeats manqués passent toujours immédiatement.
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 # ou auto pour suivre votre fuseau horaire
Météo d'Internet
Est-ce vous, ou votre hébergeur ? Voyez quels hébergeurs, CDN et créateurs de sites rencontrent des problèmes en ce moment. Avec le nom d'une entreprise, la commande se termine avec le code 3 si celle-ci a des problèmes.
pingerer weather
pingerer weather cloudflare
Pages de statut et maintenance
pingerer status-pages list
pingerer status-pages show your-bakery # avec les adresses de son badge
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 et dans les scripts
export PINGERER_TOKEN=... # un jeton en lecture seule suffit
pingerer status || echo "Something is down"
Chaque commande accepte --json, --account et --[no-]color (la couleur est désactivée quand NO_COLOR est défini). Codes de sortie : 0 tout va bien, 1 une erreur, 2 mauvaise utilisation, 3 quelque chose est hors ligne. pingerer help et pingerer <command> --help listent le reste.
Toujours bloqué ? Écrivez-nous, une vraie personne vous répondra.