From 79b58c0fafe77ae03913fd6ab3661821577a91cc Mon Sep 17 00:00:00 2001
From: Anatol Belski <anbelski@linux.microsoft.com>
Date: Thu, 26 Mar 2026 21:10:21 +0100
Subject: [PATCH] performance-metrics: Add QCOW2 backing file read micro
 benchmark

Add micro_bench_qcow_backing_read which reads clusters from a QCOW2
overlay where all data lives in a raw backing file.  Every read falls
through the L2 lookup to the backing file, exercising the backing
chain read path.

Workloads: 128 and 256 clusters.
Signed-off-by: Anatol Belski <anbelski@linux.microsoft.com>
---
 performance-metrics/src/main.rs              | 26 +++++++++++++++++++-
 performance-metrics/src/micro_bench_block.rs | 25 +++++++++++++++++++
 2 files changed, 50 insertions(+), 1 deletion(-)

diff --git a/performance-metrics/src/main.rs b/performance-metrics/src/main.rs
index 3020d5827..e40323788 100644
--- a/performance-metrics/src/main.rs
+++ b/performance-metrics/src/main.rs
@@ -378,7 +378,7 @@ mod adjuster {
     }
 }
 
-const TEST_LIST: [PerformanceTest; 72] = [
+const TEST_LIST: [PerformanceTest; 74] = [
     PerformanceTest {
         name: "boot_time_ms",
         func_ptr: performance_boot_time,
@@ -1373,6 +1373,30 @@ const TEST_LIST: [PerformanceTest; 72] = [
         },
         unit_adjuster: adjuster::s_to_us,
     },
+    PerformanceTest {
+        name: "micro_block_qcow_backing_read_128_us",
+        func_ptr: micro_bench_block::micro_bench_qcow_backing_read,
+        control: PerformanceTestControl {
+            test_timeout: 10,
+            test_iterations: 20,
+            warmup_iterations: 5,
+            num_ops: Some(128),
+            ..PerformanceTestControl::default()
+        },
+        unit_adjuster: adjuster::s_to_us,
+    },
+    PerformanceTest {
+        name: "micro_block_qcow_backing_read_256_us",
+        func_ptr: micro_bench_block::micro_bench_qcow_backing_read,
+        control: PerformanceTestControl {
+            test_timeout: 10,
+            test_iterations: 20,
+            warmup_iterations: 5,
+            num_ops: Some(256),
+            ..PerformanceTestControl::default()
+        },
+        unit_adjuster: adjuster::s_to_us,
+    },
 ];
 
 fn run_test_with_timeout(
diff --git a/performance-metrics/src/micro_bench_block.rs b/performance-metrics/src/micro_bench_block.rs
index 40869afbc..efb73559d 100644
--- a/performance-metrics/src/micro_bench_block.rs
+++ b/performance-metrics/src/micro_bench_block.rs
@@ -196,3 +196,28 @@ pub fn micro_bench_qcow_fsync(control: &PerformanceTestControl) -> f64 {
 
     elapsed
 }
+
+/// Read num_ops clusters from a QCOW2 overlay whose data lives entirely
+/// in a raw backing file.
+///
+/// This exercises the backing file read path: L2 lookup finds no
+/// allocated cluster and falls through to the backing file for every
+/// read.
+///
+/// Returns the total read wall clock time in seconds.
+pub fn micro_bench_qcow_backing_read(control: &PerformanceTestControl) -> f64 {
+    let num_ops = control.num_ops.expect("num_ops required") as usize;
+    let (_backing, _overlay, disk) = util::qcow_overlay_tempfile(num_ops);
+    let mut async_io = disk.new_async_io(1).expect("new_async_io failed");
+
+    let mut buf = vec![0u8; QCOW_CLUSTER_SIZE as usize];
+    let iovec = read_iovec(&mut buf);
+
+    let start = Instant::now();
+    submit_reads(async_io.as_mut(), num_ops, QCOW_CLUSTER_SIZE, &[iovec]);
+    let elapsed = start.elapsed().as_secs_f64();
+
+    drain_completions(async_io.as_mut(), num_ops);
+
+    elapsed
+}