diff --git a/specification/appendix-d-observability.md b/specification/appendix-d-observability.md index 0a35385d..0c2376a4 100644 --- a/specification/appendix-d-observability.md +++ b/specification/appendix-d-observability.md @@ -61,9 +61,9 @@ Telemetry hooks can emit OpenTelemetry signals in three distinct ways: | Pattern | Advantages | Disadvantages | | ---------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| **Span Events**
![recommended](https://img.shields.io/badge/recommended-green) | - Leverages existing trace configuration and tooling
- Minimal overhead, no additional spans created
- Maintains trace context relationships
- Simpler than creating spans | - Requires an active span to function
- Must gracefully handle absence of active span
- Limited to span lifetime and context. | -| **Event Logging** | - Works independently without active spans
- Aligns with OpenTelemetry's emerging direction
- Suitable for environments without tracing
- Simpler implementation model | - Requires an event exporter to be configured
- Processed and stored separately from spans
- Event logging standards still evolving | -| **Standalone Spans** | - Distributed traces contain every evaluation
- Detailed timing information
- Full span lifecycle control | - Creates one span per evaluation
- May clutter trace visualizations
- Increased overhead and resource usage
- Potential performance impact at scale
- More complex implementation | +| **Span Events**
![recommended](https://img.shields.io/badge/recommended-green) | | | +| **Event Logging** | | | +| **Standalone Spans** | | | > [!NOTE] > While span events are recommended for their low overhead and ease of use, OpenTelemetry is trending toward using log-based events instead of span events. Please refer to the [OpenTelemetry Span Event Deprecation Plan][otel-span-event-deprecation-plan] for more details.