Skip to content

flow logs

View execution history and logs.

Synopsis

View execution history recorded in the data store, with associated log output. Optionally filter by executable reference.

flow logs [ref] [flags]

Examples


  flow logs                          # all history
  flow logs --last                   # most recent entry with full output
  flow logs --status failed   # only failed runs
  flow logs run build                # history for 'run build' executable
  flow logs --running                # list active background processes

Options

  -h, --help               help for logs
      --last               Print the last execution's logs
      --limit int          Maximum number of records to display.
  -o, --output string      Output format. One of: yaml, json, or tui.
      --running            Show only active background processes.
      --since string       Filter history to entries after a duration (e.g. 1h, 30m, 7d).
      --status string      Filter history by status (success or failure).
  -w, --workspace string   Filter history by workspace name.

Options inherited from parent commands

  -L, --log-level string   Log verbosity level (debug, info, fatal) (default "info")
      --sync               Sync flow cache and workspaces

SEE ALSO

  • flow - flow is a command line interface designed to make managing and running development workflows easier.
  • flow logs attach - Stream log output from a running background process by run ID.
  • flow logs clear - Clear execution history and logs.
  • flow logs kill - Terminate a running background process by run ID.