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.
来源
- 内容摘要
- sha256:1ddd938f29ca11e02cd0bb51e457e48e9a8d4fedc43a43551025d7e2abdcb6d9
- 发布时间
- 2026-11-10T10:13:15Z
- 签名身份
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
签名
- 官方application/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
此版本的引用
oci://hub.aggrega.ai/component/core/observability/tempo:1.0.0开发者参数
开发者在 Aggregate 中设置的值。
| 名称 | 类型 | 默认值 | 必需 | 描述 |
|---|---|---|---|---|
| retention_period | string | 168h | 否 | 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). |
运维规格
运维人员按环境调整的基础设施规格。
| 名称 | 类型 | 默认值 | 必需 | 描述 |
|---|---|---|---|---|
| engine_version | string | 2.9.0 | 否 | 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 | — | 否 | 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 | — | 否 | — |
| storage | object | — | 否 | — |
| overrides | object (open) | — | 否 | Provider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads. |
输出契约
此组件通过 uses 拓扑向使用方发布的值。
| 名称 | 类型 | 默认值 | 必需 | 描述 |
|---|---|---|---|---|
| host | string | — | 是 | 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 | — | 是 | 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 | — | 否 | 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 | — | 否 | 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 套接字
此组件用于建立连接的依赖套接字。通过某个套接字接入的每个连接,其目标都必须满足该套接字的标签选择器,且每个连接都可以在该套接字声明的槽位中携带附加项。必需槽位须由 Aggregate 或 Release 通过该套接字接入的每个连接来填充。
未声明 uses 套接字。
附加槽位
Feature 附加到此组件时所用的命名绑定点。槽位的选择器限定哪个 Feature 可以填充该槽位,其 inject 列表则指明 Feature 的内容可以如何交付。必需槽位必须在每个实例上完成绑定,可以通过实例上的附加,也可以通过其上层作用域的附加;敏感槽位则声明为用于处理机密内容。Feature 也可以以任何槽位都未声明的名称进行附加。
未声明附加槽位。
自注入允许列表
env
关系
与其他已发布实体之间的类型化边。没有已发布目标的引用会呈现为断开的边,而不是链接。
使用
此实体未使用目录中的任何内容。
被使用
使用套接字 «backend»
使用套接字 «databases»
使用套接字 «etcd»
使用套接字 «backend»
使用套接字 «backend»
使用套接字 «forward_target»
使用套接字 «traces»
使用套接字 «scrape_target»
使用套接字 «backend»
使用套接字 «database»
适用于
适用于
适用于
实现
实现
实现