The open and composable observability and data visualization platform. Visualize metrics, logs, and traces from multiple sources like Prometheus, Loki, Elasticsearch, InfluxDB, Postgres and many more.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
grafana/docs/sources/developers/kinds/composable/tempodataquery/schema-reference.md

7.5 KiB

keywords title
[grafana schema] TempoDataQuery kind

Both documentation generation and kinds schemas are in active development and subject to change without prior notice.

TempoDataQuery

Maturity: experimental

Version: 0.0

It extends DataQuery.

Property Type Required Description
query string Yes TraceQL query or trace ID
refId string Yes (Inherited from DataQuery)
A - Z
datasource No (Inherited from DataQuery)
For mixed data sources the selected datasource is on the query level.
For non mixed scenarios this is undefined.
TODO find a better way to do this ^ that's friendly to schema
TODO this shouldn't be unknown but DataSourceRef | null
hide boolean No (Inherited from DataQuery)
true if query is disabled (ie should not be returned to the dashboard)
key string No (Inherited from DataQuery)
Unique, guid like, string used in explore mode
limit integer No Defines the maximum number of traces that are returned from Tempo
maxDuration string No Define the maximum duration to select traces. Use duration format, for example: 1.2s, 100ms
minDuration string No Define the minimum duration to select traces. Use duration format, for example: 1.2s, 100ms
queryType string No (Inherited from DataQuery)
Specify the query flavor
TODO make this required and give it a default
search string No Logfmt query to filter traces by their tags. Example: http.status_code=200 error=true
serviceMapQuery string No Filters to be included in a PromQL query to select data for the service graph. Example: {client="app",service="app"}
serviceName string No Query traces by service name
spanName string No Query traces by span name

DataQuery

These are the common properties available to all queries in all datasources. Specific implementations will extend this interface, adding the required properties for the given context.

Property Type Required Description
refId string Yes A - Z
datasource No For mixed data sources the selected datasource is on the query level.
For non mixed scenarios this is undefined.
TODO find a better way to do this ^ that's friendly to schema
TODO this shouldn't be unknown but DataSourceRef | null
hide boolean No true if query is disabled (ie should not be returned to the dashboard)
key string No Unique, guid like, string used in explore mode
queryType string No Specify the query flavor
TODO make this required and give it a default