Bereitstellen von Daten für GitHub Support

Informationen zu Diagnosedateien und Supportbundles

Um Ihnen bei der Behebung von Problemen mit einer GitHub Enterprise Server-Instanz in Ihrer Umgebung zu helfen, kann GitHub-Support einen oder mehrere Datentypen anfordern.

Daten	Dateiformat	BESCHREIBUNG
Diagnosedokument	Klartext	Diese Datei enthält Informationen zu den Einstellungen und der Umgebung der Instanz.
Supportbundle	Archivieren	Dieses Bundle enthält eine Diagnosedatei und standardmäßig bereinigte Protokolldateien der letzten beiden Tage.
Erweitertes Support-Bundle	Archivieren	Dieses Paket enthält eine Diagnosedatei und bereinigte Protokolldateien der letzten acht Tage.

Informationen zur Protokolldateibereinigung

Authentifizierungstoken, Schlüssel und Geheimnisse werden aus Protokolldateien in den folgenden Protokollverzeichnissen entfernt, die in einem Support-Bundle oder einer 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 sind eine Übersicht über die Einstellungen und die Umgebung einer GitHub Enterprise Server Instanz, die Folgendes enthalten:

Kundenlizenz-Informationen, einschließlich Firmenname, Ablaufdatum und Anzahl der Benutzerlizenzen
Versionsnummern und SHAs
VM-Architektur
Hostname, Privatmodus, SSL-Einstellungen
Laden und Verarbeiten von Listen
Netzwerkeinstellungen
Authentifizierungsmethode und -details
Anzahl der Repositorys, Benutzer und andere Installationsdaten

Sie können die Diagnose für Ihre Instanz herunterladen, entweder aus dem Verwaltungskonsole oder indem Sie das Befehlszeilenprogramm ghe-diagnostics ausführen.

Erstellen einer Diagnosedatei aus dem Verwaltungskonsole

Sie können eine Diagnosedatei aus dem Verwaltungskonsole erstellen, wenn Sie zurzeit keinen SSH-Zugriff haben.

Klicke in einem Verwaltungskonto für GitHub Enterprise Server in der rechten oberen Ecke einer beliebigen Seite auf .
Wenn du dich nicht bereits auf der Seite „Websiteadministrator“ befindest, klicke in der oberen linken Ecke auf Websiteadministrator.
Klicke in der Randleiste „ Site admin“ auf Verwaltungskonsole.
Wenn du mehrere Verwaltungskonsole-Benutzerkonten erstellt hast, wähle Websitedministrator mit Root-Berechtigungen oder Verwaltungskonsole-Benutzer aus. Weitere Informationen zu Verwaltungskonsole-Benutzerkonten findest du unter Verwalten des Zugriffs auf die Verwaltungskonsole.
Gib deine Anmeldeinformationen für die Verwaltungskonsole ein. Klicke anschließend auf Weiter.
Klicke auf der oberen Navigationsleiste auf Support.
Klicke auf Diagnoseinformationen herunterladen.

Eine Diagnosedatei mithilfe von SSH erstellen

Sie können diese Methode verwenden, ohne sich bei Verwaltungskonsole anzumelden.

Verwende das Befehlszeilenprogramm ghe-diagnostics, um die Diagnose für deine Instanz abzurufen.

ssh -p122 admin@HOSTNAME -- 'ghe-diagnostics' > diagnostics.txt

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,
```
        Verwaltungskonsole Protokoll
```

        `github-logs/exceptions.log`: Informationen zu 500 Fehlern auf der Website

        `github-logs/audit.log`: GitHub Enterprise Server Überwachungsprotokolle

        `babeld-logs/babeld.log`: Git-Proxyprotokolle

        `system-logs/haproxy.log`: HAProxy-Protokolle

        `elasticsearch-logs/github-enterprise.log`: Elasticsearch-Protokolle

        `configuration-logs/`: GitHub Enterprise Server Konfigurationsprotokolle

        `collectd/logs/collectd.log`: Collectd-Protokolle

        `mail-logs/mail.log`: SMTP-E-Mail-Übermittlungsprotokolle

Weitere Informationen finden Sie unter Überwachungsprotokoll für ein Unternehmen.

Supportbundle enthalten standardmäßig Protokolle der letzten beiden Tage. Du kannst eine genaue Dauer in Tagen angeben. Um Protokolle der letzten acht Tage bereitzustellen, kannst du ein erweitertes Supportbundle herunterladen. Weitere Informationen findest du unter Erstellen und Freigeben erweiterter Supportbundles.

Tipp

Wenn Sie Kontakt aufnehmen GitHub-Support, erhalten Sie eine Bestätigungs-E-Mail, die einen Ticketverweislink enthält. Wenn GitHub-Support Sie auffordert, ein Support-Bundle hochzuladen, können Sie den Ticketverweislink verwenden, um das Support-Bundle hochzuladen.

Erstellen eines Supportpakets aus dem Verwaltungskonsole

