promethues

What is promethues?

The prometheus image runs Prometheus, an open-source monitoring and alerting toolkit originally developed by SoundCloud and now part of the CNCF. Prometheus collects time-series metrics from targets via a pull-based HTTP model and stores them in a custom TSDB (time-series database).

It supports multi-dimensional data collection using key-value labels, a powerful query language (PromQL), service discovery, alerting rules, and data visualization. Prometheus integrates seamlessly with Kubernetes, microservices architectures, and third-party exporters to provide detailed insights into system performance.

This image is the backbone of many modern observability stacks and is often paired with Grafana, Alertmanager, and exporters like node-exporter or blackbox-exporter.

How to use this image

Prometheus is configured using a prometheus.yml file that defines scrape targets and alerting rules.

Run Prometheus with a local config:

<code>docker run -d -p 9090:9090 \  -v $(pwd)/prometheus.yml:/etc/prometheus/prometheus.yml \  prom/prometheus</code>

Basic prometheus.yml example:

<code>global:  scrape_interval: 15sscrape_configs:  - job_name: "prometheus"    static_configs:      - targets: ["localhost:9090"]</code>

Web UI and endpoints:

• Web interface: http://localhost:9090‍
• /metrics: Prometheus's own metrics
• /graph: Manual query interface for PromQL

{{cta}}

Image variants

Published under prom/prometheus, the image is versioned and includes no Alpine or slim variants. It's based on a minimal base image that includes only Prometheus binaries and dependencies.

prom/prometheus:latest

Latest stable release.Use for dev or testing clusters where version drift is acceptable.•

prom/prometheus:<version>

Tagged by version (e.g. v2.52.0, v2.45.3).

Recommended for production deployments to ensure consistency and compatibility.All configuration is file-based; no built-in support for environment-variable configuration.