Docs
Logs

Query your clusters' logs

GET
/v1/logs/select/logsql/query

Returns the log records that match a LogsQL query, newest first, as VictoriaLogs' /select/logsql/query does: one JSON object per line. At most limit records, 1000 by default and 10000 at most. A query that does not parse returns 400 invalid_request with a violation of query.

Authorization

headerAuthorizationBearer <cc_...>

An API key of your org, sent as Authorization: Bearer cc_.... Keys start with cc_ and are otherwise opaque. Treat a key as a password: anyone holding it can act with its scopes until it expires or is revoked. Each operation's security requirement lists the scopes it needs; an empty list means any valid key. The MCP server at /mcp accepts agent keys and no other kind.

Scope: clusters:read

Query Parameters

query*string

A LogsQL query, such as {cluster="cl-7k2m9q4x1bfa0c3d"} error. * matches every record.

Length1 <= length <= 4096
start?string

The start of the range: an RFC 3339 time, Unix seconds, milliseconds or nanoseconds, or a duration before now such as 1h. The first record kept when absent.

Length1 <= length <= 40
end?string

The end of the range, as start takes it. Now when absent.

Length1 <= length <= 40
limit?integer

The most records to return. 1000 when absent or 0, and at most 10000: a larger limit returns 10000.

Range0 <= value
extra_filters?array<>

LogsQL filters that every record must also match, as Grafana's ad hoc filters send them.

Items1 <= items <= 10
extra_stream_filters?array<>

LogsQL stream filters that every record's stream must also match.

Items1 <= items <= 10

Header Parameters

Api-Version*string

The API version the request is written against. This document describes 2026-10-15. A missing header returns 400 api_version_required, and a version the API does not serve returns 400 unsupported_api_version.

X-Correlation-ID?string

An id of your own for this request, or for a group of requests, to find them in our logs and yours. Logged with the request and returned unchanged in X-Correlation-ID. The request id itself is always the API's own, in X-Request-ID.

Match^[A-Za-z0-9._:-]+$
Length1 <= length <= 128
Org-Context?string

Admin keys only: the id of the org to act in. Required with an admin key, together with Access-Reason; with any other credential it returns 400 invalid_request. Every request that carries it is recorded in that org's operator-access log.

Match^org-[a-z0-9]([-a-z0-9]*[a-z0-9])?$
Length5 <= length <= 63
Access-Reason?string

Admin keys only: why the operator is acting in the org, such as a support ticket. Required with Org-Context. Recorded, verbatim, in the org's operator-access log.

Match^[^\x00-\x1F\x7F]+$
Length10 <= length <= 500

Response Body

The matching records, newest first, one JSON object per line, as VictoriaLogs returns them. No record at all is an empty body.

application/stream+json
  1. response

One log record, as VictoriaLogs returns it. Ignore fields you do not know.

_time*string

When the line was written, in RFC 3339.

_msg*string

The line.

_stream?string

The record's stream fields as a stream filter.

_stream_id?string

The stream's id.

cluster?string

The cluster's id.

component?string

The control-plane container that wrote the line, or audit for an API server's audit event. Open set; accept values not listed.

management?string

The management cell that runs the cluster's control plane.

project?string

The cluster's project's id.

pod?string

The control-plane pod that wrote the line.

stream?string

stdout or stderr. Open set; accept values not listed.

Example Request
curl -X GET 'https://api.cloud.confidential.ai/v1/logs/select/logsql/query?query=%7Bcomponent%3D%22kube-apiserver%22%7D+error&start=2026-10-22T16%3A00%3A00Z&end=2026-10-22T17%3A00%3A00Z&limit=1000&extra_filters=component%3Aetcd&extra_stream_filters=%7Bcomponent%3D%22etcd%22%7D' \  -H 'Api-Version: 2026-10-15' \  -H 'X-Correlation-ID: rollout-2026-10-22' \  -H 'Access-Reason: Support ticket 4821: customer asked why i-6d3f9h2k8mzr failed'
Example Response
{  "_time": "2026-10-22T16:59:58.123Z",  "_msg": "E1022 16:59:58.123456       1 status.go:71] \"Unhandled Error\" err=\"etcdserver: request timed out\"",  "_stream": "{cluster=\"cl-7k2m9q4x1bfa0c3d\",component=\"kube-apiserver\",management=\"prod-rancher\",project=\"p-4q8m2x7c1d\"}",  "_stream_id": "000003e800000000927c6f841a8821a5b23d9d0dee880d6f",  "cluster": "cl-7k2m9q4x1bfa0c3d",  "component": "kube-apiserver",  "management": "prod-rancher",  "project": "p-4q8m2x7c1d",  "pod": "kube-apiserver-cl-7k2m9q4x1bfa0c3d-5d8f7c9b6-x2k4p",  "stream": "stderr"}