Component
core/observability/otel-collector
The OpenTelemetry Collector, in its contrib distribution: a stateless server that receives traces, metrics and logs over the OpenTelemetry protocol (OTLP), on a gRPC port and an HTTP port, and runs each signal through a pipeline of its own. A producer points its OTLP exporter at the endpoint the collector publishes for the transport it speaks. Every signal always has a pipeline fed by the OTLP receiver. A backend wired to the signal's socket — `traces`, `metrics` or `logs`, each taking the components labelled `observability.aggrega.ai/<signal>` — adds one exporter to that pipeline, for the protocol the label names. A Prometheus is reached only with its `values.otlp_receiver` true; the build halts otherwise, naming that line. A signal with nothing wired ends in the collector's debug exporter at basic verbosity: what arrives is summarised in the collector's own log, one line per batch, and sent nowhere else. A producer is not refused for want of a backend, and what it sends is not dropped unseen. Realized on helm by `otel-collector-chart`, which renders the project's own Helm chart and needs its chart repository reachable at build time, and on compose by `otel-collector`, a compose service publishing nothing to the host. Both run the same image with the same configuration, written once in the OtelCollectorConfig bundle they import. With `values.metrics_enabled` true the collector serves its own telemetry 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. On helm it joins a ClusterIP Service, and another Service type halts the build.
来源
- 内容摘要
- sha256:b748c8c386227390ac4d0e453d5c7a2503bfaf947d2fd1fc788e6e93259be636
- 发布时间
- 2026-11-10T10:13:13Z
- 签名身份
- 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:a580825d7d6000571b76adf005f363c2f9594dbe023d420552f3c24684f7f3d6
此版本的引用
oci://hub.aggrega.ai/component/core/observability/otel-collector:1.0.0开发者参数
开发者在 Aggregate 中设置的值。
| 名称 | 类型 | 默认值 | 必需 | 描述 |
|---|---|---|---|---|
| metrics_enabled | boolean | false | 否 | Makes the collector's own telemetry 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. These describe the collector itself, not the metrics it forwards. The port checks no caller, so anything that reaches it can read them. |
运维规格
运维人员按环境调整的基础设施规格。
| 名称 | 类型 | 默认值 | 必需 | 描述 |
|---|---|---|---|---|
| engine_version | string | 0.162.0 | 否 | Tag of the otel/opentelemetry-collector-contrib image both Recipes run. The configuration is written for 0.162.0; another release may name a component differently. |
| source_version | string | — | 否 | Version of the opentelemetry-collector Helm chart the chart-backed realization pulls. Read only by that realization; the compose realization pulls no source artifact and ignores it. Changing it away from the Recipe's default does not guarantee value-mapping compatibility with the new chart. |
| otlp_grpc_port | integer (min 1024, max 65535) | 4317 | 否 | Port the OTLP receiver accepts gRPC on — the port published as `port` and in `endpoint`. |
| otlp_http_port | integer (min 1024, max 65535) | 4318 | 否 | Port the OTLP receiver accepts HTTP on — the port published as `otlp_http_port` and in `otlp_http_endpoint`. |
| compute | object | — | 否 | — |
| overrides | object (open) | — | 否 | Provider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads. |
输出契约
此组件通过 uses 拓扑向使用方发布的值。
| 名称 | 类型 | 默认值 | 必需 | 描述 |
|---|---|---|---|---|
| host | string | — | 是 | Name the collector is reached at — the in-cluster Service on helm, the service name on compose. A producer points its exporter at this name together with `port`. |
| port | integer | — | 是 | TCP port the OTLP receiver accepts gRPC on. |
| protocol | string | — | 否 | How the published address is spoken to — `grpc`, so an exporter is configured for the gRPC transport. |
| endpoint | string | — | 否 | The OTLP gRPC endpoint as an exporter takes it — `http://<host>:<port>`, the scheme saying the connection is not encrypted. |
| otlp_http_port | integer | — | 否 | TCP port the OTLP receiver accepts HTTP on. |
| otlp_http_endpoint | string | — | 否 | The OTLP HTTP endpoint as an exporter takes it — `http://<host>:<otlp_http_port>`. An exporter given this base address appends the path for each signal itself, such as `/v1/traces`. |
| metrics_endpoint | string | — | 否 | The full address Prometheus scrapes the collector's own telemetry metrics at — scheme, host, port and path, `http://<host>:8888/metrics`, the host being the one published as `host`. Empty while values.metrics_enabled is false. |
uses 套接字
此组件用于建立连接的依赖套接字。通过某个套接字接入的每个连接,其目标都必须满足该套接字的标签选择器,且每个连接都可以在该套接字声明的槽位中携带附加项。必需槽位须由 Aggregate 或 Release 通过该套接字接入的每个连接来填充。
traces
- 选择器
- observability.aggrega.ai/traces
- 注入
- —
此套接字未声明附加槽位,因此经由它的连接不携带任何附加项。
metrics
- 选择器
- observability.aggrega.ai/metrics
- 注入
- —
此套接字未声明附加槽位,因此经由它的连接不携带任何附加项。
logs
- 选择器
- observability.aggrega.ai/logs
- 注入
- —
此套接字未声明附加槽位,因此经由它的连接不携带任何附加项。
附加槽位
Feature 附加到此组件时所用的命名绑定点。槽位的选择器限定哪个 Feature 可以填充该槽位,其 inject 列表则指明 Feature 的内容可以如何交付。必需槽位必须在每个实例上完成绑定,可以通过实例上的附加,也可以通过其上层作用域的附加;敏感槽位则声明为用于处理机密内容。Feature 也可以以任何槽位都未声明的名称进行附加。
未声明附加槽位。
自注入允许列表
未声明自注入管道。
关系
与其他已发布实体之间的类型化边。没有已发布目标的引用会呈现为断开的边,而不是链接。
使用
- 使用使用套接字 «traces»
observability.aggrega.ai/traces
未声明附加槽位。
- 使用使用套接字 «metrics»
observability.aggrega.ai/metrics
未声明附加槽位。
- 使用使用套接字 «logs»
observability.aggrega.ai/logs
未声明附加槽位。
被使用
使用套接字 «upstream»
使用套接字 «forward_target»
使用套接字 «scrape_target»
使用套接字 «store»
适用于
适用于
适用于
适用于
适用于
适用于
适用于
实现
实现