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

使用 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 随附 collectd 版本 5.x。 collectd 5.x 不能后向兼容 4.x 发行版系列。 中央 collectd 服务器的版本至少需要是 5.x 才能接受从 您的 GitHub Enterprise Server 实例 发送的数据。

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