Analyzer diskstat

# Name

diskstat - Virtual File System Read Write By Disk Name

This analyzer monitors virtual file system read and write statistics aggregated by disk device name. It captures C-land I/O operations and provides per-disk metrics including throughput and operation counts. The analyzer presents data in table format, showing detailed statistics for each disk device, helping identify disk-level bottlenecks and balance I/O load across storage devices.

# Resource Category

Disk I/O.

# Application Type & Technical Stack

• All

# Command Line Syntax

The analyzer can be invoked directly on the command-line via the orxray utility from the openresty-xray-cli software package.

Alternatively, the analyzer can also be invoked manually or automatically on the web console UI of OpenResty XRay (like on the Advanced web page).

# PID is the target process PID.
orxray analyzer run diskstat -p PID

# trace a shell command directly
orxray analyzer run diskstat -c SHELL_CMD

# PGID is the process group ID or any process's PID within the target process
# group.
orxray analyzer run diskstat -p -PGID

# trace any processes started from the specified executable path.
orxray analyzer run diskstat --exe /path/to/exe/file

# Tracing Multiple Processes

Supported.

# Output Formats

• Tables
• Plain Texts

# Output Example

[
  {
    "data": [
      [
        "Dev",
        "Read(KB/s)",
        "Write(KB/s)"
      ],
      [
        "vda1",
        "186.059668",
        "9.065820"
      ]
    ],
    "title": "Top 10 Disk by IO: read: 186KB/s, write: 9KB/s",
    "type": "table",
    "ver": 1
  }
]

# Author

The OpenResty Inc. Team.

# Copyright

Copyright (C) by OpenResty Inc. All rights reserved.