> ## 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.

# query

<div>
  <h2>Name</h2>

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

  <p style={{ paddingLeft: "7ch" }}>
    Fetch log entries from your project. Supports filtering by time range and custom LogQL queries. Use --follow to stream live logs.
  </p>
</div>

<div>
  <h2>Synopsis</h2>

  <p style={{ paddingLeft: "4ch" }}>
    ```
    nebius logging query [query]
      --bucket
      --follow
      --forward
      --limit
      --project-id
      --since
      --until
    ```
  </p>
</div>

<div>
  <h2>Examples</h2>

  <p style={{ paddingLeft: "4ch" }}>
    **Read error logs from a bucket**

    ```
    $ nebius logging query '{level="error"}' --bucket my-bucket
    ```

    **Search for exact log messages in a bucket for the last 15 minutes**

    ```
    $ nebius logging query '{} |= "OOMKilled"' --bucket my-bucket --since 15m
    ```

    **Stream errors with a specific service\_name label value in real time**

    ```
    $ nebius logging query '{service_name="inference-gateway", level="error"}' --bucket my-bucket --follow
    ```

    **Show a maximum of one thousand logs starting from the oldest for the specified time period in a table with pod and node columns**

    ```
    $ nebius logging query \
        --bucket my-bucket \
        --limit 1000 \
        --forward \
        --since 2d \
        --until 1d \
        --format "table(timestamp,level,message,labels.k8s_pod_name,labels.k8s_node_name)"
    ```
  </p>
</div>

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

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

  <p style={{ paddingLeft: "8ch" }}>
    Filter log entries using LogQL syntax. <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>
      `--follow` (bool)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Stream new log entries as they arrive. Ignores --limit and --forward.
    </p>
  </div>

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

    <p style={{ paddingLeft: "4ch" }}>
      Display logs in chronological order (oldest first). By default, newest logs are shown first.
    </p>
  </div>

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

    <p style={{ paddingLeft: "4ch" }}>
      Maximum number of log entries to return. Default is 100.
    </p>
  </div>

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

    <p style={{ paddingLeft: "4ch" }}>
      Project ID to query logs 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 logs 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 1h.
    </p>
  </div>

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

    <p style={{ paddingLeft: "4ch" }}>
      Show logs 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 20-May-2026</strong>