---
title: Journal des actions
description: Retrouver qui a fait quoi, quand et avec quel résultat, suivre une PR de bout en bout et exporter le journal en CSV.
---

# Journal des actions

Le **Journal des actions** (journal d'audit) trace les décisions et les effets de la plateforme : connexions, invitations, changements de politique, exécutions, publications, exports, opérations d'exploitation. Il répond à la question « qui a fait quoi, quand, et avec quel résultat ».

**Qui peut le faire :** tous les rôles, avec un périmètre différent selon le rôle (tableau ci-dessous). Le journal est en lecture seule : personne ne peut modifier ni supprimer une entrée depuis la plateforme.

## Ce que chacun voit

| Rôle | Périmètre |
| --- | --- |
| Administrateur | Tout le journal de l'organisation. Chaque consultation est elle-même journalisée. |
| Responsable | Tout le journal des projets dont il est Responsable, plus sa propre activité. |
| Opérateur, Lecteur | Leur propre activité, sur leurs projets et hors projet. |

Un encadré en haut de page rappelle votre périmètre : **Vue organisation** ou **Vue limitée à vos droits**.

## Ouvrir le journal

Dans la barre **Supervision**, cliquez sur **Journal des actions**. Par défaut, la page affiche les 7 derniers jours.

## Filtrer les entrées

| Filtre | Usage |
| --- | --- |
| **Du (UTC)** et **Au (UTC, inclus)** | Période de 31 jours au plus. |
| **Projet** | Un projet de votre périmètre, ou **Tous mes projets**. |
| **Type d'acteur** | **Personne**, **Clé API**, **Système** ou **Import historique**. |
| **Acteur** | Une personne précise. |
| **Action** | Une famille (par exemple **Identité (famille)**, **Publication (famille)**) ou une action exacte (par exemple `policy.global_stop`). |
| **Résultat** | **Demandé**, **Autorisé**, **Refusé**, **Réussi**, **Échec** ou **Inconnu**. |
| **Corrélation** | Identifiant de corrélation complet d'une demande. |
| **Exécution** | Identifiant d'une exécution. |
| **Pull request n°** | Numéro de PR. Exige un projet sélectionné. |

Les familles d'actions sont : Identité, Accès et clés, Politique et accords, Maintenance, Portefeuille, Publication, Audits, Données sensibles, Exploitation, Tâches durables.

Cliquez sur **Filtrer** pour appliquer, **Réinitialiser** pour revenir aux valeurs par défaut. Les filtres s'inscrivent dans l'adresse de la page, par exemple `/audit-log?action=policy.global_stop&result=denied`.

## Lire une entrée

| Colonne | Contenu |
| --- | --- |
| **Date** | Date et heure UTC |
| **Action** | Code de l'action, avec la raison codifiée en dessous |
| **Résultat** | Badge de résultat |
| **Acteur** | La personne, « Clé API de » suivi du nom du créateur et de l'identifiant de la clé, ou le service système |
| **Projet** | Le projet, ou **Organisation** pour une action hors projet |
| **Corrélation** | Liens **Même corrélation**, **Exécution** et **PR n°** |

Les métadonnées sont expurgées : compteurs, booléens et empreintes seulement. Aucun secret, mot de passe, code de sécurité, contenu de code, message ni adresse e-mail n'est conservé.

Pour remonter dans le temps, cliquez sur **Entrées plus anciennes**.

## Suivre une PR de bout en bout

1. Sélectionnez le **Projet**.
2. Saisissez le numéro dans **Pull request n°**, puis cliquez sur **Filtrer**.
3. Le journal affiche les entrées de l'exécution qui a ouvert la PR brouillon et de toutes ses reprises : notification, publication, réponses, suivi.

Le lien **PR n°** d'une entrée lance directement cette recherche.

## Retrouver une demande précise

Chaque demande reçoit un identifiant de corrélation. Pour un appel API, il est renvoyé dans l'en-tête de réponse `X-Correlation-Id`.

1. Copiez cet identifiant.
2. Collez-le dans **Corrélation**, puis cliquez sur **Filtrer**.
3. Vous retrouvez la demande, son autorisation et ses effets, y compris ceux du worker.

Depuis une entrée, le lien **Même corrélation** fait la même recherche.

> [!TIP]
> Pour voir l'activité d'une clé API, ouvrez l'inventaire des clés et cliquez sur **Activité des clés de ce propriétaire**. Voir [Inventaire des clés API](07-inventaire-des-cles-api.md).

## Exporter en CSV

1. Réglez les filtres.
2. Cliquez sur **Exporter ces entrées en CSV**.

L'export applique exactement le périmètre et les filtres de la page. Il contient 5 000 lignes au plus : au-delà, il est refusé et vous demande une période plus courte. Les cellules qui ressembleraient à des formules de tableur sont neutralisées. L'export lui-même est inscrit au journal, réussi ou refusé.

## Durée de conservation

Les entrées sont conservées 180 jours par défaut, puis exportées et purgées par l'exploitant. Voir [Rétention du journal et rôles PostgreSQL](../08-deploiement-et-exploitation/10-retention-et-roles-postgresql.md).

## Erreurs et refus courants

| Message | Cause | Que faire |
| --- | --- | --- |
| « Filtres invalides : vérifiez la période, les identifiants et le projet. » | Période de plus de 31 jours, date de début après la date de fin, identifiant mal formé, ou **Pull request n°** sans projet. | Corrigez le filtre. |
| « Page introuvable ou accès indisponible. » | Projet hors de votre périmètre. | Retirez le filtre de projet. |
| **Aucune entrée** | Aucune action visible pour ces filtres. | Élargissez la période ou le projet. |

## Pour continuer

L'Administrateur contrôle les clés API de l'organisation dans l'[Inventaire des clés API](07-inventaire-des-cles-api.md).
