Von Gatus zu SolidPing migrieren
SolidPing liest eine Gatus-config.yaml direkt. Jeder Eintrag der endpoints:-Liste wird
zu einem Check, samt Bedingungen. Zuerst gibt es eine Vorschau, es wird also nichts
geschrieben, bevor Sie es freigeben.
Noch unsicher, ob Sie wechseln wollen? Lesen Sie zuerst SolidPing vs. Gatus. Dort steht auch, wo Gatus die bessere Wahl ist, und für alle, deren Monitoring in einem Git-Repository leben soll, ist es das oft.
1. Ihre Konfiguration finden
Gatus hat keine Export-API, die YAML-Datei ist die maßgebliche Quelle.
- Docker oder Compose: die Datei, die Sie unter
/config/config.yamleinhängen. - Kubernetes: die ConfigMap, die der Pod einhängt, zum Beispiel
kubectl get configmap gatus-config -o jsonpath='{.data.config\.yaml}'. - Binary:
config/config.yamlneben dem Binary, oder wohinGATUS_CONFIG_PATHzeigt.
Wenn Ihre Konfiguration auf ein Verzeichnis verteilt ist, fügen Sie die Dateien, die
endpoints: enthalten, vorher zu einem Dokument zusammen.
2. Vorschau
Öffnen Sie im SolidPing-Dashboard Prüfungen > Importieren, wählen Sie Gatus (config.yaml), fügen Sie die Datei ein oder laden Sie sie hoch und klicken Sie auf Importvorschau. Sie erhalten die Liste der Checks, die angelegt würden, und jedes Element, das sich nicht sauber übertragen ließ.
Oder nutzen Sie die API mit einem Admin-Token der 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. Anwenden
Bestätigen Sie im Dashboard, oder lassen Sie dryRun=true im API-Aufruf weg. Checks werden
über ihren Slug zugeordnet: Ein erneuter Lauf aktualisiert sie also, statt sie zu
duplizieren. Gatus kann parallel zu SolidPing weiterlaufen, bis Sie umstellen.
Was übernommen wird
| Gatus | SolidPing |
|---|---|
http://, https:// | http |
tcp://, tls://, starttls:// | tcp (TLS aktiv für tls und starttls) |
udp:// | udp |
icmp://, ping:// | icmp |
ssh:// | ssh |
ws://, wss:// | websocket |
ein dns:-Block | dns (die url wird zum Resolver) |
group | eine Check-Gruppe, beim Anwenden angelegt |
Name, enabled, Intervall, Methode, Body, Header und Client-Timeout werden übernommen.
Auch die Bedingungen werden übersetzt:
| Gatus-Bedingung | SolidPing |
|---|---|
[STATUS] == 200 | erwarteter Status |
[STATUS] == any(200, 301), == 2XX | erwartete Statuscodes |
[BODY] == value, != value | Body muss enthalten, darf nicht enthalten |
[BODY] == pat(*glob*) | Body-Regex |
[BODY].path == value (sowie !=, >, >=, <, <=) | eine JSONPath-Assertion |
has([BODY].path) == true | eine exists-Assertion |
[CERTIFICATE_EXPIRATION] > 48h | ein separater ssl-Check mit diesem Schwellenwert |
[DOMAIN_EXPIRATION] > 720h | ein separater domain-Check mit diesem Schwellenwert |
Was Sie von Hand erledigen
Die Vorschau führt all das als Warnungen auf. Der Check wird trotzdem importiert.
- Bedingungen mit
[RESPONSE_TIME]und[IP]. SolidPing erfasst die Antwortzeit als Metrik, nicht als Bedingung für Erfolg oder Fehlschlag. - Bedingungen mit
len([BODY].path). Keine direkte Entsprechung. - Alarme. Benachrichtigungszuordnungen werden nicht übernommen. Richten Sie in SolidPing Integrationen und Bereitschaft ein.
external-endpoints. Legen Sie sie als Heartbeat-Checks neu an.- SSH-Zugangsdaten. Werden bewusst nie importiert. Tragen Sie sie im Check neu ein.
sctp://. Kein Gegenstück, wird mit einer Warnung übersprungen.
Importierte Checks tragen das Label solidping-managed=gatus, so können Sie genau nach dem
filtern, was der Import angelegt hat.
Vollständige Referenz
Die vollständige Anleitung, gepflegt direkt neben dem Code, finden Sie unter solidping.io/docs/features/migrate/from-gatus. Wenn etwas nicht so importiert wird, wie Sie es erwarten, eröffnen Sie ein Issue mit einem Beispiel. Das Beispiel ist schon der größte Teil der Arbeit.