Durchsuchen des Überwachungsprotokolls für dein Unternehmen

Informationen zur Suche beim Überwachungsprotokoll für dein Unternehmen

Du kannst das Überwachungsprotokoll für dein Unternehmens direkt über die Benutzeroberfläche mithilfe der Dropdownliste Filter oder durch Eingabe einer Suchabfrage durchsuchen.

Weitere Informationen zum Anzeigen der Überwachungsprotokolle für dein Unternehmen findest du unter Zugreifen auf das Überwachungsprotokoll für dein Unternehmen.

Außerdem kannst du mithilfe der API Überwachungsprotokollereignisse abrufen. Weitere Informationen findest du unter Verwenden der Überwachungsprotokoll-API für dein Unternehmen.

Du kannst nicht mit Text nach Einträgen suchen. Du kannst jedoch Suchabfragen mit den verschiedensten Filtern erstellen. Viele Operatoren, die beim Abfragen des Protokolls verwendet werden, z. B. -, > oder <, entsprechen demselben Format wie beim Durchsuchen von GitHub AE. Weitere Informationen findest du unter Informationen zur Suche auf GitHub.

Suchabfragefilter

Filtern	BESCHREIBUNG
Yesterday's activity	Alle Aktionen, die am letzten Tag erstellt wurden
Enterprise account management	Alle Aktionen in der Kategorie business
Organization membership	Alle Aktionen für den Zeitpunkt, an dem ein neuer Benutzer zum Beitritt zu einer Organisation eingeladen wurde
Team management	Alle Aktionen im Zusammenhang mit der Teamverwaltung – Wenn ein Benutzerkonto oder Repository einem Team hinzugefügt oder daraus entfernt wurde – Wenn ein Teambetreuer höhergestuft oder herabgestuft wurde – Wenn ein Team gelöscht wurde
Repository management	Alle Aktionen für die Repositoryverwaltung – Wenn ein Repository erstellt oder gelöscht wurde – Wenn die Sichtbarkeit des Repositorys geändert wurde – Wenn ein Team einem Repository hinzugefügt oder daraus entfernt wurde
Hook activity	Alle Aktionen für Webhooks und Pre-Receive-Hooks
Security management	Alle Aktionen in Bezug auf SSH-Schlüssel, Bereitstellungsschlüssel, Sicherheitsschlüssel, Zweistufige Authentifizierung (2FA) und Autorisierung von SAML Single Sign-On (SSO)-Anmeldeinformationen sowie Sicherheitsrisikowarnungen für Repositorys

Suchabfragesyntax

Du kannst eine Suchabfrage aus mindestens einem key:value-Paar erstellen, das durch die logischen Operatoren UND/ODER getrennt wird. So kannst du beispielsweise alle Aktionen anzeigen, die sich seit Anfang 2017 auf das Repository octocat/Spoon-Knife ausgewirkt haben:

repo:"octocat/Spoon-Knife" AND created:>=2017-01-01

Die folgenden key:value-Paare können in einer Suchabfrage verwendet werden:

Schlüssel	Wert
action	Name der überwachten Aktion
actor	Name des Benutzerkontos, mit dem die Aktion initiiert wurde
actor_id	ID des Benutzerkontos, das die Aktion initiiert hat.
actor_ip	IP-Adresse, von der die Aktion initiiert wurde.
business	Name des Unternehmens, das von der Aktion betroffen ist (falls zutreffend).
business_id	ID des Unternehmens, das von der Aktion betroffen ist (falls zutreffend).
ip	IP-Adresse des Akteurs.
note	Verschiedene ereignisspezifische Informationen (entweder im Nur-Text- oder JSON-Format).
oauth_app_id	ID der OAuth app, die der Aktion zugeordnet ist. operation
org	Name der Organisation, die von der Aktion betroffen ist (falls zutreffend).
org_id	ID der Organisation, die von der Aktion betroffen ist (falls zutreffend).
repo_id	ID des Repositorys, das von der Aktion betroffen ist (falls zutreffend).
repository	Name des Besitzers/der Besitzerin des Repositorys, in dem die Aktion ausgeführt wurde (z. B. octocat/octo-repo).
user_id	ID des Benutzers/der Benutzerin, der/die von der Aktion betroffen ist.
user	Name des Benutzers/der Benutzerin, der/die von der Aktion betroffen ist.

Wenn du Aktionen nach Kategorie gruppiert anzeigen möchtest, kannst du auch den Aktionsqualifizierer als key:value-Paar verwenden. Weitere Informationen findest du unter „Suchen basierend auf der ausgeführten Aktion“.

Eine vollständige Liste der Aktionen im Überwachungsprotokoll deines Unternehmens findest du unter Überwachungsprotokollereignisse für dein Unternehmen.

