POST /v1/tracing/tracequery

Execute a trace search query and get the id to fetch its status and results. Use the Trace Query Status endpoint to check a query status. When the query has been completed, use the Trace Query Result endpoint to get the result of the asynchronous query.

Servers

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Request body fields

Name Type Required Description
queryRows[] Array Yes

A list of trace queries.

queryRows[].rowId String Yes

An identifier used to reference this particular row of the query request while fetching a query result. Within a query, row ids must have distinct values.

queryRows[].query Object Yes

Base query expression object.

queryRows[].query.type String Yes

Expression type of the object model.

queryRows[].orderBy Object No
queryRows[].orderBy.order String Yes

Type of sorting values - descending or ascending.

Default value: "Desc"

queryRows[].orderBy.fieldName String Yes

Field based on which results should be sorted. When not provided, the default behavior is to sort by timestamp descending. Sortable fields values: trace_id, start_timestamp, duration, spans_number, errors, status_code.

timeRange Object Yes
timeRange.type String Yes

Type of the time range. Value must be either CompleteLiteralTimeRange or BeginBoundedTimeRange.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.