Recipe

prometheus

Prometheus metrics server for local development via Docker Compose. Synthesized-mode Workload — the compose provider translates the Workload into a service entry. Each connection on the `scrape_target` uses-socket becomes one job in a minimal prometheus.yml the container writes at start-up: the `metrics_endpoint` that connection's target publishes is the job's address, and the connection's own `values` set that job's label and cadence. A target publishing none halts the build, naming it, and so does one publishing `metrics_service` or `metrics_pod_selector`: its metrics are found by discovering it in a Kubernetes cluster, which Docker Compose does not have. A connection's `credential` arrives as a container variable, which the start-up command writes to the file the job presents as a bearer token. The time-series database is persisted to a named volume. With `infra.external_base_url` set, the server takes it as its external URL and is kept serving at its root; unset, neither flag is emitted. provides.host is the bare service name, resolved on the compose network. The server's port is also published on the host: on its loopback address, 127.0.0.1, only, or on every host interface while `infra.publish_on_all_interfaces` is true. With `values.otlp_receiver` true, the server runs the OTLP receiver, which checks no caller, on that same port, so anything that reaches the port can write metrics into it, and it publishes the receiver's address as provides.otlp_http_endpoint; false, that key is empty.

Provenance

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
Content digest
sha256:9f7f222b0a2edcbd9d3f173c04c1b286921986b41644ff4d7422bc27af93f518
Published
2026-11-10T10:20:29Z
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:50b784e659d0bf2a90866c8ae72369675abbeec6d141547f8543488c214ec6f5

Reference at this version

oci://hub.aggrega.ai/recipe/compose/prometheus:1.0.0
Target
—
Implements
core/observability/prometheus:1.0.0

Provides

Deterministic pointer templates this recipe wires for consumers.

NameTemplate
host{{ .context.instance_id }}
port{{ .infra.port }}
protocolhttp
otlp_http_endpoint{{ if .values.otlp_receiver }}http://{{ .context.instance_id }}:{{ .infra.port }}/api/v1/otlp{{ end }}
metrics_endpointhttp://{{ .context.instance_id }}:{{ .infra.port }}/metrics

Workload

Workload · containers: main

Locals

No locals declared.

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/prometheus: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.

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