Metrics Reports

原文：https://docs.gitlab.com/ee/ci/metrics_reports.html

• Overview
• Use cases
• How it works
• How to set it up
• Advanced Example

Metrics Reports

在GitLab Premium 11.10 中引入 . 需要 GitLab Runner 11.10 及更高版本.

Overview

GitLab 提供了许多用于合并请求的出色报告工具-JUnit 报告 ， 代码质量 ，性能测试等.尽管 JUnit 是用于”通过”或”失败”的测试的出色开放框架，但查看其他类型的测试也很重要.给定更改的指标.

您可以将作业配置为使用自定义指标报告，并且 GitLab 会在合并请求上显示报告，以便更轻松，更快速地识别更改而无需检查整个日志.

Use cases

考虑以下可以利用指标报告的数据示例：

1. 内存使用情况
2. 负载测试结果
3. 代码复杂度
4. 代码覆盖率统计

How it works

从指标报告中读取指标（默认值： metrics.txt ）. 它们被解析并显示在 MR 小部件中.

所有值都视为字符串，并且使用字符串比较来查找来自以下各项的最新可用metrics工件之间的差异：

• master
• 功能分支

How to set it up

添加一个创建指标报告的作业（默认文件名： metrics.txt ）. 该文件应符合OpenMetrics格式.

例如：

metrics:
  script:
    - echo 'metric_name metric_value' > metrics.txt
  artifacts:
    reports:
      metrics: metrics.txt

Advanced Example

OpenMetrics 文本文件的高级示例（来自Prometheus 文档 ）在合并请求小部件中呈现为：