Network Gauge

 GitHub: uptimesoftware/uptime-network-gauge
Category: gadget

Version Compatibility
Module Name
Uptime Monitoring Station Version
Network Gauge v1.37.8
Network Gauge v1.27.7, 7.6, 7.5, 7.4, 7.3
Network Gauge v1.17.2
Download Files

Network Gauge v1.3 Network Gauge v1.1


Display port-level network performance metrics in a convenient visual gauge format.

alt text alt text

####Features * Designed with the end-user experience in mind * Leveraging latest web technologies for light-weight, beautiful results * Intuitive configuration wizard * Robust validation and error handling * Extensive visual and console logging for easy troubleshooting * Tell us which features you would like to see in a future release!

####Installation Instructions 1. Install using the Uptime Extension Manager 2. Refresh gadgets and pick Network Gauge from the list 3. If your Uptime datastore is running on either SQLServer(MSSQL) or Oracle, then you will need to install/enable ODBC drivers in uptimeDB.php located at /gadgets/definitions/uptime.NetworkGauge/ See additional steps below for more details

####Usage Instructions When you install the Network Gauge plugin it creates a new gadget for a custom dashboard. The gadget will work for elements added as network devices only using MySQL backend.

  1. From the Dashboards tab, create a new dashboard by clicking on the + tab to the right of the existing dashboards
  2. Select a Layout and create a Name for the dashboard and a group to share with
  3. Click Add Dashbord
  4. Click on Click to add gadget…
  5. Click on the Refresh Gadgets button to load the Network Gauge plugin you installed
  6. Enter a Name for the Network Device you are monitoring and click Add Gadget. Note, to change the Name, you must delete and recreate the gadget.
  7. Select a network device
  8. Choose a port
  9. Adjust the refresh interval and thresholds, if desired

####Additional Oracle Install Steps:

In order to use this gadget with an Oracle datastore, you will need to install the Oracle Instant Client & ODBC Drivers on your Uptime monitoring. The process for this varies for Windows & Linux. Once the appropriate ODBC Driver has been installed, you will need to edit the uptimeDB.php file for this gadget on your monitoring station ( /gadgets/definitions/uptime.NetworkGauge/uptimeDB.php this file may not exist until you've 'refreshed gadgets via the GUI') and uncomment one of the ODBC Driver lines near the top of the file .

#####Oracle ODBC Driver Linux Install Steps:

  1. Install unixODBC via your package manager (ie. yum install unixodbc) . This will install unixODBC into your ‘/usr/lib64/’ directory.

  2. Download and Install the latest version of the ‘Oracle Instant Client Basic’ package, available from Oracle ( Keep in mind that Uptime 7.2 comes bundled with 64bit Apache/PHP so you will need the Linux x86-64 package. ie. oracle-instantclient12.1-basic- . (The 12.1 package works with 11g Databases as well). This package will install some of the required binaries/drivers for Oracle into /usr/lib/oracle//client64/lib/

  3. Download and install the ‘ ODBC: Additional libraries’ package from Oracle (ie. oracle-instantclient12.1-odbc- ). This provides the actual ODBC Driver we need from Oracle.

  4. Edit the /etc/init.d/uptime_httpd script that starts Uptime’s apache, and add the following lines to set some of the required environment variables(This should be towards the beginning of the script add the end of to the other export commands ie. export PATH , export MIBDIRS etc). Make sure to change to the correct version for the path where the drivers were installed in Step 2 above.

export ORACLE_HOME=/usr/lib/oracle//client64 export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$ORACLE_HOME/lib

  1. Restart uptime_httpd service to pick up this change (ie. /etc/init.d/uptime_httpd stop /etc/init.d/uptime_httpd start)

  2. Make sure to uncomment one of the odbc driver lines in /gadgets/definitions/uptime.NetworkGauge/uptimeDB.php as explained above.

#####Oracle ODBC Driver Windows Install Steps:

  1. Install the Oracle Instant Client drivers or have the Oracle Client installed on the monitoring station. To get the Instant Client Download for Oracle, download the 64 bit drivers:


  1. Create a new directory C:\Oracle. Unzip the downloaded file into the new directory. You should now have C:\Oracle\instantclient_12_1 which contains a bunch of .dll & .sym files.

  2. Download the ‘Instant Client Package - ODBC’ from the same page above. ie. . Extract this zip into the same C:\Oracle\instantclient_12_1 path.

  3. Open a command prompt in the C:\Oracle\instantclient_12_1 directory and run the odbc_install.exe which will install the Oracle ODBC drivers and setup the required Environment variables.

  4. Run the ‘Data Sources (ODBC)’ utility from the Windows ‘Administrative Tools’. Click on the ‘Drivers’ tab, and confirm that you have an ‘Oracle in instantclient’ driver listed, and note the name of the driver, as this is required as the ‘ODBC Driver Name’ when setting up the service monitor. (Likely it will be ‘Oracle in instantclient_12_1’ or ‘Oracle in OraClient12Home1’).

  5. Update the Path Environment Variable to include the path to the oracle driver. Append “;C:\Oracle\instantclient_12_1” to end of the variable. To set this variable Go to System Properties > Advanced > Environment Variables > Under System variables find Path and edit it.

  6. Make sure to uncomment one of the odbc driver lines in /gadgets/definitions/uptime.NetworkGauge/uptimeDB.php as explained above.

If your having trouble with installing just the Oracle InstantClient & ODBC the likely issue is you are missing “Microsoft Visual C++ 2010 SP1 Redistributable Package (x64)” package that has the DLL that this driver needs, another option is to install these drivers as part of the ‘Oracle Data Access Components’ which is a bundle of Oracle drivers full fleged installer compared to the zips mentioned above. This bundle can be found on the Oracle website here:

#####Additional MSSQL/SQLServer Install Steps:

In order to use the Metric Chart gadget with a SQLServer based Datastore, you will need to uncomment the appropriate ODBC Driver in /gadgets/definitions/uptime.NetworkGauge/uptimeDB.php

Windows Based monitoring stations will already have ODBC itself installed as part of Windows.

But Linux based monitoring stations will require the unixODBC package to be installed.

This package should include the /usr/lib64/ SQLServer ODBC Driver needed for MSSQL/SQLserver.

See step #1 of ‘Oracle ODBC Driver Linux Install Steps:’ above for more details on installing unixODBC

October 30, 2013 |


comments powered by Disqus
Copyright © 2015 IDERA, Inc.   Legal   Privacy Statement