feat: Add FileIoTracer for tracking IO operations with call stack context (facebookincubator#422)

Summary:
Pull Request resolved: facebookincubator#422

X-link: facebookincubator/velox#16012

This diff introduces a file IO tracing infrastructure to capture IO operations along with their call stack context using thread-local storage. This enables debugging and performance analysis by providing visibility into where IO operations originate in the code.

- **IoTag**: A linked structure representing tags in the IO call stack, forming a stack trace. Supports `toString()` for human-readable output (e.g., "TableScan -> ColumnReader -> PrefixEncoding") and `depth()` for stack depth.

- **ScopedIoTag**: RAII helper that automatically pushes a tag onto the thread-local stack on construction and pops it on destruction. This allows capturing IO context without modifying function signatures.

- **threadIoTag()**: Thread-local accessor function returning reference to the current IO tag pointer. Each thread maintains its own independent tag stack.

- **FileIoTracer**: Abstract base class defining the interface for IO tracing implementations with `record()` and `finish()` methods.

- **InMemoryFileIoTracer**: Thread-safe concrete implementation that records IO operations to a `std::vector<IoRecord>`. Protected by mutex for concurrent access from multiple threads.

- **IoRecord**: Struct capturing a single IO operation with type (Read/AsyncRead/Write/AsyncWrite), offset, length, and tag string.

Other Changes

- Renamed `FileStorageContext` to `FileIoContext` and added `ioTracer` field for optionally attaching a tracer to file operations.

- Renamed `Utils.h/cpp` to `FileUtils.h/cpp` for clarity and consistency with other file-related utilities.

Reviewed By: tanjialiang

Differential Revision: D90657574

fbshipit-source-id: 7f2a8f176ea002c963c98fb4a5fe5e63e3723a4b

Author: xiaoxmeng

dwio/nimble/common/tests/TestUtils.h

@@ -295,30 +295,30 @@ class InMemoryTrackableReadFile final : public velox::ReadFile {
       uint64_t offset,
       uint64_t length,
       void* buf,
-      const velox::FileStorageContext& fileStorageContext = {}) const final {
+      const velox::FileIoContext& context = {}) const final {
     chunks_.wlock()->push_back({offset, length});
-    return file_.pread(offset, length, buf, fileStorageContext);
+    return file_.pread(offset, length, buf, context);
   }
 
   std::string pread(
       uint64_t offset,
       uint64_t length,
-      const velox::FileStorageContext& fileStorageContext = {}) const final {
+      const velox::FileIoContext& context = {}) const final {
     chunks_.wlock()->push_back({offset, length});
-    return file_.pread(offset, length, fileStorageContext);
+    return file_.pread(offset, length, context);
   }
 
   uint64_t preadv(
       uint64_t /* offset */,
       const std::vector<folly::Range<char*>>& /* buffers */,
-      const velox::FileStorageContext& fileStorageContext = {}) const final {
+      const velox::FileIoContext& context = {}) const final {
     NIMBLE_UNSUPPORTED("Not used by Nimble");
   }
 
   uint64_t preadv(
       folly::Range<const velox::common::Region*> regions,
       folly::Range<folly::IOBuf*> iobufs,
-      const velox::FileStorageContext& fileStorageContext = {}) const override {
+      const velox::FileIoContext& context = {}) const override {
     VELOX_CHECK_EQ(regions.size(), iobufs.size());
     uint64_t length = 0;
     for (size_t i = 0; i < regions.size(); ++i) {
@@ -339,11 +339,7 @@ class InMemoryTrackableReadFile final : public velox::ReadFile {
         output.appendChain(std::move(next));
       } else {
         output = folly::IOBuf(folly::IOBuf::CREATE, region.length);
-        pread(
-            region.offset,
-            region.length,
-            output.writableData(),
-            fileStorageContext);
+        pread(region.offset, region.length, output.writableData(), context);
         output.append(region.length);
       }
     }