summaryrefslogtreecommitdiffstats
path: root/docs/netdata-agent/configuration/dynamic-configuration.md
blob: 7064abf9ab002584a3464a31e6bf7a3efd20b460 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
# Dynamic Configuration Manager

**Netdata Cloud paid subscription required.**

The Dynamic Configuration Manager allows direct configuration of collectors and alerts through the Netdata UI. This feature allows users to:

- **Create, test, and deploy configurations** for one or more nodes directly within the UI.
- **Eliminate the need for manual command-line edits and node access**, enhancing workflow efficiency.

**Cloud Connection and Security**: Nodes using Dynamic Configuration Manager require a connection to Netdata Cloud. This ensures proper permission handling and data security.

> **Info**
>
> To understand what actions users can perform based on their role, refer to the [Role Based Access documentation](/docs/netdata-cloud/authentication-and-authorization/role-based-access-model.md#dynamic-configuration-manager). 

## Collectors

### Module

A module represents a specific data collector, such as Apache, MySQL, or Redis. Think of modules as templates for data collection.

Each module can have multiple jobs, which are unique configurations of that template tailored to your specific needs.

You can manage individual modules using the following actions:

| Action             | Description                                                                                                               |
|--------------------|---------------------------------------------------------------------------------------------------------------------------|
| **Add job**        | Create new configuration instances (jobs) for a particular module.                                                        |
| **Enable/Disable** | Disabling a module deactivates all currently running jobs and prevents any future jobs from being created for that module |

### Job

A job represents a running instance of a module with a specific configuration. Think of it as a customized data collection task based on a module template.

Every job has a designated "source type" indicating its origin:

- **Stock**: Pre-installed with Netdata and provides basic data collection for common services.
- **User**: Originates from user-created files on the node.
- **Discovered**: Automatically generated by Netdata upon discovering a service running on the node.
- **Dynamic Configuration**: Created and managed using the Dynamic Configuration Manager.

You can manage individual jobs using the following actions:

| Action             | Description                                                                                                                                                                                 |
|--------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **Restart**        | This restarts a job's data collection, useful if a job encounters a "Failed" state. Upon restart, a notification with the failure message will be displayed.                                |
| **Remove**         | Delete a job configuration entirely. Note that only jobs created through Dynamic Configuration can be removed. Other job types originate from files on the node and cannot be deleted here. |
| **Enable/Disable** | Control the job's activity. Disabling a running job stops data collection.                                                                                                                  |
| **Edit**           | Modify an existing job's configuration.                                                                                                                                                     |
| **Test**           | Validate newly created or edited configurations before applying them permanently.                                                                                                           |

## Health

Each entry in the Health tab contains an Alert template, that then is used to create Alerts.

The functionality in the main view is the same as with the [Collectors tab](#collectors).

### Health entry configuration

You can create new configurations both for templates or individual Alerts.

Each template can have multiple items which resemble Alerts that either apply to a certain [instance](/docs/dashboards-and-charts/netdata-charts.md#instances-dropdown), or all instances under a specific [context](/docs/dashboards-and-charts/netdata-charts.md#contexts)