Skip to main content
ZStack
Infrastructure/Collects

TailQuery

TailQuery streams live log entries from VictoriaLogs tail.

POST/api/v1/collects/query/tail

Operation ID

TailQuery

Since

1.0.0

Execution Mode

Synchronous

Auth Context

Auth Required

Auth Context

Send these values as request headers when calling this API.

AuthorizationstringRequired

Bearer Token

X-Tenant-IDstring

X-Tenant-ID

Request Inputs

application/json

Body Fields

  • query
    StringRequired

    Log query expression to stream live entries from VictoriaLogs

    Example: level=error AND service=payment

Responses

200 OK
200 OK

On success, this API returns the following response structure.

  • result
    Object

    Result payload streamed by this operation

    • fields
      LinkedHashMap

      Field list to include in the response

      Example: (nested object)

  • error
    Object

    Error details returned when stream processing fails

    • code
      String

      gRPC status code (e.g. NOT_FOUND, INVALID_ARGUMENT)

      Example: UNAUTHENTICATED

    • message
      String

      Human-readable error message

      Example: invalid or missing token