Monitoring des services Dropcolis avec Uptime Kuma

Dropcolis est une plateforme numérique de gestion logistique pensée pour les entreprises qui souhaitent automatiser, organiser et suivre efficacement les flux de colis. En combinant un tableau de bord moderne avec des microservices interconnectés, Dropcolis permet une visibilité complète sur les opérations de transport, la gestion des points relais et l’intégration avec divers outils comme Portainer, N8N ou encore des services backoffice et cloud.

L’écosystème Dropcolis repose sur plusieurs services web. Chacun d’eux remplit un rôle précis, la base de données, le site web public, le cloud, le service de livraison, entre autres. Et pour garantir une qualité de service irréprochable, ces services doivent rester disponibles 24/7.

Comment s'assurer que tout fonctionne à tout moment et être prévenu au moindre incident ? C’est là qu'intervient une solution de surveillance comme Uptime Kuma.

Uptime Kuma

A self-hosted monitoring tool

Pourquoi la surveillance des services est essentielle ?

Imaginez une boutique e-commerce qui dépend entièrement de la disponibilité de ses outils logistiques. Si le service de cloud tombe, le suivi des commandes peut être bloqué. Si la base de données n’est plus joignable, toute l'infrastructure peut s'effondrer. Le manque de disponibilité d’un seul microservice peut entraîner une perte de revenus, de confiance client et une surcharge des équipes de support.

Voici quelques raisons concrètes pour lesquelles la surveillance est indispensable :

• Réduction du temps d'arrêt : Vous êtes alerté immédiatement lorsqu'un service échoue, ce qui vous permet d’agir rapidement.
• Transparence vis-à-vis des clients : Grâce à des pages de statut publiques, vous informez vos utilisateurs de l'état actuel des systèmes.
• Historique des incidents : Suivre les tendances de pannes aide à améliorer les performances et à repérer les points faibles.
• Conformité SLA : Dans un environnement professionnel, respecter les accords de niveau de service est crucial. La surveillance permet de prouver la disponibilité.

Dans le cas de Dropcolis, où chaque service est une brique critique, il est vital d’assurer une surveillance continue de l'ensemble de l’architecture.

Uptime Kuma c'est quoi ?

Uptime Kuma est une solution open source, gratuite, de surveillance de services (uptime monitoring). Facile à installer et à utiliser, elle permet de surveiller n’importe quel service web, HTTP, TCP, ping, DNS, Docker et bien plus.

Développé en Node.js, il propose une interface utilisateur moderne, avec des graphiques de performance, une gestion des notifications multi-canaux et une flexibilité remarquable.

Quelques faits marquants sur Uptime Kuma :

• Interface web intuitive
• Déploiement en Docker très simple
• Support de nombreux types de moniteurs
• Compatible avec Telegram, Discord, Email, Slack, Webhook…
• Pages de statut personnalisables pour les utilisateurs

Pourquoi choisir Uptime Kuma pour Dropcolis ?

Uptime Kuma s’adapte parfaitement à une infrastructure modulaire comme celle de Dropcolis. Voici pourquoi :

Avantages principaux :

1. Surveillance Granulaire : Vous pouvez surveiller chaque microservice individuellement.
2. Alertes Rapides : Soyez averti instantanément si un service tombe, avant même que les utilisateurs ne s’en rendent compte.
3. Visualisation Claire : Des barres vertes (comme visibles dans l’image) montrent l’état de chaque moniteur en un coup d'œil.
4. Maintenance Facile : Ajoutez ou modifiez un moniteur sans redémarrer quoi que ce soit.
5. Open Source : Pas de coût de licence, pas de dépendance à un tiers.

Alternatives et comparaison :

Ajouter un nouveau moniteur dans Uptime Kuma

L’ajout d’un moniteur dans Uptime Kuma est aussi simple qu’un clic sur le bouton vert « + Add New Monitor ». Une fois cela fait, vous accédez à un formulaire avec différentes options :

