Skip to main content

Diese Version von GitHub Enterprise Server wurde eingestellt am 2024-03-26. Es wird keine Patch-Freigabe vorgenommen, auch nicht für kritische Sicherheitsprobleme. Für bessere Leistung, verbesserte Sicherheit und neue Features aktualisiere auf die neueste Version von GitHub Enterprise Server. Wende dich an den GitHub Enterprise-Support, um Hilfe zum Upgrade zu erhalten.

Informationen zu Systemprotokollen

Um Administratoren dabei zu helfen, Aktivitäten und Fehler zu verstehen, speichert GitHub Enterprise Server Systemprotokolle.

Informationen zur Systemprotokolle für GitHub Enterprise Server

Zum Nachverfolgen, Überprüfen und Beheben von Aktivitäten und Ausnahmen unter Ihre GitHub Enterprise Server-Instance können Sie die Systemprotokolle überprüfen. Ihre Instanz speichert die folgenden beiden Arten von Systemprotokollen:

  • Nur-Text-Protokolldateien auf dem Datenträger, gespeichert von Syslog oder bestimmten Diensten; und
  • Binärprotokolldateien, gespeichert durch Journal.

Standardmäßig werden Systemprotokolle für GitHub Enterprise Server automatisch alle 24 Stunden gedreht und für sieben Tage aufbewahrt. Systemprotokolle umfassen Systemereignisse, Anwendungsprotokolle und Git-Ereignisse. Da Protokolldateien häufig geschrieben werden und groß sein können, können Sie Protokolleinträge auf einem Host extrahieren und analysieren, die von Ihre GitHub Enterprise Server-Instance getrennt sind.

Personen mit administrativem SSH-Zugriff auf eine GitHub Enterprise Server-Instanz können auf Systemprotokolle zugreifen und diese lesen. Weitere Informationen findest du unter Auf die Verwaltungsshell (SSH) zugreifen.

Sie können Systemprotokolle und Überwachungsprotokolle zur Analyse oder längeren Aufbewahrung an ein externes System weiterleiten. Weitere Informationen finden Sie unter Protokollweiterleitung und unter Streamen des Überwachungsprotokolls für ein Unternehmen.

Neben der Überprüfung Ihrer Systemprotokolle können Sie die Aktivitäten auf Ihrer Instanz auf andere Weise überwachen. Sie können beispielsweise Überwachungsprotokolle und Pushprotokolle überprüfen oder globale Webhooks konfigurieren. Weitere Informationen findest du unter Überwachen von Aktivitäten in deinem Unternehmen.

Hinweis: Die folgenden Listen an Protokollen erheben keinen Anspruch auf Vollständigkeit.

Systemprotokolldateien

GitHub Enterprise Server schreibt verschiedene Kategorien von Systemprotokollen als Nur-Text auf die Disk der Instanz. Personen mit administratorbasiertem SSH-Zugriff auf die Instanz können diese Dateien mithilfe von Linux-Befehlszeilentools wie cat, tail, head, less und more analysieren.

Protokolldateien für die Authentifizierung

Die folgenden Protokolldateien enthalten Ereignisse von Diensten, die Authentifizierungsfunktionen für Ihre Instanz bereitstellen.

PfadBeschreibung
/var/log/github/auth.log
Zeichnet Authentifizierungsanforderungen an die GitHub-Anwendung in Ihrer Instanz auf.
/var/log/github/ldap-sync.log
Wenn LDAP für die Instanz konfiguriert ist und die LDAP-Synchronisierung aktiviert, werden Ereignisse aufgezeichnet, die der LDAP-Synchronisierung zugeordnet werden. Weitere Informationen finden Sie unter „Verwenden von LDAP“.
/var/log/github/ldap.log
Wenn LDAP für die Instanz konfiguriert ist, werden Ereignisse aufgezeichnet, die LDAP zugeordnet werden. Weitere Informationen findest du unter Verwenden von LDAP.

Protokolldateien für Datenbanken

In den folgenden Protokolldateien werden Ereignisse von Datenbankdiensten in Ihrer Instanz aufgezeichnet.

PfadBeschreibung
/var/log/mysql/mysql.log
Zeichnet Ereignisse im Zusammenhang mit der MySQL-Datenbank der Instanz auf.
/var/log/mysql/mysql.err
Zeichnet Fehler im Zusammenhang mit der MySQL-Datenbank der Instanz auf.

