Uptime Kuma

Bien qu'il existe une abondance de solutions de surveillance de la disponibilité des services, il peut être difficile d'en trouver une qui réponde à vos besoins fondamentaux tout en fonctionnant simplement sans personnalisations complexes. En utilisant différentes approches pour la disponibilité continue, nous recommandons une solution simple adaptée à tous les propriétaires d'instances On‑premise, qu'elles soient déployées localement au sein des organisations ou dans des services cloud.

La solution élégante que nous recommandons répond aux besoins suivants :

  • Déployée localement sur le serveur (donc adaptée aux infrastructures classifiées)

  • Facile à installer

  • Dispose d'une interface conviviale et n'est pas surchargée d'options

  • Capable de surveiller une variété de métriques (pas seulement pinger une adresse)

  • Prend en charge diverses options de notification (e-mail, sms, messagers et plus)

La solution s'appelle Uptime Kuma et est disponible sur le GitHub de l'auteur :

https://github.com/louislam/uptime-kuma

Cette solution est conçue pour la surveillance externe de la disponibilité des services, ce qui est généralement suffisant. Elle n'est pas adaptée à la surveillance de métriques internes, telles que l'état des services système, la charge CPU, la consommation de mémoire, etc.

Installation

L'installation est décrite en détail sur la page produit sur GitHub, nous n'insisterons donc pas sur ses détails. Il convient de noter que le plus simple est de déployer le conteneur Docker, ce qui se fait littéralement en une commande.

Comment installer Docker ?

Il existe de nombreuses instructions sur la façon d'installer Docker sur différentes plateformes. La méthode la plus simple consiste à utiliser une distribution Linux à jour et à effectuer l'installation avec ces commandes :

curl -fsSL https://get.docker.com -o install-docker.sh
sh ./install-docker.sh

Si vous utilisez une autre plateforme (Mac, Windows) ou souhaitez installer Docker Desktop, veuillez vous référer à la section appropriée de la documentation Docker :

https://docs.docker.com/manuals/

Il existe également une méthode d'installation alternative sans utiliser Docker, qui est également relativement simple et disponible pour Linux et Windows. Le choix de la méthode d'installation vous appartient.

Il est important de s'assurer que vous disposez d'un port dédié sur votre serveur pour Uptime Kuma - le port par défaut est 3001.

Après l'installation, l'interface web d'Uptime Kuma sera accessible via l'adresse du serveur (domaine ou adresse IP) et le port, et immédiatement prête à l'emploi. Vous devrez définir les identifiants administrateur et procéder à la configuration des métriques.

Métriques

Les métriques les plus importantes d'un point de vue métier sont la disponibilité du site web, l'accès des clients aux données et l'enregistrement de nouvelles données provenant des dispositifs de suivi. C'est ce que nous allons surveiller.

Pour chaque métrique, vous pouvez spécifier un intervalle de heartbeat pour ajuster la fréquence des vérifications (la valeur par défaut est 60 secondes), ajuster le nombre de tentatives (avant de considérer le serveur comme indisponible) et définir d'autres paramètres.

Disponibilité du site web

Pour commencer, créez le premier moniteur qui suivra la disponibilité du domaine en se basant sur des requêtes HTTPS. Sélectionnez le type de moniteur HTTP(s), donnez‑lui un nom et spécifiez l'URL de votre site web. Cela vérifiera la disponibilité du site en se basant sur les codes de statut HTTP. Les codes valides sont 200‑299, donc si tout autre code est reçu (par ex. 404 Not found ou 504 Gateway timeout) cela sera considéré comme une défaillance et le moniteur signalera que le service est indisponible.

La section « Avancé » offre des options de configuration de surveillance étendues, et en particulier la notification d'expiration de certificat. Cochez cette option pour être notifié lorsque le certificat de votre site expire afin de pouvoir le réémettre rapidement.

Enregistrez les paramètres du moniteur, et il commencera automatiquement à suivre la disponibilité du site web.

Disponibilité de l'API

L'API est un service central nécessaire pour qu'un site web interagisse avec le backend de la plateforme ; de plus, de nombreux clients l'utilisent pour récupérer des données directement depuis la plateforme. Par conséquent, le fonctionnement stable de l'API est également d'une importance primordiale. Et la surveillance de ce service peut se faire avec une simple requête API.

La requête ressemble à ceci :

https://my.domain.com/api/base/ping/

Et la réponse d'un service fonctionnant normalement serait le JSON suivant :

{"success": true}

Vous pouvez configurer le moniteur pour fonctionner avec cette réponse. Pour ce faire, créez un autre moniteur de type HTTP(s), spécifiez la requête API dans l'URL, puis personnalisez les options HTTP :

  • Méthode : GET

  • Encodage du corps : JSON

  • Corps : {"success": true}

Enregistrez les paramètres du moniteur, et il commencera automatiquement à vérifier la disponibilité de l'API en envoyant la requête spécifiée et en analysant les réponses.

Disponibilité TCP

La réception des données des dispositifs est cruciale pour la plateforme de suivi. Il est donc important de maintenir l'accès aux dispositifs et de surveiller l'activité du serveur TCP. Étant donné que le service de surveillance est externe à la plateforme, vous pouvez simplement surveiller la disponibilité externe de n'importe quel port sur lequel les dispositifs de suivi se connectent. Par exemple, cela peut être le port 47770 pour l'application mobile X-GPS tracker, 47776 pour Teltonika ou tout autre port pour les dispositifs que vous utilisez.

Configurez le moniteur : sélectionnez le type de moniteur « TCP Port », spécifiez votre domaine de base et le port de votre choix.

Enregistrez les paramètres du moniteur, et il commencera à vérifier la disponibilité du port.

Notifications

Pour chaque métrique, vous avez la possibilité de configurer des notifications afin qu'Uptime Kuma vous alerte lorsque des événements d'indisponibilité se produisent. Ainsi, vous pouvez non seulement disposer de graphiques de disponibilité des services, mais également recevoir des notifications urgentes si l'un des services tombe en panne.

Vous pouvez configurer différents types de notifications, mais il est important de noter qu'Uptime Kuma n'est pas lui‑même une passerelle de notification. Pour configurer tout type de notification, vous avez besoin des identifiants d'une passerelle externe appropriée (par ex. SMTP, Twilio, Discord, etc.).

Après avoir spécifié les paramètres de la passerelle de notification, vous serez informé des problèmes de service via le canal de votre choix.

Mis à jour

Ce contenu vous a-t-il été utile ?