---
title: "Document metrics and configurations changes | Grafana Loki documentation"
description: "Document metrics and configurations changes"
---

# Document metrics and configurations changes

Any metrics and configurations that are removed or modified need to be documented in the upgrade guide. Configurations whose default values changed should also be documented in the upgrade guide.

## Before you begin

All the steps are performed on `release-VERSION_PREFIX` branch.

## Steps

1. Check which configs changed, including whose default values changed.
   
   ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
   
   ```none
   $ OLD_VERSION=X.Y.Z ./tools/diff-config.sh
   ```
2. Record configurations that are modified (either renamed or had its default value changed) in the [upgrade guide](../prepare-upgrade-guide/).
3. Check if any metrics have changed.
   
   ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy
   
   ```none
   $ OLD_VERSION=X.Y.Z ./tools/diff-metrics.sh
   ```
4. Record metrics whose names have been modified in the [upgrade guide](../prepare-upgrade-guide/).