> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nebius.com/llms.txt
> Use this file to discover all available pages before exploring further.

# metrics

<div>
  <h2>Name</h2>

  <p style={{ paddingLeft: "4ch" }}>
    <code>nebius logging metrics</code>
  </p>

  <p style={{ paddingLeft: "7ch" }}>
    Execute a LogQL metric query and display results as time series, vectors, or scalars.
  </p>
</div>

<div>
  <h2>Synopsis</h2>

  <p style={{ paddingLeft: "4ch" }}>
    ```
    nebius logging metrics <query>
      --bucket
      --instant
      --project-id
      --since
      --step
      --until
    ```
  </p>
</div>

<div>
  <h2>Examples</h2>

  <p style={{ paddingLeft: "4ch" }}>
    **Error rate**

    ```
    $ nebius logging metrics 'rate({level="error"}[15m])' --bucket my-bucket
    ```

    **Top 5 pods by log volume over the last hour**

    ```
    $ nebius logging metrics 'topk(5, rate({}[5m])) by (k8s_pod_name)' --bucket my-bucket --since 1h
    ```

    **Count log lines per level**

    ```
    $ nebius logging metrics 'sum by (level)(count_over_time({}[5m]))' --bucket my-bucket --step 5m
    ```

    **Instant query: log count by level**

    ```
    $ nebius logging metrics 'sum by (level)(count_over_time({}[1h]))' --bucket my-bucket --instant
    ```

    **Log count per pod as a table**

    ```
    $ nebius logging metrics 'sum by (k8s_pod_name)(count_over_time({}[5m]))' --bucket my-bucket --step 5m --format table
    ```
  </p>
</div>

<div>
  <h2>Positional Arguments</h2>

  <p style={{ paddingLeft: "4ch" }}>
    <code>query</code>
  </p>

  <p style={{ paddingLeft: "8ch" }}>
    LogQL metric query using aggregation functions (rate, count\_over\_time, sum, topk, etc.).<br />
    For more information see [https://docs.nebius.com/observability/logs/query-language](https://docs.nebius.com/observability/logs/query-language).
  </p>
</div>

<div>
  <h2>Options</h2>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--bucket` (string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Log bucket to query. If not specified, you will be prompted to choose from available buckets.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--instant` (bool)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Evaluate query at a single point in time (--until or now).
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--project-id` (string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Project ID to query metrics from. Defaults to parent-id from config if not set.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--since` (string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Show metrics starting from this time.<br />
      Accepts a duration (7d, 2h, 30m, 10s, 100ms, 1d12h30m, now) of time before now or a timestamp in various formats: ('2006-01-02T15:04:05.999Z', '2006-01-02T15:04:05Z', '2006-01-02 15:04:05', '2006-01-02').<br />
      Default is 24h.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--step` (string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Resolution step width (e.g., '5m', '1h'). Default is auto-calculated to \~100 points.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--until` (string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Show metrics up to this time.<br />
      Accepts a duration (7d, 2h, 30m, 10s, 100ms, 1d12h30m, now) of time before now or a timestamp in various formats: ('2006-01-02T15:04:05.999Z', '2006-01-02T15:04:05Z', '2006-01-02 15:04:05', '2006-01-02').<br />
      Default is now.
    </p>
  </div>
</div>

<div>
  <h2>Global Options</h2>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `-h, --help` (bool)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Show this message.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `-p, --profile` (string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Set a profile for interacting with the cloud.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--format` (string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Output format. Supported values: yaml|json|jsonpath|table|text.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `-f, --file` (string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Input file. For 'update' commands automatically set --full=true.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `-c, --config` (string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Provide path to config file.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--debug` (bool)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Enable debug logs.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--color` (bool)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Enable colored output.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--no-browser` (bool)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Do not open browser automatically on auth.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--insecure` (bool)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Disable transport security.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--auth-timeout` (duration: 2h30m10s)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Set the timeout for the request including authentication process, default is 15m0s.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--per-retry-timeout` (duration: 2h30m10s)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Set the timeout for each retry attempt, default is 20s.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--retries` (uint)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Set the number of retry attempts, 1 is disable retries, default is 3.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--timeout` (duration: 2h30m10s)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Set the timeout for the main request, default is 1m0s.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--no-check-update` (bool)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Suppress check for updates.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--no-progress` (bool)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Suppress progress indicators and spinners.
    </p>
  </div>
</div>

<strong>Auto generated on 7-May-2026</strong>