# `mix moqx.inspect`
[🔗](https://github.com/dmorn/moqx/blob/main/lib/mix/tasks/moqx.inspect.ex#L1)

Connects to a relay, loads a catalog when available, lets you choose a track,
then prints live runtime stats (bandwidth, groups/s, objects/s, PRFT latency
when present).

## Usage

    mix moqx.inspect [relay_url] [options]

Examples:

    mix moqx.inspect
    mix moqx.inspect --track 259
    mix moqx.inspect --list-relay-presets
    mix moqx.inspect --choose-relay --list-tracks-only
    mix moqx.inspect --preset cloudflare-draft14-bbb --list-tracks-only
    mix moqx.inspect https://ord.abr.moqtail.dev --namespace moqtail
    mix moqx.inspect https://draft-14.cloudflare.mediaoverquic.com --namespace bbb --catalog-track .catalog --list-tracks-only
    mix moqx.inspect https://draft-14.cloudflare.mediaoverquic.com --namespace bbb --no-fetch --list-tracks-only

Options:

  * `--list-relay-presets` - print known relay presets and example commands.
  * `--choose-relay` - interactively select a known relay preset.
  * `--preset` - apply a known relay preset by id.
  * `--namespace` - catalog/subscription namespace (default: `"moqtail"`).
  * `--catalog-track` - explicit catalog track name. When omitted, `moqx`
    tries `"catalog"` and then `".catalog"`.
  * `--no-fetch` - skip catalog fetch and go directly to live subscribe.
  * `--track` - track name to subscribe to directly (skips interactive prompt).
  * `--list-tracks-only` - load a catalog, print tracks, and exit.
  * `--timeout` - connect/catalog/subscription timeout in ms (default: `10_000`).
    When explicitly provided, it is also used as a max stream runtime;
    when it expires, the task exits cleanly.
  * `--interval-ms` - stats print interval in ms (default: `1_000`).
  * `--delivery-timeout-ms` - passed through to `MOQX.subscribe/4`.
  * `--show-raw` - include full per-track raw catalog maps in listing output.
  * `--help` - prints this help.

---

*Consult [api-reference.md](api-reference.md) for complete listing*