Zum Hauptinhalt springen

Von Uptime Kuma zu SolidPing migrieren

Sie müssen Ihre Monitore nicht von Hand neu anlegen. SolidPing liest Ihre Uptime-Kuma-Daten, macht aus jedem Monitor einen Check und aus Kumas Monitorgruppen Check-Gruppen. Zuerst kommt eine Vorschau, es wird also nichts geschrieben, bevor Sie es sagen.

Noch nicht sicher, ob Sie wechseln möchten? Lesen Sie zuerst SolidPing vs. Uptime Kuma. Dort steht auch, wo Kuma die bessere Wahl ist.

Uptime Kuma 2.x​

Kuma 2.0 hat den JSON-Backup-Export entfernt. Die sp-CLI liest deshalb Ihre SQLite-Datenbank (kuma.db) direkt, auf Ihrem eigenen Rechner. Die Datei verlässt ihn nie. sp öffnet sie schreibgeschützt und liest drei kleine Tabellen (monitor, tag, monitor_tag). Die Heartbeat-Historie, die Tabelle notification und die Tabelle user, in der Kuma Integrations-Tokens und Passwort-Hashes ablegt, rührt sie nicht an.

1. kuma.db finden​

InstallationSpeicherort
Bare Metaldata/kuma.db im Arbeitsverzeichnis von Kuma
DockerIm unter /app/data gemounteten Volume: docker cp <container>:/app/data/kuma.db .

Kuma läuft im WAL-Modus, daneben liegen also eventuell auch kuma.db-wal und kuma.db-shm. Kopieren Sie alle drei zusammen oder stoppen Sie Kuma vorher. Ohne die -wal-Datei fehlen neuere Monitore, ohne dass es eine Meldung gibt.

Kuma auf MariaDB hat keine kuma.db, dieser Weg gilt dafür also nicht.

2. Vorschau​

sp checks import --from uptime-kuma-db ./kuma.db

Die Vorschau ist der Standard. Sie erhalten die Liste der Checks, die angelegt würden, und jedes Element, das sich nicht sauber abbilden ließ.

3. Anwenden​

sp checks import --from uptime-kuma-db ./kuma.db --apply

Checks werden über ihren Slug zugeordnet. Ein erneuter Lauf aktualisiert sie also an Ort und Stelle, statt sie zu duplizieren. Sie können Kuma neben SolidPing weiterlaufen lassen, bis Sie umstellen möchten.

Uptime Kuma 1.x​

Exportieren Sie über Profile > Settings > Backup > Export. Öffnen Sie dann im SolidPing-Dashboard Prüfungen > Importieren, wählen Sie Uptime Kuma (Backup-JSON), fügen Sie die Datei ein oder laden Sie sie hoch und klicken Sie auf Importvorschau. Oder nutzen Sie die API:

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

Lassen Sie dryRun=true weg, um anzuwenden. Das Token muss einem Administrator der Organisation gehören.

Was übernommen wird​

Uptime KumaSolidPing
httphttp
keywordhttp, der Body muss das Schlüsselwort enthalten (invertiert: darf es nicht enthalten)
json-queryhttp mit einer JSONPath-Assertion
porttcp
pingicmp
dnsdns
dockerdocker
pushheartbeat
grpc-keywordgrpc
mqttmqtt
postgrespostgresql
mysqlmysql
redisredis
sqlservermssql
mongodbmongodb
steama2s
real-browserbrowser
groupeine Check-Gruppe, ihre Kinder werden ihr zugeordnet

Intervall, Timeout, erwartete Statuscodes, Header, DNS-Server und Record-Typ werden übernommen. Wiederholungen mal Wiederholungsintervall ergeben den Bestätigungszeitraum für Incidents.

Was Sie von Hand erledigen​

Die Vorschau listet all das als Warnungen auf.

  • Passwörter. Zugangsdaten für Datenbanken, MQTT und Basic Auth werden nie importiert. Geben Sie sie im Check erneut ein.
  • Push-Monitore bekommen neue URLs. Ein push-Monitor wird zu einem Heartbeat-Check mit einer neuen Ping-URL. Kopieren Sie sie und stellen Sie den Job, der dorthin pusht, darauf um.
  • Benachrichtigungen. Kumas Verknüpfungen werden nicht übernommen. Richten Sie die Integrationen und die Bereitschaft von SolidPing ein.
  • Tags. Fügen Sie die SolidPing-Labels selbst hinzu.
  • ignoreTls und upsideDown. Keine Entsprechung. SolidPing prüft Zertifikate, und der Check meldet ganz normal.
  • gamedig, radius, tailscale-ping. Noch kein Gegenstück, diese werden übersprungen.
  • Status-Historie. Ergebnisse lassen sich nicht zwischen Tools übertragen.

Importierte Checks tragen das Label solidping-managed=uptime-kuma, so können Sie genau nach dem filtern, was der Import angelegt hat.

Vollständige Referenz​

Die vollständige Anleitung, gepflegt direkt beim Code, finden Sie unter solidping.io/docs/features/migrate/from-uptime-kuma. Wenn etwas nicht so importiert wird, wie Sie es erwarten, eröffnen Sie ein Issue mit einem Beispiel. Dieses Beispiel ist der größte Teil der Arbeit.