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.

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 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.

["ITRS Analytics"] ["User Guide", "Technical Reference"]

Was this topic helpful?