Auditprotokoll durchsuchen

Vorgangsbasierte Suche

Verwende den Qualifizierer operation, um Aktionen für spezifische Typen von Vorgängen zu beschränken. Beispiel:

• operation:access findet alle Ereignisse, bei denen auf eine Ressource zugegriffen wurde.
• operation:authentication findet alle Ereignisse, bei denen ein Authentifizierungsereignis ausgeführt wurde.
• operation:create findet alle Ereignisse, bei denen eine Ressource erstellt wurde.
• operation:modify findet alle Ereignisse, bei denen eine vorhandene Ressource geändert wurde.
• operation:remove findet alle Ereignisse, bei denen eine vorhandene Ressource entfernt wurde.
• operation:restore findet alle Ereignisse, bei denen eine vorhandene Ressource wiederhergestellt wurde.
• operation:transfer findet alle Ereignisse, bei denen eine vorhandene Ressource übertragen wurde.

Suche basierend auf Repository

Verwende den Qualifizierer repo, um Aktionen auf ein spezifisches Repository zu beschränken. Beispiel:

• repo:my-org/our-repo sucht alle Ereignisse, die für das our-repo-Repository in der my-org-Organisation aufgetreten sind.
• repo:my-org/our-repo repo:my-org/another-repo sucht alle Ereignisse, die für die our-repo- und another-repo-Repositorys in der my-org-Organisation aufgetreten sind.
• -repo:my-org/not-this-repo schließt alle Ereignisse aus, die für das not-this-repo-Repository in der my-org-Organisation aufgetreten sind.

Du musst den Namen Deiner Organisation in den repo-Qualifizierer einschließen. Es ist nicht möglich, nur nach repo:our-repo zu suchen.

Suche nach Benutzer

Der actor-Qualifizierer kann den Umfang von Ereignissen basierend auf dem Ausführenden der Aktion festlegen. Beispiel:

• actor:octocat findet alle Ereignisse, die von octocat durchgeführt wurden.
• actor:octocat actor:hubot findet alle Ereignisse, die von octocat oder hubot durchgeführt wurden.
• -actor:hubot schließt alle Ereignisse aus, die von hubot durchgeführt wurden.

Beachte, dass du nur den in GitHub AE verwendeten Benutzernamen nutzen kannst, nicht den wirklichen Namen eines Benutzers.

Suche nach der Art der durchgeführten Aktion

Verwende für die Suche nach bestimmten Ereignissen in deiner Abfrage den Qualifizierer action. Beispiel:

• action:team sucht alle Ereignisse, die in der Teamkategorie gruppiert sind.
• -action:hook schließt alle Ereignisse in der Webhookkategorie aus.

Bei jeder Kategorie gibt es eine Gruppe von zugeordneten Aktionen, nach denen du filtern kannst. Beispiel:

• action:team.create sucht alle Ereignisse, bei denen ein Team erstellt wurde.
• -action:hook.events_changed schließt alle Ereignisse aus, bei denen die Ereignisse in einem Webhook geändert wurden.

Aktionen, die im Überwachungsprotokoll deines Unternehmens zu finden sind, werden in die folgenden Kategorien gruppiert:

