collectd konfigurieren

Inhalt dieses Artikels

• Externen collectd-Server einrichten
• collectd-Weiterleitung auf GitHub Enterprise aktivieren
• collectd-Daten mit ghe-export-graphs exportieren
• Problemlösungen

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.

1. Melden Sie sich bei Ihrem collectd-Server an.
2. 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:

1. Klicken Sie in der oberen rechten Ecke einer beliebigen Seite auf .

   

2. Klicken Sie auf der linken Seitenleiste auf Managementkonsole.

   

3. Wählen Sie unterhalb der Einstellungen für die Protokollweiterleitung Enable collectd forwarding (collectd-Weiterleitung aktivieren) aus.

4. Geben Sie im Feld Server address (Serveradresse) die Adresse des collectd-Servers ein, an den die Statistiken der GitHub Enterprise-Appliance weitergeleitet werden sollen.

5. Geben Sie im Feld Port den Port ein, der verwendet wurde, um eine Verbindung zum collectd-Server herzustellen. (Der Standardwert ist 25826)

6. 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.)

7. Klicken Sie 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 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.

For help with further questions or issues, contact GitHub Enterprise-Support oder GitHub Premium-Support.