collectd für Ihre Instanzen konfigurieren

Um Einblicke in die Leistung von GitHub Enterprise Server zu erhalten, können Sie Daten aus collectd Ihrer Instanz überprüfen oder optional die Daten an einen externen collectd-Server senden.

In diesem Artikel

Informationen zu collectd für GitHub Enterprise Server

collectd ist ein Dienst, der auf Ihre GitHub Enterprise Server-Instance ausgeführt wird, um Werte zur Leistung des Systems zu sammeln und bereitzustellen. Zu den üblichen Werten, die von collectd gesammelt werden, gehören CPU-Auslastung, Speicher- und Festplattenverbrauch, Netzwerkschnittstellenverkehr und -fehler sowie die Gesamtlast eines Systems. Sie können die Daten auch an einen anderen collectd-Server weiterleiten. Weitere Informationen finden Sie im collectd-Wiki.

Ihre Instanz verwendet Werte zum Anzeigen von collectd-Diagrammen im Monitordashboard von Verwaltungskonsole. Weitere Informationen findest du unter Auf das Überwachungs-Dashboard zugreifen.

Sie können eine Liste der Werte überprüfen, die collectd auf Ihre GitHub Enterprise Server-Instance sammelt. Weitere Informationen findest du unter gesammelte Metriken für GitHub Enterprise Server.

Einen externen collectd-Server einrichten

Wenn du noch keinen externen collectd-Server eingerichtet hast, musst du dies tun, bevor du die collectd-Weiterleitung für Ihre GitHub Enterprise Server-Instance aktivierst. Dein collectd-Server muss collectd Version 5.x oder höher ausführen.

  1. Melde dich bei deinem collectd-Server an.
  2. Erstelle oder bearbeite die collectd-Konfigurationsdatei so, dass das Netzwerk-Plug-In geladen und die Server- und Portanweisungen mit den entsprechenden Werten aufgefüllt werden. In den meisten Distributionen befindet sich dies in /etc/collectd/collectd.conf.

Ein Beispiel für collectd.conf zur Ausführung eines collectd-Servers:

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

collectd-Weiterleitung auf GitHub Enterprise aktivieren

Standardmäßig ist die collectd-Weiterleitung für GitHub Enterprise deaktiviert. Führe die folgenden Schritte aus, um die collectd-Weiterleitung zu aktivieren und zu konfigurieren:

  1. Klicke in einem Verwaltungskonto auf GitHub Enterprise Server und dann in der rechten oberen Ecke einer beliebigen Seite auf „“.

  2. Wenn du dich nicht bereits auf der Seite „Websiteadministrator“ befindest, klicke in der oberen linken Ecke auf Websiteadministrator.

  3. Wähle auf der Randleiste „ Websiteadministrator“ die Option Verwaltungskonsole aus.

  4. Wähle unterhalb der Protokollweiterleitungseinstellungen die Option collectd-Weiterleitung aktivieren aus.

  5. Gib im Feld Serveradresse die Adresse des collectd-Servers ein, an den du Statistiken der GitHub Enterprise-Appliance weiterleiten möchtest.

  6. Gib im Feld Port den Port ein, der zum Herstellen einer Verbindung mit dem collectd-Server verwendet wird. (Der Standardwert ist 25826)

  7. Wähle im Dropdownmenü Kryptografieeinrichtung die Sicherheitsstufe der Kommunikation mit dem collectd-Server aus. (Ohne, signierte Pakete oder verschlüsselte Pakete.) 1. Klicke auf der Randleiste unter „Einstellungen“ auf Einstellungen speichern.

    Hinweis: Durch das Speichern von Einstellungen in der Verwaltungskonsole werden Systemdienste neu gestartet, was zu einer für den Benutzer feststellbaren Downtime führen könnte.

  8. Warten Sie auf den Abschluss der Konfigurationsausführung.

Exportieren von collectd-Daten mit ghe-export-graphs

Das Befehlszeilentool ghe-export-graphs exportiert die Daten, die collectd in RRD-Datenbanken speichert. Dieser Befehl wandelt die Daten in das XML-Format um und exportiert sie in eine einzelne Tarball-Datei (.tgz).

Sein Hauptzweck besteht darin, dem GitHub Enterprise 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 deine regulären Sicherungsexporte aufgenommen werden und bietet kein Gegenstück zum Import. Wenn Sie uns über GitHub Enterprise Support kontaktieren, werden Sie zur Fehlerbehebung ggf. gebeten, diese Daten anzugeben.

Verbrauch

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

Problembehandlung

Der zentrale collectd-Server empfängt keine Daten.

GitHub Enterprise wird mit collectd Version 5.x ausgeliefert. collectd 5.x ist nicht abwärtskompatibel mit der 4.x-Versionsreihe. Dein zentraler collectd-Server muss mindestens Version 5.x aufweisen, um Daten akzeptieren zu können, die von Ihre GitHub Enterprise Server-Instance gesendet werden.

Unterstützung zu weiteren Fragen oder Problemen erhalten Sie unter GitHub Enterprise Support.