The Prometheus monitoring system and time series database.
Branch: master
Clone or download
simonpasquier storage/remote: increase timeouts for Travis CI (#5224)
* storage/remote: adapt tests for Travis CI

Signed-off-by: Simon Pasquier <spasquie@redhat.com>

* Check filesystems on Travis environment

Signed-off-by: Simon Pasquier <spasquie@redhat.com>

* Run remote/storage tests on CircleCI for troubleshooting

Signed-off-by: Simon Pasquier <spasquie@redhat.com>

* Try using tmpfs partition

Signed-off-by: Simon Pasquier <spasquie@redhat.com>

* Revert "Try using tmpfs partition"

This reverts commit 85a30de.

Signed-off-by: Simon Pasquier <spasquie@redhat.com>

* Don't store labels in writeToMock

Signed-off-by: Simon Pasquier <spasquie@redhat.com>

* Fix data race

Signed-off-by: Simon Pasquier <spasquie@redhat.com>

* Bump retries to 100 meaning that the total timeout is 10s

Signed-off-by: Simon Pasquier <spasquie@redhat.com>

* clean up .travis.yml

Signed-off-by: Simon Pasquier <spasquie@redhat.com>

* code fixup

Signed-off-by: Simon Pasquier <spasquie@redhat.com>

* Remove unneeded empty line

Signed-off-by: Simon Pasquier <spasquie@redhat.com>
Latest commit b41d6d5 Feb 15, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci *: bump gRPC dependencies (#5075) Jan 15, 2019
.github Fix quoting in issue template (#4688) Oct 2, 2018
cmd Tail the TSDB WAL for remote_write Feb 12, 2019
config Tail the TSDB WAL for remote_write Feb 12, 2019
console_libraries Cut down console template examples to just node and prometheus (#3099) Aug 21, 2017
consoles Update example console template for node exporter 0.16.0 (#4208) Jun 8, 2018
discovery Fix fmt.Errorf error message (#5199) Feb 10, 2019
docs docs: Specifically call out NFS and POSIX Jan 31, 2019
documentation update remote write path proto so that Labels/Timeseries can't be nil ( Jan 15, 2019
notifier Fix typo in comment (#5061) Jan 4, 2019
pkg show list of offending labels in the error message in many-to-many sc… Feb 9, 2019
prompb update remote write path proto so that Labels/Timeseries can't be nil ( Jan 15, 2019
promql show list of offending labels in the error message in many-to-many sc… Feb 9, 2019
relabel Moved configuration into `relabel` package. (#4955) Dec 18, 2018
rules Fix prometheus_rule_group_last_evaluation_timestamp_seconds Feb 6, 2019
scrape scrape: catch errors when creating HTTP clients (#5182) Feb 13, 2019
scripts *: bump gRPC dependencies (#5075) Jan 15, 2019
storage storage/remote: increase timeouts for Travis CI (#5224) Feb 15, 2019
template add alert template expanding failure metric (#4747) Nov 6, 2018
util corrected regex string check for anyorigin(*) (#5117) Jan 21, 2019
vendor Various fixes to locking & shutdown for WAL-based remote write. Feb 12, 2019
web Tail the TSDB WAL for remote_write Feb 12, 2019
.dockerignore New release process using docker, circleci and a centralized Apr 18, 2016
.gitignore cleanup gitignore (#3869) Feb 20, 2018
.promu.yml promu: fix ldflags for Go modules (#4929) Nov 30, 2018
.travis.yml storage/remote: increase timeouts for Travis CI (#5224) Feb 15, 2019
CHANGELOG.md Merge v2.7.1 into master (#5170) Feb 1, 2019
CONTRIBUTING.md Fix spelling/typos (#4921) Nov 27, 2018
Dockerfile Rollback Dockerfile to version @ 2.5.x (#5122) Jan 21, 2019
LICENSE Clean up license issues. Jan 21, 2015
MAINTAINERS.md Update Fabian's email address Nov 30, 2018
Makefile *: bump gRPC dependencies (#5075) Jan 15, 2019
Makefile.common Unset GO111MODULE variable in Makefile.common (#5191) Feb 7, 2019
NOTICE Update NOTICE for gogo/protobuf Nov 2, 2017
README.md Move the build badge to the badge list (#5060) Jan 3, 2019
RELEASE.md Propose @codesome as 2.8 release shepherd Feb 11, 2019
VERSION Merge v2.7.1 into master (#5170) Feb 1, 2019
code-of-conduct.md Add CNCF code of conduct as the Prometheus code of conduct Oct 19, 2016
go.mod Use the latest versions of azure go sdk and go-autorest (#5015) Jan 28, 2019
go.sum Use the latest versions of azure go sdk and go-autorest (#5015) Jan 28, 2019

README.md

Prometheus

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

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.11 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.