ti fs-journal search-journal-entries

ジャーナルを検索し、必要に応じて一致するエントリを返します。

構文

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]

オプション

• --actor <string>: type:id 形式のアクター。
• --cursor <string>: 前のページで返されたカーソル。続きから取得する場合は、元のリクエストと同じフィルターを繰り返し指定します。
• --entry-type <string>: エントリタイプのフィルター。
• --file-system-id <string>: ファイルシステムを選択します。TI_FS_FILE_SYSTEM_ID を設定することもできます。
• --fs-token <string>: ファイルシステムトークンを設定します。省略した場合、このコマンドは TI_FS_TOKEN 環境変数を使用します。どちらも指定されていない場合、選択したファイルシステム用にローカルに保存されているトークンを使用します。
• --help: ヘルプ情報を表示します。
• --include-entries: 一致結果に完全なエントリペイロードを含めます。
• --journal-kind <string>: ジャーナル種別のフィルター。
• --label <string>: key=value 形式のラベルフィルター。繰り返し指定できます。
• --limit <int32>: 読み取る一致結果の最大数。[default: 100]
• --since <string>: 相対期間（24h など）または RFC3339 タイムスタンプで指定する下限時刻。
• --status <string>: エントリステータスのフィルター。
• --subject <string>: サブジェクトのフィルター。繰り返し指定できます。
• --until <string>: RFC3339 タイムスタンプで指定する上限時刻。相対期間は使用できません。
• --version: バージョン情報を表示します。

すべてのコマンドで共通のオプションについては、グローバルオプション を参照してください。

例

• エントリタイプで検索する場合:

  # 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
  

• ラベルと時刻で検索する場合:

  # 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
  

• アクターとサブジェクトで検索する場合:

  # 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
  

関連ドキュメント

• TiDB Cloud Filesystem Journal CLI コマンドリファレンス