prometheus Cookbook

This cookbook installs the Prometheus monitoring system and time-series database.

Requirements

• Chef 11 or higher
• Ruby 1.9.3 or higher

Platform

Tested on

• Ubuntu 14.04
• Ubuntu 12.04
• Debian 7.7
• Centos 6.6
• Centos 7.0

Attributes

In order to keep the README managable and in sync with the attributes, this cookbook documents attributes inline. The usage instructions and default values for attributes can be found in the individual attribute files.

Recipes

default

The default recipe installs creates all the default Prometheus directories, config files and and users. Default also calls the configured install_method recipe and finally calls the prometheus service recipe.

source

The source recipe builds Prometheus from a Github source tag.

binary

The binary recipe retrieves and installs a pre-compiled Prometheus build from a user-defined location.

service

The service recipe configures Prometheus to run under a process supervisor. Default supervisors are chosen based on distribution. Currently supported supervisors are init, runit, systemd, upstart and bluepill.

Resource/Provider

prometheus_job

This resource adds a job definition to the Prometheus config file. Here is an example of using this resource to define the default Prometheus job:

prometheus_job ‘prometheus’ do
  scrape_interval   ‘15s’
  target            “http://localhost#{node[‘prometheus’][‘flags’][‘web.listen-address’]}#{node[‘prometheus’][‘flags’][‘web.telemetry-path’]}”
end

Note: This cookbook uses the accumulator pattern so you can define multiple prometheus_job’s and they will all be added to the Prometheus config.

Externally managing prometheus.conf

If you prefer to manage your prometheus.conf file externally using your own inventory or service discovery mechanism you can set default[‘prometheus’][‘allow_external_config’] to true.

Dependencies

The following cookbooks are dependencies:

• build-essential
• apt
• yum
• runit
• bluepill
• accumulator
• ark

Usage

prometheus::default

Include prometheus in your node's run_list:

{
  "run_list": [
    "recipe[prometheus::default]"
  ]
}

Development

Please see the Contributing and Issue Reporting Guidelines.

License & Authors

• Author: Ray Rodriguez rayrod2030@gmail.com
• Author: kristian järvenpää kristian.jarvenpaa@gmail.com

Licensed under the Apache License, Version 2.0 (the “License”);
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an “AS IS” BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.