Surveillance et santé
Une instance KiwiDesk se surveille à trois endroits : la page Paramètres > À propos / Système pour le super administrateur, le point de santé de l’API pour un outil de supervision, et les journaux des conteneurs pour comprendre une panne.
La page À propos / Système
Section intitulée « La page À propos / Système »Ouvrez Paramètres > À propos / Système (section Avancé du menu des paramètres). Elle montre :
- Application : versions Web et API, avec leur commit et leur date de construction. La pastille À jour confirme que les deux sont identiques ; sinon un avertissement apparaît.
- Base de données : état de la connexion, latence, version de PostgreSQL, dernière migration appliquée et sa date.
- Environnement : mode (Production attendu), version de Node.js, temps écoulé depuis le démarrage de l’API.
- État des WebSockets & Temps réel : la liaison temps réel de votre navigateur, le bouton Tester le ping WebSocket, et le nombre de KiwiDesk Bridge connectés.
- Santé de l’instance : la liste des contrôles automatiques, détaillée ci-dessous.
Le bouton Télécharger KiwiDesk Bridge (GitHub) mène aux exécutables du Bridge.

Les contrôles de santé
Section intitulée « Les contrôles de santé »
| Contrôle | Orange quand… | Rouge quand… |
|---|---|---|
| Événements à diffuser (webhooks, temps réel) | un événement attend depuis plus de 15 minutes | un événement a échoué 3 fois ou plus |
| Webhooks | un envoi a échoué sur les 3 derniers jours | un webhook a été désactivé après trop d’échecs |
| Messages clients (SMS, e-mails) | un SMS ou e-mail n’est pas parti sur les 3 derniers jours | jamais |
| Conservation du journal d’audit | la purge de nuit n’a pas réussi depuis 36 heures | jamais |
| Récapitulatif quotidien des notifications | le dernier envoi a échoué | jamais |
| Espace utilisé | jamais (taille de la base et des fichiers, pour info) | jamais |
| Espace libre du volume des fichiers | moins de 10 % libre | moins de 3 % libre |
| Dernière sauvegarde | plus de 36 heures, ou aucun fichier témoin | plus de 7 jours, ou sauvegarde signalée en échec |
| Fuseau horaire de la base de données | jamais | une session de la base n’est pas en UTC |
Quand un contrôle n’est pas vert, un lien Voir mène à l’écran où agir (messagerie, webhooks, journal d’audit). Les super administrateurs retrouvent aussi les alertes dans les éléments À traiter du tableau de bord.
Le point de santé de l’API
Section intitulée « Le point de santé de l’API »GET /api/health répond sans authentification, en moins d’une seconde :
{ "status": "ok", "database": "up", "uptimeSeconds": 93784, "timestamp": "2026-11-20T08:00:00.000Z"}Il répond 503 quand la base est injoignable. C’est lui qu’utilise le contrôle de santé Docker
du service api (le service web attend qu’il soit vert pour démarrer). Pour une supervision
externe (Uptime Kuma, Zabbix, Healthchecks), interrogez-le à travers l’adresse publique :
https://kiwidesk.ma-boutique.fr/api/health.
Les journaux
Section intitulée « Les journaux »# Tous les services, en continudocker compose -f docker-compose.yml logs -f --tail=100
# Un seul servicedocker compose -f docker-compose.yml logs -f apiLe niveau de détail de l’API se règle avec LOG_LEVEL (log par défaut ; debug pour une
recherche de panne, à remettre ensuite). Les actions des utilisateurs, elles, ne sont pas dans
ces journaux mais dans le Journal d’audit de l’application (Paramètres > Journal
d’audit), conservé selon la durée réglée dans les préférences de l’instance.