Uptime Kuma : sur la surveillance de ton réseau avec Home Assistant

Introduction

As-tu déjà fait face à un serveur en panne, un interrupteur déconnecté de ton réseau Wi-Fi, ou encore un nom de domaine expiré ? Ces situations peuvent être frustrantes, surtout si tu n’es pas prévenu à temps. Heureusement, Uptime Kuma est là pour résoudre ce problème en te permettant de surveiller l’état de tes appareils et de recevoir des alertes en cas de défaillance.

Uptime Kuma est une solution de monitoring locale qui rivalise avec Uptime Robot, mais avec des fonctionnalités plus avancées et entièrement gratuites. Grâce à cet outil, tu pourras monitorer facilement tes services, qu’il s’agisse de sites web, de protocoles TCP, d’APIs et même de conteneurs Docker. Cet article va te guider étape par étape pour installer et configurer Uptime Kuma sur Home Assistant.

Prérequis techniques

Avant de plonger dans l’installation, assure-toi de disposer des éléments suivants :

• Home Assistant OS installé sur un Raspberry Pi ou tout autre serveur.

Résumé des étapes principales

1. Installation du module complémentaire Uptime Kuma dans Home Assistant.
2. Configuration de Uptime Kuma pour suivre tes appareils et services.
3. Configuration des notifications pour être alerté en cas de problème.

Prérequis

Versions logicielles requises

• Home Assistant version 2024.8.0 ou supérieure pour la prise en charge du module complémentaire Uptime Kuma.

Guide étape par étape

Étape 1 : Installation d’Uptime Kuma

1. Ouvre l’interface de Home Assistant.
2. Navigue vers les Paramètres > Modules complémentaires.
3. Clique sur Ajouter boutique des modules complémentaires.
4. Recherche Uptime Kuma dans le menu.
5. Sélectionne le module et clique sur Installer.

Note : L’installation prend entre 2 et 3 minutes. Sois patient.

6. Une fois l’installation terminée, active l’option Démarrer au démarrage et clique sur Démarrer.

Étape 2 : Configuration initiale de Uptime Kuma

1. Ouvre l’interface web d’Uptime Kuma.
2. Crée un compte d’accès (nom d’utilisateur et mot de passe).
3. Accède aux Paramètres pour ajuster le fuseau horaire si nécessaire.
4. Configure les notifications. Uptime Kuma prend en charge plus de 90 services de notification, y compris Email, Telegram, Home Assistant, etc.

Étape 3 : Ajouter des sondes de surveillance

1. Clique sur Ajouter une sonde pour surveiller un appareil (ex: Home Assistant).

• Type de sonde : HTTP(s)
• Nom d’affichage : Home Assistant
• URL : https://192.168.2.204:8123
• Délai d’expiration de la demande : 10 secondes

Attention : Si tu utilises un certificat SSL non valide, coche l’option pour ignorer les erreurs de certificat.

2. Configure l’intervalle de vérification. Par exemple, tous les 60 secondes est une bonne option pour commencer.
3. Ajouter un mécanisme de réessai si la vérification échoue. Par exemple, 2 réessais avec un délai entre chaque de 30 secondes.

Étape 4 : Configuration des notifications

1. Retourne aux paramètres de Uptime Kuma.
2. Clique sur Notifications, puis choisis le service que tu souhaites configurer (par exemple, Telegram).

• Pour utiliser Telegram, tu auras besoin d’un jeton de bot. Crée un bot sur BotFather et copie le jeton.
• Chat ID : Envoie un message à ton bot pour récupérer le chat ID.

3. Teste la notification en envoyant un message.

Étape 5 : Intégration avec Home Assistant

1. Retourne dans Home Assistant et navigue vers Paramètres > Appareils et services.
2. Ajoute Uptime Kuma en tant qu’intégration. Colle la clé API générée dans Uptime Kuma et valide.
3. Une fois lié, tu pourras créer des automatisations dans Home Assistant en fonction des états de tes sondes.

Étape 6 : Suivi et groupement des sondes

1. Tu peux créer des groupes pour regrouper plusieurs sondes. Cela te permettra d’avoir une vue d’ensemble de l’état de tes services.
2. Ajoute chaque sonde pertinente dans le groupe que tu as créé pour une surveillance simplifiée.

Conclusion

Dans cet article, tu as appris à installer et configurer Uptime Kuma sur Home Assistant pour surveiller ton réseau et tes appareils. Avec cet outil, tu seras désormais averti rapidement en cas de problème sur ton réseau.

N’hésite pas à partager ton expérience avec Uptime Kuma et à poser tes questions dans les commentaires. C’est en échangeant que nous progressons tous dans notre passion pour la domotique !