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.
Externen collectd-Server einrichten
Falls Sie noch keinen externen collectd-Server eingerichtet haben, müssen Sie dies erledigen, bevor Sie die collectd-Weiterleitung auf Ihre GitHub Enterprise Server-Instanz aktivieren. Ihr collectd-Server muss collectd Version 5.x oder höher ausführen.
- Melden Sie sich bei Ihrem
collectd-Server an. - 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:
-
In the upper-right corner of any page, click .
-
In the left sidebar, click Managementkonsole.
-
Wählen Sie unterhalb der Einstellungen für die Protokollweiterleitung Enable collectd forwarding (collectd-Weiterleitung aktivieren) aus.
-
Geben Sie im Feld Server address (Serveradresse) die Adresse des
collectd-Servers ein, an den die Statistiken der GitHub Enterprise-Appliance weitergeleitet werden sollen. -
Geben Sie im Feld Port den Port ein, der verwendet wurde, um eine Verbindung zum
collectd-Server herzustellen. (Der Standardwert ist 25826) -
Wählen Sie im Dropdownmenü Cryptographic setup (Kryptografische Einrichtung) die Sicherheitsebene für die Kommunikationen mit dem
collectd-Server aus. (Ohne, signierte Pakete oder verschlüsselte Pakete.) -
Under the left sidebar, click Save settings.
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 enthält standardmäßig collectd Version 5.x. collectd 5.x ist nicht abwärtskompatibel mit der Reihe der Version 4.x. Ihr zentraler collectd-Server muss mindestens Version 5.x aufweisen, um von Ihre GitHub Enterprise Server-Instanz gesendete Daten zu akzeptieren.
Unterstützung zu weiteren Fragen oder Issues erhalten Sie vom [GitHub Enterprise-Support](https://enterprise.github.com/support) oder [GitHub Premium-Support](https://premium.githubsupport.com).