ti fs-journal search-journal-entries

Searches journals and optionally returns matching entries.

Syntax

ti fs-journal search-journal-entries
  [--actor <string>]
  [--cursor <string>]
  [--entry-type <string>]
  [--file-system-id <string>]
  [--fs-token <string>]
  [--help]
  [--include-entries]
  [--journal-kind <string>]
  [--label <string>]
  [--limit <int32>]
  [--since <string>]
  [--status <string>]
  [--subject <string>]
  [--until <string>]
  [--version]

Options

• --actor <string>: Actor in the form type:id.
• --cursor <string>: Pagination cursor.
• --entry-type <string>: Entry type filter.
• --file-system-id <string>: Select the file system. You can also set TI_FS_FILE_SYSTEM_ID.
• --fs-token <string>: Set the file system user token. If omitted, uses TI_FS_TOKEN.
• --help: Display help information.
• --include-entries: Include full entry payloads in matches.
• --journal-kind <string>: Journal kind filter.
• --label <string>: Label filter key=value; repeatable.
• --limit <int32>: Maximum matches to read. [default: 100]
• --since <string>: Relative duration or RFC3339 lower time bound.
• --status <string>: Entry status filter.
• --subject <string>: Subject filter; repeatable.
• --until <string>: RFC3339 upper time bound.
• --version: Display version information.

For options shared by all commands, see Global options.

Examples

• Search by entry type:

  # Find journals containing task-start events and include their payloads.
  ti fs-journal search-journal-entries --file-system-id <file-system-id> --entry-type task.started --include-entries
  

• Search by label and time:

  # Limit deployment journal matches to one environment and time window.
  ti fs-journal search-journal-entries --file-system-id <file-system-id> --label env=dev --since 2026-07-01T00:00:00Z --limit 100
  

• Search by actor and subject:

  # Find events produced by one agent for a specific task subject.
  ti fs-journal search-journal-entries --file-system-id <file-system-id> --actor agent:ti --subject issue-42 --include-entries
  

Related documentation

• TiDB Cloud Filesystem Journal CLI Command Reference