pjlab-hstat 0.1.0

Cluster host monitor CLI.

hstat

Lightweight cluster resource monitor CLI.
hstat helps you inspect CPU/MEM/GPU utilization by host or by user with a clear terminal table.

---

Table of Contents

• Screenshots
• Installation
• Quick Start
• CLI Reference
• Output Interpretation

---

Screenshots

Query all

Query by host

Query by user

---

Installation

From source (recommended for now)

git clone <your-repo-url>
cd h-monitor
pip install .

Editable mode (development)

pip install -e .

Verify install

hstat --help

---

Quick Start

Query one host

hstat --host <hostname>

Query one user

hstat --user <username> --range 1h

---

CLI Reference

Argument	Alias	Description	Default
--host	-w, -n, --node	Query by host/node	-
--user	-u	Query by user and auto-discover pods	-
--tenant	-	Tenant label used in metrics query	ailab
--namespace	-	Namespace for brainctl/rjob lookup	ailab-ipec
--range	-	Prometheus range (e.g. 30m, 1h, 6h)	1h

---

Output Interpretation

• UTL: utilization meter, percentage-based load
• MEM: memory usage ratio against requested resources
• Row order: sorted by GPU utilization (high -> low)
• Footer AVG: average CPU/MEM/GPU usage across listed pods