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.
Procedencia
- Digest del contenido
- sha256:1ddd938f29ca11e02cd0bb51e457e48e9a8d4fedc43a43551025d7e2abdcb6d9
- Publicado
- 2026-11-10T10:13:15Z
- Identidad de firma
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
Firma
- Oficialapplication/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
Referencia en esta versión
oci://hub.aggrega.ai/component/core/observability/tempo:1.0.0Parámetros del desarrollador
Valores que el desarrollador establece en el Aggregate.
| Nombre | Tipo | Predeterminado | Obligatorio | Descripción |
|---|---|---|---|---|
| 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). |
Dimensionamiento del operador
Dimensionamiento de la infraestructura que el operador ajusta para cada entorno.
| Nombre | Tipo | Predeterminado | Obligatorio | Descripción |
|---|---|---|---|---|
| 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. |
Contrato de salida
Valores que este componente publica para los consumidores a través de la topología uses.
| Nombre | Tipo | Predeterminado | Obligatorio | Descripción |
|---|---|---|---|---|
| host | string | — | sí | 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 | — | sí | 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. |
Sockets uses
Los sockets de dependencia a través de los cuales se conecta este componente. El destino de cada conexión cableada a través de un socket debe satisfacer su selector de etiquetas, y cada conexión puede llevar un acoplamiento en los slots que declara el socket. Cada conexión que el Aggregate o la Release cablea a través del socket debe llenar los slots obligatorios.
No se declararon sockets uses.
Slots de acoplamiento
Puntos de enlace con nombre en los que una Feature se acopla a este componente. El selector de un slot restringe qué Feature puede llenarlo y su lista inject indica cómo puede entregarse el material de la Feature. Un slot obligatorio debe estar enlazado en cada instancia, mediante un acoplamiento en la instancia o en un ámbito superior, y un slot sensible se declara para manejar material secreto. Una Feature también puede acoplarse con un nombre que ningún slot declara.
No se declararon slots de acoplamiento.
Lista de permitidos de autoinyección
env
Relaciones
Aristas tipadas hacia y desde otras entidades publicadas. Una referencia sin un destino publicado se muestra como una arista rota en lugar de como un enlace.
Usa
Esta entidad no usa nada del catálogo.
Usado por
usa el socket «backend»
usa el socket «databases»
usa el socket «etcd»
usa el socket «backend»
usa el socket «backend»
usa el socket «forward_target»
usa el socket «traces»
usa el socket «scrape_target»
usa el socket «backend»
usa el socket «database»
se aplica a
se aplica a
se aplica a
implementa
implementa
implementa