Recipe

prometheus-chart

Prometheus metrics server on Kubernetes via the prometheus-community Helm chart, configured as one server: the chart's alerting, exporter and push-gateway subcharts are switched off. It renders a Deployment, a ConfigMap carrying the scrape configuration, a PersistentVolumeClaim for the time-series database, a ClusterIP Service, and the ServiceAccount, ClusterRole and ClusterRoleBinding the server reads the cluster's own endpoints under. The server image and the chart version are pinned. That cluster-scoped read grant also serves the chart's own jobs, which scrape whatever the cluster advertises through scrape annotations. Each connection on the `scrape_target` uses-socket becomes one scrape job, as on the workload-synthesis realization: a target publishing `metrics_endpoint` is scraped at that address; one publishing `metrics_service` or `metrics_pod_selector` is discovered in the namespace its connection's `aggrega.ai/namespace` annotation names, in every namespace for KEDA and Knative Serving, or in the server's own where neither declares one; a target publishing none halts the build. A connection's `credential` is mounted as a file through `server.extraSecretMounts`, and its job presents it as a bearer token. Reach for it where a chart repository is reachable and the server should discover targets beyond those wired, and for `prometheus` where the build must fetch nothing. With `infra.external_base_url` set, the server takes it as its external URL through the chart's `server.baseURL` and is kept serving at its root. With `values.otlp_receiver` true, `server.extraArgs` also turns on the OTLP receiver, whose address it publishes as provides.otlp_http_endpoint.

Provenance

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
Content digest
sha256:64fdfa6f4b01166fe10b30871536485d8a880fb0e5d9a2a4e6f7fbdd02de2268
Published
2026-11-10T10:26:36Z
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:1582d481ed342cf1513e9bd39ca039f760a94b1d2f70f4522250c043c1b1a636

Reference at this version

oci://hub.aggrega.ai/recipe/helm/prometheus-chart:1.0.0
Target
—
Implements
core/observability/prometheus:1.0.0

Provides

Deterministic pointer templates this recipe wires for consumers.

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

Workload

No workload template declared.

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