Count your clusters' log records over time
Counts the records that match a LogsQL query in each step from
start to end, grouped by the fields field names, as VictoriaLogs'
/select/logsql/hits does. Grafana draws its log volume from it.
AuthorizationBearer <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*stringA LogsQL query, such as {cluster="cl-7k2m9q4x1bfa0c3d"} error. * matches every record.
1 <= length <= 4096start?stringThe 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.
1 <= length <= 40end?stringThe end of the range, as start takes it. Now when absent.
1 <= length <= 40step*stringThe time between points, as a duration such as 1m or 1h.
1 <= length <= 20offset?stringHow far to move each step's boundaries, as a duration, such as your time zone's offset from UTC.
1 <= length <= 20field?array<>Fields to group the counts by, each group counted apart.
1 <= items <= 10fields_limit?integerThe most groups to return, those with the most records first; 0 for every group.
0 <= valueextra_filters?array<>LogsQL filters that every record must also match, as Grafana's ad hoc filters send them.
1 <= items <= 10extra_stream_filters?array<>LogsQL stream filters that every record's stream must also match.
1 <= items <= 10Api-Version*stringThe 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?stringAn 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.
^[A-Za-z0-9._:-]+$1 <= length <= 128Org-Context?stringAdmin 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.
^org-[a-z0-9]([-a-z0-9]*[a-z0-9])?$5 <= length <= 63Access-Reason?stringAdmin 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.
^[^\x00-\x1F\x7F]+$10 <= length <= 500The number of matching records in each step, as VictoriaLogs returns them.
application/json- response
VictoriaLogs' record counts. Ignore fields you do not know.
hits*array<>One entry per group of the field values, or one for every record without field.
curl -X GET 'https://api.cloud.confidential.ai/v1/logs/select/logsql/hits?query=%7Bcomponent%3D%22kube-apiserver%22%7D+error&start=2026-10-22T16%3A00%3A00Z&end=2026-10-22T17%3A00%3A00Z&step=5m&offset=1h&field=component&fields_limit=10&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'{ "hits": [ { "fields": { "component": "kube-apiserver" }, "timestamps": [ "2026-10-22T16:50:00Z", "2026-10-22T16:55:00Z" ], "values": [ 412, 380 ], "total": 792 }, { "fields": { "component": "etcd" }, "timestamps": [ "2026-10-22T16:50:00Z", "2026-10-22T16:55:00Z" ], "values": [ 25, 31 ], "total": 56 } ]}Query your clusters' logs GET
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`.
List the fields of your clusters' log records GET
Lists the field names of the records that match a LogsQL query, with how many records have each, as VictoriaLogs' `/select/logsql/field_names` does. Query editors such as Grafana's call it.