Sie können diese Schritte verwenden, um ein Supportpaket zu erstellen und freizugeben, wenn Sie auf das webbasierte Verwaltungskonsole und ausgehende Internet zugreifen können.

Klicke in einem Verwaltungskonto für GitHub Enterprise Server in der rechten oberen Ecke einer beliebigen Seite auf .
Wenn du dich nicht bereits auf der Seite „Websiteadministrator“ befindest, klicke in der oberen linken Ecke auf Websiteadministrator.
Klicke in der Randleiste „ Site admin“ auf Verwaltungskonsole.
Wenn du mehrere Verwaltungskonsole-Benutzerkonten erstellt hast, wähle Websitedministrator mit Root-Berechtigungen oder Verwaltungskonsole-Benutzer aus. Weitere Informationen zu Verwaltungskonsole-Benutzerkonten findest du unter Verwalten des Zugriffs auf die Verwaltungskonsole.
Gib deine Anmeldeinformationen für die Verwaltungskonsole ein. Klicke anschließend auf Weiter.
Klicke auf der oberen Navigationsleiste 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.
Besuche https://support.github.com/uploads, und lade dein Supportbundle hoch.

Support-Bundle mithilfe von SSH erstellen

Mit diesen Schritten können Sie ein Supportbundle erstellen und freigeben, wenn Sie SSH-Zugriff Ihre GitHub Enterprise Server-Instance haben und ausgehenden Internetzugriff haben.

Hinweis

Wenn für Ihre GitHub Enterprise Server-Instance eine Georeplikationskonfiguration verwendet wird oder deine Instanz ein Cluster ist, solltest du den Befehl ghe-cluster-support-bundle verwenden, um das Supportbundle abzurufen. Weitere Informationen finden Sie unter Befehlszeilenwerkzeuge.

Lade 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 findest du unter Befehlszeilenwerkzeuge.
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.
Besuche https://support.github.com/uploads, und lade dein Supportbundle hoch.

Ein Support-Paket wird mit Ihrem Unternehmenskonto hochgeladen.

Navigieren Sie zu GitHub Enterprise Cloud.
Klicke auf GitHub in der oberen rechten Ecke auf dein Profilbild.
Klicken Sie je nach Ihrer Umgebung auf "Enterprise", oder klicken Sie auf " Unternehmen ", und klicken Sie dann auf das Unternehmen, das Sie anzeigen möchten.
Klicke links auf der Seite auf der Randleiste des Enterprise-Kontos auf Settings.
Klicke unter Settings auf License.
Klicken Sie unter "GitHub Enterprise Hilfe" auf " Supportpaket hochladen".
Wähle unter „Unternehmenskonto auswählen“ im Dropdownmenü das zugehörige Konto für das Supportbundle aus.
Klicken Sie unter "Supportpaket hochladen für GitHub Enterprise-Support", um Ihr Supportpaket auszuwählen, entweder auf „Datei auswählen“ oder ziehen Sie die Supportpaketdatei 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:

Sie haben SSH-Zugriff auf Ihre GitHub Enterprise Server-Instance.
Ausgehende HTTPS-Verbindungen über TCP-Port 443 sind erlaubt von Ihre GitHub Enterprise Server-Instance zu enterprise-bundles.github.com und esbtoolsproduction.blob.core.windows.net.

Lade das Bundle auf unseren Support-Bundle-Server hoch:
```
ssh -p122 admin@HOSTNAME -- 'ghe-support-bundle -u'
```

Supportbundle enthalten standardmäßig Protokolle der letzten beiden Tage, während erweiterte Supportbundle Protokolle der letzten acht Tage enthalten. Wenn die Ereignisse, die GitHub-Support untersucht, vor mehr als zwei Tagen aufgetreten sind, bitten wir Sie möglicherweise, ein erweitertes Support-Bundle zu teilen. Sie benötigen SSH-Zugriff, um ein erweitertes Bundle herunterzuladen, da Sie dieses nicht aus dem Verwaltungskonsole herunterladen können.

Damit die Pakete nicht zu groß werden, enthalten sie nur Protokolle, die nicht rotiert und komprimiert wurden. Die Protokollrotation GitHub Enterprise Server erfolgt bei verschiedenen Häufigkeiten (täglich oder wöchentlich) für unterschiedliche Protokolldateien, je nachdem, wie groß die Protokolle sein werden.

Erweitertes Support-Bundle mithilfe von SSH erstellen

Mit diesen Schritten können Sie ein erweitertes Supportpaket erstellen und freigeben, wenn Sie SSH-Zugriff Ihre GitHub Enterprise Server-Instance haben und ausgehenden Internetzugriff haben.

Lade das erweiterte Supportbundle über SSH herunter, indem du dem -x-Befehl das Flag ghe-support-bundle 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.
Besuche https://support.github.com/uploads, und lade dein Supportbundle hoch.

Erweitertes Support-Bundle mithilfe von SSH direkt hochladen