---
title: "Monitor metrics migration progress"
description: "Learn how to effectively monitor the metrics migration progress in ITRS Analytics after an upgrade, ensuring a seamless transition to ClickHouse."
url: "https://docs.itrsgroup.com/docs/itrs-analytics/platform/2.18.0/upgrade/monitor-metrics-migration-progress/index.html"
---
This guide explains how to monitor the background metrics migration after upgrading ITRS Analytics. This is important because the standard upgrade can show as complete while the legacy Timescale metrics data is still migrating to ClickHouse in the background.


**Note**


The installer runs the migration jobs in the background, and they may continue running after the upgrade finishes, depending on the amount of data in Timescale and the performance of the migration jobs. While migration is ongoing, there can be gaps in the historical data returned by queries because only the data that has already been migrated to ClickHouse is available. All historical data becomes available after the migration completes. You may run the following commands to track migration progress. The reported progress percentage reflects the percentage of tables migrated, not the amount of physical data migrated. You can continue using ITRS Analytics during this time.



## Find the metrics migration pod

Run the following command to locate the migration pod:

```bash
kubectl get pods -n "$NAMESPACE" | grep chmigration-metrics
```

Example output:

```text
chmigration-metrics-abcde                     1/1     Running     0          15m
```

## Check the latest migration progress

To view the most recent migration progress line from the pod logs, run:

```bash
kubectl logs -n <namespace> <chmigration-metrics-pod> -c migration --tail=500 \
  | awk '/metric tables exist/ { line=$0 } END { print line }'
```

Example output:

```text
15248 metric tables exist, 3750 migrated, 11498 remaining, 25% complete
```

## Watch migration progress continuously

To monitor the migration continuously, run:

```bash
while true; do
  date
  kubectl logs -n <namespace> <chmigration-metrics-pod> -c migration --tail=500 \
    | awk '/metric tables exist/ { line=$0 } END { print line }'
  sleep 60
done
```

Example output:

```text
2026-05-05 19:13:19.935 [main] INFO  com.itrsgroup.iax.platform.tools.migration.metric.MetricsJob - 15248 metric tables exist, 14824 migrated, 424 remaining, 97% complete
Wed  6 May 2026 03:14:55 PST
2026-05-05 19:14:20.434 [main] INFO  com.itrsgroup.iax.platform.tools.migration.metric.MetricsJob - 15248 metric tables exist, 14869 migrated, 379 remaining, 98% complete
Wed  6 May 2026 03:15:57 PST
2026-05-05 19:15:21.146 [main] INFO  com.itrsgroup.iax.platform.tools.migration.metric.MetricsJob - 15248 metric tables exist, 14915 migrated, 333 remaining, 98% complete
Wed  6 May 2026 03:16:58 PST
2026-05-05 19:16:21.892 [main] INFO  com.itrsgroup.iax.platform.tools.migration.metric.MetricsJob - 15248 metric tables exist, 14962 migrated, 286 remaining, 98% complete
Wed  6 May 2026 03:18:00 PST
2026-05-05 19:17:22.946 [main] INFO  com.itrsgroup.iax.platform.tools.migration.metric.MetricsJob - 15248 metric tables exist, 15009 migrated, 239 remaining, 98% complete
Wed  6 May 2026 03:19:02 PST
2026-05-05 19:18:23.947 [main] INFO  com.itrsgroup.iax.platform.tools.migration.metric.MetricsJob - 15248 metric tables exist, 15056 migrated, 192 remaining, 99% complete
Wed  6 May 2026 03:20:03 PST
2026-05-05 19:19:24.517 [main] INFO  com.itrsgroup.iax.platform.tools.migration.metric.MetricsJob - 15248 metric tables exist, 15103 migrated, 145 remaining, 99% complete
Wed  6 May 2026 03:21:05 PST
2026-05-05 19:20:24.519 [main] INFO  com.itrsgroup.iax.platform.tools.migration.metric.MetricsJob - 15248 metric tables exist, 15149 migrated, 99 remaining, 99% complete
Wed  6 May 2026 03:22:07 PST
2026-05-05 19:21:26.345 [main] INFO  com.itrsgroup.iax.platform.tools.migration.metric.MetricsJob - 15248 metric tables exist, 15193 migrated, 55 remaining, 100% complete
Wed  6 May 2026 03:23:08 PST
2026-05-05 19:22:27.306 [main] INFO  com.itrsgroup.iax.platform.tools.migration.metric.MetricsJob - 15248 metric tables exist, 15228 migrated, 20 remaining, 100% complete
Wed  6 May 2026 03:24:10 PST
```

## After migration completes

When the migration finishes, the operator removes the `chmigration-metrics` job and the legacy Timescale workload.

