Cloudera Docs

Telemetry data exposed to OTel collector for Impala

OpenTelemetry (OTel) provides an open-source solution for collecting, processing, and exporting telemetry data. In Impala, query lifecycle data is structured as OTel traces, with a root span and multiple child spans. The following tables detail the attributes and events associated with these traces.

Root Span of the Trace

The root span represents the entire query and is of kind SERVER.

Metrics Type Description Example
ClusterId String A string that uniquely identifies a cluster, determined by the value of the --cluster_id startup flag. impala-1982661901-6j1z
EndTime Millisecond epoch time The time when the query finished in millisecond epoch time. 1743474118301
ErrorMessage String A string containing the error message received from the query execution, or an empty string if the query completed successfully. Invalid syntax
OriginalQueryId String When a query is retried, a string containing the Impala query ID of the original query. Otherwise, an empty string. ef403b2690d243be:b960c0ba00000000
QueryId String The Impala query ID. ef403b2690d243be:b960c0ba00000000
QueryStartTime Millisecond epoch time The time when the query was first received in millisecond epoch time. 1743473803667
RequestPool String A string containing the name of the request pool the query will be scheduled into. default-pool
RetriedQueryId String The ID of the query that successfully retried this query. 3a43a57ad0bf36df:dcd698b700000000
Runtime Milliseconds The time in milliseconds the query ran. 5231
SessionId String The Impala session ID. 024f45f3e0019fed:eb0fe00c00000000
State String The query state. FINISHED, EXCEPTION, or RETRIED
QueryType String The type of the statement in uppercase letters, such as QUERY, DML, or DDL. DML
UserName String The user who submitted the query. usr123

Child spans

Child spans are of kind INTERNAL and contain both global and specific attributes and events.

Global child span attributes
The global child span attributes are present on every child span.
Metrics Type Description Example
BeginTime Millisecond epoch time The time the span started in millisecond epoch time. 1743473803667
ElapsedTime Millisecond The time in milliseconds the span ran. 5231
EndTime Millisecond epoch time The time the span finished in millisecond epoch time. 1743474118301
ErrorMsg String Error details if a failure occurred during this span. Could not read file
Name String The name of the span, in the {{query_id}} - Query Stage format. cdf601fa776431c43:5e59cba4fe284ae22 - Submitted
Running Boolean A boolean value indicating if the query is actively running and not in planning, admission control, or closing. It is set to false if the query fails during this span. true
Status String The status of the task, for example, OK. OK
Specific child span attributes
The following table lists the additional attributes for the Init span, which are unique to that stage of the query lifecycle.
Metrics Type Description Example
ClusterId String A string that uniquely identifies a cluster, determined by the value of the --cluster_id startup flag. impala-1982661901-6j1z
DefaultDb String The name of the default database. tpcds
Name String The name of the span, in the {{query_id}} - Init format. cdf601fa776431c43:5e59cba4fe284ae22 - Init
OriginalQueryId String The Impala query ID of the original query when retried. Otherwise, an empty string. ef403b2690d243be:b960c0ba00000000
QueryId String The Impala query ID. ef403b2690d243be:b960c0ba00000000
QueryString String The redacted string containing the SQL statement. select * from db.tbl where col1 = “val1”
RequestPool String A string containing the name of the request pool the query will be scheduled into. default-pool
SessionId String The Impala session ID. 024f45f3e0019fed:eb0fe00c00000000
UserName String The user who submitted the query. usr123

Query Submitted

Metrics Type Description Example
Name String The name of the span, in the {{query_id}} - Init format. cdf601fa776431c43:5e59cba4fe284ae22 - Submitted

Span: Planning

Metrics Type Description Example
Name String The name of the span, in the {{query_id}} - Init format. cdf601fa776431c43:5e59cba4fe284ae22 - Planning
QueryType String The type of the statement in uppercase letters, such as QUERY, DML, or DDL. DML, QUERY

Admission control

Metrics Type Description Example
Name String The name of the span, in the {{query_id}} - AdmissionControl format. cdf601fa776431c43:5e59cba4fe284ae22 - AdmissionControl
AdmissionResult String A string containing the result from admission control. Admitted immediately
Queued Boolean A boolean value where true indicates that the query was queued and false indicates that the query was admitted immediately. false
RequestPool String A string containing the name of the request pool the query will be scheduled into. default-pool

Query execution

Metrics Type Description Example
Name String The name of the span, in the {{query_id}} - Execution format. cdf601fa776431c43:5e59cba4fe284ae22 - Execution
NumDeletedRows Integer An integer containing the total number of rows deleted by the DML statement. 0
NumModifiedRows Integer An integer containing the total number of rows modified by the DML statement. 0
NumRowsFetched Integer An integer containing the total number of rows fetched by the client. 5132

Close

Metrics Type Description Example
Name String The name of the span, in the {{query_id}} - Close format. cdf601fa776431c43:5e59cba4fe284ae22 - Close