Skip to main content

Dynamic Configuration Manager

Table of Contents

Overview

important

Netdata Cloud paid subscription is required.

tip

What You'll Learn

How to access the Dynamic Configuration Manager and understand its key features for managing your monitoring infrastructure.

The Dynamic Configuration Manager allows you to configure collectors and alerts directly through the Netdata UI. This feature enables you to:

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

Cloud Connection and Security

Your nodes using Dynamic Configuration Manager require a connection to Netdata Cloud. This ensures proper permission handling and data security.

Key Features:

FeaturePurpose
Configure collector parametersSet up data collection settings directly in the UI
Fill out configuration formsUse guided interfaces instead of editing config files
Test configurations before deploymentValidate settings to prevent errors
Create alert templatesBuild reusable alert definitions
Apply templates to instances or contextsTarget specific services or apply broadly
Deploy to multiple nodes simultaneouslyEnsure consistency across your infrastructure
Manage Health tab alert templatesCreate configurations for templates and individual alerts that apply to instances or contexts
info

To understand what actions you can perform based on your role, refer to the Role-Based Access documentation.

Quick Access Methods

tip

What You'll Learn

Four different ways to access the Dynamic Configuration Manager, each optimized for different workflows.

You can access the Dynamic Configuration Manager in multiple ways:

From Any Chart

  1. Navigate to any chart on your dashboard
  2. Click the Alert icon (bell icon) at the top of the chart
  3. Choose to edit an existing alert or create a new one
  4. Configure your alert parameters and submit changes

From the Alerts Tab

  1. Go to the Alerts tab on your Netdata dashboard
  2. Locate the alert you want to modify and click on it
  3. Adjust thresholds and parameters to match your needs
  4. Save your changes

From the Integrations Section

  1. Navigate to the Integrations section on your dashboard
  2. Browse through the available collectors
  3. Click on the Configure button for the collector you want to set up
  4. Once configured, they will start collecting data as specified

From Space Settings

  1. Go to Space Settings on your Dashboard
  2. Navigate to the Configurations section
  3. Explore, create, and edit collector, health and logs configurations


tip

Currently available for go.d collectors, you can configure collectors straight from the Integrations section. This means you can quickly identify what Netdata can monitor and set up your configurations in one go.

Getting Started

tip

What You'll Learn

How to use each of the four access methods with practical step-by-step workflows.

tip

To help you get started with the Dynamic Configuration Manager, try using the Netdata demo environment to explore these capabilities firsthand and see how they can enhance your monitoring workflows.

Step-by-Step Walkthrough

Creating Alerts from Charts

Learn more about this access method: From Any Chart

  1. Navigate to the chart (context) you want to create an alert for
  2. Click on the Alert icon (bell icon) on top of the chart to edit an existing alert or create a new one
  3. Configure your alert parameters, such as rules, instances, thresholds, etc.
  4. Submit your changes

Managing Alerts from the Alerts Tab

Learn more about this access method: From the Alerts Tab

  1. Go to the Alerts tab on your Netdata dashboard
  2. Locate the alert you wish to modify and click on it
  3. Adjust the thresholds and other parameters to match your specific needs
  4. Save the changes

Configuring Collectors from Integrations

Learn more about this access method: From the Integrations Section

  1. Navigate to the Integrations section on the dashboard
  2. Browse through the available collectors
  3. Click on the Configure button for the collector you want to set up
  4. Once configured, they will start collecting data as specified

Managing Configurations from Space Settings

Learn more about this access method: From Space Settings

  1. Go to Space Settings on your Dashboard
  2. Navigate to the Configurations section
  3. Explore, create, and edit collector, health and logs configurations

Collectors

tip

What You'll Learn

How modules and jobs work together to collect data, and the specific actions you can perform on each.

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.

Module Management Actions:

ActionDescription
Add jobCreate new configuration instances (jobs) for a particular module
Enable/DisableDisabling 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.

Job Source Types:

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

Source TypeDescription
StockPre-installed with Netdata and provides basic data collection for common services
UserCreated from user-defined configuration files on the node
DiscoveredAutomatically generated by Netdata upon discovering a service running on the node
Dynamic ConfigurationManaged and created through the Dynamic Configuration Manager

Job Management Actions:

CategoryActionDescription
ConfigurationEditModify an existing job's configuration
ConfigurationTestValidate newly created or edited configurations before applying them permanently
ManagementEnable/DisableControl the job's activity. Disabling a running job stops data collection
ManagementRestartRestart a job's data collection, useful if a job encounters a "Failed" state. Upon restart, you'll see a notification with the failure message
ManagementRemoveDelete a job configuration entirely. Note that you can only remove jobs created through Dynamic Configuration. Other job types originate from files on the node and cannot be deleted here
important

Only jobs created through Dynamic Configuration can be removed. Other job types originate from files on the node and can’t be deleted through the UI.

Multi-Node Deployment

tip

What You'll Learn

How to deploy configurations to multiple nodes simultaneously, saving time and ensuring consistency across your infrastructure.

The Dynamic Configuration Manager allows you to submit configurations to multiple nodes with just one click, eliminating the need to configure each node individually.

note

For teams using Infrastructure as Code solutions, the Dynamic Configuration Manager allows you to construct and copy configurations easily, integrating them into your IaC workflows. This ensures your configurations are consistent and reproducible across different environments.

Multi-Node Deployment Process

Deploy to Multiple Nodes

  1. Configure your collectors or alerts using any of the methods described above
  2. Use the multi-node feature to select your target nodes
  3. Submit your configuration, and it will be applied to all selected nodes instantly


note

This feature is particularly valuable for managing large infrastructures where manual configuration of individual nodes would be time-consuming and error-prone.

Experience the efficiency and power of the Dynamic Configuration Manager in Netdata today. Whether you're managing a handful of nodes or a vast infrastructure, this feature will make your monitoring and alerting tasks smoother and more intuitive.

Developing with dynamic configuration? Click here.


Do you have any feedback for this page? If so, you can open a new issue on our netdata/learn repository.