Skip to main content

inspect

View detailed metrics for a specific service.

$ sysg inspect myservice

Options

OptionDescription
--windowTime window to display (e.g., "5s" for live, "12h" for historical). Short durations (<=60s) enable live mode with auto-refresh (default: 5s)
--configPath to configuration file
--jsonEmit machine-readable JSON output instead of a report
--sysOpt into privileged system mode. Requires running as root
--drop-privilegesDrop privileges after performing privileged setup
--no-colorDisable ANSI colors in output
--log-levelSet verbosity (debug, info, warn, error)

Examples

View service metrics

$ sysg inspect api

Shows CPU and memory usage chart:

CPU & Memory Usage - api (Last 5m)
100% ┤
│ ╭─╮
80% ┤ ╱ ╰╮
│ ╱ ╰─╮
60% ┤ ╱ ╰───╮
│ ╱ ╰───────
40% ┤╱

20% ┤━━━━━━━━━━━━━━━━━━━━━━ Memory

0% └────────────────────────
0s 5m

CPU: 45.2% (current) Memory: 23.1% (current)

View longer time window

$ sysg inspect api --window 24h

Inspect by hash

Useful for cron jobs:

$ sysg inspect 3abad7ffa39c

Metrics shown

  • CPU usage - Percentage over time
  • Memory usage - Percentage over time
  • Execution count - For cron jobs
  • Average duration - For completed processes
  • Success rate - For cron jobs

See also

  • status - Quick service overview
  • logs - View service output