Skip to content
SHC Docs

shc events

shc events

Section titled “shc events”

stream and view system events

Synopsis

Section titled “Synopsis”

Stream live events from the daemon, or view the audit chain with —audit.

Default mode opens an SSE connection and pretty-prints every event as it arrives. Honour Ctrl-C — the connection drains cleanly on signal. With —since=, the daemon replays everything newer than the given sequence id before switching to live mode (capped at 1000 frames per reconnect — older events fall outside the replay window).

—audit instead queries the tamper-evident audit chain: historical records filtered by stack (global -s), tenant (global -t), event code, actor, or date range (—since/—until as YYYY-MM-DD or RFC 3339). -f/—follow polls for new records every 3 seconds.

shc events [flags]

Examples

Section titled “Examples”
  shc events
  shc events -q --type docker -s myblog
  shc events --since 4210
  shc events --audit --since 2026-06-01 --actor admin -n 50

Options

Section titled “Options”
      --actor string   with --audit: filter by actor
  -a, --all            with --audit: drop the stack filter
      --audit          view the audit chain instead of streaming live events
      --event string   with --audit: filter by event code
  -f, --follow         with --audit: poll for new records every 3s
  -h, --help           help for events
  -n, --limit int      with --audit: maximum records to show (default 100)
      --node string    stream: filter by node ID
  -q, --quiet          stream: hide noisy healthcheck events
      --since string   stream: replay from sequence id; --audit: start date (YYYY-MM-DD or RFC 3339)
  -T, --type string    stream: event types, comma-separated (default "docker,audit")
      --until string   with --audit: end date (YYYY-MM-DD or RFC 3339)

Options inherited from parent commands

Section titled “Options inherited from parent commands”
      --config stringArray   extra YAML config file to layer on top of auto-discovered config; repeatable, later files win
  -d, --debug                enable debug mode (default: $SHC_DEBUG)
  -e, --environment string   environment name (default: $SHC_ENVIRONMENT)
      --exclude string       comma-separated dotted paths to drop
      --fields string        comma-separated columns/keys to show (and their order)
      --filter string        comma-separated dotted paths to keep (drops everything else)
  -o, --output string        output format: tty|text|json|yaml (default: $SHC_OUTPUT)
  -s, --stack string         stack name (default: $SHC_STACK)
  -t, --tenant string        tenant name (default: $SHC_TENANT)
  -v, --verbose              verbose output (default: $SHC_VERBOSE)

SEE ALSO

Section titled “SEE ALSO”
  • shc - Selfhosted Cloud CLI