mirror of
https://github.com/prometheus-community/ansible
synced 2024-11-29 07:10:18 +00:00
55 lines
2 KiB
Markdown
55 lines
2 KiB
Markdown
|
# Ansible Role: influxdb exporter
|
||
|
|
|
||
|
|
## Description
|
||
|
|
|
||
|
|
Deploy prometheus [influxdb exporter](https://github.com/prometheus/influxdb_exporter) using ansible.
|
||
|
|
|
||
|
|
## Requirements
|
||
|
|
|
||
|
|
- Ansible >= 2.9 (It might work on previous versions, but we cannot guarantee it)
|
||
|
|
- gnu-tar on Mac deployer host (`brew install gnu-tar`)
|
||
|
|
|
||
|
|
## Role Variables
|
||
|
|
|
||
|
|
All variables which can be overridden are stored in [defaults/main.yml](defaults/main.yml) file as well as in [meta/argument_specs.yml](meta/argument_specs.yml).
|
||
|
|
Please refer to the [collection docs](https://prometheus-community.github.io/ansible/branch/main/influxdb_exporter_role.html) for description and default values of the variables.
|
||
|
|
|
||
|
|
## Example
|
||
|
|
|
||
|
|
### Playbook
|
||
|
|
|
||
|
|
Use it in a playbook as follows:
|
||
|
|
|
||
|
|
```yaml
|
||
|
|
- hosts: all
|
||
|
|
roles:
|
||
|
|
- prometheus.prometheus.influxdb_exporter
|
||
|
|
```
|
||
|
|
|
||
|
|
### Demo site
|
||
|
|
|
||
|
|
We provide an example site that demonstrates a full monitoring solution based on prometheus and grafana.
|
||
|
|
The repository with code and links to running instances is [available on github](https://github.com/prometheus/demo-site) and the site is hosted on [DigitalOcean](https://digitalocean.com).
|
||
|
|
|
||
|
|
## Local Testing
|
||
|
|
|
||
|
|
The preferred way of locally testing the role is to use Docker and [molecule](https://github.com/ansible-community/molecule) (v3.x).
|
||
|
|
You will have to install Docker on your system. See "Get started" for a Docker package suitable for your system. Running your tests is as simple as executing `molecule test`.
|
||
|
|
|
||
|
|
## Continuous Integration
|
||
|
|
|
||
|
|
Combining molecule and circle CI allows us to test how new PRs will behave when used with multiple ansible versions and multiple operating systems.
|
||
|
|
This also allows use to create test scenarios for different role configurations. As a result we have quite a large test matrix which can take more time than local testing, so please be patient.
|
||
|
|
|
||
|
|
## Contributing
|
||
|
|
|
||
|
|
See [contributor guideline](CONTRIBUTING.md).
|
||
|
|
|
||
|
|
## Troubleshooting
|
||
|
|
|
||
|
|
See [troubleshooting](TROUBLESHOOTING.md).
|
||
|
|
|
||
|
|
## License
|
||
|
|
|
||
|
|
This project is licensed under MIT License. See [LICENSE](/LICENSE) for more details.
|