Journaux
Les journaux de vos services restent sur votre serveur. L'agent ne lit que les lignes demandées, les masque, et le central ne les garde pas.
Lus à la demande
Sur la page Journaux d'un projet, choisissez une fenêtre (7 jours au plus), des services, un niveau minimal et un texte. Le central transmet la demande à l'agent, qui lit docker logs de chaque conteneur du projet et répond avec 2 000 lignes au plus.
- Le niveau vient du champ
levelouseverityd'une ligne JSON, sinon du motINFO,WARN,ERROR… - Chaque ligne est masquée avant le filtre : un secret masqué ne se retrouve pas par la recherche.
- L'histogramme est calculé sur toute la fenêtre, erreurs à part.
Conservation
Le central remet la réponse à la demande qui porte son identifiant, puis l'oublie. La durée de conservation est celle de Docker sur votre serveur (pilote json-file par défaut, sans rotation tant que max-size et max-file ne sont pas réglés). Kantama n'en fait aucune copie.
Le journal de l'espace
À ne pas confondre : le journal chaîné de l'espace (page Activité) garde chaque événement de Kantama lui-même, compte créé, passkey ajoutée, agent approuvé, ordre transmis, reçu, alerte. Chaque ligne contient l'empreinte de la précédente :
empreinte = SHA-256( precedente ‖ 0x00 ‖ JSON canonique { "seq", "type", "at", "data" } )GET /v1/journal/verification recalcule toute la chaîne et rend la première rupture éventuelle. Le central ne modifie aucune ligne ; il n'en efface que le début, à la fin de la durée de conservation (voir plus bas).
Ce que garde Kantama, et combien de temps
Kantama ne garde aucune copie des journaux de vos services. Ce qu'il garde, c'est l'Activité de l'espace, et sa durée de conservation dépend de la formule :
| Gardé par Kantama | Solo | Équipe | Entreprise |
|---|---|---|---|
| Journal chaîné de l'espace | 7 jours | 30 jours | 1 an |
| Ordres terminés, signatures, reçus et résultats signés par l'agent, déroulés d'exécution | 7 jours | 30 jours | 1 an |
| Occurrences des erreurs reçues | 30 jours | 30 jours | 1 an |
- La durée est celle de la formule au moment de l'effacement, fait au fil de la journée : passer à Équipe n'efface rien de plus ; revenir à Solo n'efface rien tout de suite, puis l'Activité de plus de 7 jours s'efface à l'effacement suivant. L'écran Formule le rappelle avant le retour à Solo.
- Un ordre qui attend encore une signature ou sa transmission n'est jamais effacé.
- Pour garder plus longtemps : l'export de l'Activité (Équipe, Entreprise), à conserver chez vous.
Le point de reprise
Effacer le début d'une chaîne la rendrait invérifiable. Avant chaque effacement, Kantama inscrit donc en fin de chaîne un événement journal.reprise qui fixe l'empreinte du dernier événement effacé :
{"type": "journal.reprise", "data": {"jusqua": 1824, "empreinte": "9f2c…", "at_dernier": 1794…,
"evenements": 1824, "retention_j": 7, "par": "kantama"}}La vérification part de ce point : le premier événement restant doit porter, comme maillon précédent, exactement cette empreinte. Le point est lui-même chaîné : le modifier casse la chaîne après lui. Un début effacé sans point de reprise est signalé comme une rupture, et toute modification après le point reste détectée. La page Activité indique le point de reprise en vigueur.
Les propositions de modification de la documentation ne sont pas encore ouvertes au public.