TrueNAS AppsTrueNAS Apps: Tutorials
Application maintenance is independent from TrueNAS version release cycles.
App versions, features, options, and installation behavior at time of access might vary from documented tutorials and UI reference.

Netdata

The TrueNAS Netdata app provides an easy way to install and access the Netdata infrastructure monitoring solution. TrueNAS deploys the Netdata app in a Kubernetes container using the Helm package manager. After successfully deploying the app, you can access the Netdata web portal from TrueNAS. The Netdata web portal opens on the local dashboard, and where you can create new dashboards, add plugins, metric databases, physical and virtual systems, containers, and other cloud deployments you want to monitor. The portal also provides access to the Netdata Cloud sign-in screen.

Before You Begin

The TrueNAS Netdata app does not require advance preparation.

You can allow TrueNAS to automatically create storage volumes for the Netdata app or you can create specific datasets to use for configuration, cache, and library storage and extra storage volumes in the container pod. If using specific datasets, create these before beginning the app installation.

The administrator account must have sudo permissions enabled. To verify, go to Credentials > Local User. Click on the administrator user (e.g., admin), then click Edit. Scroll down to the sudo permissions. Select either Allow all sudo commands to permit changes after entering a password (not recommended in this instance) or Allow all sudo commands with not password to permit changes without requiring a password. If you upgraded from Angelfish or early releases of Bluefin that do not have an admin user account, see Creating an Admin User Account for instructions on correctly creating an administrator account with the required permissions.

You can create a Netdata account before or after installing and deploying the Netdata app.

Installing Netdata on TrueNAS

To install the Netdata application, go to Apps, click on Discover Apps, then either scroll down to the Netdata app widget or begin typing Netdata in the search field to filter the list to find the Netdata app widget.

Netdata App Widget
Figure 1: Netdata App Widget

Click on the widget to open the Netdata application details screen.

Netdata App Details Screen
Figure 2: Netdata App Details Screen

Click Install to open the Install Netdata screen.

Install Netdata Screen
Figure 3: Install Netdata Screen

Application configuration settings presented in several sections, are explained in Understanding Netdata Settings below. To find specific fields click in the Search Input Fields search field, scroll down to a particular section or click on the section heading on the navigation area in the upper-right corner.

Accept the default values in Application Name and Version.

Accept the default settings in Netdata Configuration and the default port in Node Port to use for Netdata UI. The TrueNAS Netdata app uses the default port 20489 to communicate with Netdata and show the Netdata local dashboard.

Make no changes in the Storage section to allow TrueNAS to create the storage volumes for the app, or to use datasets created for Netdata configuration storage, select Enable Host Path for Netdata to show the Host Path for Netdata Configuration settings.

Install Netdata Storage Enable Host Path
Figure 4: Install Netdata Storage Enable Host Path

Enter or browse to select the dataset created for Netdata configuration storage to populate the mount path. If using datasets created for cache and library storage, enable these options, then enter or browse to the datasets for each.

Accept the default settings in Advanced DNS Settings.

Accept the default values in Resources Limits or select Enable Pod Resource limits to show resource configuration options for CPU and memory and enter new values to suit your use case.

Click Install. The system opens the Installed Applications screen with the Netdata app in the Deploying state. When the installation completes it changes to Running.

Netdata Installed
Figure 5: Netdata Installed

Click Web Portal on the Application Info widget to open the Netdata web interface showing the local dashboard.

Netdata Web Portal Local Dashboard
Figure 6: Netdata Web Portal Local Dashboard

Understanding Netdata Wizard Settings

The following sections provide more detail explanations of the settings found in each section of the Install Netdata screen.

Application Name Settings

Netdata Configuration Settings

You can accept the defaults in the Netdata Configuration settings or enter the settings you want to use.

Click Add to the right of Netdata image environment to display the environment variable Name and Value fields. Netdata does not require using environment variables to deploy the application but you can enter any you want to use to customize your container.

Netdata Configuration Add Environment Variable
Figure 7: Netdata Configuration Add Environment Variable

The TrueNAS Netdata app uses port 20489 to communicate with Netdata and open the web portal. Netdata documentation states it uses 19999 as the default port, but it recommends restricting access to this for security reasons. Refer to the TrueNAS default port list for a list of assigned port numbers. To change the port numbers, enter a number within the range 9000-65535.

Netdata Storage Settings

TrueNAS defaults to automatically creating storage volumes for Netdata without enabling the host path options.

To create and use datasets for the Netdata configuration, cache, and library storage or extra storage volumes inside the container pod, first create these datasets. Go to Datasets and create the datasets before you begin the app installation process. See Add Datasets for more information. Select Enable Host Path for Netdata to show the volume mount path field to add the configuration storage dataset.

Install Netdata Storage Enable Host Path
Figure 8: Install Netdata Storage Enable Host Path

Enter or browse to select the dataset and populate the mount path field. To use datasets created for cache and library storage volumes, first enable each option and then enter or browse to select the datasets tp populate the mount path fields for each.

If you want to add storage volumes inside the container pod for other storage, click Add to the right of Extra Host Path Volumes for each storage volume (dataset) you want to add.

Install Netdata Storage Add Extra Host Path
Figure 9: Install Netdata Storage Add Extra Host Path

You can add extra storage volumes at the time of installation or edit the application after it deploys. Stop the app before editing settings.

Advanced DNS Settings

The default DNS Configuration is sufficient for a basic installation. To specify additional DNS options, click Add to the right of DNS Options to add the DNS Option Name and Option Value fields.

Install Netdata Advanced DNS Options
Figure 10: Install Netdata Advanced DNS Options

Resource Limits Settings

Accept the default values in Resources Limits or select Enable Pod Resource limits to show CPU and memory resource configuration options.

By default, the application is limited to use no more than four CPU cores and eight gigabytes available memory. The application might use considerably less system resources.

Install Netdata Resource Limits
Figure 11: Install Netdata Resource Limits

To customize the CPU and memory allocated to the container (pod) Netdata uses, enter new CPU values as a plain integer value followed by the suffix m (milli). Default is 4000m.

Accept the default value 8Gi allocated memory or enter a new limit in bytes. Enter a plain integer followed by the measurement suffix, for example 129M or 123Mi.

Using the Netdata Web Portal

After deploying the TrueNAS Netdata app click on Web Portal to open the Netdata agent local dashboard. This Netdata dashboard provides a system overview of CPU usage and other vital statistics for the TrueNAS server connecting to Netdata.

Netdata Web Portal Local Dashboard
Figure 12: Netdata Web Portal Local Dashboard

The Netdata System Overview dashboard displays a limited portion of the reporting capabilities. Scroll down to see more information or click on a listed metric on the right side of the screen to show the graph and reporting on that metric. Click the other tabs at the top left of the dashboard to view other dashboards for nodes, alerts, anomalies, functions, and events.

You can add your own Netdata dashboards using Netdata configuration documentation to guide you.

Click on the Nodes tab to better understand the differences between the Netdata agent and Netdata Cloud service reporting. The Netdata Cloud monitors your cloud storage providers added to Netdata.

Netdata Nodes Dashboard
Figure 13: Netdata Nodes Dashboard

Click Sign In to open the Netdata Cloud sign-in screen.

Netdata Cloud Sign-In Screen
Figure 14: Netdata Cloud Sign-In Screen

Use the Netdata-provided documentation to customize Netdata dashboards to suit your use case and monitoring needs.