idealista.prometheus_jmx_exporter_role
Prometheus JMX 导出器 Ansible 角色
这个 Ansible 角色在 Debian 环境中安装 Prometheus Node Exporter。
开始使用
这些说明将帮助你在 ansible playbook 中获取该角色的副本。启动后,它将在 Debian 系统中安装一个 Prometheus JMX 导出器 服务器。
注意: 从 2.1.0 版本开始,默认行为是服务将日志发送到 systemd 的日志而不是日志文件。你可以通过修改相关的 ansible 变量来改变这一点(参见 defaults/main.yml)。
先决条件
必须安装 Ansible 2.9.x.x 版本。 库存目标应为 Debian 环境。
为了测试,使用 Molecule 和 Vagrant 作为驱动程序(与 vagrant-hostmanager 结合使用),以及 VirtualBox 作为提供者。
安装
创建或添加到你的角色依赖文件(例如 requirements.yml):
- src: idealista.prometheus_jmx_exporter_role
version: 2.1.2
name: prometheus_jmx_exporter
使用 ansible-galaxy 命令安装该角色:
ansible-galaxy install -p roles -r requirements.yml -f
在 playbook 中使用:
---
- hosts: someserver
roles:
- role: prometheus_jmx_exporter
使用
查看 defaults 属性文件,以了解可能的配置属性。
提供自定义配置
从 2.x.x 版本开始,为了提供自定义 JMX 导出器配置,可将 jmx_exporter_config_template_path
设置为 playbook 中的配置文件模板。例如:
jmx_exporter_config_template_path: "{{ playbook_dir }}/templates/jmx_exporter/config/jmx_config.yml"
在以前的版本中,该变量指向的是文件夹而不是文件。如果你自 1.x 版本以来一直在使用该角色,可以查看我们的 迁移指南。
测试
安装依赖
$ pipenv sync
有关更多信息,请阅读 pipenv 文档。
测试
$ pipenv run molecule test
构建工具
版本控制
有关可用版本,请参见 该仓库的标签。
此外,您可以查看每个版本的更改记录,见 CHANGELOG.md 文件。
作者
- Idealista - 合作方 - idealista
另见 贡献者 列表,查看参与本项目的人。
许可证
本项目许可遵循 Apache 2.0 许可证 - 详见 LICENSE 文件。
贡献
请阅读 CONTRIBUTING.md 以了解我们的行为准则及提交拉取请求的流程。