我们经常发布文档更新,此页面的翻译可能仍在进行中。有关最新信息,请访问英文文档。如果此页面上的翻译有问题,请告诉我们

此版本的 GitHub Enterprise 已停止服务 2021-03-02. 即使针对重大安全问题,也不会发布补丁。 要获得更好的性能、改进的安全性和新功能,请升级到 GitHub Enterprise 的最新版本。 如需升级方面的帮助,请联系 GitHub Enterprise 支持

配置 collectd

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

本文内容

设置外部 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 转发

默认情况下,collectd 转发在 GitHub Enterprise 上处于禁用状态。 请按照以下操作步骤启用并配置 collectd 转发:

  1. 从 GitHub Enterprise Server 上的管理帐户,点击任何页面右上角的
    用于访问站点管理员设置的火箭图标
  2. 在左侧边栏中,单击 管理控制台
    左侧边栏中的 管理控制台 选项卡
  3. 在日志转发设置下,选择 Enable collectd forwarding
  4. Server address 字段中,输入要将 GitHub Enterprise 设备统计信息转发到的 collectd 服务器的地址。
  5. Port 字段中,输入用于连接到 collectd 服务器的端口。 (默认为 25826)
  6. Cryptographic setup 下拉菜单中,选择与 collectd 服务器通信的安全等级。 (无、签名数据包或加密数据包。)
  7. 在左侧边栏下,单击 Save settings(保存设置)
    管理控制台 中的 Save settings 按钮
  8. 等待配置运行完毕。

使用 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 不能后向兼容 4.x 发行版系列。 中央 collectd 服务器的版本至少需要是 5.x 才能接受从 您的 GitHub Enterprise Server 实例 发送的数据。

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