Kategoriename	BESCHREIBUNG
artifact	Enthält Aktivitäten im Zusammenhang mit GitHub Actions-Artefakten für Workflowausführungen.
business	Enthält Aktivitäten im Zusammenhang mit Geschäftseinstellungen für ein Unternehmen.
business_secret_scanning_custom_pattern	Enthält Aktivitäten im Zusammenhang mit benutzerdefinierten Mustern zur secret scanning in einem Unternehmen.
checks	Enthält Aktivitäten im Zusammenhang mit Überprüfungssammlungen und -ausführungen.
commit_comment	Enthält Aktivitäten im Zusammenhang mit dem Aktualisieren oder Löschen von Commitkommentaren.
dependabot_alerts	Umfasst Konfigurationsaktivitäten auf Organisationsebene für Dependabot alerts in vorhandenen Repositorys Weitere Informationen findest du unter Informationen zu Dependabot-Warnungen.
dependabot_alerts_new_repos	Enthält Konfigurationsaktivitäten auf Organisationsebene für Dependabot alerts in neuen Repositorys, die in der Organisation erstellt wurden.
dependabot_repository_access	Enthält Aktivitäten im Zusammenhang mit den privaten Repositorys in einer Organisation, auf die Dependabot zugreifen darf.
dependency_graph	Enthält Konfigurationsaktivitäten auf Organisationsebene für Abhängigkeitsdiagramme für Repositorys. Weitere Informationen findest du unter Informationen zum Abhängigkeitsdiagramm.
dependency_graph_new_repos	Enthält Konfigurationsaktivitäten auf Organisationsebene für neue Repositorys, die in der Organisation erstellt wurden.
external_group	Enthält Aktivitäten im Zusammenhang mit Okta-Gruppen.
external_identity	Enthält Aktivitäten im Zusammenhang mit einem Benutzer in einer Okta-Gruppe.
hook	Enthält Aktivitäten im Zusammenhang mit Webhooks.
integration	Enthält Aktivitäten im Zusammenhang mit Integrationen in einem Konto.
integration_installation	Enthält Aktivitäten im Zusammenhang mit Integrationen, die in einem Konto installiert sind.
integration_installation_request	Enthält Aktivitäten im Zusammenhang mit Anforderungen, die von Organisationsmitgliedern an Besitzer*innen gesendet werden, um Integrationen zur Verwendung innerhalb der Organisation genehmigen zu lassen.
ip_allow_list	Enthält Aktivitäten im Zusammenhang mit dem Aktivieren oder Deaktivieren der IP-Zulassungsliste für eine Organisation.
ip_allow_list_entry	Enthält Aktivitäten im Zusammenhang mit dem Erstellen, Löschen und Bearbeiten eines IP-Zulassungslisteneintrags für eine Organisation.
issue	Enthält Aktivitäten im Zusammenhang mit dem Anheften, Übertragen oder Löschen eines Issues in einem Repository.
issue_comment	Enthält Aktivitäten im Zusammenhang mit dem Anheften, Übertragen oder Löschen von Issuekommentaren.
issues	Enthält Aktivitäten im Zusammenhang mit dem Aktivieren oder Deaktivieren der Issueerstellung für eine Organisation.
members_can_create_pages	Enthält Aktivitäten zum Verwalten der Veröffentlichung von GitHub Pages-Websites für Repositorys in der Organisation. Weitere Informationen findest du unter Verwalten der Veröffentlichung von GitHub Pages-Websites für deine Organisation.
members_can_create_private_pages	Enthält Aktivitäten zum Verwalten der Veröffentlichung privater GitHub Pages-Websites für Repositorys in der Organisation.
members_can_create_public_pages	Enthält Aktivitäten zum Verwalten der Veröffentlichung öffentlicher GitHub Pages-Websites für Repositorys in der Organisation.
members_can_delete_repos	Enthält Aktivitäten im Zusammenhang mit der Aktivierung oder Deaktivierung der Repositoryerstellung für eine Organisation.
oauth_access	Enthält Aktivitäten im Zusammenhang mit OAuth-Zugriffstoken.
oauth_application	Umfasst Aktivitäten im Zusammenhang mit OAuth apps.
org	Enthält Aktivitäten im Zusammenhang mit der Organisationsmitgliedschaft.
org_credential_authorization	Enthält Aktivitäten im Zusammenhang mit der Autorisierung von Anmeldeinformationen für die Verwendung mit SAML Single Sign-On.
org_secret_scanning_custom_pattern	Enthält Aktivitäten im Zusammenhang mit benutzerdefinierten Mustern für die secret scanning in einer Organisation. Weitere Informationen findest du unter Definieren von benutzerdefinierten Mustern für die Geheimnisüberprüfung.
organization_default_label	Enthält Aktivitäten im Zusammenhang mit Standardbezeichnungen für Repositorys in einer Organisation.
private_repository_forking	Enthält Aktivitäten im Zusammenhang mit der Zulassung von Forks privater und interner Repositorys für ein Repository, eine Organisation oder ein Unternehmen.
project	Enthält Aktivitäten im Zusammenhang mit Projektboards.
project_field	Enthält Aktivitäten im Zusammenhang mit der Felderstellung und -löschung in einem Projektboard.
project_view	Enthält Aktivitäten im Zusammenhang mit der Ansichtserstellung und -löschung in einem Projektboard.
protected_branch	Enthält Aktivitäten im Zusammenhang mit geschützten Branches.
public_key	Enthält Aktivitäten im Zusammenhang mit SSH-Schlüsseln und Bereitstellungsschlüsseln.
pull_request	Enthält Aktivitäten im Zusammenhang mit Pull Requests.
pull_request_review	Enthält Aktivitäten im Zusammenhang mit Pull Request-Überprüfungen.
pull_request_review_comment	Enthält Aktivitäten im Zusammenhang mit Pull Request-Überprüfungskommentaren.
repo	Enthält Aktivitäten im Zusammenhang mit den Repositorys, die einer Organisation gehören.
repository_image	Enthält Aktivitäten im Zusammenhang mit Bildern für ein Repository.
repository_invitation	Enthält Aktivitäten im Zusammenhang mit Einladungen zum Beitreten zu einem Repository.
repository_projects_change	Enthält Aktivitäten im Zusammenhang mit der Aktivierung von Projekten für ein Repository oder für alle Repositorys in einer Organisation.
repository_secret_scanning	Enthält Aktivitäten auf Repositoryebene im Zusammenhang mit der secret scanning. Weitere Informationen findest du unter Informationen zur Geheimnisüberprüfung.
repository_secret_scanning_custom_pattern	Enthält Aktivitäten im Zusammenhang mit benutzerdefinierten Mustern für die secret scanning in einem Repository. Weitere Informationen findest du unter Definieren von benutzerdefinierten Mustern für die Geheimnisüberprüfung.
repository_secret_scanning_push_protection	Umfasst Aktivitäten im Zusammenhang mit dem secret scanning-Pushschutzfeature in einem Repository. Weitere Informationen findest du unter Pushschutz für Repositorys und Organisationen.
repository_vulnerability_alert	Enthält Aktivitäten im Zusammenhang mit Dependabot alerts.
role	Enthält Aktivitäten im Zusammenhang mit benutzerdefinierten Repositoryrollen.
secret_scanning	Enthält Konfigurationsaktivitäten auf Organisationsebene zur secret scanning in vorhandenen Repositorys. Weitere Informationen findest du unter Informationen zur Geheimnisüberprüfung.
secret_scanning_new_repos	Enthält Konfigurationsaktivitäten auf Organisationsebene für die secret scanning in neuen Repositorys, die in der Organisation erstellt wurden.
security_key	Enthält Aktivitäten im Zusammenhang mit der Registrierung und Entfernung von Sicherheitsschlüsseln.
ssh_certificate_authority	Enthält Aktivitäten im Zusammenhang mit einer SSH-Zertifizierungsstelle in einer Organisation oder einem Unternehmen.
ssh_certificate_requirement	Enthält Aktivitäten, mit denen festgelegt wird, dass Mitglieder SSH-Zertifikate verwenden müssen, um auf Organisationsressourcen zuzugreifen.
staff	Enthält Aktivitäten im Zusammenhang mit einem Websiteadministrator, der eine Aktion ausführt.
team	Enthält Aktivitäten im Zusammenhang mit Teams in einer Organisation.
team_discussions	Enthält Aktivitäten im Zusammenhang mit der Verwaltung von Teamdiskussionen für eine Organisaation.
user	Enthält Aktivitäten im Zusammenhang mit Benutzer*innen in einem Unternehmen oder einer Organisation.
workflows Enthält Aktivitäten im Zusammenhang mit GitHub Actions-Workflows.

