Daten für den GitHub-Support bereitstellen

Inhalt dieses Artikels

• Diagnosedateien erstellen und freigeben
• Support-Bundles erstellen und freigeben
• Erweiterte Support-Bundles erstellen und freigeben
• Weiterführende Informationen

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.

1. Klicken Sie in der oberen rechten Ecke einer beliebigen Seite auf .

   

2. Klicken Sie auf der linken Seitenleiste auf Managementkonsole.

   

3. Wenn Sie dazu aufgefordert werden, geben Sie Ihr Managementkonsole-Passwort ein.

   

4. Klicken Sie im oberen rechten Bereich der Managementkonsole auf Support.

   

5. 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“.

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.

1. Klicken Sie in der oberen rechten Ecke einer beliebigen Seite auf .

   

2. Klicken Sie auf der linken Seitenleiste auf Managementkonsole.

   

3. Wenn Sie dazu aufgefordert werden, geben Sie Ihr Managementkonsole-Passwort ein.

   

4. Klicken Sie im oberen rechten Bereich der Managementkonsole auf Support.

   

5. Klicken Sie auf Download support bundle (Support-Bundle herunterladen).

6. Besuchen Sie „https://enterprise.github.com/support“, und melden Sie sich an (falls Sie dazu aufgefordert werden).

7. 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.

1. Laden Sie das Support-Bundle über SSH herunter:

   $ ssh -p 122 admin@hostname -- 'ghe-support-bundle -o' > support-bundle.tgz

   Weitere Informationen zum Befehl ghe-support-bundle finden Sie unter „Befehlszeilenprogramme“.

2. Besuchen Sie „https://enterprise.github.com/support“, und melden Sie sich an (falls Sie dazu aufgefordert werden).

3. 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.

1. 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.

1. Laden Sie das erweiterte Support-Bundle über SSH herunter, indem Sie den Flag -x zum Befehl ghe-support-bundle hinzufügen:

   $ ssh -p 122 admin@hostname -- 'ghe-support-bundle -o -x' > support-bundle.tgz

2. Besuchen Sie „https://enterprise.github.com/support“, und melden Sie sich an (falls Sie dazu aufgefordert werden).

3. 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.
• Ausgehende HTTPS-Verbindungen über TCP-Port 443 sind von Ihrer GitHub Enterprise Server-Appliance aus möglich.

1. Laden Sie das Bundle auf unseren Support-Bundle-Server hoch:

   $ ssh -p122 admin@hostname -- 'ghe-support-bundle -u -x'

Weiterführende Informationen

• „Informationen zum GitHub Enterprise-Support“
• „Informationen zum GitHub Premium-Support für GitHub Enterprise Server“