5.24. Analyseur de traçabilité (traceability_analyzer)¶

5.24.1. Présentation¶

Le playbook d’exploitation traceability_analyzer.yml est un outil d’analyse des chaînes de sécurisation des journaux d’opération et des journaux de cycles de vie.

Il permet de vérifier la cohérence globale des chaînes de traçabilité dans la solution logicielle VITAM.

À l’issue de son exécution, il génère des rapports d’analyse textuels (au format markdown) ainsi que des graphes (au format SVG) permettant la visualisation de la chaîne de sécurisation et des éventuelles anomalies de traçabilité.

5.24.2. Lancement du playbook¶

Le playbook s’exécute depuis le répertoire deployment/ de la manière suivante :

ansible-playbook ansible-vitam-exploitation/traceability_analyzer.yml -i environments/hosts.<environnement> --ask-vault-pass -e "tenants=0-2" -e "startDate=2026-01-01" -e "endDate=2026-06-30" -e "type=UNITS"

5.24.2.1. Paramètres optionnels¶

Les paramètres suivants peuvent être transmis via l’option -e (extra-vars) :

tenants : Liste des tenants à analyser (ex. tenants=0 ou tenants=0-2). Par défaut, tous les tenants de l’environnement sont analysés.
type : Type de traçabilité à analyser. Valeurs acceptées : * UNITS : Journaux de cycle de vie des unités archivistiques. * OBJECT_GROUPS : Journaux de cycle de vie des groupes d’objets. * LOGBOOK_OPERATIONS : Journal des opérations. Par défaut, les 3 types sont analysés.
startDate : Date de début de la période d’analyse au format YYYY-MM-DD (ex. 2026-01-01).
endDate : Date de fin de la période d’analyse au format YYYY-MM-DD (ex. 2026-05-01).
minCriticity : Niveau minimal de criticité des anomalies à inclure dans le rapport. Valeurs possibles : CRITICAL (anomalies critiques), SEVERE (anomalies critiques ou sévères), WARNING (anomalies critiques ou sévères ou modérées), NOTICE (par défaut, toutes les anomalies critiques, sévères, modérées ou mineures).
traceabilityVersion (avancé) : Version de la chaîne de traçabilité à analyser (ex. V1). Par défaut, la version de sécurisation actuelle du système est auditée.

5.24.2.2. Résultats et comportement¶

Les résultats et artefacts générés (rapports textuels MARKDOWN et graphes SVG) sont compactés dans une archive située sous environments/ :

environments/traceability_analyzer_<date_heure>_<site_name>.zip

Prudence

Si au moins une anomalie critique est détectée lors de l’analyse, le playbook se termine en échec.

5.24.3. Anomalies reportées¶

L’analyseur identifie et reporte les anomalies selon 4 niveaux de criticité.

5.24.3.1. Anomalies critiques (CRITICAL)¶

Prudence

Toute anomalie de ce niveau indique une probable rupture grave de la chaîne de traçabilité. L’exploitant doit contacter le support du programme VITAM.

CRITICAL_TRUNCATED_LOGBOOK_OPERATION_TRACEABILITY
- Explication : La traçabilité des journaux d’opérations n’a sécurisé que 10 000 éléments sur un total inconnu d’opérations. Il est probable que certains journaux d’opérations n’aient pas été sécurisés.
- Cause(s) possible(s) : * Un bug historique gérait mal la sécurisation d’un très grand nombre de journaux d’opérations cumulées. Les traitements périodiques (scheduler) ont dû être arrêtés pour une période anormalement longue. Typiquement lié au lancement du playbook stop_vitam_scheduling.yml lors d’une opération de maintenance, sans relance du playbook start_vitam_scheduling.yml.
- Conduite à tenir : * Contacter le support du programme VITAM avec le rapport d’analyse.
CRITICAL_MULTIPLE_TRACEABILITY_OPERATIONS_SAME_ZIP_NAME
- Explication : Plusieurs opérations de traçabilité concurrentes ont généré des ZIPs de sécurisation portant exactement le même nom. L’une des opérations a écrasé le contenu de l’autre.
- Cause(s) possible(s) :
  
  Un bug historique peut avoir causé dans certains cas l’exécution concurrente de 2+ opérations de traçabilité simultanées.
- Conduite à tenir :
  
  Contacter le support du programme VITAM avec le rapport d’analyse.
CRITICAL_MULTIPLE_TRACEABILITY_CHAIN_ROOTS
- Explication : Plusieurs chaînes concurrentes de traçabilité ont été identifiées.
- Cause(s) possible(s) :
  
  Un bug historique peut avoir causé dans certains cas l’exécution concurrente de 2+ opérations de traçabilité simultanées.
  
  Perte(s) ou suppression(s) d’opération(s) de sécurisation.
- Conduite à tenir :
  
  Contacter le support du programme VITAM avec le rapport d’analyse.
