Skip to main content

miren runner query

Query a runner's live host activity and print the JSON result

Observe what is happening right now or during the query window, never historical data. Use --reference to print query syntax and Miren source fields without connecting to a cluster.

Usage​

miren runner query [node] [expression] [flags]

Arguments​

  • node — Runner to query (name, ID, or short ID)
  • expression — Live host query expression (not SQL); quote expressions containing spaces

Flags​

  • --cluster, -C — Cluster name
  • --config — Path to the config file
  • --reference — Print the offline query syntax and source reference

Global Options​

  • --options — Path to file containing options
  • --server-address — Server address to connect to (default: 127.0.0.1:8443)
  • --verbose, -v — Enable verbose output

Examples​

Show the offline query reference:

miren runner query --reference

Inspect runner memory:

miren runner query my-runner memory

Sample memory usage over ten seconds:

miren runner query my-runner "memory avg(used) over 10s every 1s"

See also​