Skip to content

Capture sources

The Extractor can run four source families at once. SQL Server and PostgreSQL observations exclude row values, and HTTP observations exclude request and response bodies. Capture output can still contain query strings, identifiers, names, and explicitly allowlisted OpenTelemetry attribute values. See Why Prologue for the complete boundary.

Enabled byAdding an entry to prologue.sqlServer[]
MechanismChange Data Capture. The Extractor enables CDC on the database itself — no manual setup needed unless you set enableChangeDataCapture: false
CapturesWhich tables and columns changed, per transaction
Never capturesRow values
Configname, connectionString, enableChangeDataCapture, tables (allowlist), pollIntervalMilliseconds — see Configuration
Enabled byAdding an entry to prologue.postgres[]
MechanismLogical replication. The Extractor creates its own replication slot and publication on the configured database — the server just needs wal_level = logical
CapturesWhich tables and columns changed, per transaction
Never capturesRow values
Configname, connectionString, slot, publication — see Configuration
Enabled byAdding a reverseProxy section — the Extractor becomes a YARP reverse proxy in front of your system
MechanismEvery request that reaches the proxy passes through to your system unchanged; state-changing requests are also captured
CapturesMethod, path including query string, response status, and the W3C traceparent trace id if present, for POST, PUT, and DELETE requests only
Never capturesGET/read traffic, request or response bodies
ConfigPlain YARP routes/clusters configuration — see Configuration
Enabled byprologue.openTelemetry.enabled: true
MechanismAn OTLP proxy (HTTP and gRPC). Telemetry is captured, then forwarded on to upstream.http/upstream.grpc unchanged — or nowhere, if you leave both empty, making the Extractor a terminal collector
CapturesSpan, metric, and log names and identifiers; every observed attribute key; values only for configured attributeKeys; service names matching serviceNames, or all services when empty
Never capturesLog bodies, metric measurements, or values for attributes not in attributeKeys
Configenabled, serviceNames, attributeKeys, upstream.http, upstream.grpc — see Configuration

Any source family can run alone. When several are enabled, the correlator uses the correlation window and trace identifiers where available to associate currently unclaimed observations. The association is provisional: database transactions do not carry trace identifiers in the current contract and therefore correlate with HTTP commands by time.