• Monitor Type : HTTP(s), TCP, Ping, Docker, etc.
• Friendly Name : nom qui s'affiche dans l’interface (ex. : dropcolis-cloud).
• URL : le lien vers le service à surveiller.
• Heartbeat Interval : la fréquence à laquelle le service est pingé (ex : toutes les 60 secondes).
• Retries : combien de fois tenter avant de considérer le service comme « down ».

Configuration d’un moniteur HTTP(s) pour Dropcolis

Nom convivial et URL

Dans notre exemple, un moniteur est configuré avec :

• Friendly Name : portainer
• URL : https://portainer.dropcolis.ca

Ce nom sert à distinguer les services dans la liste des moniteurs. L'URL doit pointer directement vers le service web ou l'API.

Intervalle de vérification et nombre de tentatives

• Heartbeat Interval : fixé à 60 secondes — cela signifie que toutes les minutes, Uptime Kuma vérifiera si le service répond.
• Retries : défini à 0, ce qui indique qu’en cas d'échec, une alerte est envoyée immédiatement sans seconde tentative.

Vous pouvez ajuster ces paramètres selon la criticité du service. Par exemple, une base de données peut être surveillée toutes les 30 secondes avec 1 ou 2 retries.

Méthode HTTP utilisée

• La méthode HTTP est ici GET — standard pour vérifier que la page répond.
• D'autres méthodes comme POST ou HEAD peuvent être utilisées si vous avez des API REST ou des endpoints spécifiques à tester.

Notifications et alertes

Dans un système distribué comme celui de Dropcolis, être notifié en temps réel d’un incident est non seulement utile, c’est crucial. Uptime Kuma propose une panoplie de canaux de notifications pour que vous ne manquiez jamais un événement important.

Configuration des alertes par e-mail

Par défaut, dans l’interface d’Uptime Kuma, vous pouvez activer les Email Alerts. Voici comment faire :

1. Cliquez sur “Setup Notification”.
2. Choisissez Email (SMTP).
3. Entrez les paramètres SMTP de votre fournisseur de messagerie :
   • Hôte SMTP (ex : smtp.gmail.com)
   • Port (ex : 587)
   • Adresse e-mail et mot de passe de l’expéditeur
   • Adresse(s) de destination
4. Testez l’envoi pour vous assurer que tout fonctionne.

Une fois configuré, chaque moniteur peut être lié à une ou plusieurs notifications. Dans l’exemple visible sur la capture d’écran, l’alerte e-mail est déjà activée avec l’étiquette My Email Alert (1).

Ajout d’autres canaux de notifications

Uptime Kuma ne s’arrête pas aux e-mails. Il prend en charge :

• Telegram : pour des alertes instantanées sur mobile.
• Discord / Slack : idéal pour une équipe DevOps.
• Webhooks : pour intégrer vos propres workflows.
• Gotify, Pushover, Signal, Mattermost, Microsoft Teams, etc.

Exemple d’un scénario typique Dropcolis :

• E-mail envoyé aux développeurs
• Notification Telegram pour les alertes critiques
• Webhook vers N8N pour déclencher un redémarrage automatique du conteneur Docker défaillant

Cas d’usage pour les alertes Dropcolis

Imaginons que le microservice dropcolis-cloud tombe pendant 10 minutes. Voici un exemple de séquence :

1. Uptime Kuma détecte l’échec au bout de 60 secondes.
2. Une alerte est immédiatement envoyée via :
   • Email au CTO
   • Message Telegram au support
   • Notification Discord dans le canal #infra
3. Le développeur redémarre manuellement le service ou lance un script automatisé.
4. Une alerte “up” est envoyée dès que le service revient en ligne.
5. Un rapport mensuel de performance est généré.

En résumé, les notifications permettent de transformer Uptime Kuma en un centre de commandement entièrement pilotable et réactif.

Analyse de l’état de Dropcolis avec Uptime Kuma

Une fois les moniteurs configurés, Uptime Kuma devient votre tableau de bord de santé numérique. Voyons comment exploiter au maximum ses fonctionnalités d’analyse.

