Nouveau · l'app mobile, second appareil pour relire et signer chaque ordre
kantamaSe connecterCréer un espace

Pile de suivi

Prometheus, Loki, GlitchTip, Uptime Kuma et Umami tournent déjà sur votre serveur : l'agent les lit en local et leurs chiffres apparaissent dans le projet, avec leurs alertes, sans ouvrir un seul port. Toutes les formules.

3 minutesMis à jour le 18 novembre 2026

Lus par l'agent, jamais par le serveur central

Ces services ne sont en général joignables que sur le serveur lui-même ou par le réseau Docker. Vous les déclarez dans kantama.yaml ; l'agent les interroge à leur adresse locale et n'envoie que le résultat.

ServiceCe que l'agent litDans la console
Prometheusles requêtes PromQL que vous déclarez, et elles seulesvaleur, seuils, courbe ; alerte au-delà d'un seuil
Lokià la demande : un des flux déclarés, filtré par un textelignes masquées, les plus récentes d'abord
GlitchTiples problèmes non résolustitre (masqué), occurrences, dernière vue
Uptime Kumales moniteurs d'une page de statutétat, temps de réponse, disponibilité sur 24 h ; panne d'un moniteur = alerte
Umamivisiteurs, pages vues et visites sur 24 h, visiteurs en ce momentchiffres du site

Déclarer les sources

kantama.yaml
['observability:', '  - name: prometheus', '    kind: prometheus', '    url: http://suivi_prometheus:9090', '    queries:', '      - id: erreurs_5xx', '        label: Réponses 5xx de nginx', '        promql: \'sum(rate(nginx_http_requests_total{status=~"5.."}[5m]))\'', '        unit: r/s', '        warn: 0.5', '        critical: 2', '  - {name: loki, kind: loki, url: http://suivi_loki:3100, streams: [\'{compose_project="boutique"}\']}', '  - {name: kuma, kind: uptime_kuma, url: http://suivi_kuma:3001, status_page: boutique}', '  - {name: erreurs, kind: glitchtip, url: http://suivi_glitchtip:8000, token: GLITCHTIP_TOKEN, organization: boutique}', '  - {name: audience, kind: umami, url: http://suivi_umami:3000, token: UMAMI_TOKEN, website: 3f1c2b4a-0d1e-4f5a-9b8c-7d6e5f4a3b2c}']
  • url : une adresse locale : 127.0.0.1, une adresse de réseau privé, ou le nom d'un conteneur (sans point). Un nom de domaine ou une adresse publique est refusé ;
  • every : intervalle de lecture, de 30 s à 1 h (1 min par défaut) ;
  • warn et critical : seuils d'une requête, franchis strictement ; below: true pour une valeur qui ne doit pas descendre (disponibilité, nombre de cibles en ligne) ;
  • token : le nom d'une variable, jamais sa valeur.

Jetons

GlitchTip et Umami demandent un jeton d'API. Après avoir déclaré la source, ouvrez Variables : la source y apparaît comme une cible, « jeton à saisir ». La valeur est chiffrée dans votre navigateur pour l'agent seul et appliquée par un ordre signé ; l'agent relit aussitôt la source. Donnez à ce jeton un accès en lecture seule.

Uptime Kuma se lit par l'API publique de sa page de statut : aucun jeton n'est nécessaire, mais seuls les moniteurs de cette page sont vus.

Ce que l'agent garantit

  • il ne se connecte qu'à une adresse locale, vérifiée à chaque connexion, après résolution du nom : un nom qui se mettrait à pointer vers Internet est refusé ;
  • il ne suit aucune redirection et ne passe par aucun proxy ;
  • il ne lance que les requêtes déclarées : la console ne peut pas lui faire exécuter une requête PromQL de son choix ;
  • dans Loki, la console choisit un flux déclaré et un texte ; le texte est cherché tel quel, il ne peut pas devenir un opérateur ;
  • il masque les lignes, les titres d'erreurs et les messages avant de les envoyer, comme les journaux des conteneurs ;
  • il borne tout : 10 s par appel, 2 Mio par réponse, 1 000 lignes par recherche.

Alertes

  • une requête au-delà de critical : panne ; au-delà de warn : alerte. Redescendue sous critical, la panne devient une alerte ; sous warn, elle se ferme ;
  • un moniteur Uptime Kuma en panne : panne, fermée à son retour ;
  • une source injoignable trois lectures de suite : alerte, fermée à la première lecture réussie.

Elles suivent le cycle habituel des alertes : notification, webhook, SMS en cas de panne pour qui l'a choisi.

Formule

SoloÉquipeEntreprise
Pile de suivi : lecture, alertes, recherche dans Lokiouiouioui
Cette page vous a-t-elle aidé ?Modifier cette page

Les propositions de modification de la documentation ne sont pas encore ouvertes au public.