Logs

Get one stored log query by its queryId: the question it answered (or the spec's plain-words reading), how it was read, the times it read, the kind of results it returned, and its log query spec. Any queryId a logs.ask answer or logs.executeQuery run returned can be read, runs included. Run it again with logs.executeQuery. An unknown id, or one from another project, is not found.

get/logs/queries/{queryId}

Request

  • Base URL: https://api.sazabi.com/v1
  • URL: https://api.sazabi.com/v1/logs/queries/{queryId}
  • Auth: none declared

Path parameters

queryIdstring uuid required

queryId of a logs.ask answer or a logs.executeQuery run in the project.

Query parameters

projectIdstring uuid

Project the query belongs to. Auto-filled from CLI and SDK context when omitted.

Response

OK

queryIdstring uuid required

queryId of a logs.ask answer or a logs.executeQuery run in the project.

questionstring required

The question as stored, with emails and key-like tokens redacted; for a spec, its plain-words reading.

interpretedAsstring nullable required

How the question was read. Null for a spec.

parentIdstring uuid nullable required

For a run of an earlier query, that query's queryId; null for a question or a spec run directly.

resultsKindstring nullable required

The kind of results it returned (rows, value, distinct, table, messages, series, search). Null when it returned none.

createdAtstring date-time required

When the query was asked or run.

specobject required

The query's log query spec (version 2): which lines (predicate), grouped by what (dimensions), measured how (measure), shaped as what (output). It is the shape logs.executeQuery takes as spec.

Changes