https://github.com/geerlingguy/ansible-role-node_exporter

Ansible role - Node exporter
https://github.com/geerlingguy/ansible-role-node_exporter

ansible ansible-role monitoring node-exporter prometheus

Last synced: 14 days ago
JSON representation

Ansible role - Node exporter

• Host: GitHub
• URL: https://github.com/geerlingguy/ansible-role-node_exporter
• Owner: geerlingguy
• License: mit
• Created: 2020-05-23T01:39:54.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2024-07-16T19:22:41.000Z (4 months ago)
• Last Synced: 2024-10-14T07:22:19.456Z (30 days ago)
• Topics: ansible, ansible-role, monitoring, node-exporter, prometheus
• Language: Jinja
• Homepage: https://galaxy.ansible.com/geerlingguy/node_exporter
• Size: 33.2 KB
• Stars: 107
• Watchers: 4
• Forks: 68
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
# Ansible Role: Node exporter

[![CI](https://github.com/geerlingguy/ansible-role-node_exporter/workflows/CI/badge.svg?event=push)](https://github.com/geerlingguy/ansible-role-node_exporter/actions?query=workflow%3ACI)

This role installs Prometheus' [Node exporter](https://github.com/prometheus/node_exporter) on Linux hosts, and configures a systemd unit file so the service can run and be controlled by systemd.

**Note**: If you're running in a Kubernetes cluster, you could run Node exporter as a DaemonSet in the cluster, instead of installing it on individual nodes.

## Requirements

N/A

## Role Variables

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

    node_exporter_version: '0.18.1'

The version of Node exporter to install. Available releases can be found on the [tags](https://github.com/prometheus/node_exporter/tags) listing in the Node exporter repository. Drop the `v` off the tag.

If you change the version, the `node_exporter` binary will be replaced with the updated version, and the service will be restarted.

    node_exporter_arch: 'amd64'

    node_exporter_download_url: https://github.com/prometheus/node_exporter/releases/download/v{{ node_exporter_version }}/node_exporter-{{ node_exporter_version }}.linux-{{ node_exporter_arch }}.tar.gz

The architecture and download URL for Node exporter. If you're on a Raspberry Pi running Raspbian, you may need to override the `arch` value with `armv7`.

    node_exporter_bin_path: /usr/local/bin/node_exporter

The path where the `node_exporter` binary will be installed.

    node_exporter_host: 'localhost'

    node_exporter_port: 9100

Host and port on which node exporter will listen.

    node_exporter_options: ''

Any additional options to pass to `node_exporter` when it starts, e.g. `--no-collector.wifi` if you want to ignore any WiFi data.

    node_exporter_state: started

    node_exporter_enabled: true

Controls for the `node_exporter` service.

## Dependencies

None.

## Example Playbook

    - hosts: all

      roles:

        - role: geerlingguy.node_exporter

## License

MIT / BSD

## Author Information

This role was created in 2020 by [Jeff Geerling](https://www.jeffgeerling.com/), author of [Ansible for DevOps](https://www.ansiblefordevops.com/).