prometheus / prometheus

Prometheus
 Visit prometheus.io for the full documentation,
examples and guides. 
[ ][quay]
[ ][hub]
Prometheus, a Cloud Native Computing Foundation project, is a systems and service monitoring system. It collects metrics
from configured targets at given intervals, evaluates rule expressions,
displays the results, and can trigger alerts when specified conditions are observed.
The features that distinguish Prometheus from other metrics and monitoring systems are:
* A **multi-dimensional** data model (time series defined by metric name and set of key/value dimensions)
* PromQL, a **powerful and flexible query language** to leverage this dimensionality
* No dependency on distributed storage; **single server nodes are autonomous**
* An HTTP **pull model** for time series collection
* **Pushing time series** is supported via an intermediary gateway for batch jobs
* Targets are discovered via **service discovery** or **static configuration**
* Multiple modes of **graphing and dashboarding support**
* Support for hierarchical and horizontal **federation**
## Architecture overview
## Install
There are various ways to install Prometheus.
### Precompiled binaries
Precompiled binaries for released versions are available in the
*download* section
on prometheus.io. Using the latest production release binary
is the recommended way to install Prometheus.
See the Installing
chapter in the documentation for all the details.
### Docker images
Docker images are available on Quay.io or Docker Hub.
You can launch a Prometheus container for trying it out with
 [code] 
Prometheus will now be reachable at .
### Building from source
To build Prometheus from source code, you need:
* Go: Version specified in go.mod or greater.
* NodeJS: Version specified in .nvmrc or greater.
* npm: Version 10 or greater (check with `npm --version` and here).
Start by cloning the repository:
 [code] 
You can use the `go` tool to build and install the `prometheus`
and `promtool` binaries into your `GOPATH`:
 [code] 
*However*, when using `go install` to build Prometheus, Prometheus will expect to be able to
read its web assets from local filesystem directories under `web/ui/static`. In order for
these assets to be found, you will have to run Prometheus from the root of the cloned
repository. Note also that this directory does not include the React UI unless it has been
built explicitly using `make assets` or `make build`.
An example of the above configuration file can be found here.
You can also build using `make build`, which will compile in the web assets so that
Prometheus can be run from anywhere:
 [code] 
The Makefile provides several targets:
* *build*: build the `prometheus` and `promtool` binaries (includes building and compiling in web assets)
* *test*: run the tests
* *test-short*: run the short tests
* *format*: format the source code
* *vet*: check the source code for common errors
* *assets*: build the React UI
### Service discovery plugins
Prometheus is bundled with many servi