Skip to main content

配置 collectd

GitHub Enterprise 可以通过 collectd 收集数据并将数据发送到外部 collectd 服务器。 除了其他指标外,我们还会收集标准数据集,例如 CPU 利用率、内存与磁盘使用量、网络接口流量与错误,以及 VM 的总负荷。

设置外部 collectd 服务器

如果尚未设置外部 collectd 服务器,则需要在对 your GitHub Enterprise Server instance 启用 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 转发

默认情况下,在 GitHub Enterprise 上禁用 collectd 转发。 请按照以下步骤启用和配置 collectd 转发:

  1. 从 GitHub Enterprise Server 上的管理帐户任意页面的右上角,单击

    用于访问站点管理员设置的火箭图标的屏幕截图

  2. 如果你尚未在“站点管理员”页上,请在左上角单击“站点管理员”。

    “站点管理员”链接的屏幕截图 1. 在左侧边栏中,单击“管理控制台”。 左侧边栏中的 管理控制台 选项卡

  3. 在日志转发设置下方,选择“启用 collectd 转发”。

  4. 在“服务器地址”字段中,输入要将 GitHub Enterprise 设备统计信息转发到的 collectd 服务器的地址。

  5. 在“端口”字段中,输入用于连接到 collectd 服务器的端口。 (默认为 25826)

  6. 在“加密设置”下拉菜单中,选择与 collectd 服务器通信的安全级别。 (无、签名数据包或加密数据包。)1. 在左侧边栏下,单击“保存设置”。

    管理控制台 中的“保存设置”按钮的屏幕截图

    注意:保存 管理控制台 中的设置会重启系统服务,这可能会导致用户可察觉的停机时间。

  7. 等待配置运行完毕。

    配置实例

使用 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 才能接受从 your GitHub Enterprise Server instance 发送的数据。

要获取其他问题的帮助,请联系 GitHub Enterprise 支持