Netdata

1. Overview
2. Role Variables
3. Example Playbook
4. Configuration
5. Development
6. License
7. Author Information

Overview

A role to manage Netdata installation and configuration.

Role Variables

• netdata__base_packages : List of base packages in order to provide Netdata [default : netdata].
• netdata__install_recommends : If recommends packages should be install [default : True].
• netdata__deploy_state : The desired state this role should achieve. [default : present].
• netdata__etc_src : Directory used as source to templating /etc/netdata configuration content [default : ../templates/etc/netdata].
• netdata__service_name : The service name to manage [default : netdata].
• netdata__service_manage : If the Netdata services should be managed [default : True].

Example Playbook

• Use defaults vars :

- hosts: mynode.DOMAIN
  roles:
    - role: ipr-cnrs.netdata
      tags: ['role::netdata', 'ipr']

• Use your own Netdata's configuration as source :

- hosts: mynode.DOMAIN
  roles:
    - role: ipr-cnrs.netdata
      netdata__etc_src: '{{ inventory_dir + "/../resources/host/mynode.DOMAIN/etc/netdata/" }}'

• Ensure your directory contains only templates or sub-directories, such as :

mynode.DOMAIN
└── etc
    └── netdata
        ├── fping.conf.j2
        ├── health_alarm_notify.conf.j2
        ├── netdata.conf.j2
        └── node.d
            ├── named.conf.md.j2
            ├── README.md.j2
            ├── sma_webbox.conf.md.j2
            └── snmp.conf.md.j2

Configuration

This role will :

• Install needed packages to provide netdata service.
• Manage Netdata configuration (/etc/netdata).
• Ensure Netdata service is enabled and started.

Development

This source code comes from our Gogs instance and the Github repo exist just to be able to send the role to Ansible Galaxy…

But feel free to send issue/PR here :)

Thanks to this hook, Github automatically got updates from our Gogs instance :)

License

WTFPL

Author Information

Jérémy Gardais

• Source : on IPR's Gogs
• IPR (Institut de Physique de Rennes)