docs: node up logging flags (--log-file / --log-level / --log-json)

Merged
WI
3mo ago
+24-1

What

Documents the new agent-relay node up logging flags that surface a served fleet node's activity — every capability it registers and every action that hits it (invoked → completed/failed, with a duration). Companion to the CLI change in relay#1237.

  • cli-broker-lifecycle.mdx — adds --log-file, --log-level, --log-json to the node up flags table (and notes --verbose raises the node log level to debug), with a pointer to the Nodes page.
  • nodes.mdx — a Watch what a node is doing section: the three invocations, the level each event logs at (capability registration debug, invocations info, failures warn), the structured fields every line carries (node, capability, kind, action, invocationId, ms, error), and example output.

Verification

Both edited files compile cleanly with @mdx-js/mdx; code fences balanced and table escaping matches the existing convention.

Note

The documented flags ship with relay#1237 — merge/release that first (or land together) so the docs match the released CLI.

🤖 Generated with Claude Code

Summary by cubic

Adds docs for new agent-relay node up logging flags to watch node activity, with examples, log levels, JSON output, and event‑specific fields. Clarifies that --verbose raises node logs to debug, and that default info captures actions but not capability registration.

  • New Features - New features added
    • cli-broker-lifecycle.mdx: documents --log-file, --log-level, --log-json; notes --verbose sets node log level to debug; links to Nodes page; notes node is quiet by default.
    • nodes.mdx: adds “Watch what a node is doing” with example commands and output; maps levels (registration debug, invocations info, failures warn); clarifies event‑specific fields (actions: node, action, kind, invocationId, ms, error on failures; registration: node, capability, kind); notes default info omits debug registration lines and how to include them.