CRITICAL_TRACEABILITY_OPERATION_HAS_MULTIPLE_PARENTS
- Explication : Une opération de traçabilité possède plusieurs opérations parentes. Cette anomalie est souvent associée à l’anomalie CRITICAL_MULTIPLE_TRACEABILITY_OPERATIONS_SAME_ZIP_NAME.
- Cause(s) possible(s) :
  
  Un bug historique peut avoir causé dans certains cas le lancement concurrent de 2+ opérations de traçabilité simultanées.
- Conduite à tenir :
  
  Contacter le support du programme VITAM avec le rapport d’analyse.
CRITICAL_MISSING_PREVIOUS_TRACEABILITY_OPERATIONS
- Explication : Une opération de sécurisation référence une précédente sécurisation introuvable dans le système.
- Cause(s) possible(s) :
  
  Perte ou suppression d’une opération de sécurisation.
- Conduite à tenir :
  
  Contacter le support du programme VITAM avec le rapport d’analyse.

5.24.3.2. Anomalies sévères (SEVERE)¶

SEVERE_TRACEABILITY_OPERATION_WITHOUT_SUCCESSOR
- Explication : Aucune opération de sécurisation récente. La dernière opération de sécurisation date de plus de 24 heures.
- Cause(s) possible(s) :
  
  Changement de version de la chaîne de sécurisation (ex. si l’exploitant configure une version de sécurisation V2, la chaîne de sécurisation V1 est abandonnée).
  
  Les traitements périodiques (scheduler) ont dû être arrêtés pour une période anormalement longue. Typiquement lié au lancement du playbook stop_vitam_scheduling.yml lors d’une opération de maintenance, sans relance du playbook start_vitam_scheduling.yml.
- Conduite à tenir :
  
  Vérifier le statut des traitements périodiques et relancer le cas échéant le playbook start_vitam_scheduling.yml.
  
  Vérifier la configuration des versions de chaînes de sécurisation.
SEVERE_TRACEABILITY_OPERATION_CONTAINS_TOO_OLD_DATA
- Explication : Une opération de traçabilité contient des données datant de plus de 24 heures au moment de son exécution.
- Cause(s) possible(s) :
  
  Les traitements périodiques (scheduler) ont dû être arrêtés pour une période anormalement longue. Typiquement lié au lancement du playbook stop_vitam_scheduling.yml lors d’une opération de maintenance, sans relance du playbook start_vitam_scheduling.yml.
  
  Retard important dans l’exécution périodique du job de traçabilité (accumulation d’événements non sécurisés).
- Conduite à tenir :
  
  Vérifier le statut des traitements périodiques et relancer le cas échéant le playbook start_vitam_scheduling.yml.
  
  Vérifier la fréquence des traitements périodiques.
SEVERE_TRACEABILITY_OPERATION_WRONG_STATUS
- Explication : L’opération de traçabilité indique un statut final incohérent avec le statut des étapes et actions du processus.
- Cause(s) possible(s) :
  
  Un bug du moteur de processing peut dans des cas rares causer un statut final de l’opération invalide (ex. Outcome OK malgré la présence d’étapes ou d’actions en WARNING ou KO).
- Conduite à tenir :
  
  Consulter l’écran d’administration des journaux d’opérations pour vérifier le statut réel et le détail de l’opération.

5.24.3.3. Anomalies modérées (WARNING)¶

WARNING_TRACEABILITY_OPERATION_PAUSED
- Explication : L’opération de traçabilité a été mise en pause (PAUSED).
- Cause(s) possible(s) :
  
  Mise en pause manuelle par l’exploitant.
  
  Erreur technique (PAUSE/FATAL) lors de l’exécution du workflow de traçabilité.
- Conduite à tenir :
  
  Consulter l’écran d’administration des journaux d’opérations.
  
  Consulter les logs techniques de la solution en cas d’erreurs techniques.
  
  Poursuivre l’exécution de l’opération depuis l’écran de gestion des opérations.
  
  Si le problème persiste, contacter le support du programme VITAM.
WARNING_TRACEABILITY_OPERATION_ABORTED
- Explication : L’opération de traçabilité a été interrompue / terminée.
- Cause(s) possible(s) :
  
  Annulation forcée du processus de traçabilité par l’exploitant.
- Conduite à tenir :
  
  L’opération de sécurisation étant terminée, aucune action n’est possible.
Prudence

L’annulation forcée d’un processus est un acte d’administration sensible pouvant impacter la cohérence de la solution. Cette actions ne devrait être réalisée qu’après consultation préalable du support du programme VITAM.
WARNING_TRACEABILITY_OPERATION_FAILED
- Explication : L’opération de traçabilité s’est terminée en échec (KO).
- Cause(s) possible(s) :
  
  Incohérence des empreintes (digests) lors de la sécurisation entre la base de données et les offres de stockage.
  
  Conflit de processus concurrents modifiant la même métadonnée. Exemple : une MAJ et une élimination concurrente d’un même périmètre d’unités archivistiques ou groupe d’objets.
