Managing dirty block tracking

This section provides commands for testing purposes of dirty block tracing.

Starting dirty block tracking

Procedure

Run the following command on any node in the cluster:

zbs-cdp dirty-trace start <volume_id> [options]

Parameter description

Parameter	Description
`volume_id`	The local volume ID.
`--chunk_ip <IP>`	Optional. Specifies the IP address of the chunk node.
`--chunk_port <PORT>`	Optional. Specifies the port of the chunk node.

Output example

zbs-cdp dirty-trace start be09dd2c-325d-406c-b772-bcb36d3991fd

Output note

If the command succeeds, no output is displayed.

Procedure

Run the following command on any node in the cluster:

zbs-cdp dirty-trace stop <volume_id> [options]

Parameter description

Parameter	Description
`volume_id`	The local volume ID.
`--chunk_ip <IP>`	Optional. Specifies the IP address of the chunk node.
`--chunk_port <PORT>`	Optional. Specifies the port of the chunk node.

Output example

zbs-cdp dirty-trace stop be09dd2c-325d-406c-b772-bcb36d3991fd

Output note

If the command succeeds, no output is displayed.

Procedure

Run the following command on any node in the cluster:

zbs-cdp dirty-trace show <volume_id> [options]

Parameter description

Parameter	Description
`volume_id`	The local volume ID.
`--chunk_ip <IP>`	Optional. Specifies the IP address of the chunk node.
`--chunk_port <PORT>`	Optional. Specifies the port of the chunk node.
`--dry_run` / `--no_dry_run`	Optional. The default value is `--dry_run`, which means dirty blocks in the cache are not cleaned up. Use `--no_dry_run` to clean up dirty blocks.
`--show_details`	Optional. Specifies whether to display detailed information about all blocks. By default, the information is not displayed.

Output example

zbs-cdp dirty-trace show be09dd2c-325d-406c-b772-bcb36d3991fd
total: 13

or display detailed information

zbs-cdp dirty-trace show be09dd2c-325d-406c-b772-bcb36d3991fd --show_details
total: 13
[0, 1, 2, 3, 20, 21, 22, 28, 86, 87, 88, 89, 99]

Output note

After successful execution, the dirty page statistics will be displayed.

Field	Description
`total`	The total number of dirty blocks.
`[...]`	If `--show_details` is specified, the index list of all dirty blocks will be displayed.

In this article