Aller au contenu

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.

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.

Page À propos / Système avec les sections Application, Base de données, Environnement et État des WebSockets et Temps réel.
Section Santé de l'instance : événements à diffuser, webhooks, messages clients, conservation du journal d'audit, récapitulatif quotidien, espace utilisé, espace libre, dernière sauvegarde et fuseau horaire de la base.
Chaque ligne est verte, orange (à surveiller) ou rouge (à corriger).
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.

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.

Fenêtre de terminal
# Tous les services, en continu
docker compose -f docker-compose.yml logs -f --tail=100
# Un seul service
docker compose -f docker-compose.yml logs -f api

Le 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.