bandsintown/prometheus repository overview

⁠What is Prometheus?

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

⁠Motivation

We built this image to use Consul and Consul Template to be able to configure prometheus dynamically.

In particular we want to be able to add scraping targets⁠, and alerting rules⁠.

This image allows to define the prometheus.yml file as a Consul key and to declare the alerting rules as keys.

⁠Configuration through Consul

To manage the prometheus configuration through Consul you have to create a Consul key at service/prometheus/global.yml to register the global configuration. The global configuration MUST NOT contains the rule_files section.

Then to add an alerting rules you have to create Consul key at service/prometheus/rule_files/<name>.

When an rule_file is created as a Consul key, the rule is automatically added to the prometheus.yml configuration and the service is reloaded.

⁠License

All the code contained in this repository, unless explicitly stated, is licensed under ISC license.

A copy of the license can be found inside the LICENSE⁠ file.