Troubleshooting

Common observability issues and solutions.

E01: No Telemetry

Issue: No data in OpenObserve

Fix:

1. Check collector health: curl localhost:13133
2. Verify OTLP endpoint in SDK
3. Check collector logs: docker logs otel-collector

E02: Missing Semantic Context

Issue: sea.* attributes missing

Fix:

1
2
3
4
resource = Resource.create({
    "sea.platform": "sea-forge",
    "sea.domain": "my-domain"
})

E03: High Cardinality

Issue: Metrics cardinality explosion

Fix:

• Remove high-cardinality labels (user.id, order.id)
• Keep only low-cardinality (domain, concept)

E04: PII in Logs

Issue: Sensitive data in telemetry

Fix: Ensure collector PII processor active:

1
2
3
4
5
processors:
  attributes/pii:
    actions:
      - key: user.email
        action: hash

E05: Traces Not Correlating

Issue: Logs don’t link to traces

Fix:

• Ensure trace context propagation
• Use Logfire for auto-correlation

Last Updated: January 2026