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
| Installation | Speicherort |
|---|---|
| Bare Metal | data/kuma.db im Arbeitsverzeichnis von Kuma |
| Docker | Im 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 Kuma | SolidPing |
|---|---|
http | http |
keyword | http, der Body muss das Schlüsselwort enthalten (invertiert: darf es nicht enthalten) |
json-query | http mit einer JSONPath-Assertion |
port | tcp |
ping | icmp |
dns | dns |
docker | docker |
push | heartbeat |
grpc-keyword | grpc |
mqtt | mqtt |
postgres | postgresql |
mysql | mysql |
redis | redis |
sqlserver | mssql |
mongodb | mongodb |
steam | a2s |
real-browser | browser |
group | eine 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.
ignoreTlsundupsideDown. 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.