# Monitoring project metrics

You can view the values of all [metrics-definition](https://docs.sonarsource.com/sonarqube-server/2025.2/user-guide/code-metrics/metrics-definition "mention") in your project and you can view the value history of one or several code metrics in your project.

## Viewing the values of all code metrics <a href="#all-metrics" id="all-metrics"></a>

1. In the top navigation bar, click **Projects** and then click the project you want to monitor.
2. In the project navigation bar, click **Measures**.

## Viewing the value history of one or several metrics <a href="#value-history" id="value-history"></a>

1\. In the top navigation bar, click **Projects** and then click the project you want to monitor.

2\. In the project navigation bar, select **Activity**. The left sidebar contains the list of code scans performed on your project.

3\. In **Filter events**, you can filter the scans list by event type (see **Event types** in [activity-and-history](https://docs.sonarsource.com/sonarqube-server/2025.2/user-guide/viewing-projects/activity-and-history "mention")).

4\. Issues are shown in the graph by default. To change the metrics shown, click **Issues** and select another metric category in the drop-down list.

<div align="left"><figure><img src="https://3577027091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F69lEOGGgOhCpumODGD9v%2Fuploads%2Fgit-blob-5c6016b93205ffda21b3697a880078fca6398783%2Fsonarqube-select-metrics.png?alt=media" alt="Selecting custom metrics for issues" width="534"><figcaption></figcaption></figure></div>

5\. Select **Custom** if you want to monitor other metrics: the **Add metric** drop-down list is displayed. Then, click **Add metric** and select in the drop-down list the metric(s) you want to monitor. The selected metrics are displayed in one or several graphs so that you can compare them.

<div align="left"><figure><img src="https://3577027091-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F69lEOGGgOhCpumODGD9v%2Fuploads%2Fgit-blob-b2056c2fe32b64abb2d9d3abbcc7f2e85f1b48c6%2Fsonarqube-code-metrics-monitoring.png?alt=media" alt="Adding custom metrics to the graph" width="563"><figcaption></figcaption></figure></div>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sonarsource.com/sonarqube-server/2025.2/user-guide/code-metrics/monitoring-project-metrics.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
