关于 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 支持。