Generator for 128-bit trace IDs with embedded metadata. More...
#include <trace_id_generator.hpp>
Collaboration diagram for trace_id_generator:
Public Member Functions | |
| trace_id_generator () | |
| Constructs the generator with locally derived machine ID. | |
| trace_id_generator (std::uint16_t machine_id) | |
| Constructs the generator with an explicit machine ID. | |
| domain::trace_id | operator() () |
| Generates a new trace_id. | |
| std::uint16_t | machine_id () const |
| Gets the machine ID being used by this generator. | |
Detailed Description
Generator for 128-bit trace IDs with embedded metadata.
The generated trace_id has the following structure:
- Bytes 0-5 (48 bits): Timestamp in milliseconds since Unix epoch
- Bytes 6-7 (16 bits): Machine identifier (locally derived hash)
- Bytes 8-15 (64 bits): Random component for uniqueness
This structure provides:
- Time-sortability (traces can be ordered by creation time)
- Machine identification (for debugging in distributed systems)
- High uniqueness (64-bit random + timestamp + machine = very low collision)
- OpenTelemetry compatibility (128-bit size)
Constructor & Destructor Documentation
◆ trace_id_generator() [1/2]
Constructs the generator with locally derived machine ID.
The machine ID is derived from system properties (hostname, MAC address) and remains constant for the lifetime of the process.
◆ trace_id_generator() [2/2]
|
explicit |
Constructs the generator with an explicit machine ID.
- Parameters
-
machine_id The 16-bit machine identifier.
Member Function Documentation
◆ operator()()
| domain::trace_id operator() | ( | ) |
Generates a new trace_id.
Thread-safe: Multiple threads can call this concurrently.
- Returns
- A unique trace_id with embedded timestamp and machine ID.
