https://github.com/dgibbs64/ansible-role-netdata
An Ansible role that installs and configures netdata agent for standalone or cloud use.
https://github.com/dgibbs64/ansible-role-netdata
ansible netdata
Last synced: 11 months ago
JSON representation
An Ansible role that installs and configures netdata agent for standalone or cloud use.
- Host: GitHub
- URL: https://github.com/dgibbs64/ansible-role-netdata
- Owner: dgibbs64
- License: mit
- Created: 2023-06-11T19:43:35.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2024-04-27T17:15:54.000Z (about 2 years ago)
- Last Synced: 2024-05-01T15:46:12.027Z (about 2 years ago)
- Topics: ansible, netdata
- Language: Jinja
- Homepage:
- Size: 101 KB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# netdata
An [Ansible](https://www.ansible.com) role that installs and configures netdata agent for standalone or cloud use.
## About
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.
## Requirements
Requires a Netdata account to use the cloud features.
### Supported Distros
- AlmaLinux >= 9
- AmazonLinux 2023
- Debian >= 12
- Fedora >= 41
- openSUSE >= 15.6
- OracleLinux >= 8
- Pop!\_OS >= 20.04
- Redhat Enterprise Linux >= 9
- Rocky Linux >= 9
- Ubuntu >= 20.04
> Note: This role will check the distro and skip the role if the distro is not supported. This can be bypassed by setting `netdata_distro_check_bypass` to `true`.
## Role Variables
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](https://learn.netdata.cloud/docs/installing/install-with-a-cicd-provisioning-system/ansible#edit-the-varsmainyml-file) for more information.
To disable the standalone dashboard set `netdata_agent_web_enabled` to `false`. See the [Netdata documentation](https://learn.netdata.cloud/docs/configuring/securing-netdata-agents/) for more information on securing netdata.
```yaml
# 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:
```
## Dependencies
```yaml
community.general
```
## Example Playbook
```yaml
---
- name: Netdata
hosts: all
roles:
- dgibbs64.netdata
```
## License
MIT
## Author Information
- [Daniel Gibbs](https://danielgibbs.co.uk)