Suche nach dem Zeitpunkt der Aktion

Verwende den Qualifizierer created, um Ereignisse im Überwachungsprotokoll basierend auf dem Zeitpunkt, an dem sie aufgetreten sind, zu filtern.

Die Datumsformatierung muss dem ISO8601-Standard entsprechen: YYYY-MM-DD (Jahr-Monat-Tag). Du kannst nach dem Datum auch optionale Zeitinformationen im Format THH:MM:SS+00:00 hinzufügen, um nach Stunde, Minute und Sekunde zu suchen. Das heißt, T, gefolgt von HH:MM:SS (Stunden-Minuten-Sekunden) und einem UTC-Offset (+00:00).

Wenn du nach einem Datum suchst, kannst du „größer als“, „kleiner als“ und Bereichsqualifizierer verwenden, um Ergebnisse weiter zu filtern. Weitere Informationen findest du unter Grundlagen der Suchsyntax.

Beispiel:

• created:2014-07-08 sucht alle Ereignisse, die am 8. Juli 2014 aufgetreten sind.
• created:>=2014-07-08 sucht alle Ereignisse, die am oder nach dem 8. Juli 2014 aufgetreten sind.
• created:<=2014-07-08 sucht alle Ereignisse, die am oder vor dem 8. Juli 2014 aufgetreten sind.
• created:2014-07-01..2014-07-31 sucht alle Ereignisse, die im Juli 2014 aufgetreten sind.

Suche nach Standort

Mithilfe des Qualifizierers country kannst du Ereignisse im Überwachungsprotokoll basierend auf dem Ursprungsland filtern. Dazu kannst du den Kurzcode aus zwei Buchstaben oder den vollständigen Namen eines Landes verwenden. Ländernamen mit Leerzeichen müssen in Anführungszeichen eingeschlossen werden. Beispiel:

• country:de sucht alle Ereignisse, die in Deutschland aufgetreten sind.
• country:Mexico sucht alle Ereignisse, die in Mexiko aufgetreten sind.
• country:"United States" sucht alle Ereignisse, die in den USA aufgetreten sind.