设置外部 collectd
服务器
如果您尚未设置外部 collectd
服务器,则需要首先进行设置,然后才能在 your GitHub Enterprise Server instance 上启用 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
转发:
-
From an administrative account on GitHub Enterprise Server, in the upper-right corner of any page, click .
-
If you're not already on the "Site admin" page, in the upper-left corner, click Site admin.
-
在左侧边� �中,单击 管理控制台。
-
在日志转发设置下,选择 Enable collectd forwarding。
-
在 Server address 字段中,输入要将 GitHub Enterprise 设备统计信息转发到的
collectd
服务器的地址。 -
在 Port 字段中,输入用于连接到
collectd
服务器的端口。 (默认为 25826) -
在 Cryptographic setup 下拉菜单中,选择与
collectd
服务器通信的安全等级。 (� 、签名数据包或� 密数据包。) -
在左侧边� �下,单击 Save settings(保存设置)。
Note: Saving settings in the 管理控制台 restarts system services, which could result in user-visible downtime.
-
等待配置运行完毕。
使用 ghe-export-graphs
导出 collectd 数据
命令行工具 ghe-export-graphs
将导出 collectd
存储在 RRD 数据库中的数据。 此命令会将数据转换为 XML � �式并导出到一个 tarball (.tgz
) 中。
此文件的主要用途是为 GitHub Enterprise Support 团队提供关于 VM 性能的数据(� 需下载整个支持包), 不应包含在常规备份导出范围中,也没有对应的导入文件。 如果您联系 GitHub Enterprise Support,我们可能会要求您提供此数据,以便协助故障排查。
用法
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 才能接受从 your GitHub Enterprise Server instance 发送的数据。
要获取其他问题的帮助,请联系 GitHub Enterprise Support。