Integrate NetQ with Grafana
Switches collect statistics about the performance of their interfaces. The NetQ Agent on each switch collects these statistics every 15 seconds and then sends them to your NetQ Appliance or Virtual Machine.
NetQ collects statistics for physical interfaces; it does not collect statistics for virtual interfaces, such as bonds, bridges, and VXLANs.
- Transmit with tx_ prefix: bytes, carrier, colls, drop, errs, packets
- Receive with rx_ prefix: bytes, drop, errs, frame, multicast, packets
You can use Grafana version 6.x or 7.x, an open source analytics and monitoring tool, to view these statistics. The fastest way to achieve this is by installing Grafana on an application server or locally per user, and then installing the NetQ plug-in.
If you do not have Grafana installed already, refer to grafana.com for instructions on installing and configuring the Grafana tool.
Install NetQ Plug-in for Grafana
Use the Grafana CLI to install the NetQ plug-in. For more detail about this command, refer to the Grafana CLI documentation.
grafana-cli --pluginUrl https://netq-shared.s3-us-west-2.amazonaws.com/grafana/dist.zip plugins install netq-dashboard installing netq-dashboard @ from: https://netq-shared.s3-us-west-2.amazonaws.com/grafana/dist.zip into: /usr/local/var/lib/grafana/plugins ✔ Installed netq-dashboard successfully
After installing the plugin a restart of Grafana is required. Restart Grafana according to your implementation.
Set Up the NetQ Data Source
Now that you have the plug-in installed, you need to configure access to the NetQ data source.
Open the Grafana user interface.
Log in using your application credentials.
The Home Dashboard appears.
Click Add data source or > Data Sources.
Enter Net-Q in the search box. Alternately, scroll down to the Other category, and select it from there.
Enter Net-Q into the Name field.
Enter the URL used to access the database:
- Cloud: api.netq.cumulusnetworks.com
- On-premises: <hostname-or-ipaddr-of-netq-appl-or-vm>/api
- Cumulus in the Cloud (CITC): air.netq.cumulusnetworks.com
Select procdevstats from the Module dropdown.
Enter your credentials (the ones used to log in).
For NetQ cloud deployments only, if you have more than one premises configured, you can select the premises you want to view, as follows:
If you leave the Premises field blank, the first premises name is selected by default
If you enter a premises name, that premises is selected for viewing
Note: If multiple premises are configured with the same name, then the first premises of that name is selected for viewing
Click Save & Test.
Create Your NetQ Dashboard
With the data source configured, you can create a dashboard with the transmit and receive statistics of interest to you.
To create your dashboard:
Click to open a blank dashboard.
Click (Dashboard Settings) at the top of the dashboard.
Enter hostname into the Name field.
Enter Hostname into the Label field.
Select Net-Q from the Data source list.
Enter hostname into the Query field.
You should see a preview at the bottom of the hostname values.
Click to return to the new dashboard.
Click Add Query.
Select Net-Q from the Query source list.
Select the interface statistic you want to view from the Metric list.
Click the General icon.
Select hostname from the Repeat list.
Set any other parameters around how to display the data.
Return to the dashboard.
Add additional panels with other metrics to complete your dashboard.
Analyze the Data
Once you have your dashboard configured, you can start analyzing the data.
For reference, this example shows a dashboard with all of the available statistics.
Select the hostname from the variable list at the top left of the charts to see the statistics for that switch or host.
Review the statistics, looking for peaks and valleys, unusual patterns, and so forth.
Explore the data more by modifying the data view in one of several ways using the dashboard tool set:
- Select a different time period for the data by clicking the forward or back arrows. The default time range is dependent on the width of your browser window.
- Zoom in on the dashboard by clicking the magnifying glass.
- Manually refresh the dashboard data, or set an automatic refresh rate for the dashboard from the down arrow.
- Add a new variable by clicking the cog wheel, then selecting Variables
- Add additional panels
- Click any chart title to edit or remove it from the dashboard
- Rename the dashboard by clicking the cog wheel and entering the new name