Metrics¶

Migration Manager exposes metrics about the daemon and the entities it manages through the /1.0/metrics endpoint. The metrics are served in the OpenMetrics text format, which can be consumed by Prometheus and compatible scrapers.

The endpoint requires the same authentication as the rest of the API, so the scraper needs either a trusted TLS client certificate or a valid OIDC token.

curl -s --cert client.crt --key client.key https://<server>:6443/1.0/metrics

Available metrics¶

Metric	Labels	Description
`migration_manager_artifacts`	`type`	The number of defined artifacts.
`migration_manager_batches`	`status`	The number of defined batches.
`migration_manager_batch_instances`	`batch`, `status`	The number of instances assigned to a batch.
`migration_manager_batch_migrated_instances`	`batch`, `status`	The number of instances of a batch that have been migrated.
`migration_manager_batch_blocked_instances`	`batch`, `status`, `reason`	The number of instances of a batch that are blocked from migrating.
`migration_manager_batch_disk_bytes`	`batch`, `status`	The disk size in bytes of the instances assigned to a batch.
`migration_manager_batch_migrated_disk_bytes`	`batch`, `status`	The disk size in bytes of a batch that has been transferred to the target.
`migration_manager_instances`		The number of instances known to the daemon.
`migration_manager_networks`	`source`	The number of networks known to the daemon.
`migration_manager_queue_entries`	`batch`, `status`	The number of instances currently in a migration queue.
`migration_manager_sources`	`type`	The number of configured sources.
`migration_manager_source_instances`	`source`, `type`	The number of instances reported by a source.
`migration_manager_source_imported_instances`	`source`	The number of instances of a source that were fully imported by the last sync.
`migration_manager_source_migrated_instances`	`source`	The number of instances of a source that have been migrated.
`migration_manager_source_ineligible_instances`	`source`, `reason`	The number of instances of a source that aren’t eligible for migration.
`migration_manager_source_import_issues`	`source`, `issue`	The number of instances of a source affected by an import issue.
`migration_manager_targets`	`type`	The number of configured targets.
`migration_manager_warnings`	`type`, `status`	The number of recorded warnings.
`migration_manager_uptime_seconds`		The daemon uptime in seconds.
`migration_manager_go_goroutines`		The number of goroutines that currently exist.
`migration_manager_go_alloc_bytes`		The number of bytes allocated and still in use.
`migration_manager_go_alloc_bytes_total`		The total number of bytes allocated, even if freed.
`migration_manager_go_heap_objects`		The number of allocated objects.
`migration_manager_go_sys_bytes`		The number of bytes obtained from the system.

The per-batch and per-source metrics report the same numbers as the /1.0/stats endpoint. An instance assigned to several batches is counted in each of them, so the per-batch series can add up to more than migration_manager_instances.

Incus OS metrics¶

When Migration Manager runs on Incus OS, the system metrics reported by the Incus OS node exporter are appended to the output. This provides the usual node_* metrics for the host, such as CPU, memory, disk and network usage, alongside the Migration Manager metrics.