Skip to main content

inspect

View detailed metrics for a specific service.
$ sysg inspect -s myservice

Options

OptionDescription
-s, --serviceName of the service to inspect
--streamContinuously refresh output and render a rolling metrics window of the provided duration (e.g., 5, 1s, 2m)
--configPath to configuration file
--jsonEmit machine-readable JSON output instead of a report
--sysOpt into privileged system mode. Requires running as root
--no-colorDisable ANSI colors in output
--log-levelSet verbosity (debug, info, warn, error)

Examples

View service metrics

$ sysg inspect -s 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)

Stream with a longer rolling window

$ sysg inspect -s api --stream 24h

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