hyperhive/docs/tools/swarm-logs-cli.md
atlas 42dcf10064 swarm-logs-cli.md: regenerate from the binary, prettierignore it
The committed doc was stale (missing help text under --limit/--format
that the binary's clap-markdown output now includes). Regenerated with
the documented command. While at it: docs/tools/swarm-logs-cli.md was
never added to .prettierignore alongside its three siblings, so nix fmt
silently reformatted it back to a stale layout right after
regeneration — the exact failure mode .prettierignore's own comment
warns about. Added it so the *-docs-fresh check in nix/checks.nix stays
satisfiable.
2026-09-17 01:02:14 +02:00

1.5 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

This document was generated automatically by clap-markdown.