netdata

An Ansible role that installs and sets up the netdata agent for local or cloud use.

About

Netdata is a monitoring tool that runs on Linux to gather system data and show it on a web dashboard. This role can either install or uninstall the netdata agent, and it can be set up to use a local dashboard or a cloud dashboard.

Requirements

You need a Netdata account to access cloud features.

Supported Operating Systems

• AlmaLinux >= 8
• Amazon Linux 2023
• CentOS >= 8
• Debian >= 10
• Fedora >= 29
• openSUSE >= 15.4
• Oracle Linux >= 8
• Pop!_OS >= 20.04
• Red Hat Enterprise Linux >= 8
• Rocky Linux >= 8
• Ubuntu >= 20.04

Role Variables

By default, this role configures the netdata agent with the local dashboard on.

To enable cloud features, set netdata_cloud_enable to true and enter values for netdata_cloud_claim_token and netdata_cloud_claim_room_id. Check the Netdata Cloud documentation for details.

If you want to disable the local dashboard, change netdata_agent_web_enabled to false. More information on securing the netdata setup can be found in the Netdata documentation.

# Netdata cloud settings
# https://learn.netdata.cloud/docs/installing/install-with-a-cicd-provisioning-system/ansible#edit-the-varsmainyml-file
netdata_cloud_enable: false
netdata_cloud_claim_url: https://app.netdata.cloud
netdata_cloud_claim_token:
netdata_cloud_claim_room_id:
netdata_cloud_force_claim: false

# Netdata agent options
netdata_agent_channel: stable  # Choose stable or edge
netdata_agent_state: present    # Use present to install, or absent to remove

# Configuration template location
netdata_agent_conf_template: netdata.conf.j2

## Netdata agent web dashboard settings
# https://learn.netdata.cloud/docs/configuring/securing-netdata-agents/
netdata_agent_web_enabled: true
netdata_agent_web_port: 19999
netdata_agent_web_bind_to:
netdata_agent_web_allow_from:

Dependencies

community.general

Example Playbook

---
- name: Netdata
  hosts: all
  roles:
    - dgibbs64.netdata

License

MIT

Author Information

• Daniel Gibbs