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:
- Klicke in der oberen rechten Ecke einer beliebigen Seite auf .
- Klicke auf der linken Seitenleiste auf 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. (None, signed packets, or encrypted packets.) - Klicke auf der linken Seitenleiste auf Save settings (Einstellungen speichern).
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 Ihre GitHub Enterprise Server-Instanz gesendete Daten zu akzeptieren.
Unterstützung zu weiteren Fragen oder Problemen erhältst Du vom GitHub Enterprise-Support oder GitHub Premium-Support.