Informationen zu Diagnosedateien und Supportbundles
Um Issues mit einer GitHub Enterprise Server-Instanz in deiner Umgebung zu beheben, fordert GitHub-Support möglicherweise einen oder mehrere Datentypen an.
Daten | Dateiformat | BESCHREIBUNG |
---|---|---|
Diagnosedatei | 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 Supportbundle | Archivieren | Dieses Bundle 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 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 bieten eine Übersicht über die Einstellungen und die Umgebung einer GitHub Enterprise Server-Instanz. Sie enthalten Folgendes:
- 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 Verwaltungskonsole oder durch Ausführen des Befehlszeilenprogramms ghe-diagnostics
herunterladen.
Diagnosedatei über die Verwaltungskonsole erstellen
Du kannst eine Diagnosedatei über die Verwaltungskonsole erstellen, wenn du derzeit über keinen SSH-Zugriff verfügst.
-
Klicke in einem Verwaltungskonto auf GitHub Enterprise Server und dann 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.
-
Wähle auf der Randleiste „ Websiteadministrator“ die Option Verwaltungskonsole aus.
-
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.
Diagnosedatei mithilfe von SSH erstellen
Du kannst diese Methode verwenden, ohne sich bei der Verwaltungskonsole 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,
- Verwaltungskonsole-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.
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 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 Verwaltungskonsole erstellen
Mit diesen Schritten kannst du ein Support-Bundle erstellen und freigeben, wenn du auf die webbasierte Verwaltungskonsole zugreifen kannst und einen ausgehenden Internetzugang hast.
-
Klicke in einem Verwaltungskonto auf GitHub Enterprise Server und dann 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.
-
Wähle auf der Randleiste „ Websiteadministrator“ die Option Verwaltungskonsole aus.
-
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 kannst du ein Supportbundle erstellen und freigeben, wenn du SSH-Zugriff auf Ihre GitHub Enterprise Server-Instance und ausgehenden Internetzugang hast.
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 findest du unter Befehlszeilenprogramme.
-
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 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.
-
Besuche https://support.github.com/uploads, und lade dein Supportbundle hoch.
Ein Support-Paket wird mit deinem Unternehmenskonto hochladen
-
Navigieren Sie zu GitHub Enterprise Cloud.
-
Klicken Sie in der oberen rechten Ecke von GitHub auf Ihr Profilfoto und dann auf Ihre Unternehmen.
-
Klicke in der Liste der Unternehmen auf das Unternehmen, das du anzeigen möchtest.
-
Klicken Sie auf der linken Seite der Seite in der Randleiste des Enterprise-Kontos auf Einstellungen.
-
Klicke unter Einstellungen auf Lizenz .
-
Klicke unter GitHub Enterprise-Hilfe auf Supportbundle hochladen.
-
Wähle unter „Unternehmenskonto auswählen“ im Dropdownmenü das zugehörige Konto für das Supportbundle 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.
-
Klicke 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 Ihre GitHub Enterprise Server-Instance.
- Ausgehende HTTPS-Verbindungen über TCP-Port 443 sind von Ihre 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
Supportbundle enthalten standardmäßig Protokolle der letzten beiden Tage, während erweiterte Supportbundle Protokolle der letzten acht Tage enthalten. 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 Verwaltungskonsole 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 Ihre 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.
-
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 Ihre GitHub Enterprise Server-Instance.
- Ausgehende HTTPS-Verbindungen über TCP-Port 443 sind von Ihre 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'