Skip to main content

​
Name

nebius logging query

Fetch log entries from your project. Supports filtering by time range and custom LogQL queries. Use —follow to stream live logs.

​
Synopsis

nebius logging query [query]
  --bucket
  --follow
  --forward
  --limit
  --project-id
  --since
  --until

​
Examples

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)"

​
Positional Arguments

query

Filter log entries using LogQL syntax.
For more information see https://docs.nebius.com/observability/logs/query-language.

​
Options

--bucket (string)

Log bucket to query. If not specified, you will be prompted to choose from available buckets.

--follow (bool)

Stream new log entries as they arrive. Ignores —limit and —forward.

--forward (bool)

Display logs in chronological order (oldest first). By default, newest logs are shown first.

--limit (int)

Maximum number of log entries to return. Default is 100.

--project-id (string)

Project ID to query logs from. Defaults to parent-id from config if not set.

--since (string)

Show logs starting from this time.
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’).
Default is 1h.

--until (string)

Show logs up to this time.
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’).
Default is now.

​
Global Options

-h, --help (bool)

Show this message.

-p, --profile (string)

Set a profile for interacting with the cloud.

--format (string)

Output format. Supported values: yaml|json|jsonpath|table|text.

-f, --file (string)

Input file. For ‘update’ commands automatically set —full=true.

-c, --config (string)

Provide path to config file.

--debug (bool)

Enable debug logs.

--color (bool)

Enable colored output.

--no-browser (bool)

Do not open browser automatically on auth.

--insecure (bool)

Disable transport security.

--auth-timeout (duration: 2h30m10s)

Set the timeout for the request including authentication process, default is 15m0s.

--per-retry-timeout (duration: 2h30m10s)

Set the timeout for each retry attempt, default is 20s.

--retries (uint)

Set the number of retry attempts, 1 is disable retries, default is 3.

--timeout (duration: 2h30m10s)

Set the timeout for the main request, default is 1m0s.

--no-check-update (bool)

Suppress check for updates.