Protokolldateien für die GitHub-Anwendung

In den folgenden Protokolldateien werden Ereignisse aus der GitHub-Anwendung in Ihrer Instanz aufgezeichnet.

PfadBeschreibung
/var/log/github/audit.log
Zeichnet Benutzer-, Repository- und Systemereignisse für Aktivitäten in der GitHub-Anwendung in Ihrer Instanz auf. Sie können Einträge im Protokoll mithilfe des github_audit-Schlüsselworts filtern.
/var/log/github/exceptions.log
Zeichnet Ausnahmen auf, die von der GitHub-Anwendung gefunden werden.
/var/log/github/gitauth.log
Zeichnet Git-Authentifizierungsanforderungen mithilfe von HTTPS oder SSH auf. Sämtliche Git-Authentifizierungsanforderungen werden vom babeld-Dienst verarbeitet.
/var/log/github/production.log
Zeichnet interne Ereignisse für die GitHub-Anwendung auf. Für Anfragen an die Website, umfasst die Controller-Aktion, die geantwortet hat. Kann Einträge mit unterschiedlichen Strukturen enthalten, abhängig vom Ursprung des Jobs oder der Anforderung.

Protokolldateien für den HTTP-Server

In den folgenden Protokolldateien werden Ereignisse vom HTTP-Server der Instanz aufgezeichnet.

PfadBeschreibung
/var/log/nginx/error.log*
Zeichnet Fehler für Webanforderungen auf.
/var/log/nginx/gist.log
Zeichnet HTTP-Anforderungen im Zusammenhang mit Gists auf. Weitere Informationen findest du unter Gists erstellen.
/var/log/nginx/gist.error.log
Zeichnet Fehler im Zusammenhang mit HTTP-Anforderungen für Gists auf.
/var/log/nginx/github.log
Zeichnet HTTP-Anforderungen an die GitHub-Anwendung auf.
/var/log/nginx/github.error.log
Zeichnet Fehler auf, die HTTP-Anforderungen zugeordnet sind.
/var/log/nginx/pages.log
Zeichnet HTTP-Anforderungen auf, die GitHub Pages zugeordnet sind. Weitere Informationen findest du unter Informationen zu GitHub Pages.
/var/log/nginx/pages.error.log
Zeichnet Fehler im Zusammenhang mit HTTP-Anforderungen für GitHub Pages auf.

Protokolldateien für die Verwaltungskonsole

Die folgenden Protokolldateien enthalten Ereignisse aus den Verwaltungskonsole Ihrer Instanz. Weitere Informationen findest du unter Informationen zur Verwaltungskonsole.

PfadBeschreibung
/var/log/enterprise-manage/audit.log
Zeichnet die Aktivität in der Verwaltungskonsole der Instanz auf.
/var/log/enterprise-manage/unicorn.log
| Zeichnet HTTP- und HTTPS-Operationen auf, die Administratoren in den Verwaltungskonsole mithilfe der Web-Benutzeroberfläche oder REST-API ausführen. |

Protokolldateien für die Instanzkonfiguration

Die folgenden Protokolldateien enthalten Ereignisse im Zusammenhang mit der Konfiguration Ihrer Instanz.

PfadBeschreibung
/data/user/common/ghe-config.log
Zeichnet Ereignisse auf, die mit each Konfigurationsablauf assoziiert sind. Wenn eine Konfigurationsausführung fehlschlägt, wird die Ausgabe in das Protokoll beendet. Dieses Protokoll zeichnet auch Informationen zu Migrationen auf, die während des Upgrades der Software einer Instanz ausgeführt werden. Weitere Informationen findest du unter Befehlszeilenprogramme.

Die folgenden Protokolldateien enthalten Ereignisse von Diensten, die Suchfunktionen für Ihre Instanz bereitstellen.

PfadBeschreibung
/var/log/elasticsearch/github-enterprise.log
Zeichnet Ereignisse auf, die dem Elasticsearch-Dienst zugeordnet sind, der von Ihrer Instanz zum Bereitstellen von Suchdiensten verwendet wird.

Journalprotokolle für Webhooks

Die folgenden Protokolldateien enthalten Ereignisse im Zusammenhang mit Webhooks, die Ihre Instanz sendet.

