cookbook 'prometheus-platform', '~> 2.2.0'
prometheus-platform (5) Versions 2.2.0 Follow6
Cookbook used to install and configure prometheus
cookbook 'prometheus-platform', '~> 2.2.0', :supermarket
knife supermarket install prometheus-platform
knife supermarket download prometheus-platform
Prometheus Platform
Description
Prometheus is an Open-source systems monitoring and alerting toolkit originally
built at SoundCloud.
This cookbook is designed to install and configure Prometheus with its
Alertmanager and all exporters listed on https://prometheus.io/download.
Others, specific exporters are out of the scope of this cookbook.
Requirements
Cookbooks and gems
Declared in [metadata.rb](metadata.rb) and in [Gemfile](Gemfile).
Platforms
Should works on every Linux distro managed by systemd, possibly with minor
adjustments. Tested on CentOS 7.
Usage
Test
This cookbook is tested through the installation of 2 nodes in docker hosts:
- a master with Prometheus server, Alertmanager, Pushgateway, Node exporter and Statsd exporter
- a worker with Node exporter and Statsd exporter.
This uses kitchen, docker and some monkey-patching.
For more information, see .kitchen.yml and test directory.
Attributes
Configuration is done by overriding default attributes. All configuration keys
have a default defined in:
[attributes/default.rb](attributes/default.rb).
Please read it to have a comprehensive view of what and how you can configure
this cookbook behavior.
You can also look at the role written for the tests to have an example on how
to configure this cookbook:
[server](test/integration/roles/prometheus-platform-server.json) and
[node](test/integration/roles/prometheus-platform.json).
Recipes
default
Include all others recipes.
user
Create user/group used by Prometheus
install
Install all components with sub-attribute 'install?' as true.
scrapers
Prepare scrape_configs configuration from scrapers attributes. Use
cluster-search to create a dynamic "static_configs".
config
Generate and deploy configuration for all components.
Also generate the alerting and recording rules for Prometheus.
service
Deploy systemd units for all components.
Resources/Providers
None.
Changelog
Available in [CHANGELOG.md](CHANGELOG.md).
Contributing
Please read carefully [CONTRIBUTING.md](CONTRIBUTING.md) before making a merge
request.
License and Author
- Author:: Samuel Bernard (samuel.bernard@gmail.com)
- Author:: Florian Philippon (florian.philippon@gmail.com)
Copyright (c) 2016-2017 Sam4Mobile, 2017-2020 Make.org 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.
Dependent cookbooks
cluster-search >= 0.0.0 |
ark >= 0.0.0 |
Contingent cookbooks
There are no cookbooks that are contingent upon this one.
Changelog
2.2.0
Main:
- fix: use correct config variable for checksum
- feat: update all components to latest version
- prometheus to 2.17.2
- alertmanager to 0.20.0
- blackbox_exporter to 0.16.0
- consul_exporter to 0.6.0
- graphite_exporter to 0.7.0
- memcached_exporter to 0.6.0
- mysqld_exporter to 0.12.1
- node_exporter to 0.18.1
- pushgateway to 1.2.0
- statsd_exporter to 0.15.0
Tests:
- fix pushgateway journalctl expected output
- fix statsd journalctl expected output
- add rspec-core to Gemfile
- accept chef license
- make kitchen.yml config file visible
- switch to chefplatform image
Misc:
- chore: add time to storage.tsdb.retention option
- chore: set 2020 in copyright notice
- style(rubocop): fix multiple offenses
- add FrozenStringLiteralComment
- use
e
instead oferror
- do not use send method mith mix-in
2.1.0
Main:
- feat: add alertmanager template generation
- feat: update all components to latest version
Misc:
- chore: set generic maintainer & helpdesk email
- chore: add supermarket category in .category
- style: fix rubocop offenses (add line after guard)
- fix: replace match? by match for ruby 2.3 compat
- doc: use doc in git message instead of docs
2.0.0
Main:
- feat: breaking change migration to support Prometheus 2.X (actually 2.2.1)
- update all components to latest version
- set all flags with double dash
- put alertmanager discovery in config
- update storage flags
- reformat rules in yaml
- adapt tests to new logs
Tests:
- fix waiting condition on targets
- include .gitlab-ci.yml from test-cookbook
- replace deprecated require_chef_omnibus
Misc:
- feat: set default data retention to 15d
- chore: add 2018 to copyright notice
1.1.0
Main:
- add default config for scrapers
- change default data directories to /var/opt
- update default version of components:
- prometheus to 1.7.2
- blackbox to 0.9.1
- alertmanager to 0.9.1
Tests:
- fix rubocop on heredoc delimiters
1.0.0
Initial version:
- with Centos support
- manage all artifacts available on https://prometheus.io/download/
Collaborator Number Metric
2.2.0 failed this metric
Failure: Cookbook has 1 collaborators. A cookbook must have at least 2 collaborators to pass this metric.
Contributing File Metric
2.2.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file
Foodcritic Metric
2.2.0 passed this metric
No Binaries Metric
2.2.0 passed this metric
Testing File Metric
2.2.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
2.2.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
2.2.0 failed this metric
2.2.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file
Foodcritic Metric
2.2.0 passed this metric
No Binaries Metric
2.2.0 passed this metric
Testing File Metric
2.2.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
2.2.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
2.2.0 passed this metric
2.2.0 passed this metric
Testing File Metric
2.2.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
2.2.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
2.2.0 failed this metric
2.2.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number