Search Exchange

Search All Sites

Nagios Live Webinars

Let our experts show you how Nagios can help your organization.

Contact Us

Phone: 1-888-NAGIOS-1
Email: sales@nagios.com

Login

Remember Me

get_rdp_info

Rating
3 votes
Favoured:
2
Current Version
2012-10-10
Last Release Date
2012-10-10
Compatible With
  • Nagios 3.x
  • Nagios XI
Owner
License
GPL
Hits
63117
Files:
FileDescription
get_rdp_info.zipPlugin, pnp template and Read Me
Network Monitoring Software - Download Nagios XI
Log Management Software - Nagios Log Server - Download
Netflow Analysis Software - Nagios Network Analyzer - Download
The purpose of this plugin is to get information on the Windows Terminal Services / Remote Desktop Session Host Usage and return this back to Nagios.

The plugin runs without any arguments, it will just return a service status of OK.

The plugin is not designed to return critical or warning states, it's core purpose is to gather data for historical analysis.
This plugin is designed to be run by NSClient++ on the host you want to check. It is not designed to allow you to check a remote host, this is why there is no option to specify the host name.


Session Information:
The plugin will report how many RDP sessions are Active, Idle or Disconnected.
This is a way to look at daily trends and understand how loaded your servers are.


RDP Bytes:
This plugin will report the total RDP Input and Output bytes of all sessions.
Once again this is a way to look at daily trends and understand how much RDP traffic is generated by your RDP servers. For example users may be transferring files via the RDP protocol, this will be highlighted when looking at the historical data.


Configuring Nagios and NSClient++

Nagios:
The following shows you how to configure your Command AND Service definitions.
Command Definition:
define command {
command_name get_rdp_info
command_line $USER1$/check_nrpe -H $HOSTADDRESS$ -t 30 -c get_rdp_info
}

Service Definition:
define service {
host_name your_host
service_description RDP Info
check_command get_rdp_info
max_check_attempts 3
check_interval 3
retry_interval 3
register 1
}

NSClient++
Version 0.3.x
Copy the plugin to the scripts directory.
Add the following to the [External Scripts] section in NSC.ini:
get_rdp_info=cscript.exe //T:30 //NoLogo scriptsget_rdp_info.vbs

Nagios PNP Performance Graph Template
A custom pnp performance graph template has been provided, this generates two seperate performance graphs.
The file must be placed into the pnp/templates directory on your Nagios host. I have only tested this on Nagios XI and the default location on a Nagios XI host is /usr/local/nagios/share/pnp/templates.
NOTE: The name of the file MUST match the name of the Command Definition command_name. In the example above it is called get_rdp_info and hence this is why the template is called get_rdp_info.php.


License:
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

To see the license type:
cscript /nologo check_paging_file.vbs -license | more

Help:
To see the help type:
cscript /nologo check_paging_file.vbs -help | more


Version Notes:
2012-10-05 Initial release.

2012-10-10 Updated plugin performance data to include the name of the plugin as the ending string, pnp will see this and use the custom pnp template. This works if you are using this plugin as a passive check.
Reviews (2)
bywhutest, May 13, 2014
Hello! I have the same issue. When I run vbs from commandline I recieve 0 for all types of sessions.
My terminal server is Windows2003R2. Could you please help me?
Owner's reply

Can you please send an email to my address above, I will give you some steps so we can help diagnose the problem.

byMikeT, October 10, 2012
Hey, just found your plugin. However, doing a test from the commandline or executing the .VBS within Windows, all values are 0.
(Nagios 3.4.1)

May you be able to help?
Owner's reply

Can you please send an email to my address above, I will give you some steps so we can help diagnose the problem.