nsaspy/star-lang
1
0
Fork 0
Code Issues 15 Pull requests 6 Projects Releases Packages Wiki Activity Actions

Observability: optional OTLP/OpenObserve hooks through runtime config #49

New issue
Open
opened 2026-08-26 07:47:28 +00:00 by lost-rob0t · 0 comments
lost-rob0t commented 2026-08-26 07:47:28 +00:00 (Migrated from github.com)
Copy link

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

Add provider-neutral observability hooks to the Star Language runtime so StarLang actors can participate in the same operator-controlled OTLP/OpenObserve plane without making observability mandatory.

Requirements

  • Add optional observability configuration to the runtime/init configuration.
  • Default OFF; absent config means no exporter initialization or outbound observability traffic.
  • Keep instrumentation API/provider-neutral; OTLP is the export boundary and OpenObserve is one destination.
  • Instrument actor creation/termination, mailbox/message processing, supervision/restart, dispatch, runtime errors, and external-call boundaries.
  • Preserve semantic control-plane identities in safe resource/span attributes (actor type/name, runtime version, environment), avoiding unbounded cardinality.
  • Do not export message bodies or investigation payloads by default.
  • Exporter failures are bounded/non-fatal and never change actor semantics.
  • Tests prove disabled mode has zero exporter/network effects.
  • Tests cover configured exporter and exporter-down behavior.
  • Document generic OTLP and OpenObserve examples.

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

Exclusion

No anonymous usage analytics or StarIntel-owned product telemetry endpoint.

Coordinate with https://github.com/lost-rob0t/starintel-server/issues/128. Add provider-neutral observability hooks to the Star Language runtime so StarLang actors can participate in the same operator-controlled OTLP/OpenObserve plane without making observability mandatory. ## Requirements - [ ] Add optional observability configuration to the runtime/init configuration. - [ ] Default OFF; absent config means no exporter initialization or outbound observability traffic. - [ ] Keep instrumentation API/provider-neutral; OTLP is the export boundary and OpenObserve is one destination. - [ ] Instrument actor creation/termination, mailbox/message processing, supervision/restart, dispatch, runtime errors, and external-call boundaries. - [ ] Preserve semantic control-plane identities in safe resource/span attributes (actor type/name, runtime version, environment), avoiding unbounded cardinality. - [ ] Do not export message bodies or investigation payloads by default. - [ ] Exporter failures are bounded/non-fatal and never change actor semantics. - [ ] Tests prove disabled mode has zero exporter/network effects. - [ ] Tests cover configured exporter and exporter-down behavior. - [ ] Document generic OTLP and OpenObserve examples. Docs: https://openobserve.ai/docs/ingestion/ ## Exclusion No anonymous usage analytics or StarIntel-owned product telemetry endpoint.
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
feature/real-actor-system-tests
hydra/fleet-jobs-20260904
ipx/actor-system-foundation
agent/swi-mqi-worker-adapter
agent/production-readiness-20260825
agent/json-file-output-actor
agent/logic-call-ir-policy
agent/portable-logic-foundation
agent/freeze-verification-certificate-claims
extract/deterministic-wire-dispatcher
extract/canonical-wire-encoding
extract/portable-payload-validation
extract/portable-wire-contract
extract/runtime-directory-core
extract/heartbeat-lease-core
extract/runtime-journal-core
extract/canonical-json-core
extract/wire-lifecycle-contract
agent/sento-compat-concrete-adapter
agent/actor-runtime-mailbox-extraction
runtimecompiler
agent/scraping-library-core
agent/final-runtime-ownership-actors-ingest
agent/rabbitmq-transport-binding
agent/actor-protocol-service-uri-clean
agent/actor-protocol-service-uri
agent/native-sha256-ironclad
agent/resolver-effect-ports-phase1
design/star-funds-prediction-market-gap
agent/canonical-manifest-fixtures
agent/full-sha256-locks
agent/star-service-uri
agent/hygienic-macros
agent/camelcase-ir-stability
agent/compiler-foundation
agent/asdf-prototype-test-contract
agent/relation-target-compat
agent/research-006-star-cl-destination
agent/research-006-relation-destination
agent/research-006-https-imports
agent/nix-flake-agpl3
No results found.
Labels
Clear labels   
bug
Something isn't working

  
documentation
Improvements or additions to documentation

  
duplicate
This issue or pull request already exists

  
enhancement
New feature or request

  
good first issue
Good for newcomers

  
help wanted
Extra attention is needed

  
invalid
This doesn't seem right

  
question
Further information is requested

  
wontfix
This will not be worked on

No labels
bug
documentation
duplicate
enhancement
good first issue
help wanted
invalid
question
wontfix
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
nsaspy/star-lang#49
No description provided.