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

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
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.0

Developer parameters

Values the developer sets in the Aggregate.

NameTypeDefaultRequiredDescription
retention_periodstring168hnoHow 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.

NameTypeDefaultRequiredDescription
engine_versionstring2.9.0noTempo 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_versionstring—noVersion 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.
computeobject—no—
storageobject—no—
overridesobject (open)—noProvider-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.

NameTypeDefaultRequiredDescription
hoststring—yesName 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`.
portinteger—yesTCP 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.
protocolstring—noHow the published address is spoken to — `grpc`, so an exporter is configured for the gRPC transport rather than the HTTP one.
metrics_endpointstring—noThe 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

Component concept reference →

The Aggrega catalog — an open index of components, features, recipes, and the plugins that render them.

Built with the shared Aggrega design system.

Privacy