73c6477b7e
Previously, we used brackets to denote the tier badges, but this made Kramdown, the docs site Markdown renderer, show many warnings when building the site. This is now fixed by using parentheses instead of square brackets. This was caused by [PREMIUM] looking like a link to Kramdown, which couldn't find a URL there. See: - https://gitlab.com/gitlab-com/gitlab-docs/merge_requests/484 - https://gitlab.com/gitlab-org/gitlab-ce/issues/63800
49 lines
1.7 KiB
Markdown
49 lines
1.7 KiB
Markdown
---
|
|
type: reference
|
|
---
|
|
|
|
# Metrics Reports **(PREMIUM)**
|
|
|
|
> [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/9788) in [GitLab Premium](https://about.gitlab.com/pricing/) 11.10.
|
|
Requires GitLab Runner 11.10 and above.
|
|
|
|
## Overview
|
|
|
|
GitLab provides a lot of great reporting tools for [merge requests](../user/project/merge_requests/index.md) - [JUnit reports](junit_test_reports.md), [codequality](../user/project/merge_requests/code_quality.md), performance tests, etc. While JUnit is a great open framework for tests that "pass" or "fail", it is also important to see other types of metrics from a given change.
|
|
|
|
You can configure your job to use custom Metrics Reports, and GitLab will display a report on the merge request so that it's easier and faster to identify changes without having to check the entire log.
|
|
|
|
|
|
|
|
## Use cases
|
|
|
|
Consider the following examples of data that can utilize Metrics Reports:
|
|
|
|
1. Memory usage
|
|
1. Load testing results
|
|
1. Code complexity
|
|
1. Code coverage stats
|
|
|
|
## How it works
|
|
|
|
Metrics are read from the metrics report (default: `metrics.txt`). They are parsed and displayed in the MR widget.
|
|
|
|
All values are considered strings and string compare is used to find differences between the latest available `metrics` artifact from:
|
|
|
|
- `master`
|
|
- The feature branch
|
|
|
|
## How to set it up
|
|
|
|
Add a job that creates a [metrics report](yaml/README.md#artifactsreportsmetrics-premium) (default filename: `metrics.txt`). The file should conform to the [OpenMetrics](https://openmetrics.io/) format.
|
|
|
|
For example:
|
|
|
|
```yaml
|
|
metrics:
|
|
script:
|
|
- echo 'metric_name metric_value' > metrics.txt
|
|
artifacts:
|
|
reports:
|
|
metrics: metrics.txt
|
|
```
|