How to setup Netdata on your GridPane Servers

3 min read

Netdata is a very cool (and totally FREE!) server monitoring tool and alert system. We’ve recently been asked about it, and while we can’t provide support for it, for those of you who are interested in checking it out, this guide is for you.

Also, big thanks to “WordPresseh” for contributing the original KB to the GridPane community. That was awesome, thank you.

IMPORTANT

Before we begin, we need to reiterate that this is a third party app and is NOT supported by GridPane. Please review the following guide to understand how it could potentially impact our ability to provide support for any servers you install it on:

Can I install other Applications on a GridPane managed server?

Part 1. Install Netdata on your server

Installing Netdata is a simple process that only takes a few minutes. Below are the steps to install it on your server/s.

Step 1. SSH into your server:

Please see the following articles to get started:

Generate your SSH Key:

Generate SSH Key on Mac

Generate SSH Key on Windows with Putty

Generate SSH Key on Windows with Windows Subsystem for Linux

Generate SSH Key on Windows with Windows CMD/PowerShell

Add your SSH Key to GridPane:

Add default SSH Keys

Add/Remove an SSH Key to/from an Active GridPane Server

Connect to your server:

Connect to a GridPane server by SSH as Root user.

Step 2. Create a new user

For simplicity, I’m going to create a user called “netdata” and install Netdata via this user. You can switch out “netdata” in the commands below for any username you prefer.

To start run:

adduser netdata

You’ll then be prompted to enter a new password and then confirm the password you just entered.

Next you can simply hit enter for the next few questions.

Finally you’ll be asked to confirm the details you’ve just entered. Type y and Enter.

Your new user has now been created.

Next, run the following command to add the new user to the sudo group:

usermod -aG sudo netdata

And finally switch to your new user with:

su - netdata

Step 3. Install Netdata on your server

To install, run the following command:

bash <(curl -Ss https://my-netdata.io/kickstart.sh)

The above will install Netdata.

Follow the prompts during the setup process and once installation in complete you’ll see the following:

Step 4. Opt out of anonymous statistics

According to their documentation, running the above installation script with --disable-telemetry  is supposed to automatically opt you out of their data tracking. In my testing however, this didn’t work, so we’ll do this the long winded way.

To opt out of anonymous statistics, navigate to the Netdata directory with:

cd /etc/netdata

Switch back to root user with:

sudo -s

And run the following command to opt out:

touch .opt-out-from-anonymous-statistics

For more information checkout their article on anonymous statistics here:

https://learn.netdata.cloud/docs/agent/anonymous-statistics

Part 2. Connect your server to Netdata Cloud

Now we just need to connect your server to Netdata Cloud and you’re all set!

Step 1. Create a Netdata Cloud account

Head to https://app.netdata.cloud/sign-in

Enter your email, confirm your email, then head back and sign into netdata.cloud.

Step 2. Sign into Netdata Cloud and copy your claim script

On signing in, you’ll be presented with a page that looks like the following:

Choose the “War Room” you wish to add your server to from the dropdown and copy your claim script.

Step 3. Claim your server

Back in your server, paste in your key and hit enter.

You’ll see a message like in the image below:

Nice job! You’ve successful setup Netdata on your server. Back in netdata.cloud you’ll be able to see your server stats via their very cool dashboard:

Part 3. Netdata Resources

For Netdata’s step-by-step user guide, checkout:

https://learn.netdata.cloud/guides/step-by-step/step-00

If at any point in the future you would like to uninstall Netdata, check out their guide here:

https://learn.netdata.cloud/docs/agent/packaging/installer/uninstall

There’s tons of documentation on their site. Go crazy.

Leave a Reply