Skip to main content

此版本的 GitHub Enterprise Server 已于以下日期停止服务 2024-07-09. 即使针对重大安全问题,也不会发布补丁。 为了获得更好的性能、更高的安全性和新功能,请升级到最新版本的 GitHub Enterprise。 如需升级帮助,请联系 GitHub Enterprise 支持

为实例配置 collectd

要深入了解 GitHub Enterprise Server 的性能,可以查看实例 collectd 中的数据,或者选择将数据发送到外部 collectd 服务器。

关于 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 或更高版本。

  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. 如果你尚未在“站点管理员”页上,请在左上角单击“站点管理员”。

  3. 在“ 站点管理”边栏中,单击“管理控制台”。

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

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

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

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

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

  8. 等待配置运行完毕。

使用 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 支持