Set up an external collectd
server
If you haven't already set up an external collectd
server, you will need to do so before enabling collectd
forwarding on your GitHub Enterprise Server instance. Your collectd
server must be running collectd
version 5.x or higher.
- Log into your
collectd
server. - Create or edit the
collectd
configuration file to load the network plugin and populate the server and port directives with the proper values. On most distributions, this is located at/etc/collectd/collectd.conf
An example collectd.conf to run a collectd
server:
LoadPlugin network
...
...
<Plugin network>
Listen "0.0.0.0" "25826"
</Plugin>
Enable collectd forwarding on GitHub Enterprise
By default, collectd
forwarding is disabled on GitHub Enterprise. Follow the steps below to enable and configure collectd
forwarding:
-
GitHub Enterprise Server の管理アカウントから、任意のページの右上隅の をクリックします。
-
[サイト管理者] ページにま� 表示されていない� �合は、左上隅の [サイト管理者] をクリックします。
-
左側のサイドバーで、 [Management Console] をクリックします。
-
Below the log forwarding settings, select Enable collectd forwarding.
-
In the Server address field, type the address of the
collectd
server to which you'd like to forward GitHub Enterprise appliance statistics. -
In the Port field, type the port used to connect to the
collectd
server. (Defaults to 25826) -
In the Cryptographic setup dropdown menu, select the security level of communications with the
collectd
server. (None, signed packets, or encrypted packets.) -
左側のサイドバーで、 [設定の保存] をクリックします。
注: [Management Console] に設定を保存すると、システ� サービスが再起動され、ユーザーに表示されるダウンタイ� が発生する可能性があります。
-
設定の実行が完了するのを待ってく� さい。
Exporting collectd data with ghe-export-graphs
The command-line tool ghe-export-graphs
will export the data that collectd
stores in RRD databases. This command turns the data into XML and exports it into a single tarball (.tgz
).
Its primary use is to provide the GitHub Enterprise Support team with data about a VM's performance, without the need for downloading a full Support Bundle. It shouldn't be included in your regular backup exports and there is no import counterpart. If you contact GitHub Enterprise Support, we may ask for this data to assist with troubleshooting.
Usage
ssh -p 122 admin@[hostname] -- 'ghe-export-graphs' && scp -P 122 admin@[hostname]:~/graphs.tar.gz .
Troubleshooting
Central collectd server receives no data
GitHub Enterprise ships with collectd
version 5.x. collectd
5.x is not backwards compatible with the 4.x release series. Your central collectd
server needs to be at least version 5.x to accept data sent from your GitHub Enterprise Server instance.
For help with further questions or issues, contact GitHub Enterprise Support.