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. 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:
- From an administrative account on GitHub Enterprise Server, click in the upper-right corner of any page.
- 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).
- 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.