Aller au contenu principal

Migrer de Gatus vers SolidPing

SolidPing lit directement un config.yaml Gatus. Chaque entrée de la liste endpoints: devient un contrôle, conditions comprises. Il affiche d'abord un aperçu : rien n'est écrit tant que vous ne l'avez pas décidé.

Vous n'êtes pas sûr de vouloir changer ? Lisez d'abord SolidPing vs Gatus. Cette page indique aussi dans quels cas Gatus est le meilleur choix, et pour qui veut que sa supervision vive dans un dépôt Git, c'est souvent le cas.

1. Trouver votre configuration​

Gatus n'a pas d'API d'export, le fichier YAML fait foi.

  • Docker ou Compose : le fichier que vous montez sur /config/config.yaml.
  • Kubernetes : la ConfigMap que monte le pod, par exemple kubectl get configmap gatus-config -o jsonpath='{.data.config\.yaml}'.
  • Binaire : config/config.yaml à côté du binaire, ou l'emplacement indiqué par GATUS_CONFIG_PATH.

Si votre configuration est répartie dans un répertoire, concaténez d'abord en un seul document les fichiers qui contiennent endpoints:.

2. Aperçu​

Dans le tableau de bord SolidPing, ouvrez Contrôles > Importer, choisissez Gatus (config.yaml), collez ou envoyez le fichier et cliquez sur Aperçu de l'import. Vous obtenez la liste des contrôles qui seraient créés et chaque élément qui n'a pas pu être converti à l'identique.

Ou passez par l'API avec un jeton d'administrateur de l'organisation :

curl -s -X POST \
-H "Authorization: Bearer $TOKEN" \
-H 'Content-Type: application/yaml' \
--data-binary @config.yaml \
'https://your-instance/api/v1/orgs/myorg/checks/import/convert?source=gatus&dryRun=true'

3. Appliquer​

Confirmez dans le tableau de bord, ou retirez dryRun=true de l'appel d'API. Les contrôles sont rapprochés par leur slug : relancer l'import met à jour l'existant au lieu de créer des doublons. Vous pouvez laisser Gatus tourner à côté de SolidPing jusqu'à ce que vous soyez prêt à basculer.

Ce qui est converti​

GatusSolidPing
http://, https://http
tcp://, tls://, starttls://tcp (TLS activé pour tls et starttls)
udp://udp
icmp://, ping://icmp
ssh://ssh
ws://, wss://websocket
un bloc dns:dns (l'url devient le résolveur)
groupun groupe de contrôles, créé à l'application

Le nom, enabled, l'intervalle, la méthode, le corps, les en-têtes et le délai d'expiration client sont repris.

Les conditions sont traduites elles aussi :

Condition GatusSolidPing
[STATUS] == 200statut attendu
[STATUS] == any(200, 301), == 2XXcodes de statut attendus
[BODY] == value, != valuele corps doit contenir, ne doit pas contenir
[BODY] == pat(*glob*)expression régulière sur le corps
[BODY].path == value (et !=, >, >=, <, <=)une assertion JSONPath
has([BODY].path) == trueune assertion exists
[CERTIFICATE_EXPIRATION] > 48hun contrôle ssl distinct avec ce seuil
[DOMAIN_EXPIRATION] > 720hun contrôle domain distinct avec ce seuil

Ce que vous faites à la main​

L'aperçu signale tous ces points sous forme d'avertissements. Le contrôle est tout de même importé.

  • Conditions [RESPONSE_TIME] et [IP]. SolidPing enregistre le temps de réponse comme une métrique, pas comme une condition de réussite ou d'échec.
  • Conditions len([BODY].path). Pas d'équivalent direct.
  • Alertes. Les liaisons de notification ne sont pas reprises. Configurez les intégrations et l'astreinte de SolidPing.
  • external-endpoints. Recréez-les sous forme de contrôles heartbeat.
  • Identifiants SSH. Jamais importés, volontairement. Saisissez-les à nouveau sur le contrôle.
  • sctp://. Pas d'équivalent, ignoré avec un avertissement.

Les contrôles importés portent le label solidping-managed=gatus, ce qui vous permet de filtrer exactement ce que l'import a créé.

Référence complète​

Le guide complet, tenu à jour à côté du code, se trouve sur solidping.io/docs/features/migrate/from-gatus. Si quelque chose ne s'importe pas comme vous l'attendez, ouvrez un ticket avec un exemple. Cet exemple représente l'essentiel du travail.