tramai-spring-boot-starter-sovereign-ops-observability

Version: 0.6.0
Status: Preview
Role: OpenTelemetry instrumentation for the sovereign ops audit-outbox worker.

Purpose

This add-on registers a SovereignOpsAuditOutboxWorkerObserverContribution backed by OpenTelemetry, so audit-outbox worker activity is visible in your existing tracing/metrics pipeline.

It activates on presence, not on a property: the contribution is created when an OpenTelemetry bean exists in the context and no OT contribution has been registered yet. The module ships the OpenTelemetry API only — bring the SDK and exporter yourself. It registers before the ops auto-configuration, so the base starter's composite observer chain includes it while status snapshots keep updating.

What it provides

Type	Role
`OpenTelemetrySovereignOpsAuditOutboxWorkerObserver`	Emits worker telemetry through an `OpenTelemetry` instance
`SovereignOpsOutboxObservabilityAutoConfiguration`	Creates the observer contribution, backing off if a bean with that name exists

Instrumentation is best-effort: an unavailable exporter must not break the worker path.

Dependencies

dependencies {
    implementation(platform("dev.tramai:tramai-bom:0.6.0"))
    implementation("dev.tramai:tramai-spring-boot-starter")
    implementation("dev.tramai:tramai-spring-boot-starter-sovereign-ops")
    implementation("dev.tramai:tramai-spring-boot-starter-sovereign-ops-observability")
    implementation("io.opentelemetry:opentelemetry-sdk") // SDK + exporter are yours
}

tramai:
  sovereign:
    ops:
      outbox:
        worker:
          enabled: true

When to use this add-on

You already run OpenTelemetry and want the outbox worker in the same traces.
You want worker telemetry without adopting Micrometer.

When NOT to use this add-on

You need Micrometer metrics instead: use tramai-spring-boot-starter-sovereign-ops-micrometer.
You only need a health/status surface: use tramai-spring-boot-starter-sovereign-ops-actuator.
No OpenTelemetry bean is configured — nothing is registered.