Correlation ID
Pronunciation: kor-uh-LAY-shun eye-DEE
Also known as: Request Correlation Identifier, Correlation Identifier
Definition
Correlation ID is an identifier propagated across related requests, messages, logs, and services so operators can reconstruct one distributed business or technical flow. It groups related work, while a request ID identifies one request and a trace ID usually follows a formal distributed-tracing context.
Overview
Meaning and scope
Correlation ID is an identifier propagated across related requests, messages, logs, and services so operators can reconstruct one distributed business or technical flow. It groups related work, while a request ID identifies one request and a trace ID usually follows a formal distributed-tracing context.
Mechanism and operation
Evidence for Correlation ID should preserve the input, configuration version, actor or service, decision, downstream reference, and final outcome. A production implementation should generate or validate it at a trusted boundary, propagate it consistently, avoid embedding sensitive data, index it in logs, and distinguish external values from internal identifiers. The production boundary for Correlation ID should identify the authoritative system, responsible owner, accepted states, and recovery path. Useful measures include propagation coverage, orphan-log rate, invalid identifiers, investigations completed with one identifier, and services dropping correlation context. Testing Correlation ID should cover boundary values, dependency failure, restart recovery, and incompatible versions where they affect the workflow.
Practical payment example
A customer disputes a payment; support traces the same correlation identifier through invoice creation, callback processing and order fulfillment logs.
Operational checks
Operational metrics for Correlation ID should use stable denominators and separate technical activity from successful business completion. For Correlation ID, identifiers and timestamps should remain stable enough to trace the technical action to its final business outcome. Monitoring for Correlation ID should distinguish transport success, processing success, and the final external or financial result.
Distinctions and limits
The principal risks include identifier collisions, attacker-controlled log injection, missing propagation, accidental use as an authorization key, inconsistent formats, and correlation gaps across asynchronous events. Changes to Correlation ID should be tested against normal, failed, delayed, duplicate, and recovery paths that apply to the operation.
Related reading
Related definitions: Payment Trace ID, Webhook Event Log.
Example
A customer disputes a payment; support traces the same correlation identifier through invoice creation, callback processing and order fulfillment logs.
Comparison
The principal risks include identifier collisions, attacker-controlled log injection, missing propagation, accidental use as an authorization key, inconsistent formats, and correlation gaps across asynchronous events.
Key Takeaway
Generate or validate it at a trusted boundary, propagate it consistently, avoid embedding sensitive data, index it in logs, and distinguish external values from internal identifiers.
Sources
- Trace Context — World Wide Web Consortium (2026-08-03)
- CloudEvents Specification — Cloud Native Computing Foundation (2026-08-03)
- OpenAPI Specification — OpenAPI Initiative (2026-08-03)