# Metrics Reports > 原文：[https://docs.gitlab.com/ee/ci/metrics_reports.html](https://docs.gitlab.com/ee/ci/metrics_reports.html) * [Overview](#overview) * [Use cases](#use-cases) * [How it works](#how-it-works) * [How to set it up](#how-to-set-it-up) * [Advanced Example](#advanced-example) # Metrics Reports[](#metrics-reports-premium "Permalink") 在[GitLab Premium](https://about.gitlab.com/pricing/) 11.10 中[引入](https://gitlab.com/gitlab-org/gitlab/-/issues/9788) . 需要 GitLab Runner 11.10 及更高版本. ## Overview[](#overview "Permalink") GitLab 提供了許多用于[合并請求](../user/project/merge_requests/index.html)的出色報告工具[-JUnit 報告](junit_test_reports.html) ， [代碼質量](../user/project/merge_requests/code_quality.html) ，性能測試等.盡管 JUnit 是用于"通過"或"失敗"的測試的出色開放框架，但查看其他類型的測試也很重要.給定更改的指標. 您可以將作業配置為使用自定義指標報告，并且 GitLab 會在合并請求上顯示報告，以便更輕松，更快速地識別更改而無需檢查整個日志. [](img/metrics_reports_v13_0.png) ## Use cases[](#use-cases "Permalink") 考慮以下可以利用指標報告的數據示例： 1. 內存使用情況 2. 負載測試結果 3. 代碼復雜度 4. 代碼覆蓋率統計 ## How it works[](#how-it-works "Permalink") 從指標報告中讀取指標（默認值： `metrics.txt` ）. 它們被解析并顯示在 MR 小部件中. 所有值都視為字符串，并且使用字符串比較來查找來自以下各項的最新可用`metrics`工件之間的差異： * `master` * 功能分支 ## How to set it up[](#how-to-set-it-up "Permalink") 添加一個創建[指標報告](pipelines/job_artifacts.html#artifactsreportsmetrics-premium)的作業（默認文件名： `metrics.txt` ）. 該文件應符合[OpenMetrics](https://openmetrics.io/)格式. 例如： ``` metrics: script: - echo 'metric_name metric_value' > metrics.txt artifacts: reports: metrics: metrics.txt ``` ## Advanced Example[](#advanced-example "Permalink") OpenMetrics 文本文件的高級示例（來自[Prometheus 文檔](https://github.com/prometheus/docs/blob/master/content/docs/instrumenting/exposition_formats.md#text-format-example) ）在合并請求小部件中呈現為： [](img/metrics_reports_advanced_v13_0.png)