Skip to main content

Exportieren der Überwachungsprotokollaktivität für dein Unternehmen

Du kannst die Daten von Überwachungs- und Git-Ereignissen zur Offlineanalyse in eine Datei exportieren.

Wer kann dieses Feature verwenden?

Enterprise owners

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 finden Sie 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üsselBeispielwert
actionteam.create
actoroctocat
usercodertocat
actor_location.country_codeUS
orgocto-org
repoocto-org/documentation
created_at1429548104000 (der Zeitstempel gibt die Zeit in Millisekunden seit Beginn der UNIX-Zeit an)
data.emailoctocat@nowhere.com
data.hook_id245
data.events["issues", "issue_comment", "pull_request", "pull_request_review_comment"]
data.events_were["push", "pull_request", "issues"]
data.target_loginoctocat
data.old_userhubot
data.teamocto-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

  1. Klicke auf GitHub in der oberen rechten Ecke auf dein Profilfoto.
  2. Klicke je nach deiner Umgebung auf Dein Unternehmenoder auf Deine Unternehmen, und klicke dann auf das Unternehmen, das du anzeigen möchtest.
  3. Klicken Sie auf der linken Seite der Seite in der Randleiste des Enterprise-Kontos auf Einstellungen.
  4. Wähle unter „ Einstellungen“ die Option Überwachungsprotokoll aus.
  5. Optional kannst du nur die gefilterten Ergebnisse exportieren, indem du nach mindestens einem unterstützten Qualifizierer suchst oder Protokollfilter verwendest.
  6. 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.

  1. Klicke auf GitHub in der oberen rechten Ecke auf dein Profilfoto.

  2. Klicke je nach deiner Umgebung auf Dein Unternehmenoder auf Deine Unternehmen, und klicke dann auf das Unternehmen, das du anzeigen möchtest.

  3. Klicken Sie auf der linken Seite der Seite in der Randleiste des Enterprise-Kontos auf Einstellungen.

  4. Wähle unter „ Einstellungen“ die Option Überwachungsprotokoll aus.

  5. Wähle das Dropdownmenü Git-Ereignisse exportieren und dann einen Datumsbereich aus, für den Protokollereignisse exportiert werden sollen.

  6. Klicke auf Ergebnisse herunterladen.

  7. 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