Observability: optional OTLP/OpenObserve instrumentation hooks #10

New issue

Open

opened 2026-08-26 07:48:54 +00:00 by lost-rob0t · 0 comments

lost-rob0t commented

2026-08-26 07:48:54 +00:00

(Migrated from github.com)

Coordinate with https://github.com/lost-rob0t/starintel-server/issues/128.

Add provider-neutral instrumentation hooks for the Nim StarIntel document/schema implementation without making this library a mandatory network client.

Instrumentation is activated only by the host application's init/config.
Default/no context means no exporter and no outbound traffic.
Expose safe spans/events/metrics for validation, parse/encode/decode, schema/version errors, and performance where useful.
Host owns OTLP/OpenObserve exporter and credentials.
Never export document field values/bodies by default; schema/type/size/outcome metadata only.
Instrumentation failures cannot change validation or serialization results.
Tests prove disabled behavior equivalence and no network effects.
Add host integration example for generic OTLP/OpenObserve.

Docs: https://openobserve.ai/docs/ingestion/

No product telemetry in this issue.

Coordinate with https://github.com/lost-rob0t/starintel-server/issues/128. Add provider-neutral instrumentation hooks for the Nim StarIntel document/schema implementation without making this library a mandatory network client. - [ ] Instrumentation is activated only by the host application's init/config. - [ ] Default/no context means no exporter and no outbound traffic. - [ ] Expose safe spans/events/metrics for validation, parse/encode/decode, schema/version errors, and performance where useful. - [ ] Host owns OTLP/OpenObserve exporter and credentials. - [ ] Never export document field values/bodies by default; schema/type/size/outcome metadata only. - [ ] Instrumentation failures cannot change validation or serialization results. - [ ] Tests prove disabled behavior equivalence and no network effects. - [ ] Add host integration example for generic OTLP/OpenObserve. Docs: https://openobserve.ai/docs/ingestion/ No product telemetry in this issue.