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.
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.
| Service | Ce que l'agent lit | Dans la console |
|---|---|---|
| Prometheus | les requêtes PromQL que vous déclarez, et elles seules | valeur, seuils, courbe ; alerte au-delà d'un seuil |
| Loki | à la demande : un des flux déclarés, filtré par un texte | lignes masquées, les plus récentes d'abord |
| GlitchTip | les problèmes non résolus | titre (masqué), occurrences, dernière vue |
| Uptime Kuma | les moniteurs d'une page de statut | état, temps de réponse, disponibilité sur 24 h ; panne d'un moniteur = alerte |
| Umami | visiteurs, pages vues et visites sur 24 h, visiteurs en ce moment | chiffres du site |
Déclarer les sources
['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) ;warnetcritical: seuils d'une requête, franchis strictement ;below: truepour 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à dewarn: alerte. Redescendue souscritical, la panne devient une alerte ; souswarn, 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 | Équipe | Entreprise | |
|---|---|---|---|
| Pile de suivi : lecture, alertes, recherche dans Loki | oui | oui | oui |
Les propositions de modification de la documentation ne sont pas encore ouvertes au public.