配置 collectd
GitHub Enterprise 可以通过“collectd”收集数据并将数据发送到外部“collectd”服务器。 除了其他指标外,我们还会收集标准数据集,例如 CPU 利用率、内存与磁盘使用量、网络接口流量与错误,以及 VM 的总负荷。
设置外部 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 转发
默认情况下,collectd
转发在 GitHub Enterprise 上处于禁用状态。 请按照以下操作步骤启用并配置 collectd
转发:
-
In the upper-right corner of any page, click .
-
在左侧边栏中,单击 管理控制台。
-
在日志转发设置下,选择 Enable collectd forwarding。
-
在 Server address 字段中,输入要将 GitHub Enterprise 设备统计信息转发到的
collectd
服务器的地址。 -
在 Port 字段中,输入用于连接到
collectd
服务器的端口。 (默认为 25826) -
在 Cryptographic setup 下拉菜单中,选择与
collectd
服务器通信的安全等级。 (None, signed packets, or encrypted packets.) -
Under the left sidebar, click 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 随附的 collectd
的版本为 5.x。collectd
5.x 不向后兼容 V4.x 版本系列。 中央 collectd
服务器的版本至少需要是 5.x 才能接受从 您的 GitHub Enterprise Server 实例 发送的数据。