collectd konfigurieren

In diesem Artikel

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

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 deine GitHub Enterprise Server-Instanz 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 du GitHub Enterprise Support kontaktierst, wirst du zur Fehlerbehebung ggf. gebeten, diese Daten anzugeben.

Verwendung

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 deine GitHub Enterprise Server-Instanz gesendet werden.

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