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
- 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.
| Name | Template |
|---|---|
| host | {{ .context.instance_id }} |
| port | {{ .infra.otlp_grpc_port }} |
| protocol | grpc |
| endpoint | http://{{ .context.instance_id }}:{{ .infra.otlp_grpc_port }} |
| otlp_http_port | {{ .infra.otlp_http_port }} |
| otlp_http_endpoint | http://{{ .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
| Name | Template |
|---|---|
| collector_config_delivery | compose_configs |
| collector_config_name | {{ .context.instance_id }}-collector-config |
| metrics_port | 8888 |
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
- implementsimplementscontract compatible
core/observability/otel-collector:1.0.0
All required outputs are satisfied and every provided output is named in the contract.
Used by
Nothing in the catalog depends on this entity.