Component
core/observability/jaeger
A Jaeger distributed-tracing backend in its single-node shape. Jaeger receives trace spans over the OpenTelemetry protocol, keeps them in a local embedded key-value trace store, and serves trace-lookup and search queries over its query UI. Every Jaeger subsystem — the OTLP receiver, the storage writer, and the query service — runs inside one process backed by a local on-disk store, so it renders as a single stateful server with a data volume rather than a set of microservices. Its primary contract to consumers is the OTLP gRPC receiver: a trace producer wires to it and pushes spans there. The OTLP HTTP receiver and the query UI are exposed on their own ports. Realized on Kubernetes via its Helm Recipe, which synthesizes the workload directly from the official Jaeger image; helm-only. Exports its OTLP gRPC receiver host and port to consumers via the uses topology, and carries `observability.aggrega.ai/traces: otlp-grpc`, so an OpenTelemetry Collector's `traces` socket takes it and exports spans to that receiver. The packaged Jaeger server is Apache-2.0. With `values.metrics_enabled` true the Recipe has Jaeger serve its own metrics, at /metrics on port 8888, on every interface rather than its loopback address, and publishes that address as `metrics_endpoint`; false, that key is empty. The port checks no caller.
Provenance
- Content digest
- sha256:83bfdc2d401b83dd421af951624c76844590da235f919faafc8f4666eb38baf9
- Published
- 2026-11-10T10:13:00Z
- Signing identity
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
Signature
- Officialapplication/vnd.dev.sigstore.bundle.v0.3+json
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
sha256:1cd36c5987ac05c0dc5f27a04a22a0bed6a098afe8367dc1d17540c9865af046
Reference at this version
oci://hub.aggrega.ai/component/core/observability/jaeger:1.0.0Developer parameters
Values the developer sets in the Aggregate.
| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| metrics_enabled | boolean | false | no | Makes Jaeger's own metrics, served at /metrics on port 8888, reachable on every interface rather than its loopback address alone, and publishes their address as `metrics_endpoint`; while false that key is empty. The port checks no caller, so anything that reaches it can read them. |
Operator sizing
Infrastructure sizing the operator tunes per environment.
| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| engine_version | string | 2.19.0 | no | Jaeger server image tag. Pins the packaged Jaeger version the workload references. |
| otlp_grpc_port | integer | 4317 | no | Port for the OTLP gRPC trace receiver — the primary ingestion endpoint trace producers push spans to. |
| otlp_http_port | integer | 4318 | no | Port for the OTLP HTTP trace receiver. |
| query_port | integer | 16686 | no | Port for the Jaeger query UI and its trace-lookup API. |
| compute | object | — | no | — |
| storage | object | — | no | — |
| overrides | object (open) | — | no | Provider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads. |
Output contract
Values this component publishes to consumers over the uses topology.
| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| host | string | — | yes | In-cluster DNS name of the Service receiving trace spans. An application exporting spans points its exporter at this name together with `port`. |
| port | integer | — | yes | TCP port spans are ingested on. It carries the OpenTelemetry gRPC receiver port, not the query UI port, so a consumer wires its exporter rather than its browser. |
| protocol | string | — | no | How the published address is spoken to — `grpc`, so an exporter is configured for the gRPC transport rather than the HTTP one. |
| metrics_endpoint | string | — | no | The full address Prometheus scrapes this component's metrics at — scheme, host, port and path, `http://<host>:8888/metrics`, the host being the tracing backend's Service name. Empty while values.metrics_enabled is false. |
Uses sockets
The dependency sockets this component connects through. The target of every connection wired through a socket must satisfy its label selector, and each connection may carry an attachment in the slots the socket declares. A required slot is owed by each connection the Aggregate or the Release wires through the socket.
No uses sockets declared.
Attachment slots
Named binding points at which a Feature attaches to this component. A slot's selector constrains which Feature may fill it and its inject list names how the Feature's material may be delivered. A required slot must be bound on every instance, by an attachment on the instance or at a scope above it, and a sensitive slot is declared to handle secret material. A Feature may also attach under a name no slot declares.
No attachment slots declared.
Self-inject allowlist
No self-inject pipes declared.
Relationships
Typed edges to and from other published entities. A reference with no published target renders as a broken edge rather than a link.
Uses
This entity uses nothing in the catalog.
Used by
uses socket «backend»
uses socket «databases»
uses socket «etcd»
uses socket «backend»
uses socket «backend»
uses socket «forward_target»
uses socket «traces»
uses socket «scrape_target»
uses socket «backend»
uses socket «database»
applies to
applies to
applies to
implements