使用统计
- 版本: Free, Premium, Ultimate
- 提供类型: GitLab Self-Managed
GitLab Inc. 会定期收集有关您实例的信息，以执行各种操作。
对于免费的 GitLab Self-Managed 实例，所有使用统计数据都是可选择性退出的。
Service Ping
Service Ping 是一个收集并发送每周数据负载到 GitLab Inc. 的过程。 当启用 Service Ping 时，GitLab 会从其他实例收集数据，并启用某些依赖于 Service Ping 的实例级分析功能。
为什么要启用 Service Ping？
Service Ping 的主要目的是构建一个更好的 GitLab。我们收集关于 GitLab 如何使用的数据，以了解功能或阶段的采用和使用情况。这些数据让我们深入了解 GitLab 如何创造价值，并帮助我们的团队理解人们使用 GitLab 的原因，有了这些知识，我们就能做出更好的产品决策。
启用 Service Ping 还有其他几个好处：
- 分析您的 GitLab 安装中用户随时间的活动情况。
- 一个DevOps 评分，让您全面了解您的实例从规划到监控的并发 DevOps 采用情况。
- 通过可以使用收集数据的客户成功经理（CSM）提供更主动的支持。
- 关于如何从您在 GitLab 上的投资中获得最大价值的见解和建议。
- 显示您与其他类似组织（匿名）比较情况的报告，并提供关于如何改进您的 DevOps 流程的具体建议和推荐。
- 参与我们的注册功能计划以获得免费的付费功能。
注册功能计划
在 GitLab 14.1 及更高版本中，运行 GitLab Enterprise Edition 的 GitLab Self-Managed 实例的 GitLab Free 客户可以通过启用注册功能并通过 Service Ping 向我们发送活动数据来获得付费功能。此处引入的功能不会从其付费版本中移除该功能。付费版本的实例受Cloud Licensing管理的产品使用数据政策约束。
可用功能
在下表中，您可以看到：
- 通过注册功能计划可用的功能
- 这些功能可用的 GitLab 版本
启用注册功能
- 以具有管理员访问权限的用户身份登录。
- 在左侧边栏底部，选择管理员。
- 选择设置 > 指标和分析。
- 展开使用统计部分。
- 如果未启用，选择启用 Service Ping复选框。
- 选择启用注册功能复选框。
- 选择保存更改。
版本检查
如果启用，版本检查会通过状态通知您是否有新版本可用及其重要性。该状态显示在所有已认证用户的帮助页面（/help）和管理员区域页面上。状态包括：
- 绿色：您正在运行最新版本的 GitLab。
- 橙色：有 GitLab 的更新版本可用。
- 红色：您正在运行的 GitLab 版本存在漏洞。您应尽快安装包含安全修复的最新版本。
启用或禁用版本检查
- 在左侧边栏底部，选择管理员。
- 选择设置 > 指标和分析。
- 展开使用统计。
- 选中或清除启用版本检查复选框。
- 选择保存更改。
请求流程示例
以下示例显示了您的实例与 GitLab 版本应用程序之间的基本请求/响应流程：
sequenceDiagram
participant GitLab instance
participant Version Application
GitLab instance->>Version Application: Is there a version update?
Version Application->>GitLab instance: Response (PNG/SVG)
配置您的网络
要向 GitLab Inc. 发送使用统计数据，您必须允许从您的 GitLab 实例到主机 version.gitlab.com 的端口 443 的网络流量。
如果您的 GitLab 实例位于代理后面，请设置适当的代理配置变量。
启用或禁用 Service Ping
您是否可以完全禁用 Service Ping 取决于实例的版本和特定许可证。
Service Ping 设置仅控制数据是否与 GitLab 共享，或仅限于实例内部使用。
即使您禁用 Service Ping，gitlab_service_ping_worker 后台任务仍会定期为您的实例生成 Service Ping 数据负载。
该数据负载可在指标和分析管理员部分中找到。
通过用户界面
要启用或禁用 Service Ping：
- 在左侧边栏底部，选择管理员。
- 选择设置 > 指标和分析。
- 展开使用统计。
- 选中或清除启用 Service Ping复选框。
- 选择保存更改。
通过配置文件
要禁用 Service Ping 并防止将来通过管理员区域进行配置。
-
编辑
/etc/gitlab/gitlab.rb：gitlab_rails['usage_ping_enabled'] = false -
重新配置 GitLab：
sudo gitlab-ctl reconfigure
-
编辑
/home/git/gitlab/config/gitlab.yml：production: &base # ... gitlab: # ... usage_ping_enabled: false -
重启 GitLab：
sudo service gitlab restart
启用或禁用 Service Ping 中的可选数据
GitLab 区分操作数据和可选收集数据。
通过用户界面
要在 Service Ping 中启用或禁用可选数据：
- 在左侧边栏底部，选择管理员。
- 转到设置 > 指标和分析。
- 展开使用统计部分。
- 要启用可选数据，选择在 Service Ping 中包含可选数据复选框。要禁用它，清除该复选框。
- 选择保存更改。
通过配置文件
-
编辑
/etc/gitlab/gitlab.rb：gitlab_rails['include_optional_metrics_in_service_ping'] = false -
重新配置 GitLab：
sudo gitlab-ctl reconfigure
-
编辑
/home/git/gitlab/config/gitlab.yml：production: &base # ... gitlab: # ... include_optional_metrics_in_service_ping: false -
重启 GitLab：
sudo service gitlab restart
访问 Service Ping 数据负载
您可以在管理员区域或通过 API 访问发送到 GitLab Inc. 的确切 JSON 数据负载。
在用户界面中
- 以具有管理员访问权限的用户身份登录。
- 在左侧边栏底部，选择管理员。
- 选择设置 > 指标和分析 > 使用统计。
- 选择预览数据负载。
通过 API
手动上传 Service Ping 数据负载
即使您的实例没有互联网访问权限，或者 Service Ping cron 任务未启用，您也可以将 Service Ping 数据负载上传到 GitLab。
要手动上传数据负载：
- 以具有管理员访问权限的用户身份登录。
- 在左侧边栏底部，选择管理员。
- 选择设置 > 指标和分析 > 使用统计。
- 选择下载数据负载。
- 保存 JSON 文件。
- 访问服务使用数据中心。
- 选择选择文件，然后选择包含下载数据负载的 JSON 文件。
- 选择上传。
上传的文件经过加密，并使用安全的 HTTPS 协议发送。HTTPS 在 Web 浏览器和服务器之间创建安全的通信通道，并保护传输的数据免受中间人攻击。
如果手动上传出现问题：
- 在version app 项目的 security fork中创建一个机密问题。
- 如果可能，请附上 JSON 数据负载。
- 标记
@gitlab-org/analytics-section/analytics-instrumentation，他们将处理该问题。