Query Correlation ID
How Pinot assigns and reuses query correlation IDs.
Last updated
Was this helpful?
⌘Ctrlk
How Pinot assigns and reuses query correlation IDs.
Every Pinot query gets a correlation ID so you can track it through broker and server logs.
Pinot assigns a correlation ID automatically when the broker receives a query. That ID is included in the logging context and can be used to follow the query through the cluster.
If your client already has a request identifier, set clientQueryId so Pinot uses it as the correlation ID.
SET clientQueryId = 'query-2026-03-24-001';
SELECT * FROM stores LIMIT 10;Use a high-entropy value such as a UUID when you provide your own ID.
Correlation IDs are most useful when you need to:
search logs for a single request
cancel a query later
connect application tracing with Pinot query execution
This page covered how Pinot assigns query correlation IDs, how to provide a custom one, and why the ID matters operationally.
If you need to stop a running query, read Query cancellation.
Last updated
Was this helpful?
Was this helpful?