Aller au contenu principal

Migrer d'Uptime Kuma vers SolidPing

Inutile de recréer vos moniteurs à la main. SolidPing lit vos données Uptime Kuma, transforme chaque moniteur en contrôle et chaque groupe de moniteurs Kuma en groupe de contrôles. 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 Uptime Kuma. Cette page indique aussi dans quels cas Kuma est le meilleur choix.

Uptime Kuma 2.x​

Kuma 2.0 a supprimé l'export de sauvegarde JSON, la CLI sp lit donc directement votre base SQLite (kuma.db), sur votre propre machine. Le fichier ne la quitte jamais. sp l'ouvre en lecture seule et lit trois petites tables (monitor, tag, monitor_tag). Il ne touche ni à l'historique des heartbeats, ni à la table notification, ni à la table user, où Kuma conserve les jetons d'intégration et les empreintes de mots de passe.

1. Trouver kuma.db​

InstallationEmplacement
Sur machine nuedata/kuma.db dans le répertoire de travail de Kuma
DockerDans le volume monté sur /app/data : docker cp <container>:/app/data/kuma.db .

Kuma fonctionne en mode WAL, vous verrez donc peut-être aussi kuma.db-wal et kuma.db-shm à côté. Copiez les trois fichiers ensemble, ou arrêtez Kuma au préalable. Sans le fichier -wal, les moniteurs récents manquent sans le moindre avertissement.

Kuma sur MariaDB n'a pas de kuma.db, cette méthode ne s'y applique donc pas.

2. Aperçu​

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

L'aperçu est le mode par défaut. Vous obtenez la liste des contrôles qui seraient créés et chaque élément qui n'a pas pu être converti à l'identique.

3. Appliquer​

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

Les contrôles sont rapprochés par leur slug : relancer la commande met à jour l'existant au lieu de créer des doublons. Vous pouvez laisser Kuma tourner à côté de SolidPing jusqu'à ce que vous soyez prêt à basculer.

Uptime Kuma 1.x​

Exportez depuis Profile > Settings > Backup > Export, puis dans le tableau de bord SolidPing ouvrez Contrôles > Importer, choisissez Uptime Kuma (sauvegarde JSON), collez ou envoyez le fichier et cliquez sur Aperçu de l'import. Ou passez par l'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'

Retirez dryRun=true pour appliquer. Le jeton doit appartenir à un administrateur de l'organisation.

Ce qui est converti​

Uptime KumaSolidPing
httphttp
keywordhttp, le corps doit contenir le mot-clé (inversé : ne doit pas le contenir)
json-queryhttp avec une assertion JSONPath
porttcp
pingicmp
dnsdns
dockerdocker
pushheartbeat
grpc-keywordgrpc
mqttmqtt
postgrespostgresql
mysqlmysql
redisredis
sqlservermssql
mongodbmongodb
steama2s
real-browserbrowser
groupun groupe de contrôles, auquel ses enfants sont rattachés

L'intervalle, le délai d'expiration, les codes de statut attendus, les en-têtes, le serveur DNS et le type d'enregistrement sont repris. Le nombre de tentatives multiplié par l'intervalle entre tentatives devient la période de confirmation des incidents.

Ce que vous faites à la main​

L'aperçu signale tous ces points sous forme d'avertissements.

  • Mots de passe. Les identifiants de base de données, MQTT et d'authentification basique ne sont jamais importés. Saisissez-les à nouveau sur le contrôle.
  • Les moniteurs push reçoivent de nouvelles URL. Un moniteur push devient un contrôle heartbeat avec une nouvelle URL de ping. Copiez-la et faites pointer vers elle la tâche qui envoie les pings.
  • Notifications. Les liaisons de Kuma ne sont pas reprises. Configurez les intégrations et l'astreinte de SolidPing.
  • Tags. Ajoutez vous-même les labels SolidPing.
  • ignoreTls et upsideDown. Pas d'équivalent. SolidPing vérifie les certificats et le contrôle rend compte normalement.
  • gamedig, radius, tailscale-ping. Pas encore d'équivalent, ils sont ignorés.
  • Historique des statuts. Les résultats ne sont pas transférables d'un outil à l'autre.

Les contrôles importés portent le label solidping-managed=uptime-kuma, 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-uptime-kuma. 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.