Skip to content

yasp-toolkit activity

Review what your jobs have been doing: every service publishes lifecycle events (created, update, completed, cancelled, failed) as work progresses, keyed by correlation id and task id.

The activity host defaults to https://compile.yasp.ai/activity and can be overridden with the --activity-* flags shown in --help.

Usage:

$ yasp-toolkit activity [OPTIONS] COMMAND [ARGS]...

Options: * --help: Show this message and exit.

Commands:

  • list: List activity events, newest first.

yasp-toolkit activity list

List activity events, newest first.

Follows the server's cursor pagination until --limit events are collected, an event falls outside --max-age, or the pages run out.

Usage:

$ yasp-toolkit activity list [OPTIONS]
Option Default Description
-c, --correlation-id <str> Only events for this correlation id.
-e, --expand-correlation <str> Look up the correlation id of this task id, then list every event sharing it.
--task-id <str> Only events attached to this task id.
--payload-type <str> Only events with this payload type.
--event-type <str> Only events with this lifecycle type (created, update, completed, cancelled, failed).
--show <str> Extra column to include in the table; repeatable. One of: correlation-id.
--task-ids Print only the distinct task ids, one per line (newest first) — for piping into other commands.
--limit <int range> 1000; x>=1 Stop after this many events.
--max-age <str> 7d Skip events older than this. <number><unit> with unit s/m/h/d/w (e.g. 30m, 12h, 7d).

Each row shows the event's date (UTC), payload type, status, description, and task id — plus any extra columns requested via --show (e.g. --show correlation-id). A dim footer notes when the walk stopped early (--limit reached or events older than --max-age skipped).