cookbook 'prometheus-platform', '= 2.0.0'
prometheus-platform (5) Versions 2.0.0 Follow6
Cookbook used to install and configure prometheus
cookbook 'prometheus-platform', '= 2.0.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-2018 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.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.0.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.0.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.0.0 passed this metric
No Binaries Metric
2.0.0 passed this metric
Testing File Metric
2.0.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.0.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.0.0 failed this metric
2.0.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.0.0 passed this metric
No Binaries Metric
2.0.0 passed this metric
Testing File Metric
2.0.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.0.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.0.0 passed this metric
2.0.0 passed this metric
Testing File Metric
2.0.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.0.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.0.0 failed this metric
2.0.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
