Artikelversion: Enterprise Server 2.17
Daten für den GitHub-Support bereitstellen
Da der GitHub-Support keinen Zugriff auf Ihre Umgebung hat, benötigen wir einige zusätzliche Informationen von Ihnen.
Diagnosedateien erstellen und freigeben
Die Diagnose ist eine Übersicht über die Einstellungen und die Umgebung einer GitHub Enterprise Server-Instanz. Sie enthält Folgendes:
- Client license information, including company name, expiration date, and number of user licenses
- Versionsnummern und SHAs
- VM-Architektur
- Hostname, Privatmodus, SSL-Einstellungen
- Lade- und Prozessauflistungen
- Netzwerkeinstellungen
- Authentifizierungsmethode und -details
- Anzahl der Repositorys, Benutzer und andere Installationsdaten
Sie können die Diagnose für Ihre Instanz über die Managementkonsole oder durch Ausführen des Befehlszeilenprogramms ghe-diagnostics
herunterladen.
Diagnosedatei über die Managementkonsole erstellen
Sie können diese Methode verwenden, wenn Sie Ihren SSH-Schlüssel nicht zur Hand haben.
- Klicke in der oberen rechten Ecke einer beliebigen Seite auf .
- Klicke auf der linken Seitenleiste auf Managementkonsole.
- Wenn Du dazu aufgefordert wirst, gib Dein Managementkonsole-Passwort ein.
- Klicke im oberen rechten Bereich der Managementkonsole auf Support.
- Klicken Sie auf Download diagnostics info (Diagnoseinformationen herunterladen).
Diagnosedatei mithilfe von SSH erstellen
Sie können diese Methode verwenden, ohne sich bei der Managementkonsole anzumelden.
Verwenden Sie das Befehlszeilenprogramm ghe-diagnostics, um die Diagnose für Ihre Instanz abzurufen.
$ ssh -p122 admin@hostname -- 'ghe-diagnostics' > diagnostics.txt
Support-Bundles erstellen und freigeben
Nachdem Sie Ihre Supportanfrage eingereicht haben, bitten wir Sie unter Umständen, unserem Team ein Support-Bundle bereitzustellen. Das Support-Bundle ist ein gzip-komprimiertes Tar-Archiv, das Diagnosen und wichtige Protokolle Ihrer Instanz enthält, beispielsweise
- authentifizierungsbezogene Protokolle, die bei der Behebung von Authentifizierungsfehlern oder der Konfiguration von LDAP, CAS oder SAML hilfreich sein können,
- Managementkonsole-Protokoll,
github-logs/exceptions.log
: Informationen über 500 Fehler, die auf der Website aufgetreten sind,github-logs/audit.log
: GitHub Enterprise Server-Auditprotokolle,babeld-logs/babeld.log
: Git-Proxy-Protokolle,system-logs/haproxy.log
: HAProxy-Protokolle,elasticsearch-logs/github-enterprise.log
: ElasticSearch-Protokolle,configuration-logs/ghe-config.log
: GitHub Enterprise Server-Konfigurationsprotokolle,collectd/logs/collectd.log
: Collectd-Protokolle,mail-logs/mail.log
: SMTP-E-Mail-Zustellprotokolle,hookshot-logs/exceptions.log
: Webhook-Auslieferungsfehler.
Weitere Informationen finden Sie unter „Auditprotokollierung“.
Support-Bundles enthalten Protokolle der letzten zwei Tage. Um Protokolle der letzten sieben Tage abzurufen, können Sie ein erweitertes Support-Bundle herunterladen. Weitere Informationen finden Sie unter „Erweiterte Support-Bundles erstellen und freigeben“.
Tipp: Wenn Sie den GitHub-Support kontaktieren, erhalten Sie eine Bestätigungs-E-Mail mit einem Ticket-Referenzlink. Wenn der GitHub-Support Sie bittet, ein Support-Bundle hochzuladen, können Sie dazu den Ticket-Referenzlink verwenden.
Support-Bundle über die Managementkonsole erstellen
Mit diesen Schritten können Sie ein Support-Bundle erstellen und freigeben, wenn Sie auf die webbasierte Managementkonsole zugreifen können und einen ausgehenden Internetzugang haben.
- Klicke in der oberen rechten Ecke einer beliebigen Seite auf .
- Klicke auf der linken Seitenleiste auf Managementkonsole.
- Wenn Du dazu aufgefordert wirst, gib Dein Managementkonsole-Passwort ein.
- Klicke im oberen rechten Bereich der Managementkonsole auf Support.
- Klicken Sie auf Download support bundle (Support-Bundle herunterladen).
- Besuche „https://enterprise.github.com/support“, und melde Dich an (falls Sie dazu aufgefordert werden).
- Besuche „https://enterprise.github.com/support/bundles/new“, und lade Dein Support-Bundle hoch.
Support-Bundle mithilfe von SSH erstellen
Mit diesen Schritten können Sie ein Support-Bundle erstellen und freigeben, wenn Sie SSH-Zugriff auf Ihre GitHub Enterprise Server-Appliance und ausgehenden Internetzugang haben.
Hinweis: Wenn Du eine Geo-Replikationskonfiguration oder GitHub Enterprise Clustering verwendest, solltest Du das Support-Bundle mit dem Befehl ghe-cluster-support-bundle
abrufen. Weitere Informationen findest Du unter „Befehlszeilendienstprogramme“.
- Laden Sie das Support-Bundle über SSH herunter:
Weitere Informationen zum Befehl$ ssh -p 122 admin@hostname -- 'ghe-support-bundle -o' > support-bundle.tgz
ghe-support-bundle
finden Sie unter „Befehlszeilenprogramme“. - Besuche „https://enterprise.github.com/support“, und melde Dich an (falls Sie dazu aufgefordert werden).
- Besuche „https://enterprise.github.com/support/bundles/new“, und lade Dein Support-Bundle hoch.
Support-Bundle mithilfe von SSH direkt hochladen
Unter folgenden Voraussetzungen können Sie ein Support-Bundle direkt auf unseren Server hochladen:
- Sie haben SSH-Zugriff auf Ihre GitHub Enterprise Server-Appliance.
- Ausgehende HTTPS-Verbindungen über TCP-Port 443 sind von Ihrer GitHub Enterprise Server-Appliance aus möglich.
- Laden Sie das Bundle auf unseren Support-Bundle-Server hoch:
$ ssh -p122 admin@hostname -- 'ghe-support-bundle -u'
Erweiterte Support-Bundles erstellen und freigeben
Support-Bundles beinhalten Protokolle der letzten zwei Tage, wohingegen erweiterte Support-Bundles Protokolle der letzten sieben Tage beinhalten. Wenn die vom GitHub-Support untersuchten Ereignisse vor mehr als zwei Tagen aufgetreten sind, bitten wir Sie möglicherweise, ein erweitertes Support-Bundle bereitzustellen. Sie benötigen SSH-Zugriff, um ein erweitertes Bundle herunterzuladen. Sie können ein erweitertes Bundle nicht über die Managementkonsole 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 können Sie ein erweitertes Support-Bundle erstellen und freigeben, wenn Sie SSH-Zugriff auf Ihre GitHub Enterprise Server-Appliance und ausgehenden Internetzugang haben.
- Laden Sie das erweiterte Support-Bundle über SSH herunter, indem Sie den Flag
-x
zum Befehlghe-support-bundle
hinzufügen:$ ssh -p 122 admin@hostname -- 'ghe-support-bundle -o -x' > support-bundle.tgz
- Besuche „https://enterprise.github.com/support“, und melde Dich an (falls Sie dazu aufgefordert werden).
- Besuche „https://enterprise.github.com/support/bundles/new“, und lade Dein Support-Bundle hoch.
Erweitertes Support-Bundle mithilfe von SSH direkt hochladen
Unter folgenden Voraussetzungen können Sie ein Support-Bundle direkt auf unseren Server hochladen:
- Sie haben SSH-Zugriff auf Ihre GitHub Enterprise Server-Appliance.
- Ausgehende HTTPS-Verbindungen über TCP-Port 443 sind von Ihrer GitHub Enterprise Server-Appliance aus möglich.
- Laden Sie das Bundle auf unseren Support-Bundle-Server hoch:
$ ssh -p122 admin@hostname -- 'ghe-support-bundle -u -x'