Hallo, Entdecker! An dieser Seite wird aktiv gearbeitet, oder sie wird noch übersetzt. Die neuesten und genauesten Informationen findest Du in unserer englischsprachigen Dokumentation.

Diese Version von GitHub Enterprise wurde eingestellt am 2021-03-02. Es wird keine Patch-Freigabe vorgenommen, auch nicht für kritische Sicherheitsprobleme. Für eine bessere Leistung, verbesserte Sicherheit und neue Features nimm ein Upgrade auf die neueste Version von GitHub Enterprise vor. Wende Dich an den GitHub Enterprise-Support, um Hilfe beim Upgrade zu erhalten.

collectd konfigurieren

GitHub Enterprise kann Daten mit „collectd“ erfassen und an einen externen „collectd“-Server senden. Neben anderen Kennzahlen erfassen wir einen Standarddatensatz wie CPU-Auslastung, Arbeitsspeicher- und Festplattennutzung, Traffic und Fehler der Netzwerkschnittstelle sowie die Gesamtauslastung der VM.

Inhalt dieses Artikels

Externen collectd-Server einrichten

Falls Sie noch keinen externen collectd-Server eingerichtet haben, müssen Sie dies erledigen, bevor Sie die collectd-Weiterleitung auf your GitHub Enterprise Server instance aktivieren. Your collectd server must be running collectd version 5.x or higher.

  1. Melden Sie sich bei Ihrem collectd-Server an.
  2. Erstellen Sie die collectd-Konfigurationsdatei, oder bearbeiten Sie sie so, dass das Netzwerk-Plug-in geladen und in die Server- und Portdirektiven die entsprechenden Werte eingetragen werden. Auf den meisten Distributionen befindet sie sich unter /etc/collectd/collectd.conf.

collectd.conf-Beispieldatei zum Ausführen eines collectd-Servers:

LoadPlugin network
...
...
<Plugin network>
    Listen "0.0.0.0" "25826"
</Plugin>

collectd-Weiterleitung auf GitHub Enterprise aktivieren

Die collectd-Weiterleitung ist auf GitHub Enterprise standardmäßig deaktiviert. Befolgen Sie die Schritte zum Aktivieren und Konfigurieren der collectd-Weiterleitung:

  1. From an administrative account on GitHub Enterprise Server, click in the upper-right corner of any page.
    Raumschiffsymbol für den Zugriff auf die Einstellungen des Websiteadministrators
  2. Klicke auf der linken Seitenleiste auf Managementkonsole.
    Registerkarte „Managementkonsole" in der linken Seitenleiste
  3. Wählen Sie unterhalb der Einstellungen für die Protokollweiterleitung Enable collectd forwarding (collectd-Weiterleitung aktivieren) aus.
  4. Geben Sie im Feld Server address (Serveradresse) die Adresse des collectd-Servers ein, an den die Statistiken der GitHub Enterprise-Appliance weitergeleitet werden sollen.
  5. Geben Sie im Feld Port den Port ein, der verwendet wurde, um eine Verbindung zum collectd-Server herzustellen. (Der Standardwert ist 25826)
  6. Wählen Sie im Dropdownmenü Cryptographic setup (Kryptografische Einrichtung) die Sicherheitsebene für die Kommunikationen mit dem collectd-Server aus. (None, signed packets, or encrypted packets.)
  7. Klicke auf der linken Seitenleiste auf Save settings (Einstellungen speichern).
    Die Schaltfläche „Save settings“ (Einstellungen speichern) in der Managementkonsole
  8. Warten Sie auf den Abschluss der Konfigurationsausführung.

collectd-Daten mit ghe-export-graphs exportieren

Das Befehlszeilentool ghe-export-graphs exportiert die Daten, die von collectd in RRD-Datenbanken gespeichert werden. Dieser Befehl wandelt die Daten in das XML-Format um und exportiert sie in einer einzelnen Tarball-Datei (.tgz).

Sein Hauptzweck besteht darin, dem GitHub Enterprise-Support oder GitHub Premium-Support-Team Daten über die Leistung einer VM zur Verfügung zu stellen, ohne dass ein vollständiges Support-Bundle heruntergeladen werden muss. Er sollte nicht in Ihre regulären Backup-Exporte aufgenommen werden und bietet kein Gegenstück zum Import. Wenn Sie GitHub Enterprise-Support oder GitHub Premium-Support kontaktieren, werden Sie zur Fehlerbehebung ggf. gebeten, diese Daten anzugeben.

Beispiel

ssh -p 122 admin@[hostname] -- 'ghe-export-graphs' && scp -P 122 admin@[hostname]:~/graphs.tar.gz .

Problemlösungen

Der zentrale collectd-Server empfängt keine Daten.

GitHub Enterprise ships with collectd version 5.x. collectd 5.x is not backwards compatible with the 4.x release series. Ihr zentraler collectd-Server muss mindestens Version 5.x aufweisen, um von your GitHub Enterprise Server instance gesendete Daten zu akzeptieren.

Unterstützung zu weiteren Fragen oder Problemen erhältst Du vom GitHub Enterprise-Support oder GitHub Premium-Support.