An Ansible role that installs and configures netdata agent for standalone or cloud use.
Netdata is a monitoring agent that can be installed on Linux systems to collect metrics and provide a web dashboard for viewing metrics. This role will install or remove netdata agent and can be configured to use the standalone dashboard or the cloud dashboard.
Requires a Netdata account to use the cloud features.
- AlmaLinux >= 8
- AmazonLinux 2023
- CentOS >= 8
- Debian >= 10
- Fedora >= 29
- openSUSE >= 15.4
- OracleLinux >= 8
- Pop!_OS >= 20.04
- Redhat Enterprise Linux >= 8
- Rocky Linux >= 8
- Ubuntu >= 20.04
By default this role will setup netdata agent with the standalone dashboard enabled.
To enable cloud functionality change netdata_cloud_enable to true and set the netdata_cloud_claim_token and netdata_cloud_claim_room_id variables. See the Netdata Cloud documentation for more information.
To disable the standalone dashboard set netdata_agent_web_enabled to false. See the Netdata documentation for more information on securing netdata.
# Netdata cloud
# 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
# Channel stable|edge
netdata_agent_channel: stable
# Agent state present|absent
netdata_agent_state: present
# netdata.conf template location
netdata_agent_conf_template: netdata.conf.j2
## Netdata agent web dashboard
# 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:community.general---
- name: Netdata
hosts: all
roles:
- dgibbs64.netdataMIT