Interface visuelle des moniteurs

L’interface est élégante, claire et conçue pour que vous puissiez savoir en un coup d’œil ce qui fonctionne ou non. À gauche, une liste de tous les moniteurs avec :

• Nom convivial (ex : dropcolis-backoffice)
• Pourcentage de disponibilité
• Indicateurs graphiques en bâton (vert = bon état)

Chaque ligne représente un service et les barres montrent les résultats des tests de disponibilité sur une période donnée. Cela permet de détecter facilement :

• Les coupures fréquentes (barres manquantes)
• Les services à surveiller plus activement

Lecture des pourcentages de disponibilité

Chaque service affiche un pourcentage (100%, 99.9%, etc.). Ce chiffre est le taux de disponibilité sur une période donnée (jour, semaine, mois). Voici comment l’interpréter :

• 100% : aucune interruption détectée
• 99.9% : environ 43 minutes d’interruption/mois
• 99.5% : environ 3h39 d’interruption/mois

Pour des services critiques comme la base de données ou l’API principale, viser 99.99% ou plus est recommandé.

Suivi historique des pannes et performances

Uptime Kuma conserve un historique complet :

• Délai de réponse (ping, HTTP response time)
• Jours et heures exacts des coupures
• Durée totale d’indisponibilité

Grâce à cela, vous pouvez produire des rapports mensuels ou trimestriels à présenter aux partenaires ou à la direction.

Un exemple typique pour Dropcolis :

• Générer un rapport PDF indiquant que dropcolis-service a connu 99.98% de disponibilité avec deux interruptions de 3 minutes.

Bonnes pratiques pour un monitoring efficace chez Dropcolis

Une fois que tout est mis en place, il ne suffit pas de “surveiller pour surveiller”. Il faut intégrer des bonnes pratiquespour rendre le monitoring durable, précis et réellement utile.

Documenter chaque moniteur

Pour chaque service surveillé, gardez une fiche technique contenant :

• Le rôle du service
• Le propriétaire ou responsable technique
• Le contact en cas d'incident
• Le comportement attendu (latence moyenne, seuils critiques)
• Les dépendances (autres services ou bases de données)

Cela permet d’agir plus rapidement lors d’un incident, même pour une personne qui découvre le projet.

Revoir régulièrement les paramètres de vérification

Ne laissez pas les moniteurs en configuration par défaut pendant des mois. Adaptez les paramètres à l'évolution de votre infrastructure :

• Réduisez les intervalles pour les services critiques
• Augmentez le nombre de retries si vous subissez de faux positifs
• Modifiez les URLs si vos endpoints changent

Un audit mensuel peut suffire à éviter de fausses alertes ou une surveillance inefficace.

Former les équipes à l’utilisation d’Uptime Kuma

Même si Uptime Kuma est simple, il est essentiel que tous les membres de l’équipe technique (ou produit) sachent :

• Lire les statuts
• Interpréter les logs
• Réagir aux alertes
• Modifier ou ajouter un moniteur

Organisez une mini-formation interne ou créez une documentation wiki pour que tout le monde soit à niveau.

La plateforme Dropcolis, avec ses nombreux microservices interconnectés, repose sur une disponibilité constante pour offrir une expérience fluide à ses utilisateurs. L’intégration d’une solution de monitoring comme Uptime Kuma permet de surveiller proactivement l'état de chaque composant, de réagir rapidement en cas de défaillance et d’informer les utilisateurs de manière transparente.

Grâce à ses nombreuses fonctionnalités, surveillance HTTP(s), alertes multi-canaux, pages de statut personnalisées, compatibilité Docker, etc. Uptime Kuma s’impose comme un outil incontournable pour toute stack technique moderne.

En appliquant les bonnes pratiques mentionnées et en intégrant Uptime Kuma dans vos workflows, vous transformez un simple tableau de bord en véritable tour de contrôle, garantissant robustesse, sécurité et satisfaction client.

TakkJokk,