为实例配置 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. 在“设置”边栏下，单击“保存设置”。

    Note

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

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