Try it free

Convert an LQL matcher to DQL

  • Latest Dynatrace
  • Reference

Convert an LQL matcher to DQL in Dynatrace OpenPipeline API, using the query body field to translate the matcher format.

POSTSaaShttps://{your-environment-id}.apps.dynatrace.com/platform/openpipeline/v1/matcher/lqlToDql

Overview

You send the query in the request body to translate an LQL matcher into DQL. The response returns the converted LQL matcher in DQL format.

Authentication

To execute this request, you need a platform token or OAuth access token with openpipeline:configurations:read scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

ParameterTypeDescriptionInRequired
bodyMatcherRequest

Valid LQL matcher for conversion.

bodyRequired

Request body objects

The MatcherRequest object

ElementTypeDescriptionRequired
querystring

The matcher query to process.

Optional

Request body JSON model

This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request.

{
"query": "log.source=\"snmptraps\" AND snmp.trap_oid=\"F5-BIGIP-COMMON-MIB\""
}

Response

Response codes

CodeTypeDescription
200MatcherRequest

Returns the converted LQL matcher in DQL format.

4XXErrorResponseEnvelope

Client-side error.

5XXErrorResponseEnvelope

Server-side error.

Response body objects

The MatcherRequest object

ElementTypeDescription
querystring

The matcher query to process.

The ErrorResponseEnvelope object

Encloses the encountered error.

ElementTypeDescription
errorErrorResponse

Basic information of the encountered error.

The ErrorResponse object

Basic information of the encountered error.

ElementTypeDescription
codeinteger

The returned HTTP status code.

detailsErrorResponseDetails

Detailed information of the error.

messagestring

Description of the encountered error.

The ErrorResponseDetails object

Detailed information of the error.

ElementTypeDescription
typestring

Defines the actual set of fields depending on the value. See one of the following objects:

  • constraintViolation -> ConstraintViolationDetails
The element can hold these values
  • constraintViolation

Response body JSON models

{
"query": "matchesValue(log.source, \"snmptraps\") and matchesValue(snmp.trap_oid, \"F5-BIGIP-COMMON-MIB\")"
}
{
"error": {
"code": 400,
"message": "Bad request."
}
}

Related topics

  • Conversion to DQL for Logs
Related tags
Platform APIDynatrace Platform