hyperhive/docs/tools/swarm-logs-cli.md
iris 2346bef3b1 docs: gate write-good.Passive on CI
Both blockers are done — #4548 (353 hits in hand-written docs) and
#4549 (46 hits in generated CLI reference docs, hivectl/swarmctl/hive-forge's
own clap help text) — and the previous commit suppresses the reviewed
false-positive remainder. vale --minAlertLevel=error docs now returns
0 errors, matching CI's existing prose-lint-errors job.

Closes #4546.
2026-09-20 16:24:11 +02:00

1.3 KiB

Command-Line Help for swarm-logs

This document contains the help content for the swarm-logs command-line program.

Command Overview:

swarm-logs

query the swarm's log store from an agent

Usage: swarm-logs <COMMAND>

Subcommands:
  • query — Run a LogsQL query and print the matched log lines

swarm-logs query

Run a LogsQL query and print the matched log lines

Usage: swarm-logs query [OPTIONS] <LOGSQL>

Arguments:
  • <LOGSQL> — The LogsQL query. A bare word is a full-text search for it.

    Quote it: LogsQL uses characters the shell also claims, and an unquoted | pipes this command into the rest of your query instead of sending it.

Options:
  • --limit <LIMIT> — Stop after this many records.

    Unset means the store's own default. Worth setting on a broad query — nothing between here and the store narrows one, so a bare word matches across every hive in the swarm.

  • --format <FORMAT> — What to print for each matched record

    Default value: message

    Possible values:

    • message: One log message per line — the _msg field and nothing else
    • json: The store's response body, unmodified, one JSON object per line