Informationen zum Exportieren von Überwachungsprotokoll und Git-Ereignisdaten
Du kannst das Überwachungsprotokoll exportieren, indem du eine JSON- oder CSV-Datei aus deinem Unternehmen auf GitHub Enterprise Cloud herunterlädst. Wenn du Überwachungsprotokollereignisse exportierst, kannst du eine oder mehrere dieser unterstützten Qualifizierer abfragen, um für den Export nach bestimmten Protokollereignissen zu filtern. Weitere Informationen findest du unter „Durchsuchen des Überwachungsprotokolls für dein Unternehmen“.
Das Audit-Protokoll listet Ereignisse auf, die durch Aktivitäten ausgelöst wurden, die Ihr Unternehmen innerhalb der letzten 180 Tage betreffen. Das Überwachungsprotokoll behält Git-Ereignisse sieben Tage lang bei.
Du kannst Git-Ereignisdaten exportieren, indem du eine JSON-Datei aus dem Überwachungsprotokoll deines Unternehmens herunterlädst. Im Gegensatz zu Überwachungsprotokolldaten kannst du keine Abfrage für bestimmte Git-Ereignisse durchführen, um auf der Benutzeroberfläche des Überwachungsprotokolls zu filtern und zu exportieren.
Hinweis: Wenn du Git-Ereignisse exportierst, sind Ereignisse, die über den Webbrowser initiiert wurden, oder die REST- oder GraphQL-APIs nicht enthalten. Wenn ein Benutzer beispielsweise einen Pull Request im Webbrowser mergt, werden Änderungen in den Basisbranch gepusht, aber das Git-Ereignis für diesen Push ist nicht im Export enthalten.
Nachdem du das Protokoll exportiert hast, werden die folgenden Schlüssel und Werte in der resultierenden Datei aufgeführt.
| Schlüssel | Beispielwert |
|---|---|
action | team.create |
actor | octocat |
user | codertocat |
actor_location.country_code | US |
org | octo-org |
repo | octo-org/documentation |
created_at | 1429548104000 (der Zeitstempel gibt die Zeit in Millisekunden seit Beginn der UNIX-Zeit an) |
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 |
Alternativ zum Exportieren von Protokollereignissen kannst du die API zum Abrufen von Überwachungsprotokollereignissen verwenden oder GitHub Enterprise Cloud zum Streamen von Überwachungsdaten einrichten, wenn Ereignisse protokolliert werden. Weitere Informationen findest du unter Verwenden der Überwachungsprotokoll-API für dein Unternehmen und unter Streamen des Überwachungsprotokolls für ein Unternehmen.
Exportieren von Überwachungsprotokolldaten
-
Klicken Sie in der oberen rechten Ecke von GitHub auf Ihr Profilfoto und dann auf Ihre Unternehmen.
-
Klicke in der Liste der Unternehmen auf das Unternehmen, das du anzeigen möchtest.
-
Klicken Sie auf der linken Seite der Seite in der Randleiste des Enterprise-Kontos auf Einstellungen.
-
Wähle unter „ Einstellungen“ die Option Überwachungsprotokoll aus.
-
Optional kannst du nur die gefilterten Ergebnisse exportieren, indem du nach mindestens einem unterstützten Qualifizierer suchst oder Protokollfilter verwendest.
-
Wähle das Dropdownmenü Exportieren aus, und klicke auf ein Dateiformat.
Exportieren von Git-Ereignisdaten
Du kannst auch Git-Ereignisdaten für einen Datumsbereich exportieren. Die Daten werden als komprimierte durch neue Zeilen getrennte JSON-Datei exportiert.
-
Klicken Sie in der oberen rechten Ecke von GitHub auf Ihr Profilfoto und dann auf Ihre Unternehmen.
-
Klicke in der Liste der Unternehmen auf das Unternehmen, das du anzeigen möchtest.
-
Klicken Sie auf der linken Seite der Seite in der Randleiste des Enterprise-Kontos auf Einstellungen.
-
Wähle unter „ Einstellungen“ die Option Überwachungsprotokoll aus.
-
Wähle das Dropdownmenü Git-Ereignisse exportieren und dann einen Datumsbereich aus, für den Protokollereignisse exportiert werden sollen.
-
Klicke auf Ergebnisse herunterladen.
-
Um die JSON-Daten zu extrahieren, dekomprimierst du die Datei mit einem Hilfsprogrammclient oder Befehl für Archive. Beispiel:
gunzip export-avocado-corp-1642896556.json.gz