- Conduite à tenir :
  
  Analyser les journaux d’erreurs de l’opération concernée et/ou les logs techniques pour en déterminer la cause précise.
  
  Vérifier si les opérations de sécurisation suivantes ont pu reprendre en succès.
  
  Si le problème persiste, contacter le support du programme VITAM.
WARNING_TRACEABILITY_OPERATION_ABNORMALLY_LONG
- Explication : L’opération de traçabilité dure depuis plus de 4 heures.
- Cause(s) possible(s) :
  
  Surcharge de la plateforme (trop d’opérations longues, plateforme sous-dimensionnée…).
  
  Ralentissement des accès réseau (stockage, sites distants…).
  
  Erreurs intermittentes (réseau ou stockage) causant des timeouts/retries…
- Conduite à tenir :
  
  Consulter l’écran d’administration des journaux d’opérations pour vérifier l’état de l’opération.
  
  Consulter l’écran de gestion des opérations pour vérifier l’état des processus actuels de la plateforme.
  
  Vérifier la charge du système et les métriques de la plateforme.
  
  Si le problème persiste, contacter le support du programme VITAM.
WARNING_ROOT_TRACEABILITY_OPERATION_MAY_CONTAIN_TOO_OLD_DATA
- Explication : La toute première opération de traçabilité de la chaîne pourrait contenir des données datant de plus de 24 heures.
- Cause(s) possible(s) :
  
  L’outil n’est pas capable de vérifier s’il n’y avait pas de données sécurisées de plus de 24 heures au moment de la toute première sécurisation.
- Conduite à tenir :
  
  Vérifier que la toute première sécurisation correspond à la date des premières données à sécuriser de la solution :
  
  Pour les journaux d’opérations : Devrait correspondre à la date de l’initialisation du tenant (première installation ou configuration du tenant).
  
  Pour les journaux de cycles de vie : Devrait correspondre à la date des premiers versements dans le système.
WARNING_TRACEABILITY_OPERATION_CONTAINS_WARNINGS
- Explication : L’opération de traçabilité s’est terminée avec le statut WARNING.
- Cause(s) possible(s) :
  
  Avertissements concernant certains éléments traités lors du déroulement du workflow.
- Conduite à tenir :
  
  Consulter l’écran d’administration des journaux d’opérations pour vérifier l’état de l’opération.
  
  Vérifier l’absence d’erreurs dans les sécurisations suivantes.
  
  Si le problème persiste, contacter le support du programme VITAM.

5.24.3.4. Anomalies mineures (NOTICE)¶

NOTICE_TRACEABILITY_BRANCH_DETECTED
- Explication : Une bifurcation (branche) a été détectée dans la chaîne de traçabilité.
- Cause(s) possible(s) :
  
  Un bug historique pouvait causer dans certains cas des exécutions d’opérations de traçabilité concurrentes.
- Conduite à tenir :
  
  Examiner le graphe SVG pour vérifier qu’une seule branche de la sécurisation est active (branche principale), et que toute autre branche est abandonnée (secondaire).
NOTICE_DISCONTINUED_TRACEABILITY_BRANCH
- Explication : Aucune opération de sécurisation n’est chaînée à la présente branche de traçabilité (branche abandonnée).
- Cause(s) possible(s) :
  
  Un bug historique pouvait causer dans certains cas des exécutions d’opérations de traçabilité concurrentes.
- Conduite à tenir :
  
  Examiner le graphe SVG pour vérifier qu’une seule branche de la sécurisation est active (branche principale), et que toute autre branche est abandonnée (secondaire).
NOTICE_TRACEABILITY_OPERATION_DEAD
- Explication : L’opération de traçabilité s’est terminée brusquement.
- Cause(s) possible(s) :
  
  Erreur technique ayant causé l’interruption de la sécurisation (réseau, stockage, crash du composant vitam-logbook…).
- Conduite à tenir :
  
  Consulter l’écran d’administration des journaux d’opérations pour vérifier l’état de l’opération.
  
  Consulter les logs techniques de la solution en cas d’erreurs techniques.
  
  Vérifier que les sécurisations suivantes ont bien pu reprendre dans l’écran d’administration des journaux d’opérations.
  
  Si le problème persiste, contacter le support du programme VITAM.
NOTICE_CONCURRENT_TRACEABILITY_OPERATION
- Explication : L’exécution d’une opération de traçabilité s’est arrêtée suite à la détection d’une opération de sécurisation concurrente.
- Cause(s) possible(s) :
  
  Un bug historique pouvait causer dans certains cas des exécutions d’opérations de traçabilité concurrentes.
- Conduite à tenir :
  
  Aucune action requise.