/usr/share/munin/plugins/snmp__rdp_users is in munin-plugins-core 2.0.19-3.
This file is owned by root:root, with mode 0o755.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 | #!/usr/bin/perl
# -*- perl -*-
# vim: ft=perl
=head1 NAME
snmp__rdp_users - Munin plugin to monitor the number of remote users
connected to a Microsoft Windows Remote Desktop server.
=head1 APPLICABLE SYSTEMS
Microsoft Windows servers running Remote Desktop Services (or Terminal
Services, as it used to be known). It requires an SNMP server to be
enabled on the machine to
be monitored.
=head1 CONFIGURATION
As a rule SNMP plugins need site specific configuration. The default
configuration (shown here) will only work on insecure sites/devices.
[snmp_*]
env.version 2
env.community public
In general SNMP is not very secure at all unless you use SNMP version
3 which supports authentication and privacy (encryption). But in any
case the community string for your devices should not be "public".
Please see 'perldoc Munin::Plugin::SNMP' for further configuration
information.
=head1 INTERPRETATION
The number of users currently logged into the Remote Desktop server.
=head1 MIB INFORMATION
This plugin requires support for the HOST-RESOURCES-MIB (RFC 2790). It
reports the hrSWRunName column of hrSWRunTable.
=head1 MAGIC MARKERS
#%# family=snmpauto
#%# capabilities=snmpconf
=head1 VERSION
$Id$
=head1 BUGS
Unlikely to work on non-Windows RDP servers, since it relies on the
name of the server process being 'rdpclip.exe'. But is there even such
a thing as a non-Windows RDP server?
=head1 AUTHOR
Copyright (C) 2004 Rune Nordbøe Skillingstad
Documented and updated to use Munin::Plugin::SNMP by Matthew Boyle.
=head1 LICENSE
GPLv2.
=cut
use strict;
use Munin::Plugin::SNMP;
my $oid = "1.3.6.1.2.1.25.4.2.1.2";
if (defined $ARGV[0] and $ARGV[0] eq 'snmpconf') {
print "require ${oid}. rdpclip\\.exe\n";
exit 0;
}
if (defined $ARGV[0] and $ARGV[0] eq "config") {
my ($host) = Munin::Plugin::SNMP->config_session();
print "host_name $host\n" unless $host eq 'localhost';
print <<"EOC";
graph_title Number of RDP users
graph_args --base 1000 -l 0
graph_vlabel number of RDP users
graph_scale no
graph_category system
graph_info This graph shows the number of remote users on the Windows system.
users.label users
users.draw LINE2
users.info Number of users logged in.
EOC
exit 0;
}
my($session, $error) = Munin::Plugin::SNMP->session();
die "Failed to create session: $error" unless $session;
my $process_names = $session->get_entries(-columns => [ $oid ]);
my $user_count = $process_names ? grep /^rdpclip\.exe$/i, values %$process_names
: 'U';
print "users.value ", $user_count, "\n";
|