Component
core/observability/tempo
A Grafana Tempo distributed-tracing server in its single-binary shape: every subsystem runs inside one process backed by a local trace store, so it renders as a single stateful server with a data volume. It receives trace spans over the OpenTelemetry protocol and other tracing wire formats, and answers trace-lookup and search queries over its HTTP API, on its own port, which a dashboards server reads to display traces. It serves its own metrics in the Prometheus format at /metrics on that HTTP port, 3200, on by default, and every Recipe publishes that address as `metrics_endpoint`. Its primary contract to consumers is the OTLP gRPC receiver: a trace producer wires to it and pushes spans there, and the component exports that receiver's host and port. It carries `observability.aggrega.ai/traces: otlp-grpc`, so an OpenTelemetry Collector's `traces` socket takes it and exports spans to that receiver. Realized on helm by two realizations the Manifest chooses between, and on compose by one. `tempo` synthesizes the server as a workload and fetches nothing, so it is the one to reach for where the build must complete with no chart repository reachable. `tempo-chart` renders the community-maintained Tempo Helm chart, which assembles the server's configuration from named settings rather than from a hand-written file and additionally accepts spans in the Jaeger and Zipkin wire formats, so reach for it where a chart repository is reachable at build time. On compose, `tempo` runs the same image and configuration as its helm namesake, as a service publishing nothing to the host.
Provenance
- Content digest
- sha256:1ddd938f29ca11e02cd0bb51e457e48e9a8d4fedc43a43551025d7e2abdcb6d9
- Published
- 2026-11-10T10:13:15Z
- 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:89434ed4833a641cb62157a4e2ec26b68383a49efa0f1d7691c3a46ca9c32df8
Reference at this version
oci://hub.aggrega.ai/component/core/observability/tempo:1.0.0Developer parameters
Values the developer sets in the Aggregate.
| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| retention_period | string | 168h | no | How long stored trace blocks are kept before the in-process compactor deletes them. Expressed as a Go duration (e.g. `168h` for seven days). |
Operator sizing
Infrastructure sizing the operator tunes per environment.
| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| engine_version | string | 2.9.0 | no | Tempo container image tag. Selects the grafana/tempo image tag the workload-synthesis realizations run, on helm and on compose; the chart-backed realization pins its own image tag. |
| source_version | string | — | no | Version of the Helm chart the chart-backed realization pulls. Read only by that realization; the workload-synthesis realizations, on helm and on compose, pull no source artifact and ignore it. Changing it away from the Recipe's default does not guarantee value-mapping compatibility with the new chart. |
| 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 | Name the server receiving trace spans is reached at — the in-cluster Service on helm, the service name on compose. 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 API port, so a consumer wires its exporter rather than its dashboard. |
| 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>:3200/metrics` on the HTTP API's port, which is not the published `port`. Empty where the component serves none reachable. |
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
env
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
implements
implements