Monitor metrics migration progress
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.
During this period, the deployment can appear healthy even though migration work is still running and the legacy Timescale workload has not yet been removed. Monitoring migration progress helps you confirm that the migration is advancing as expected, estimate how much work remains, and avoid making cleanup or capacity decisions too early.
Note
After the upgrade completes, thechmigration-metricspod can continue running in the background while metrics migration is still in progress.
Find the metrics migration pod Copied
Run the following command to locate the migration pod:
kubectl get pods -n "$NAMESPACE" | grep chmigration-metrics
Example output:
chmigration-metrics-abcde 1/1 Running 0 15m
Check the latest migration progress Copied
To view the most recent migration progress line from the pod logs, run:
kubectl logs -n "$NAMESPACE" <chmigration-metrics-pod> -c migration --tail=500 \
| awk '/metric tables exist/ { line=$0 } END { print line }'
Example output:
15248 metric tables exist, 3750 migrated, 11498 remaining, 25% complete
Watch migration progress continuously Copied
To monitor the migration continuously, run:
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:
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 Copied
When the migration finishes, the operator removes the chmigration-metrics job and the legacy Timescale workload.