# # ######
## # ###### ##### # # ###### ###### ######
# # # # # # # # # #
# # # ##### # ###### ##### ##### #
# # # # # # # # # #
# ## # # # # # # #
# # ###### # ###### ###### ###### ######
About NetBeez
NetBeez is a network performance dashboard that reports the status and performance of a wireless or wired network. The dashboard collects information from network sensors that can be installed on a linux host with network connectivity. including a Raspberry Pi.
Type of information collected
One agent can run user-defined tests like: ping, to verify network connectivity and reachability; dig, to verify if a DNS server responds and if a DNS record is available; curl, to check if an HTTP server responds and if a specific page is available; traceroute, to trace what route is traversed to reach a destination. The resulting information of these commands, like response time, packet loss, or percentage of number of failed tests is sent back to the server for processing, alarming, and visualization.
How to install NetBeez
1. Create a dashboard by requesting an instance at https://netbeez.net/free-instance-signup/
2. Install the software agent, virtual agent, or Raspberry Pi image
Software Agent
1. Add the NetBeez software repository, update the database, and install the netbeez-agent package
echo "deb http://repo.netbeez.net wheezy main" | sudo tee -a /etc/apt/sources.list
sudo wget -O - http://repo.netbeez.net/netbeez_pub.key | sudo apt-key add -
sudo apt-get update
sudo apt-get install netbeez-agent
2. As root, save the private key that you received with the welcome email at step 1 as file /etc/netbeez/netbeez-agent.pem
3. As root, edit the configuration file /etc/netbeez/netbeez-agent.conf
and replace "hostname" with your dashboard instance name
{"host":"hostname.netbeezcloud.net", "secure_port":"20018", "interfaces":"eth0", "model":"software-debian"}
4. Restart the agent process
sudo service netbeez-agent stop; sudo service netbeez-agent start
If you are having problems, please read the FAQ at the bottom of this page or ask the community at http://community.netbeez.net
Virtual Agent
1. Download the OVA file
OVA: netbeez-virtual-agent-0.11.2.ova
MD5: netbeez-virtual-agent-0.11.2.md5
2. Load the OVA on VirtualBox (available here) or vSphere with the following settings:
vCPU: 1
Sockets: 1 or 2
RAM: 1 or 2 GB
HDD: Thin provisioning
3. Once the OVA is booted, login with netbeez/netbeez (username/password) and follow this procedure to configure the virtual agent (use root or sudo):
i) Save the private key that you received with the welcome email at step 1 as file /etc/ssl/certs/netbeez.pem
ii) Edit the configuration file /etc/netbeez/netbeez-agent.conf and replace "hostname" with your dashboard instance name
{"host":"hostname.netbeezcloud.net", "secure_port":"20018", "interfaces":"eth0", "model":"virtual-model-ova"}
4. Restart the agent process
sudo service nbagent_prod stop; sudo service nbagent_prod start
Raspberry Pi image
You can download and install a preconfigured NetBeez Raspbian image on a Raspberry Pi. The image has been tested on the Raspberry Pi Model B, Model B+, and Model 2.
1. Download the NetBeez Raspian image
IMG: generic_free_rpi-model-b_0.11.2_20160302.img.zip
MD5: generic_free_rpi-model-b_0.11.2_20160302.img.zip.md5
2. Install the NetBeez Raspbian on your Raspberry Pi on an 8 GB SD card. Instructions can be found here.
3. Once booted, login into the Raspberry Pi with username pi and password netbeez--free (two dashes).
4. Edit the configuration file /etc/netbeez/netbeez-agent.conf and replace "hostname" with your dashboard instance name
{"host":"hostname.netbeezcloud.net", "secure_port":"20018", "interfaces":"eth0", "model":"rpi-model-b"}
5. Save the certificate that you received with the welcome email as file /etc/netbeez/netbeez-agent.pem
6. Reboot the netbeez agent process
sudo service nbagent_prod stop
sudo service nbagent_prod start
If you are having problems, please read the FAQ at the bottom of this page or ask the community at http://community.netbeez.net
Setup NetBeez
1- Login to your dashboard by pointing your browsers to the address provided during the dashboard creation
2- Click on the Agents tab, and verify that the agents you have configured are reporting back to the dashboard
3- Click on the Targets tab, and click on the + sign to create a new target
NetBeez | Community | Documentation