Diese Seite wurde maschinell übersetzt. Englisches Original lesen.

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.

Herkunft

OffiziellSigniert von einer Signaturidentität, die dieser Katalog als offiziellen Herausgeber anerkennt.
Inhalts-Digest
sha256:b748c8c386227390ac4d0e453d5c7a2503bfaf947d2fd1fc788e6e93259be636
Veröffentlicht
2026-11-10T10:13:13Z
Signaturidentität
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

Signatur

  • Offiziellapplication/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

Referenz zu dieser Version

oci://hub.aggrega.ai/component/core/observability/otel-collector:1.0.0

Entwicklerparameter

Werte, die der Entwickler im Aggregate festlegt.

NameTypStandardwertErforderlichBeschreibung
metrics_enabledbooleanfalseneinMakes 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.

Dimensionierung durch den Operator

Infrastrukturdimensionierung, die der Operator pro Umgebung anpasst.

NameTypStandardwertErforderlichBeschreibung
engine_versionstring0.162.0neinTag 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_versionstring—neinVersion 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_portinteger (min 1024, max 65535)4317neinPort the OTLP receiver accepts gRPC on — the port published as `port` and in `endpoint`.
otlp_http_portinteger (min 1024, max 65535)4318neinPort the OTLP receiver accepts HTTP on — the port published as `otlp_http_port` and in `otlp_http_endpoint`.
computeobject—nein—
overridesobject (open)—neinProvider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads.

Ausgabevertrag

Werte, die diese Komponente über die uses-Topologie an Konsumenten veröffentlicht.

NameTypStandardwertErforderlichBeschreibung
hoststring—jaName 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`.
portinteger—jaTCP port the OTLP receiver accepts gRPC on.
protocolstring—neinHow the published address is spoken to — `grpc`, so an exporter is configured for the gRPC transport.
endpointstring—neinThe OTLP gRPC endpoint as an exporter takes it — `http://<host>:<port>`, the scheme saying the connection is not encrypted.
otlp_http_portinteger—neinTCP port the OTLP receiver accepts HTTP on.
otlp_http_endpointstring—neinThe 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_endpointstring—neinThe 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-Sockets

Die Abhängigkeits-Sockets, über die sich diese Komponente verbindet. Das Ziel jeder über einen Socket verdrahteten Verbindung muss dessen Label-Selektor erfüllen, und jede Verbindung kann in den Slots, die der Socket deklariert, eine Anbindung tragen. Einen erforderlichen Slot muss jede Verbindung füllen, die das Aggregate oder das Release über den Socket verdrahtet.

traces

Selektor
observability.aggrega.ai/traces
Injektion
—

Dieser Socket deklariert keine Anbindungs-Slots, daher trägt eine Verbindung über ihn keine Anbindung.

metrics

Selektor
observability.aggrega.ai/metrics
Injektion
—

Dieser Socket deklariert keine Anbindungs-Slots, daher trägt eine Verbindung über ihn keine Anbindung.

logs

Selektor
observability.aggrega.ai/logs
Injektion
—

Dieser Socket deklariert keine Anbindungs-Slots, daher trägt eine Verbindung über ihn keine Anbindung.

Anbindungs-Slots

Benannte Bindungspunkte, an denen ein Feature an diese Komponente angebunden wird. Der Selektor eines Slots schränkt ein, welches Feature ihn füllen darf, und seine inject-Liste benennt, wie das Feature sein Material liefern darf. Ein erforderlicher Slot muss auf jeder Instanz gebunden sein, durch eine Anbindung an der Instanz oder in einem darüberliegenden Geltungsbereich, und ein sensibler Slot ist für den Umgang mit geheimem Material deklariert. Ein Feature kann auch unter einem Namen angebunden werden, den kein Slot deklariert.

Keine Anbindungs-Slots deklariert.

Zulassungsliste für Selbstinjektion

Keine Selbstinjektions-Pipes deklariert.

Beziehungen

Typisierte Kanten zu und von anderen veröffentlichten Entitäten. Eine Referenz ohne veröffentlichtes Ziel wird als unterbrochene Kante statt als Link dargestellt.

Verwendet

Verwendet von

Konzeptreferenz zu Component →

Der Aggrega-Katalog — ein offener Index von Komponenten, Funktionen, Rezepten und den Plugins, die sie rendern.

Erstellt mit dem gemeinsamen Aggrega-Designsystem.

Datenschutz