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.
In diesem Artikel:
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-Lizenzinformationen, einschließlich Firmenname, Ablaufdatum und Anzahl der Benutzer
- 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.
-
In the upper-right corner of any page, click .
-
In the left sidebar, click Managementkonsole.
-
If prompted, type your Managementkonsole password.
-
In the upper right of the Managementkonsole, click 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.
-
In the upper-right corner of any page, click .
-
In the left sidebar, click Managementkonsole.
-
If prompted, type your Managementkonsole password.
-
In the upper right of the Managementkonsole, click Support.
-
Klicken Sie auf Download support bundle (Support-Bundle herunterladen).
-
Besuchen Sie „https://enterprise.github.com/support“, und melden Sie sich an (falls Sie dazu aufgefordert werden).
-
Besuchen Sie „https://enterprise.github.com/support/bundles/new“, und laden Sie Ihr 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.
Note: If you are using a Geo-replication configuration, or GitHub Enterprise Clustering, you should use the ghe-cluster-support-bundle
command to retrieve the support bundle. For more information, see "Command-line utilities."
-
Laden Sie das Support-Bundle über SSH herunter:
$ ssh -p 122 admin@hostname -- 'ghe-support-bundle' -o > support-bundle.tgz
For more information about the
ghe-support-bundle
command, see "Command-line utilities". -
Besuchen Sie „https://enterprise.github.com/support“, und melden Sie sich an (falls Sie dazu aufgefordert werden).
-
Besuchen Sie „https://enterprise.github.com/support/bundles/new“, und laden Sie Ihr 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
-
Besuchen Sie „https://enterprise.github.com/support“, und melden Sie sich an (falls Sie dazu aufgefordert werden).
-
Besuchen Sie „https://enterprise.github.com/support/bundles/new“, und laden Sie Ihr 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.
- Managementkonsole-Protokoll.
-
Laden Sie das Bundle auf unseren Support-Bundle-Server hoch:
$ ssh -p122 admin@hostname -- 'ghe-support-bundle -u -x'