Recipe

otel-collector

The OpenTelemetry Collector, contrib distribution, for local development via Docker Compose, synthesized from the Workload kind by the compose provider: one stateless service running the same image as the Kubernetes realization with the same configuration, the OtelCollectorConfig bundle, delivered as a compose config mounted over the file the image starts the collector with. The bundle writes one exporter for each backend wired to the traces, metrics and logs sockets, and the service carries a digest of the infra and those backends, so a changed address re-creates it. The service publishes nothing to the host: a producer on the compose network reaches it at the service name, on the OTLP gRPC and HTTP ports. The image carries no shell and no client to ask the collector's health check from inside the container, so the service declares no healthcheck. provides.host is the compose service name. With `values.metrics_enabled` true the collector serves its own telemetry metrics at port 8888 on every interface, which every peer on the compose network reaches and which checks no caller, and provides.metrics_endpoint publishes the address; false, that key is empty.

Provenance

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
Content digest
sha256:dab16096723c77b0c9c50f748ec5d11c22334cb7b85d909fe13026b852084378
Published
2026-11-10T10:20:19Z
Signing identity
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

Signature

  • Officialapplication/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:efe08c4da08a9b49e3445f25c34a5b58145e445878044e724816d064ea0be54c

Reference at this version

oci://hub.aggrega.ai/recipe/compose/otel-collector:1.0.0
Target
—
Implements
core/observability/otel-collector:1.0.0

Provides

Deterministic pointer templates this recipe wires for consumers.

NameTemplate
host{{ .context.instance_id }}
port{{ .infra.otlp_grpc_port }}
protocolgrpc
endpointhttp://{{ .context.instance_id }}:{{ .infra.otlp_grpc_port }}
otlp_http_port{{ .infra.otlp_http_port }}
otlp_http_endpointhttp://{{ .context.instance_id }}:{{ .infra.otlp_http_port }}
metrics_endpoint{{ if .values.metrics_enabled }}http://{{ .context.instance_id }}:{{ .locals.metrics_port }}/metrics{{ end }}

Workload

Workload · form: stateless · containers: main

Locals

NameTemplate
collector_config_deliverycompose_configs
collector_config_name{{ .context.instance_id }}-collector-config
metrics_port8888

Values mapping

No values mapping declared.

Relationships

Typed edges to and from other published entities. A reference with no published target renders as a broken edge rather than a link.

Uses

Used by

Nothing in the catalog depends on this entity.

Recipe concept reference →

The Aggrega catalog — an open index of components, features, recipes, and the plugins that render them.

Built with the shared Aggrega design system.

Privacy