Analyzer disktop-by-proc

# Name

disktop-by-proc - Virtual File System Read Write N Process

This analyzer monitors virtual file system read and write activity across processes in the system. It captures kernel-level stack traces during file I/O operations and aggregates metrics by process. The analyzer presents data in table format, showing the top 20 processes by disk I/O activity (read/write throughput in KB/s), helping identify resource-intensive applications and troubleshoot system-wide disk performance issues. You can optionally filter by specific block 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 disktop-by-proc -p PID

# trace a shell command directly
orxray analyzer run disktop-by-proc -c SHELL_CMD

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

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

# Tracing Multiple Processes

Supported.

# Output Formats

• Tables
• Plain Texts

# Output Example

[{
  "type": "table",
  "ver": 1,
  "title": "Show Top 20 Disk IO: read: 102KB/s, write: 3KB/s",
  "data": [
    ["Dev", "PID", "EXE", "Read(KB/s)", "Write(KB/s)"],
    ["vda1", "2721910", "nginx", "97.635352", "2.532812"],
    ["vda1", "2140304", "systemd-user-ru", "2.358203", "0.000000"]
  ]
}]

# Author

The OpenResty Inc. Team.

# Copyright

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