Ansible Role: node_exporter

Install and configure Prometheus node_exporter.

Requirements

An Ansible 2.2 or higher installation.
This role makes use of the Ansible json_filter that requires jmespath to be installed on the Ansible machine. See the requirements.txt file for further details on the specific version of jmespath required by the role.

Role Variables

Available variables are listed below, along with default values (see defaults/main.yml):

node_exporter_release_tag: "latest"

The node_exporter release to be installed. By default, the latest release published at https://github.com/prometheus/node\_exporter/releases.

node_exporter_release_url: ""

If set, the role will download node-exporter from the provided URL instead of using the download URL indicated in the node_exporter Github release metadata.

node_exporter_user: "node_exporter"
node_exporter_group: "node_exporter"

node_exporter system user and group.

node_exporter_install_path: "/opt"

Directory containing the downloaded node_exporter release artifacts.

node_exporter_bin_path: "/usr/local/bin"

Directory to which the node_exporter binaries will be symlinked.

node_exporter_listen_address: "127.0.0.1:9100"

The node_exporter WebServer listen ip address and port.
NOTE: the node_exporter metrics will be available at {{ node_exporter_listen_address }}/metrics.

node_exporter_log_level: "info"

node_exporter logs verbosity level.

node_exporter_collector_textfile_path: "/var/lib/node_exporter/textfile-collector/"

Directory used by the node_exporter's textfile collector to look for *.prom metrics files to be exposed by the exporter. See https://github.com/prometheus/node_exporter#textfile-collector.

node_exporter_additional_cli_args: ""

Additional command-line arguments to be added to the node_exporter service unit. For the complete refence of the available CLI arguments please refer to the output of the node_exporter --help command.

Dependencies

None.

Example Playbooks

$ cat playbook.yml
- name: "Install and configure Prometheus node_exporter"
  hosts: all
  roles:
    - { role: atosatto.node_exporter }

Testing

Tests are automated with Molecule.

$ pip install tox

To test all the scenarios run

$ tox

To run a custom molecule command

$ tox -e py27-ansible29 -- molecule test -s node_exporter-latest

License

MIT

Author Information

Andrea Tosatto (@_hilbert_)

atosatto / ansible-node_exporter