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 vCanopy 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 vCanopy. 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 vCanopy 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 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 vCanopy:
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:
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.