Skip to content
SHC Docs

shc events ls

list the most recent events (alias for bare shc events)

shc events ls [flags]
-h, --help help for ls
--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
--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: "prod", or "default" on an estate with no licence and no trial; $SHC_ENVIRONMENT and shc ctx -e override it, and the "master" tenant is always "default")
--event string filter by event code
--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)
-f, --follow stream live events until interrupted (this form does not terminate); with --audit: poll for new records every 3s
-n, --limit int maximum records to show (listing and --audit; ignored with --follow) (default 100)
--node string filter by node: its name or ID
-o, --output string output format: tty|text|json|yaml (default: $SHC_OUTPUT)
-q, --quiet hide noisy healthcheck events
--since string with --follow: replay from sequence id; with --audit: start date (YYYY-MM-DD or RFC 3339)
-s, --stack string stack name (default: $SHC_STACK)
-t, --tenant string tenant name (default: $SHC_TENANT)
-T, --type string event types, comma-separated, or all; --event without -T reads every type (default "docker,audit,placement_bind,placement_move,placement_move_cleared,placement_retire")
--until string with --audit: end date (YYYY-MM-DD or RFC 3339)
-v, --verbose verbose output (default: $SHC_VERBOSE)
  • shc events - list recent system events; -f follows them live