Informationen zu Diagnosedateien und Supportbundles
GitHub Support kann dich bitten, zusätzliche Daten in Form von bereinigten Protokolldateien bereitzustellen. Es gibt drei Arten von Protokolldateien, die du möglicherweise angeben sollst.
Diagnosedateien enthalten Informationen zu den Einstellungen und Umgebungen einer GitHub Enterprise Server-Instanz, Supportbundles enthalten Diagnosen und Protokolle der letzten zwei Tage, und erweiterte Supportbundles enthalten auch Diagnose- und Protokolle, aber aus den letzten sieben Tagen.
Informationen zur Protokolldateibereinigung
Authentifizierungstoken, Schlüssel und Geheimnisse werden aus Protokolldateien in den folgenden Protokollverzeichnissen entfernt, die in einer Supportbundle- oder Diagnosedatei enthalten sind:
alambic-logs
babeld-logs
codeload-logs
enterprise-manage-logs
github-logs
hookshot-logs
lfs-server-logs
semiotic-logs
task-dispatcher-logs
pages-logs
registry-logs
render-logs
svn-bridge-logs
Diagnosedateien erstellen und freigeben
Diagnosedateien stellen eine Übersicht der Einstellungen und Umgebung einer GitHub Enterprise Server-Instanz dar, die Folgendes enthält:
- Kundenlizenz-Informationen, einschließlich Firmenname, Ablaufdatum und Anzahl der Benutzerlizenzen
- Versionsnummern und SHAs
- VM-Architektur
- Hostname, Privatmodus, SSL-Einstellungen
- Lade- und Prozessauflistungen
- Netzwerkeinstellungen
- Authentifizierungsmethode und -details
- Anzahl der Repositorys, Benutzer und andere Installationsdaten
Du kannst die Diagnose für deine Instanz über die Management Console oder durch Ausführen des Befehlszeilenprogramms ghe-diagnostics
herunterladen.
Diagnosedatei über die Management Console erstellen
Du kannst diese Methode verwenden, wenn du deinen SSH-Schlüssel nicht zur Hand hast.
-
Klicke in einem Verwaltungskonto auf GitHub Enterprise Server, und klicke in der oberen rechten Ecke einer beliebigen Seite auf .
-
Wenn du dich nicht bereits auf der Seite „Websiteadministrator“ befindest, klicke in der oberen linken Ecke auf Websiteadministrator.
1. Klicke auf der linken Seitenleiste auf Management Console .
1. Wenn du dazu aufgefordert wirst, gib dein Management Console-Kennwort ein.
4. Klicke im oberen rechten Bereich der Management Console auf Support.
-
Klicke auf Diagnoseinformationen herunterladen.
Diagnosedatei mithilfe von SSH erstellen
Du kannst diese Methode verwenden, ohne sich bei der Management Console anzumelden.
Verwende das Befehlszeilenprogramm ghe-diagnostics, um die Diagnose für deine Instanz abzurufen.
$ ssh -p122 admin@HOSTNAME -- 'ghe-diagnostics' > diagnostics.txt
Support-Bundles erstellen und freigeben
Nachdem du deine Supportanfrage eingereicht hast, können wir Dich bitten, unserem Team ein Support-Paket bereitzustellen. Das Support-Bundle ist ein als .gzip komprimiertes TAR-Archiv, das Diagnosen und wichtige Protokolle deiner Instanz enthält, z. B.:
- authentifizierungsbezogene Protokolle, die bei der Behebung von Authentifizierungsfehlern oder der Konfiguration von LDAP, CAS oder SAML hilfreich sein können,
- Management Console-Protokoll,
github-logs/exceptions.log
: Informationen zu 500 Fehlern auf der Websitegithub-logs/audit.log
: GitHub Enterprise Server-Auditprotokollebabeld-logs/babeld.log
: Git-Proxyprotokollesystem-logs/haproxy.log
: HAProxy-Protokolleelasticsearch-logs/github-enterprise.log
: Elasticsearch-Protokolleconfiguration-logs/ghe-config.log
: GitHub Enterprise Server-Konfigurationsprotokollecollectd/logs/collectd.log
: Collectd-Protokollemail-logs/mail.log
: SMTP-E-Mail-Übermittlungsprotokolle
Weitere Informationen findest du unter Informationen zum Überwachungsprotokoll für dein Unternehmen.
Support-Bundles enthalten Protokolle der letzten zwei Tage. Um Protokolle der letzten sieben Tage abzurufen, kannst du ein erweitertes Support-Bundle herunterladen. Weitere Informationen findest du unter Erstellen und Freigeben erweiterter Supportbundles.
Tipp: Wenn du den GitHub Support kontaktierst, erhältst du eine Bestätigungs-E-Mail mit einem Ticket-Referenzlink. Wenn der GitHub Support dich bittet, ein Support-Bundle hochzuladen, kannst du dazu den Ticket-Referenzlink verwenden.
Support-Bundle über die Management Console erstellen
Mit diesen Schritten kannst du ein Support-Bundle erstellen und freigeben, wenn du auf die webbasierte Management Console zugreifen kannst und einen ausgehenden Internetzugang hast.
-
Klicke in einem Verwaltungskonto auf GitHub Enterprise Server, und klicke in der oberen rechten Ecke einer beliebigen Seite auf .
-
Wenn du dich nicht bereits auf der Seite „Websiteadministrator“ befindest, klicke in der oberen linken Ecke auf Websiteadministrator.
1. Klicke auf der linken Seitenleiste auf Management Console .
1. Wenn du dazu aufgefordert wirst, gib dein Management Console-Kennwort ein.
4. Klicke im oberen rechten Bereich der Management Console auf Support.
-
Klicke auf Supportbundle herunterladen.
-
Wenn dir ein Supporttechniker einen Uploadlink für dein Supportpaket mitgeteilt hat, verwende diesen Link. Andernfalls besuche https://support.github.com/, und melde dich (auf Aufforderung) bei einem Unternehmenskonto mit Supportanspruch an. 1. Besuche https://support.github.com/uploads, und lade dein Supportbundle hoch.
Support-Bundle mithilfe von SSH erstellen
Mit diesen Schritten kannst du ein Supportbundle erstellen und freigeben, wenn du SSH-Zugriff auf your GitHub Enterprise Server instance und ausgehenden Internetzugang hast.
Hinweis: Wenn du eine Georeplikationskonfiguration oder GitHub Enterprise-Clustering verwendest, solltest du den Befehl ghe-cluster-support-bundle
verwenden, um das Supportpaket abzurufen. Weitere Informationen findest du unter Befehlszeilenprogramme.
- Lade das Support-Bundle über SSH herunter:
Weitere Informationen zum$ ssh -p 122 admin@HOSTNAME -- 'ghe-support-bundle -o' > support-bundle.tgz
ghe-support-bundle
-Befehl findest du unter Befehlszeilenprogramme. - Wenn dir ein Supporttechniker einen Uploadlink für dein Supportpaket mitgeteilt hat, verwende diesen Link. Andernfalls besuche https://support.github.com/, und melde dich (auf Aufforderung) bei einem Unternehmenskonto mit Supportanspruch an. 1. Besuche https://support.github.com/uploads, und lade dein Supportbundle hoch.
Ein Support-Paket wird mit deinem Unternehmenskonto hochladen
-
Navigiere zu GitHub.com.
-
Klicke in der oberen rechten Ecke von GitHub.com auf dein Profilfoto und dann auf Deine Unternehmen.
-
Klicke in der Liste der Unternehmen auf das Unternehmen, das du anzeigen möchtest.
1. Klicke in der Randleiste des Unternehmenskontos auf Einstellungen.
-
Klicke auf der linken Seitenleiste auf Enterprise-Lizenzierung.
-
Klicke unter GitHub Enterprise-Hilfe auf Supportbundle hochladen.
-
Wähle unter „Select an enterprise account“ (Unternehmenskonto auswählen) das zugehörige Konto des Support-Pakets aus dem Dropdown-Menü aus.
-
Klicke unter „Hochladen eines Supportbundles für GitHub Enterprise Support“ auf Datei auswählen, um dein Supportbundle auszuwählen, oder ziehe alternativ deine Supportbundledatei auf Datei auswählen.
-
Klicken Sie auf Hochladen.
Support-Bundle mithilfe von SSH direkt hochladen
Unter folgenden Voraussetzungen kannst du ein Support-Bundle direkt auf unseren Server hochladen:
- Du hast SSH-Zugriff auf your GitHub Enterprise Server instance.
- Ausgehende HTTPS-Verbindungen über TCP-Port 443 sind von your GitHub Enterprise Server instance zu enterprise-bundles.github.com und esbtoolsproduction.blob.core.windows.net zugelassen.
- Lade das Bundle auf unseren Support-Bundle-Server hoch:
$ ssh -p122 admin@HOSTNAME -- 'ghe-support-bundle -u'
Erweiterte Support-Bundles erstellen und freigeben
Supportbundles beinhalten Protokolle der letzten zwei Tage, wohingegen erweiterte Supportbundles Protokolle der letzten sieben Tage beinhalten. Wenn die vom GitHub Support untersuchten Ereignisse vor mehr als zwei Tagen aufgetreten sind, bitten wir dich möglicherweise, ein erweitertes Support-Bundle bereitzustellen. Du benötigst SSH-Zugriff, um ein erweitertes Bundle herunterzuladen. Du kannst ein erweitertes Bundle nicht über die Management Console herunterladen.
Damit die Pakete nicht zu groß werden, enthalten sie nur Protokolle, die nicht rotiert und komprimiert wurden. Die Protokollrotation unter GitHub Enterprise Server erfolgt in verschiedenen Intervallen (täglich oder wöchentlich) für verschiedene Protokolldateien, je nachdem, wie groß die Protokolle schätzungsweise sein werden.
Erweitertes Support-Bundle mithilfe von SSH erstellen
Mit diesen Schritten kannst du ein erweitertes Supportbundle erstellen und freigeben, wenn du SSH-Zugriff auf your GitHub Enterprise Server instance und ausgehenden Internetzugang hast.
- Lade das erweiterte Supportbundle über SSH herunter, indem du dem
ghe-support-bundle
-Befehl das Flag-x
hinzufügst:$ ssh -p 122 admin@HOSTNAME -- 'ghe-support-bundle -o -x' > support-bundle.tgz
- Wenn dir ein Supporttechniker einen Uploadlink für dein Supportpaket mitgeteilt hat, verwende diesen Link. Andernfalls besuche https://support.github.com/, und melde dich (auf Aufforderung) bei einem Unternehmenskonto mit Supportanspruch an. 1. Besuche https://support.github.com/uploads, und lade dein Supportbundle hoch.
Erweitertes Support-Bundle mithilfe von SSH direkt hochladen
Unter folgenden Voraussetzungen kannst du ein Support-Bundle direkt auf unseren Server hochladen:
- Du hast SSH-Zugriff auf your GitHub Enterprise Server instance.
- Ausgehende HTTPS-Verbindungen über TCP-Port 443 sind von your GitHub Enterprise Server instance zu enterprise-bundles.github.com und esbtoolsproduction.blob.core.windows.net zugelassen.
- Lade das Bundle auf unseren Support-Bundle-Server hoch:
$ ssh -p122 admin@HOSTNAME -- 'ghe-support-bundle -u -x'