Measure Commands

Every command the measure module offers, from its declarations, in order of the resource each acts on. Each command's help says the same.

Export

lnk measure export set

Send every look to an OTLP endpoint too (an OpenTelemetry collector, Grafana, Honeycomb), or stop: one of --url, --off, or --job

lnk measure export set [--header-file <header-file>] [--job <job>] [--json] [--off] [--url <url>]
  • --header-file, path: A file of headers sent with each look, name: value a line (an API key), or - for standard input; kept only for you to read
  • --job, string: Send one retained job profile to the configured endpoint and wait for its acknowledgement
  • --json, boolean: Print the answer as JSON for other programs
  • --off, boolean: Stop sending looks
  • --url, string: Its OTLP/HTTP address (http://localhost:4318; looks go to <url>/v1/metrics, as JSON)

It answers core.report.

Measure

lnk measure get

Show how often the watcher looks, how long it keeps what it saw, and where else it sends it: yours, and Link's where you set none

lnk measure get [--json]

It takes --json, boolean: Print the answer as JSON for other programs. It answers core.report.

lnk measure list

What your agents and this machine use: memory, CPU, disk, network, tokens, spend

lnk measure list [--agent <agent>] [--job <job>] [--json] [--pid <pid>]
  • --agent, string: One agent, now and over the last day, an hour at a time, by its name (lnk agent list) [default: this machine, as a tree]
  • --job, string: A retained job profile and its child stages, by job ID
  • --json, boolean: Print the answer as JSON for other programs
  • --pid, integer: One process of that agent, by its ID

It answers measure.measured.

lnk measure set

Set how often the watcher looks, and how long it keeps what it saw, then show them all: yours, and Link's where you set none

lnk measure set [--every <every>] [--folders-every <folders-every>] [--folders-max <folders-max>] [--json] [--keep-fine <keep-fine>] [--keep-minutes <keep-minutes>] [--no-processes] [--processes]
  • --every, string: How often it looks (10s, 1m)
  • --folders-every, string: How often each agent's folders are walked for their size (10m)
  • --folders-max, integer: The most entries a walk of an agent's folders counts
  • --json, boolean: Print the answer as JSON for other programs
  • --keep-fine, string: How long every look is kept (12h, 1d)
  • --keep-minutes, string: How long each minute's summary is kept, after (30d)
  • --no-processes, boolean: Keep each agent's processes no more
  • --processes, boolean: Keep each agent's processes too: about seven times the disk

It answers core.report.

lnk measure show

Show this execution's CPU, memory and filesystem capacity, including usable container limits. Missing observations stay unknown.

lnk measure show [--json] [--path <path>]

It takes --json, boolean: Print the answer as JSON for other programs. It takes --path, path: Observe filesystem capacity for this directory (default: the current directory), as well as temporary storage. It answers measure.capacity.

lnk measure start

Keep watching in the background: a look every so often (lnk measure set), kept on this machine

lnk measure start [--json] [--quiet]

It takes --json, boolean: Print the answer as JSON for other programs. It takes --quiet, boolean: Say less, for another of Link's commands running it on the way. It answers core.report.

lnk measure stop

Stop watching in the background; what it kept stays

lnk measure stop [--json]

It takes --json, boolean: Print the answer as JSON for other programs. It answers core.report.