Observability Cheat Sheet

Quick reference for observability.


OTel SDK (Python)

1
2
3
4
5
from opentelemetry import trace
tracer = trace.get_tracer(__name__)

with tracer.start_as_current_span("operation") as span:
    span.set_attribute("sea.concept", "MyOp")

Semantic Attributes

Attribute Description
sea.platform Platform ID
sea.domain Business domain
sea.concept Active concept
sea.correlation_id Business TX ID

Collector Endpoints

Endpoint Port
OTLP gRPC 4317
OTLP HTTP 4318
Health 13133
zPages 55679

Log Queries

1
2
3
4
5
6
7
8
-- Errors in last hour
SELECT * FROM logs WHERE level = 'error'

-- By domain
SELECT * FROM logs WHERE sea_domain = 'governance'

-- By trace
SELECT * FROM logs WHERE trace_id = '...'

Debug Commands

1
2
3
curl http://localhost:13133/          # Health
open http://localhost:55679/debug/tracez  # Traces
docker logs -f otel-collector          # Logs

Last Updated: January 2026