À propos de l'exportation des données d'événements du journal d'audit et de Git
Vous pouvez exporter le journal d’audit en téléchargeant un fichier JSON ou CSV à partir de votre entreprise sur GitHub. Quand vous exportez des événements du journal d’audit, vous pouvez effectuer des interrogations avec un ou plusieurs des qualificateurs pris en charge pour filtrer les événements de journal spécifiques à exporter. Consultez « Recherche dans le journal d’audit de votre entreprise ».
Le journal d'audit répertorie les événements déclenchés par les activités qui ont affecté votre entreprise au cours des 180 derniers jours. Le journal d’audit conserve les événements Git pendant sept jours.
Vous pouvez exporter des données d’événements Git en téléchargeant un fichier JSON à partir du journal d’audit de votre entreprise. Vous ne pouvez pas effectuer d’interrogation pour filtrer et exporter des événements Git spécifiques dans l’interface utilisateur du journal d’audit comme vous pouvez le faire avec les données du journal d’audit.
Remarque
Lorsque vous exportez des événements Git, les événements lancés via le navigateur web ou les API REST ou GraphQL ne sont pas inclus. Par exemple, lorsqu’un utilisateur fusionne une demande de tirage dans le navigateur web, les modifications sont poussées vers la branche de base, mais l’événement Git pour cette poussée n’est pas inclus dans l’exportation.
En guise d’alternative à l’exportation d’événements de journal, vous pouvez utiliser l’API pour récupérer les événements du journal d’audit. Pour plus d’informations, consultez « Utilisation de l’API de journal d’audit pour votre entreprise ».
Limites d’exportation
Il existe une limite stricte lors de l’exportation des journaux d’audit pour votre entreprise. Ces limites sont les suivantes :
- Fichier compressé de 100 Mo ou
- 10 minutes de traitement pour l’exportation, ou
- les deux.
Pour éviter ces limites, nous vous recommandons de filtrer le journal d’audit sur un jeu de données plus petit avant d’exporter. Pour plus d’informations, consultez « Recherche dans le journal d’audit de votre entreprise ».
Si vous envisagez d’examiner un jeu de données volumineux de journaux d’audit, nous vous recommandons de diffuser en continu vos journaux vers un système de gestion des données externe. Pour plus d’informations, consultez « Streaming de journaux d’audit pour votre entreprise ».
Clés et valeurs de journal exportées
Après avoir exporté le journal, vous verrez les clés et valeurs suivantes dans le fichier qui en résulte.
| Clé | Valeur d'exemple |
|---|---|
action | team.create |
actor | octocat |
user | codertocat |
actor_location.country_code | US |
org | octo-org |
repo | octo-org/documentation |
created_at | 1429548104000 (Timestamp indique le temps écoulé depuis l’époque, en millisecondes). |
data.email | octocat@nowhere.com |
data.hook_id | 245 |
data.events | ["issues", "issue_comment", "pull_request", "pull_request_review_comment"] |
data.events_were | ["push", "pull_request", "issues"] |
data.target_login | octocat |
data.old_user | hubot |
data.team | octo-org/engineering |
Exportation des données du journal d’audit
- Accédez à votre entreprise. Par exemple, depuis la page Entreprises sur GitHub.com.
- En haut de la page, cliquez sur Paramètres.
- Sous « Paramètres », cliquez sur Journal d’audit.
- Si vous le souhaitez, pour exporter uniquement les résultats filtrés, effectuez une recherche avec un ou plusieurs qualificateurs ou filtres de journal pris en charge.
- Sélectionnez le menu déroulant Exporter, puis cliquez sur un format de fichier.
Exportation des données d’événements Git
Vous pouvez également exporter des données d’événements Git par plage de dates. Les données sont exportées sous la forme d’un fichier JSON compressé, délimité par des lignes nouvelles.
-
Accédez à votre entreprise. Par exemple, depuis la page Entreprises sur GitHub.com.
-
En haut de la page, cliquez sur Paramètres.
-
Sous « Paramètres », cliquez sur Journal d’audit.
-
Sélectionnez le menu déroulant Exporter les événements Git et choisissez une plage de dates pour laquelle exporter les événements de journal.
-
Cliquez sur Télécharger les résultats.
-
Pour extraire les données JSON, décompressez le fichier à l’aide d’une commande ou d’un client utilitaire d’archivage. Par exemple :
gunzip export-avocado-corp-1642896556.json.gz