Centre d'aide / Développeurs

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.