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.
Provenienza
- Digest del contenuto
- sha256:b748c8c386227390ac4d0e453d5c7a2503bfaf947d2fd1fc788e6e93259be636
- Pubblicato
- 2026-11-10T10:13:13Z
- Identità di firma
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
Firma
- Ufficialeapplication/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
Riferimento a questa versione
oci://hub.aggrega.ai/component/core/observability/otel-collector:1.0.0Parametri dello sviluppatore
Valori che lo sviluppatore imposta nell’Aggregate.
| Nome | Tipo | Predefinito | Obbligatorio | Descrizione |
|---|---|---|---|---|
| metrics_enabled | boolean | false | no | 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. |
Dimensionamento dell’operatore
Dimensionamento dell’infrastruttura che l’operatore regola per ogni ambiente.
| Nome | Tipo | Predefinito | Obbligatorio | Descrizione |
|---|---|---|---|---|
| engine_version | string | 0.162.0 | no | 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 | — | no | 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 | no | Port the OTLP receiver accepts gRPC on — the port published as `port` and in `endpoint`. |
| otlp_http_port | integer (min 1024, max 65535) | 4318 | no | Port the OTLP receiver accepts HTTP on — the port published as `otlp_http_port` and in `otlp_http_endpoint`. |
| compute | object | — | no | — |
| overrides | object (open) | — | no | Provider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads. |
Contratto di output
Valori che questo componente pubblica verso i consumatori attraverso la topologia uses.
| Nome | Tipo | Predefinito | Obbligatorio | Descrizione |
|---|---|---|---|---|
| host | string | — | sì | 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 | — | sì | TCP port the OTLP receiver accepts gRPC on. |
| protocol | string | — | no | How the published address is spoken to — `grpc`, so an exporter is configured for the gRPC transport. |
| endpoint | string | — | no | The OTLP gRPC endpoint as an exporter takes it — `http://<host>:<port>`, the scheme saying the connection is not encrypted. |
| otlp_http_port | integer | — | no | TCP port the OTLP receiver accepts HTTP on. |
| otlp_http_endpoint | string | — | no | 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 | — | no | 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. |
Socket uses
I socket di dipendenza attraverso cui questo componente si connette. La destinazione di ogni connessione collegata attraverso un socket deve soddisfare il suo selettore di etichette, e ogni connessione può portare un aggancio negli slot che il socket dichiara. Uno slot obbligatorio deve essere riempito da ogni connessione che l’Aggregate o la Release collega attraverso il socket.
traces
- Selettore
- observability.aggrega.ai/traces
- Iniezione
- —
Questo socket non dichiara slot di aggancio, quindi una connessione attraverso di esso non porta alcun aggancio.
metrics
- Selettore
- observability.aggrega.ai/metrics
- Iniezione
- —
Questo socket non dichiara slot di aggancio, quindi una connessione attraverso di esso non porta alcun aggancio.
logs
- Selettore
- observability.aggrega.ai/logs
- Iniezione
- —
Questo socket non dichiara slot di aggancio, quindi una connessione attraverso di esso non porta alcun aggancio.
Slot di aggancio
Punti di associazione con nome in cui una Feature si aggancia a questo componente. Il selettore di uno slot limita quale Feature può riempirlo e la sua lista inject indica come può essere consegnato il materiale della Feature. Uno slot obbligatorio deve essere associato su ogni istanza, da un aggancio sull’istanza o a un ambito superiore, e uno slot sensibile è dichiarato per gestire materiale segreto. Una Feature può anche agganciarsi con un nome che nessuno slot dichiara.
Nessuno slot di aggancio dichiarato.
Elenco consentito di auto-iniezione
Nessuna pipe di auto-iniezione dichiarata.
Relazioni
Archi tipizzati da e verso altre entità pubblicate. Un riferimento senza una destinazione pubblicata viene mostrato come arco interrotto anziché come link.
Usa
- usausa il socket «traces»
observability.aggrega.ai/traces
Non dichiara slot di aggancio.
- usausa il socket «metrics»
observability.aggrega.ai/metrics
Non dichiara slot di aggancio.
- usausa il socket «logs»
observability.aggrega.ai/logs
Non dichiara slot di aggancio.
Usato da
usa il socket «upstream»
usa il socket «forward_target»
usa il socket «scrape_target»
usa il socket «store»
si applica a
si applica a
si applica a
si applica a
si applica a
si applica a
si applica a
implementa
implementa