ansible.netdata/README.md

6.6 KiB
Raw Permalink Blame History

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__group_name: Name of the directory which contains configuration files for this specific group [default: nonexistent-host-group].
  • netdata__default_etc_src: Directory which contains configuration files for Netdata from this role [default: ../templates/etc/netdata].
  • netdata__etc_src: Directory which contains configuration files that should be managed on all hosts [default: ../templates/etc/netdata].
  • netdata__group_etc_src: Directory which contains configuration files for Netdata that should be managed by a specific Ansible inventory group [default: {{ (inventory_dir | realpath + "/../resources/") + "files/by-group/" + netdata__group_name + "/etc/netdata" }}].
  • netdata__host_etc_src: Directory which contains configuration files for Netdata that should be managed on specific host [default: {{ (inventory_dir | realpath + "/../resources/") + "files/by-host/" + inventory_hostname + "/etc/netdata" }}].
  • netdata__service_name: The service name to manage [default: netdata].
  • netdata__service_manage: If the Netdata services should be managed [default: True].
  • netdata__conf_bind_ip: IP address used by Netdata to listen [default: 127.0.0.1].
  • netdata__conf_bind_port: Port used by Netdata to listen [default: 19999].
  • netdata__conf_memory_mode: The memory mode of the database [default: ram].
  • **netdata__conf_recipient_emaiThe default email recipient to use if a role doesn't define one [default: root].
  • netdata__registry_enable: If node should be a registry [default: False].
  • netdata__registry_announce: The URL of the registry [default: ''].
  • netdata__registry_hostname: The server name to display on the registry (max 50. char) [default: {{ ansible_hostname }}].
  • netdata__slave_enable: If node should send metrics to a master [default: False].
  • netdata__slave_destination: The destination to send metrics to [default: netdata.{{ ansible_domain }}].
  • netdata__slave_api_key: The API KEY to use to identify with the master [default: ''].
  • netdata__slave_buffer_size: The buffer to use for sending metrics [default: ``].
  • netdata__slave_reconnect: If the connection fails, or it disconnects, retry after that many seconds [default: 5].
  • netdata__master_enable: If node should receive metrics from other nodes [default: False].
  • netdata__master_api_key: The API key to authenticate slaves [default: ''].
  • netdata__master_history: The number of entries in the database per hosts [default: 3600].
  • netdata__master_memory_mode: The memory mode to be used for all hosts using this API key [default: ram].
  • netdata__master_health_alarm: Shall the master send alarms for hosts using the API key [default: auto].

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:
    • Ensure you have resources directory contains only templates or sub-directories, such as:
inventory
├── group_vars
│   ├── all
│   │   ├── ….yml
│   │   └── netdata.yml
│   └── …
resources
├── files
│   ├── by-group
│   │   └── all
│   │   │   ├── etc
│   │   │   │   ├── netdata
│   │   │   │   │   ├── health.d
│   │   │   │   │   │   └── ram.conf.j2
│   │   │   │   │   ├── plugins.d
│   │   │   │   │   │   └── python.d.plugin
│   │   │   │   │   └── python.d
│   │   │   │   │       └── fail2ban.chart.py
  • Listen on LAN, be careful, Netdata is not designed to be exposed (see issue 64):
- hosts: mynode.DOMAIN
  roles:
    - role: ipr-cnrs.netdata
      netdata__etc_src: '{{ inventory_dir + "/../resources/host/mynode.DOMAIN/etc/netdata/" }}'

Configuration

This role will:

  • Install needed packages to provide netdata service.
  • Manage Netdata configuration directory (/etc/netdata) from several sources (netdata__default_etc_src, netdata__etc_src, netdata__group_etc_src and netdata__host_etc_src).
  • Ensure Netdata service is enabled and started.
  • Set up some basics configuration (bind ip, port,…).
  • Set up registry configuration (take a look on the documentation).
  • Can set up a slave/master configuration, but it's highly recommended to take a look to registry before.

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