Skip to main content
← Back to list
01Issue
FeatureShippedSwamp Club
Assigneesstack72

Relationships

#1162 Docs: document the OTel logs signal in the swamp-club manual (opentelemetry.md)

Opened by stack72 · 7/15/2026· Shipped 7/15/2026

Follow-up to #1158 (OTel logs signal). The user-facing manual at swamp-club/swamp-club:content/manual/reference/opentelemetry.md is trace-only and needs a Logs section. Filed here because issues are disabled on the swamp-club/swamp-club repo.

What shipped in #1158

  • Structured log lines are exported as native OTLP log records, gated by the same OTEL_EXPORTER_OTLP_* config as traces.
  • Each record carries the active trace_id/span_id (correlated with spans).
  • Run secrets are redacted from log bodies/attributes before export.
  • Covers swamp serve and worker subprocesses (via propagated TRACEPARENT).

Manual updates needed

  1. A Logs signal section (OTLP log export, correlation, redaction; logs POST to /v1/logs).
  2. Config table rows:
    • OTEL_LOGS_EXPORTERotlp, console (stderr), or none; default otlp.
    • OTEL_BLRP_USE1 to batch log exports for long-running swamp serve; default per-record.
  3. SDK-lifecycle note: logs flow through a LoggerProvider + fetch-based OTLP log exporter, flushed on shutdown.

The in-repo README.md and troubleshooting skill reference were already updated in the #1158 PR.


Automoved by swampadmin from https://github.com/swamp-club/swamp/issues/1857

02Bog Flow
OPENTRIAGEDIN PROGRESSSHIPPED+ 1 MOREASSIGNED+ 2 MOREREVIEW+ 3 MOREPR_MERGED+ 1 MORENOTIFICATION_SKIPPED

Shipped

7/15/2026, 11:47:31 PM

Click a lifecycle step above to view its details.

03Sludge Pulse
stack72 assigned stack727/15/2026, 11:25:08 PM

Sign in to post a ripple.