关于 GitHub Enterprise Server
的 collectd
collectd 是在 你的 GitHub Enterprise Server 实例 上运行的服务，用于收集和提供系统性能相关指标。 collectd 收集的常见指标包括 CPU 利用率、内存和磁盘消耗、网络接口流量和错误以及系统的总体负载。 还可将数据转发到其他 collectd 服务器。 有关详细信息，请参阅 collectd wiki。
实例使用 collectd 的指标在 管理控制台 的监视器仪表板中显示图形。 有关详细信息，请参阅“访问监视仪表板”。
可以查看 collectd 在 你的 GitHub Enterprise Server 实例 上收集的指标列表。 有关详细信息，请参阅“GitHub Enterprise Server 的 collectd 指标”。
设置外部 collectd 服务器
如果尚未设置外部 collectd 服务器，则需要在对 你的 GitHub Enterprise Server 实例 启用 collectd 转发之前进行设置。 collectd 服务器必须运行 collectd 5.x 或更高版本。
- 登录到
collectd服务器。 - 创建或编辑
collectd配置文件，以加载网络插件并使用正确的值填充服务器和端口指令。 在大多数发行版中，该文件位于/etc/collectd/collectd.conf
用于运行 collectd 服务器的示例 collectd.conf：
LoadPlugin network
...
...
<Plugin network>
Listen "0.0.0.0" "25826"
</Plugin>
在 GitHub Enterprise 上启用 collectd 转发
默认情况下，在 GitHub Enterprise 上禁用 collectd 转发。 请按照以下步骤启用和配置 collectd 转发：
-
在 GitHub Enterprise Server 上的管理帐户中，在任一页面的右上角，单击 。
-
如果你尚未在“站点管理员”页上，请在左上角单击“站点管理员”。
-
在“ 站点管理”边栏中，单击“管理控制台”。
-
在日志转发设置下方，选择“启用 collectd 转发”。
-
在“服务器地址”字段中，输入要将 GitHub Enterprise 设备统计信息转发到的
collectd服务器的地址。 -
在“端口”字段中，输入用于连接到
collectd服务器的端口。 （默认为 25826） -
在“加密设置”下拉菜单中，选择与
collectd服务器通信的安全级别。 （无、签名数据包或加密数据包。）1. 在“设置”边栏下，单击“保存设置”。注意：保存 管理控制台 中的设置会重启系统服务，这可能会导致用户可察觉的停机时间。
-
等待配置运行完毕。
使用 ghe-export-graphs 导出 collectd 数据
命令行工具 ghe-export-graphs 将导出 collectd 存储在 RRD 数据库中的数据。 此命令会将数据转换为 XML 格式并导出到一个 tarball (.tgz) 中。
此文件的主要用途是为 GitHub Enterprise 支持 团队提供关于 VM 性能的数据（无需下载整个支持包）， 不应包含在常规备份导出范围中，也没有对应的导入文件。 如果你通过 GitHub Enterprise 支持 联系我们，我们可能会要求你提供此数据，以便协助排除故障。
使用情况
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 支持。