Observability: optional OTLP/OpenObserve instrumentation hooks #11

New issue

Open

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

lost-rob0t commented

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

(Migrated from github.com)

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

Add provider-neutral instrumentation hooks for StarIntel Common Lisp model/library code without turning the library itself into a mandatory network client.

Instrumentation is opt-in through the host application's init/config.
Default/no host observability context means no exporter, no network activity, and near-zero behavior change.
Expose spans/events/metrics around parse/validate/encode/decode and meaningful failures where useful.
Host process owns OTLP exporter configuration and OpenObserve credentials.
Never export document bodies/fields by default; safe schema/type/size/outcome metadata only.
Instrumentation failures cannot alter library results.
Tests prove behavior equivalence with instrumentation disabled.
Add a 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 StarIntel Common Lisp model/library code without turning the library itself into a mandatory network client. - [ ] Instrumentation is opt-in through the host application's init/config. - [ ] Default/no host observability context means no exporter, no network activity, and near-zero behavior change. - [ ] Expose spans/events/metrics around parse/validate/encode/decode and meaningful failures where useful. - [ ] Host process owns OTLP exporter configuration and OpenObserve credentials. - [ ] Never export document bodies/fields by default; safe schema/type/size/outcome metadata only. - [ ] Instrumentation failures cannot alter library results. - [ ] Tests prove behavior equivalence with instrumentation disabled. - [ ] Add a host integration example for generic OTLP/OpenObserve. Docs: https://openobserve.ai/docs/ingestion/ No product telemetry in this issue.