You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
AllenZMC 1e62435960 fix wrong spells in live_reader.go (#5899) 16 hours ago
.circleci *: bump Go version to 1.13 (#6020) 1 week ago
.github Revert "Add GH actions" (#5950) 3 weeks ago
cmd add checks for metrics and display duplicate fields (#6026) 1 day ago
config Removed extra tsdb/testutil after merge. 1 month ago
console_libraries Added humanizePercentage formatting to templates (#5670) 3 months ago
consoles Update console template example metric names. (#5678) 3 months ago
discovery remove resetting of manager properties and init manager props under locking (#5979) 2 weeks ago
docs Third correction (#6012) 1 day ago
documentation Merge pull request #5787 from cstyan/reshard-max-logging 1 week ago
notifier notifier: return nil is better. (#5958) 2 weeks ago
pkg Fix exported function comments (#6002) 1 week ago
prompb remote-read: streamed chunked server side; Extended protobuf; Added chunked, checksumed reader (#5703) 1 month ago
promql fix wrong spells in live_reader.go (#5899) 16 hours ago
rules *: improve error messages when parsing bad rules (#5965) 3 weeks ago
scrape Ctx name (#5961) 3 weeks ago
scripts *: enable all default linters (#5504) 4 months ago
storage Move WAL watcher code to tsdb/wal package. (#5999) 2 days ago
template template: remove redundant parentheses. (#5904) 1 month ago
tsdb fix wrong spells in live_reader.go (#5899) 16 hours ago
util remove missing substitution in the Equal test util. (#6039) 2 days ago
vendor vendor: Update json-iterator (#6030) 4 days ago
web cleanup redundant code of `TestEndpoints` (#6022) 3 days ago
.dockerignore Docker images for ARM32v7 and ARM64v8 (#5031) 5 months ago
.gitignore *: enable golangci-lint (#5437) 5 months ago
.golangci.yml *: enable all default linters (#5504) 4 months ago
.promu.yml *: bump Go version to 1.13 (#6020) 1 week ago
.travis.yml *: bump Go version to 1.13 (#6020) 1 week ago
CHANGELOG.md Cut v2.12.0 (#5913) 1 month ago
CONTRIBUTING.md *: bump Go version to 1.13 (#6020) 1 week ago
Dockerfile Docker images for ARM32v7 and ARM64v8 (#5031) 5 months ago
LICENSE Clean up license issues. 4 years ago
MAINTAINERS.md Update Fabian's email address 9 months ago
Makefile Cleanup after merging tsdb into prometheus 1 month ago
Makefile.common Bump golangci-lint to v1.18.0 (#6004) 1 week ago
NOTICE Change http to https for security links (#5238) 7 months ago
README.md *: bump Go version to 1.13 (#6020) 1 week ago
RELEASE.md Add Chris Marchbanks as release shepherd for v2.14 (#5985) 2 weeks ago
VERSION Cut v2.12.0 (#5913) 1 month ago
code-of-conduct.md Add CNCF code of conduct as the Prometheus code of conduct 2 years ago
fuzzit.sh Fix fuzzit job (#6005) 1 week ago
go.mod vendor: Update json-iterator (#6030) 4 days ago
go.sum vendor: Update json-iterator (#6030) 4 days ago

README.md

Prometheus

Build Status CircleCI Docker Repository on Quay Docker Pulls Go Report Card CII Best Practices fuzzit

Visit prometheus.io for the full documentation, examples and guides.

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 if some condition is observed to be true.

Prometheus’ main distinguishing features as compared to other monitoring systems are:

  • a multi-dimensional data model (timeseries defined by metric name and set of key/value dimensions)
  • a flexible query language to leverage this dimensionality
  • no dependency on distributed storage; single server nodes are autonomous
  • timeseries collection happens via a pull model over HTTP
  • pushing timeseries is supported via an intermediary gateway
  • 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 of installing 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 of installing Prometheus. See the Installing chapter in the documentation for all the details.

Debian packages are available.

Docker images

Docker images are available on Quay.io or Docker Hub.

You can launch a Prometheus container for trying it out with

$ docker run --name prometheus -d -p 127.0.0.1:9090:9090 prom/prometheus

Prometheus will now be reachable at http://localhost:9090/.

Building from source

To build Prometheus from the source code yourself you need to have a working Go environment with version 1.13 or greater installed.

You can directly use the go tool to download and install the prometheus and promtool binaries into your GOPATH:

$ go get github.com/prometheus/prometheus/cmd/...
$ prometheus --config.file=your_config.yml

You can also clone the repository yourself and build using make:

$ mkdir -p $GOPATH/src/github.com/prometheus
$ cd $GOPATH/src/github.com/prometheus
$ git clone https://github.com/prometheus/prometheus.git
$ cd prometheus
$ make build
$ ./prometheus --config.file=your_config.yml

The Makefile provides several targets:

  • build: build the prometheus and promtool binaries
  • test: run the tests
  • test-short: run the short tests
  • format: format the source code
  • vet: check the source code for common errors
  • assets: rebuild the static assets
  • docker: build a docker container for the current HEAD

More information

  • The source code is periodically indexed: Prometheus Core.
  • You will find a Travis CI configuration in .travis.yml.
  • See the Community page for how to reach the Prometheus developers and users on various communication channels.

Contributing

Refer to CONTRIBUTING.md

License

Apache License 2.0, see LICENSE.