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é parGATUS_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
| Gatus | SolidPing |
|---|---|
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) |
group | un 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 Gatus | SolidPing |
|---|---|
[STATUS] == 200 | statut attendu |
[STATUS] == any(200, 301), == 2XX | codes de statut attendus |
[BODY] == value, != value | le 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) == true | une assertion exists |
[CERTIFICATE_EXPIRATION] > 48h | un contrôle ssl distinct avec ce seuil |
[DOMAIN_EXPIRATION] > 720h | un 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.