Zum Hauptinhalt springen

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.yaml einhängen.
  • Kubernetes: die ConfigMap, die der Pod einhängt, zum Beispiel kubectl get configmap gatus-config -o jsonpath='{.data.config\.yaml}'.
  • Binary: config/config.yaml neben dem Binary, oder wohin GATUS_CONFIG_PATH zeigt.

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​

GatusSolidPing
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:-Blockdns (die url wird zum Resolver)
groupeine Check-Gruppe, beim Anwenden angelegt

Name, enabled, Intervall, Methode, Body, Header und Client-Timeout werden übernommen.

Auch die Bedingungen werden übersetzt:

Gatus-BedingungSolidPing
[STATUS] == 200erwarteter Status
[STATUS] == any(200, 301), == 2XXerwartete Statuscodes
[BODY] == value, != valueBody muss enthalten, darf nicht enthalten
[BODY] == pat(*glob*)Body-Regex
[BODY].path == value (sowie !=, >, >=, <, <=)eine JSONPath-Assertion
has([BODY].path) == trueeine exists-Assertion
[CERTIFICATE_EXPIRATION] > 48hein separater ssl-Check mit diesem Schwellenwert
[DOMAIN_EXPIRATION] > 720hein 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.