DienstnameBeschreibung
hookshot-go
Zeichnet Ereignisse für alle Webhook-Aktivitäten auf der Instanz auf, einschließlich ausgelöster Webhooks, Lieferungen und Fehler.

Protokolldateien für Systemdienste

Die folgenden Protokolle enthalten Ereignisse von Systemdiensten auf Ihrer Instanz.

PfadBeschreibung
/var/log/coredumps.log
Zeichnet Informationen zu Systemprozessen auf, die unerwartet beendet werden.
/var/log/boot.log
Zeichnet Informationen zum Startvorgang der Instanz auf.
/var/log/chrony/
Dieses Verzeichnis enthält Protokolle im Zusammenhang mit der NTP (Network Time Protocol)-Synchronisierung und der Systemuhr der Instanz. Weitere Informationen finden Sie unter Zeitsynchronisierung konfigurieren.
/var/log/haproxy.log
Zeichnet alle Web- und API-Anforderungen an die Instanz auf. Bei HTTP-Verbindungen enthalten Einträge die URL, die der Client angefordert hat, sowie die HTTP-Methode für die Anforderung.
/var/log/ssh-console-audit.log
Zeichnet Befehle auf, die Administratoren mit der Verwaltungs-Shell (SSH) ausführen. Weitere Informationen findest du unter Auf die Verwaltungsshell (SSH) zugreifen.
/var/log/mail-replies/metroplex.log
Zeichnet Informationen zu E-Mails auf, die Ihre Instanz empfängt. Weitere Informationen findest du unter E-Mail für Benachrichtigungen konfigurieren.

Systemprotokolle im systemd-Journal

Mehrere GitHub Enterprise Server-Dienste, z. B. der babeld-Dienst, werden containerisiert. GitHub Enterprise Server schreibt Systemprotokolle für diese Dienste in das systemd-Journal in einem Binärformat.

Personen mit administrativem SSH-Zugriff auf die Instanz können diese Protokolle mithilfe des journalctl-Befehls analysieren. Weitere Informationen finden Sie unter journalctl(1) im Linux-Online-Handbuch.

Um Protokolle im systemd-Journal anzuzeigen, führen Sie den folgenden Befehl aus, indem Sie SERVICE-NAME durch einen Dienstnamen aus der folgenden Liste der Protokolle ersetzen.

journalctl -t SERVICE-NAME

Journalprotokolle für die GitHub-Anwendung

In den folgenden Protokollen werden Ereignisse aus der GitHub-Anwendung in Ihrer Instanz aufgezeichnet.

DienstnameBeschreibung
github-resqued
Zeichnet Ereignisse im Zusammenhang mit Hintergrundjobs auf.
github-unicorn
Zeichnet HTTP- und HTTPS-Operationen auf, die Benutzer in der Web-Benutzeroberfläche der Instanz oder über die APIs ausführen.

Journalprotokolle für Git

Die folgenden Protokolle enthalten Ereignisse im Zusammenhang mit Git-Aktivitäten auf Ihrer Instanz

DienstnameBeschreibung
babeld
Zeichnet Ereignisse für alle Git-Aktivitäten auf der Instanz auf, einschließlich der Authentifizierung für den Zugriff auf das Repository.
codeload
Zeichnet Ereignisse für Aktivitäten im Zusammenhang mit der Generierung oder dem Heranholen von Codearchiven für Repositorys auf der Instanz auf.
gpgverify
Zeichnet Ereignisse im Zusammenhang mit der Überprüfung der Prepaidtarif-Signatur auf. Weitere Informationen findest du unter Informationen zur Verifizierung einer Commit-Signatur.

Journalprotokolle für Speicher

Die folgenden Protokolle enthalten Ereignisse von Diensten, die Daten auf Ihrer Instanz speichern oder von Ihrer Instanz abrufen.

DienstnameBeschreibung
alambic
Zeichnet Ereignisse im Zusammenhang mit der Speicherung und dem Abruf von Dateien auf, z. B. Git LFS Objekte, Avatar-Bilder, Dateianhänge aus Kommentaren in der Web-UI und Freigabearchive.

Info zu Systemprotokollen in Supportbundles

Wenn Sie ein Supportbundle generieren, enthält die Datei Systemprotokolle. Weitere Informationen findest du unter Providing data to GitHub Support (Bereitstellen von Daten für GitHub Support).