配置 collectd

设置外部 collectd 服务器

如果您尚未设置外部 collectd 服务器，则需要首先进行设置，然后才能在 您的 GitHub Enterprise Server 实例 上启用 collectd 转发。 您的 collectd 服务器运行的 collectd 版本不得低于 5.x。

1. 登录 collectd 服务器。
2. 创建或编辑 collectd 配置文件，以加载网络插件并为服务器和端口指令填入适当的值。 在大多数分发中，此文件位于 /etc/collectd/collectd.conf 中

用于运行 collectd 服务器的示例 collectd.conf：

LoadPlugin network
...
...
<Plugin network>
    Listen "0.0.0.0" "25826"
</Plugin>

在 GitHub Enterprise 上启用 collectd 转发

默认情况下，collectd 转发在 GitHub Enterprise 上处于禁用状态。 请按照以下操作步骤启用并配置 collectd 转发：

1. 在任何页面的右上角，单击 。
   
2. 在左侧边栏中，单击 管理控制台。
   
3. 在日志转发设置下，选择 Enable collectd forwarding。
4. 在 Server address 字段中，输入要将 GitHub Enterprise 设备统计信息转发到的 collectd 服务器的地址。
5. 在 Port 字段中，输入用于连接到 collectd 服务器的端口。 （默认为 25826）
6. 在 Cryptographic setup 下拉菜单中，选择与 collectd 服务器通信的安全等级。 （无、签名数据包或加密数据包。）
7. 在左侧边栏下，单击 Save settings（保存设置）。
   

使用 ghe-export-graphs 导出 collectd 数据

命令行工具 ghe-export-graphs 将导出 collectd 存储在 RRD 数据库中的数据。 此命令会将数据转换为 XML 格式并导出到一个 tarball (.tgz) 中。

此文件的主要用途是为 GitHub Enterprise 支持 或 GitHub 高级支持 团队提供关于 VM 性能的数据（无需下载整个支持包）， 不应包含在常规备份导出范围中，也没有对应的导入文件。 如果您联系 GitHub Enterprise 支持 或 GitHub 高级支持，我们可能会要求您提供此数据，以便协助故障排查。

用法

ssh -p 122 admin@[hostname] -- 'ghe-export-graphs' && scp -P 122 admin@[hostname]:~/graphs.tar.gz .

疑难解答

中央 collectd 服务器未收到数据

GitHub Enterprise ships with collectd version 5.x. collectd 5.x is not backwards compatible with the 4.x release series. 中央 collectd 服务器的版本至少需要是 5.x 才能接受从 您的 GitHub Enterprise Server 实例 发送的数据。

要获取其他问题的帮助，请联系 GitHub Enterprise 支持 或 GitHub 高级支持。