PRTG Manual 1
PRTG Manual 1
PRTG Manual 1
© 2014 Paessler AG
All rights reserved. No parts of this work may be reproduced in any form or by any means—graphic,
electronic, or mechanical, including photocopying, recording, taping, or information storage and retrieval
systems—without the written permission of the publisher.
Products that are referred to in this document may be either trademarks and/or registered trademarks
of the respective owners. The publisher and the author make no claim to these trademarks.
While every precaution has been taken in the preparation of this document, the publisher and the author
assume no responsibility for errors or omissions, or for damages resulting from the use of information
contained in this document or from the use of programs and source code that may accompany it. In no
event shall the publisher and the author be liable for any loss of profit or any other commercial damage
caused or alleged to have been caused directly or indirectly by this document.
Table of Contents
3
Contents
4
Contents
5
Contents
6
Contents
7
Contents
8
Contents
4 Multi-Edit 1736
5 Create Device Template 1741
6 Geo Maps 1744
7 Notifications 1749
Setting Up Notifications Based on Sensor Limits: Example 1751
8 Libraries 1759
Libraries Step By Step 1762
Management 1766
Libraries and Node Settings 1768
Context Menus 1774
9 Reports 1775
Reports Step By Step 1778
View and Run Reports 1781
Reports Settings 1784
10 Maps 1794
Maps Step By Step 1797
Maps Designer 1800
Maps Settings 1806
11 Setup 1810
Account Settings—My Account 1812
Account Settings—Notifications 1817
Account Settings—Schedules 1827
System Administration—User Interface 1831
System Administration—Monitoring 1839
System Administration—Notification Delivery 1843
System Administration—Core & Probes 1849
System Administration—Cluster 1855
System Administration—User Accounts 1856
System Administration—User Groups 1861
System Administration—Administrative Tools 1865
PRTG Status—System Status 1869
PRTG Status—Auto-Update 1878
PRTG Status—Cluster Status 1883
PRTG Status—Activation Status 1884
Optional Downloads and Add-Ons 1885
Chrome Desktop Notifications 1887
Support—Contact Support 1889
9
Contents
Tickets 1922
Setup 1924
Search Results 1926
4 PRTG Servers 1927
5 Options 1930
6 Windows Menu Structure 1936
7 Context Menus 1941
8 Shortcuts Overview 1942
10
Contents
11 Using Your Own SSL Certificate with PRTG's Web Server 2076
12 Calculating Percentiles 2078
Index 2091
11
Part 1
Welcome to PRTG Network Monitor
14.01.2014 13
Part 1: Welcome to PRTG Network Monitor |
Today, most businesses rely on a computer and network infrastructure for internet, internal
management, telephone, and email. A complex set of servers and network equipment is
required to ensure that business data flows seamlessly between employees, offices, and
customers. The economical success of an organization is tightly connected with the flow of
data.
The computer network's reliability, speed, and efficiency are crucial for businesses to be
successful. But, like all other technical objects, network devices may fail from time to time—
potentially causing trouble and loss of sales, no matter what migration efforts have been made
up-front.
Network administrators need to take three key steps to maintain network uptime, reliability,
and speed:
PRTG Network Monitor, the software described in this document, is a complete solution for
monitoring small, medium, and large networks.
The software is easy to set up and use and monitors a network using Simple Network
Management Protocol (SNMP), Windows Management Instrumentation (WMI), packet sniffer,
Cisco NetFlow (as well as IPFIX, sFlow, and jFlow), and many other industry standard protocols.
It runs on a Windows-based machine in your network for 24-hours every day. PRTG Network
Monitor constantly records the network usage parameters and the availability of network
systems. The recorded data is stored in an internal database for later analysis.
14 14.01.2014
Part 1: Welcome to PRTG Network Monitor | 1 About this Document
This document is also meant as a reference for all available settings. Short contextual help is
already provided within the Ajax web interface; in this manual you often get some more help
regarding the different options available.
This document does not explain monitoring protocols and file formats in-depth. Also, the use
of the Application Programming Interface (API) built into PRTG is only briefly addressed.
Whenever possible, hyperlinks to more detailed resources are provided, such as articles in the
Paessler Knowledge Base.
To start using PRTG right away, please see the Quick St art Guide 32 section. For more
detailed instructions, see the other sections.
19.07.2013 15
Part 1: Welcome to PRTG Network Monitor | 2 Key Features
The PRTG installer contains all modules and software necessary to run the monitoring system
without the need for third party modules, including:
§ High performance: PRTG's own fast and efficient database system to store the raw
monitoring results as well as logs, Toplists, and tickets (outperforms SQL servers for
monitoring data), accessible through Application Programming Interface (API). You can
distribute high loads over multiple probes.
§ Low system requirements: an average PC from the year 2007 is sufficient and even a
netbook can monitor over thousand sensors.
16 14.01.2014
Part 1: Welcome to PRTG Network Monitor | 2 Key Features
§ High security standards: SSL encryption for connections and web server, and multiple user
accounts with shared and private sensors, as well as rights management, and many more.
§ Built-in SSL secured web server with HTTP and HTTPS support for the user interface.
§ Fast web interface, works as Single Page Application (SPA) to avoid time-extensive reloading
of the page.
§ Mail server for automatic email delivery.
§ Flexible alerting
§ including nine notification technologies, for example, email, SMS, syslog and SNMP trap,
HTTP request, event log, Amazon SNS, executing scripts, etc.
§ including various triggers, for example, status alerts, limit alerts, threshold alerts, multiple
condition alerts, escalation alerts.
§ including dependencies to avoid alarms floods, acknowledging alarms to avoid further
notifications for this alarm, and alert scheduling.
§ In-depth report generator to create reports on-the-fly as well as scheduled reports in HTML
or Portable Document Format (PDF). Many report templates are available by default.
§ Graphics engine for user-friendly live and historic data charts.
§ Network analysis module to automatically discover network devices and sensors.
§ Distributed monitoring to monitor several networks in different locations.
§ Special features for Managed Service Provider (MSP) to monitor customer networks and
increase the quality of service.
§ Data publishing with real time dashboards—private and public—including live performance
and status information. You can design these maps as you like with many different objects,
as well as you can integrate external custom objects.
§ Different languages like English, German, Spanish, French, Portuguese, Dutch, Czech,
Japanese, and Simplified Chinese.
§ Customizations: The PRTG Application Programming Interface (API) allows you to program
your own features and to customize and re-brand PRTG's web interface to your needs. In
addition, you can create custom sensors, notifications, and device templates.
PRTG Network Monitor supports monitoring up to 20,000 thousand sensors per installation. It
can optionally work with multiple remote probes to monitor multiple sites or network
segments from one central core installation, and to distribute high loads. You can also
configure fail-safe monitoring using a cluster installation to perform automatic failovers. Single
failover installations are allowed with every PRTG license.
The software is based on Paessler's reliable monitoring technology, which has been constantly
improved since 1997 and is already used by more than 150,000 users around the world every
day. An outstanding support ensures that your inquiries are answered within one business day
in order to ensure best possible network monitoring. Attractive licensing packages from
freeware (up to 10 sensors) to enterprise level (with thousands of sensors) make sure that
every user finds the proper solution.
14.01.2014 17
Part 1: Welcome to PRTG Network Monitor | 3 New in This Version
§ St able: best tested version of PRTG for live systems; updated about once or twice a month;
for usage on live systems
§ Preview: offering the latest features and fixes; updated about once a week; consider this
version as "beta", thus, do not use this version on live systems you have to depend on!
§ Canary : providing "nightly builds"; updated very often; not tested extensively; never use on
live systems you have to depend on!
Because of these three channels, you can choose either maximum stability, earlier access to
new features, or a mixture of both.
For an overview of all most recent changes in the current version, please visit the version
history on our website. Please see the More 18 section below for more information.
More
Paessler Website: PRTG Network Monitor Version History
§ http://www.paessler.com/prtg/history
18 14.01.2014
Part 1: Welcome to PRTG Network Monitor | 4 Available Licenses
Freeware Edition
The Freeware Edition is a good solution to get started with PRTG, or for private use:
Special Edition
The Special Edition has all the features of the Freeware Edition, plus it supports up to 30
sensors. By entering a Special Edition key, you can extend your Freeware Edition. This key is
not for download, we only hand it out on special request. For detailed information, see More
20 section below.
Trial Edition
The Trial Edition is intended for evaluation purposes for customers who are interested in
purchasing commercial licenses:
§ With each license one single failover cluster setup 81 , consisting of two nodes, is included.
Cluster installations with two and three failover nodes will require one additional trial license
key; a cluster installation with four failover nodes will require two additional trial license
keys.
After the trial period has ended, a Trial Edition will revert into a Freeware Edition, allowing you
to monitor up to 10 sensors for free.
28.05.2014 19
Part 1: Welcome to PRTG Network Monitor | 4 Available Licenses
Commercial Editions
There are several licenses of PRTG Network Monitor available to suit the demands of smaller,
as well as larger customers and organizations:
For more information about available commercial licenses, please see More 20 section below.
More
Knowledge Base: What is the PRTG Special Edition license?
§ http://kb.paessler.com/en/topic/8063
Paessler FAQs: What is the difference between the PRTG Network Monitor licenses?
§ http://www.paessler.com/support/faqs#e1912
20 28.05.2014
Part 1: Welcome to PRTG Network Monitor | 5 System Requirements
§ A PC server or virtual machine with roughly the CPU performance of an average PC built in
the year 2007 or later and minimum 1024 RAM memory. For cluster 81 installations, use
systems with similar performance.
§ Operating systems Microsoft Windows 7, Windows 8, Server 2012, Server 2012 R2, Windows
2003 SP1 or later, or Windows 2008 R2 (all 32-bit or 64-bit) are officially supported. You can
also use Windows Vista or 2008 R1, but we recommend not using these systems, because
there are known performance issues related to them.
§ Web browser to access the web interface. The following browsers are supported:
§ Google Chrome 34 or later (recommended)
§ Mozilla Firefox 28 or later
§ Microsoft Internet Explorer 10 or 11
As a rule of thumb, an average PC/server built in the year 2007 or later should be able to
monitor 1,000 sensors with ease. Some exceptions apply for version 3 of Simple Network
Management Protocol (SNMP), Windows Management Instrumentation (WMI) and packet sniffer.
The maximum number of sensors you can monitor with one installation of PRTG mainly
depends on the monitoring technology and the monitoring intervals you use. In general,
consider the following rules:
28.05.2014 21
Part 1: Welcome to PRTG Network Monitor | 5 System Requirements
To overcome any limitations mentioned above you should distribute the sensors over two
remote probes 2049 or more. For detailed information please use the site planner tool to plan
large installations. See More 22 section below.
We recommend using a dedicated physical machine to run both the PRTG core server and PRTG
remote probes. For more information please see the Det ailed Sy st em Requirement s 23
section.
More
§ Updat e From Previous Versions 47
22 28.05.2014
Part 1: Welcome to PRTG Network Monitor | 5 System Requirements
1 Detailed System Requirements
This section lists different aspects of system requirements for PRTG. Please consider these
requirements in order to avoid issues while network monitoring.
§ Hardware Requirement s 24
§ More 29
The 32-bit and 64-bit versions of the following operating systems are officially supported for
PRTG Core Service and Probe Service (Intel x86/x64 architectures only):
§ Microsoft Windows 7
§ Microsoft Windows 8
§ Microsoft Windows Server 2008 R2 and Windows Server 2008 R2 SP1
§ Microsoft Windows Server 2012**
§ Microsoft Windows Server 2012 R2**
§ Microsoft Windows Server 2003 SP1 or later
§ Microsoft Windows Vista*
§ Microsoft Windows Server 2008*
* For performance reasons, we do not recommend using Windows Vista or Windows Server
2008 R1, especially when monitoring via Windows Management Instrumentation (WMI). Using
these operating systems, you will only be able to add a limited number of WMI sensors! For
detailed information, please see More 29 section below. If you need to use Windows Server
2008 R1, we strongly recommend installing Service Pack 2 (SP2).
** Windows Server 2012 in Core mode and the Minimal Server Interface are not officially
supported.
28.05.2014 23
Part 1: Welcome to PRTG Network Monitor | 5 System Requirements
1 Detailed System Requirements
The version (32-bit or 64-bit) of the PRTG Core Server depends on the version of your
operating system. The 64-bit version of the PRTG Core Server will be installed if
Otherwise the 32-bit version of the PRTG Core Server will be installed.
We recommend you to provide Microsoft .NET Framework versions 3.5 and 4.0 (with latest
updates) on all systems running a PRTG probe. Note: Version 4.0 is imperatively needed for
monitoring VMware and XenServer virtual environments.
More details: Some sensor types need the Microsoft .NET Framework to be installed on the
computer running the PRTG probe. This is either on the local system (on every node, if on a
cluster probe), or on the system running a remote probe 2050 . Depending on the sensor type,
the required versions are 2.0, 3.0, or 4.0. Note: According to the Microsoft website, .NET
version 3.5 contains versions 2.0 SP1 and 3.0 SP1. Version 4.0 is not downward compatible,
but must be installed side-by-side to older version(s), if required.
For best performance of hybrid sensors using Windows Performance Counters and Windows
Management Instrumentation (WMI), we recommend Windows 2008 R2 or higher on the
computer running the PRTG probe: This is either on the local system (on every node, if on a
cluster probe), or on the system running a remote probe 2050 .
Hardware Requirements
Hardware requirements for PRTG Core Service and Probe Service mainly depend on the
sensor types and intervals used. The following values are provided as reference for common
usage scenarios of PRTG (based on a default sensor interval of 60 seconds).
§ CPU
An average PC built in 2007 can easily monitor 1,000 sensors (see sensor type specific notes
below). PRTG supports native x86 architectures.
§ RAM memory
Minimum requirement: 1024 MB RAM. You will need about 150 KB of RAM per sensor.
§ Hard Disk Drive
You will need about 200 KB of disk space per sensor per day (for sensors with 60 second
interval).
§ Int ernet connect ion
An internet connection is required for license activation (via HTTP or email).
§ St able net work connect ion for remot e probes
Remote probes require a stable network connection between the PRTG core server and the
remote probe. Unstable connections, for example via 3G, might work but it could be possible
that you lose monitoring data if the connection is non-reliable.
24 28.05.2014
Part 1: Welcome to PRTG Network Monitor | 5 System Requirements
1 Detailed System Requirements
There are also non-hardware dependent limitations for some sensor types, for example, WMI
and SNMP V3 sensors. These limitations can be overcome by distributing the sensors across
multiple remote probes 2049 . If you plan installations with more than 500 to 1,000 sensors, or
more than 10 Packet Sniffer or xFlow (NetFlow, sFlow) sensors, please consult the site planner
tool linked in the More 29 section below.
Sample Configurations
The sample configurations in the table below will give you an overview of the hardware
requirements for PRTG, based on your configuration.
28.05.2014 25
Part 1: Welcome to PRTG Network Monitor | 5 System Requirements
1 Detailed System Requirements
Large Inst allat ion Large Inst allat ion B Net book
A Inst allat ion
RAM 8 GB 16 GB 1 GB
Number of Probes 4 1 1
* CPU load is higher while users are accessing the web interface.
26 28.05.2014
Part 1: Welcome to PRTG Network Monitor | 5 System Requirements
1 Detailed System Requirements
PRTG core server as well as PRTG probe can be run on virtualized platforms. The following
platforms were tested successfully:
VMware ESX/ESXi versions 3.5, 4.0, or 5.0 Windows XP, Windows 2003 SP1 or later
(32/64 bit), Windows Vista, Windows 7 (32/64
bit), Windows 2008 (32/64 bit), Windows 8
(32/64 bit), Windows 2012 (32/64 bit)
Parallels Virtuozzo Containers Windows 2003 Server SP1 or later (32/64 bit),
Windows 2008 Server, Windows 8 (32/64 bit),
Windows 2012 (32/64 bit)
Cloud Hosting Platforms (Amazon EC2, Windows Server 2003 SP1 or later, Windows
TheRackspaceCloud, and others) Server 2008, Windows 8 (32/64 bit), Windows
2012 (32/64 bit)
Important notice: We recommend using a dedicated physical machine to run both the PRTG
core server and PRTG remote probes. If you run PRTG on a virtual machine, we strongly
recommend to stay below 2,000 sensors for performance reasons. Unfortunately, we cannot
offer technical support regarding performance and stability problems for PRTG installations on
virtual machines that run with more than 5,000 sensors. In this case, please migrate PRTG to
one or more, preferably physical, machines.
Note: When running PRTG on a virtual machine, do not use dynamic resource allocation, but
please make sure that full resources are available to the virtual machine at any time. In our
experience, dynamic resource allocation is not working efficiently for a monitoring software
and can therefore lead to massive performance issues.
28.05.2014 27
Part 1: Welcome to PRTG Network Monitor | 5 System Requirements
1 Detailed System Requirements
The following browsers are officially supported by the PRTG web interface (in order of
performance and reliability):
PRTG's web interface makes heavy use of Javascript and AJAX. We found that for some
functions Chrome is up to 10 times faster than Internet Explorer, and 3 to 5 times faster than
Firefox.
Screen Resolution
A screen resolution of at least 1024x768 pixels is sufficient for most functions of PRTG.
However, we recommend a screen resolution of 1200x800 or higher.
28 28.05.2014
Part 1: Welcome to PRTG Network Monitor | 5 System Requirements
1 Detailed System Requirements
The optional PRTG Ent erprise Console 1894 runs under all Windows versions XP or later. It has a
built-in webkit browser engine and requires no specific browser installed on the system. See
also section Ent erprise Console—Requirement s for Connect ions t o PRTG Web Server(s) 1894
.
The feature-limited mobile web interface is optimized for low bandwidth and mobile access. It
has been designed for and tested with iOS (iPhone, iPad), Android, Blackberry, Windows Mobile,
and also deprecated Internet Explorer versions.
More
§ Updat e From Previous Versions 47
Paessler Blog: Don't Use Windows Vista And Windows 2008 R1 for Network Monitoring via
WMI!
§ http://www.paessler.com/blog/2010/09/22/
Knowledge Base: Frequent Questions about xFlow, Packet Sniffing, Traffic Monitoring and
Cisco
§ http://kb.paessler.com/en/topic/3733
28.05.2014 29
Part 1: Welcome to PRTG Network Monitor | 5 System Requirements
1 Detailed System Requirements
§ http://kb.paessler.com/en/topic/46863
30 28.05.2014
Part 2
Quick Start Guide
14.01.2014 31
Part 2: Quick Start Guide |
Setting up monitoring for your network is easy! You only need to download the installer from
Paessler's website, run through the installation wizard, and provide some information in the
configuration guru. PRTG will start monitoring your network immediately without any further
complicated stumbling blocks! Of course, later on, you still can adjust everything to your
needs.
32 14.01.2014
Part 2: Quick Start Guide | 1 ONE—Download, Installation, and First Login
Download
On the Paessler website, you find two different installers for PRTG, a public download for the
Freeware, Special, and Trial editions, and a login link to download the commercial editions
(which is only available for paying customers).
PRTG Download on Paessler Website with Marked Full Version Download Link
03.04.2014 33
Part 2: Quick Start Guide | 1 ONE—Download, Installation, and First Login
Please download the latest publicly available file from the Paessler website. You can also
request a trial key there, which must be entered during installation:
§ ht t p://www.paessler.com/prt g/download
Note: Every Freeware installation will start as a Trial version, giving you an unlimited number of
sensors for 30 days. After the trial period has expired, your installation will automatically revert
to a Freeware edition with 10 sensors.
Note: A Special Edition is an extended Freeware version. If you meet certain requirements, you
can receive a Special Edition key from us which gives you an extended number of sensors for
free. For details, please see:
§ ht t p://www.paessler.com/prt g/download#30sensors
Downloads and updates are free to customers with an active maintenance contract. Please log
into the Paessler website to get the latest download. You can also find your license key there,
which must be entered during installation:
§ ht t p://www.paessler.com/login
Note: Once installed, you will usually use the Soft ware Aut o-Updat e 1878 function of PRTG to
download and install new versions. This will further ease the process of installing updates.
Installation
Please double click the setup file on the computer that will be your PRTG server. Follow the
installation wizard and install the software.
At the end of the installation, a browser window will be opened automatically, and it will
connect to the PRTG web interface, showing the Configurat ion Guru. Please make sure you
load the web interface with one of the supported browsers:
34 03.04.2014
Part 2: Quick Start Guide | 1 ONE—Download, Installation, and First Login
Note: Due to scripting incompatibilities, you might not be able to use all functionalities of the
PRTG Ajax web interface with Internet Explorer 9 or earlier and other older browsers. If you
cannot access the Configurat ion Guru, please open the URL of the PRTG web interface in
another browser.
Login
If everything works fine, you will not see the login screen on first startup. Only when switching
browsers you will have to log in.
Please make sure you use a supported web browser when logging in to PRTG. Please use
Google Chrome 34 or later (recommended), Mozilla Firefox 28 or later, or Microsoft Internet
Explorer 10 or 11. Only with a supported browser you can use the AJAX Web GUI (All
feat ures, opt imized for deskt op access) option. If you see this option grayed out, please
change your browser and open the URL again.
Please see the next step for more information about Using t he Configurat ion Guru 36 .
More
Video Tutorials for PRTG Network Monitor:
§ http://www.paessler.com/support/video_tutorials
03.04.2014 35
Part 2: Quick Start Guide | 2 TWO—Using the Configuration Guru
Note: When using the Ent erprise Console 1894 , please start the Guru by selecting Help | Run
Configurat ion Guru from the main menu.
By answering about ten simple questions, this assistant will guide you through an initial setup
and pre-configure an essential monitoring of your network including important devices,
servers, and websites. You can later adjust these automatically generated monitoring settings
later by hand.
36 12.05.2014
Part 2: Quick Start Guide | 2 TWO—Using the Configuration Guru
Click on the St art Guru button to start. You can skip a step at any time by clicking on the Skip
button.
12.05.2014 37
Part 2: Quick Start Guide | 2 TWO—Using the Configuration Guru
This step is shown only if your web server runs on http. We recommend running the PRTG web
interface using SSL encryption (https), especially if you make your web interface available from
the internet. Without encryption your passwords are sent over your network unencrypted.
Choose between:
§ Yes: Switch the PRTG web server to use SSL. A popup will appear, showing you the screen
shot of a certificate security warning that will be shown the next time you load the PRTG
web interface. Confirm by clicking the button Yes, swit ch t o SSL now. After you confirm,
the PRTG core server Windows service will be restarted and the web interface will be
reloaded, most likely showing a certificate warning. Confirm it to proceed to the login
screen. For more information, please see SSL Cert ificat e Warning 105 .
§ No: Skip this step and keep using an unencrypted http connection. Once you skipped this
step, it will not be shown again. You can switch to SSL later by using the PRTG Server
Administrator tool from the Windows start menu. For more information, please see PRTG
Server Administ rat or 1999 .
Click the Save & Next button to apply your settings, or click the Skip button to skip this step.
Both buttons will take you to the next step.
By default, PRTG uses the administrator account with login name prt gadmin and password
prt gadmin. For security reasons you should at least change the password.
Please enter credentials and email address for the administrator account.
Click the Save & Next button to apply your settings, or click the Skip button to skip this step.
Both buttons will take you to the next step.
In order to monitor your Windows clients and servers via Windows Management
Instrumentation (WMI), please enter Windows administrator credentials for your network. We
recommend using Domain Administrator credentials (if you're using an Active Directory).
PRTG will store these credentials in the Root 224 group of your device tree. All Windows-based
devices will automatically inherit and use them for monitoring. You can discontinue
Inherit ance of Set t ings 87 at any level, entering other credentials instead.
38 12.05.2014
Part 2: Quick Start Guide | 2 TWO—Using the Configuration Guru
For a general introduction to the technology behind WMI, please see Monit oring via WMI 1959
section.
Click the Save & Next button to apply your settings, or click the Skip button to skip this step.
Both buttons will take you to the next step.
In order to monitor your hardware (router, switches, etc.), Simple Network Management
Protocol (SNMP) is the most common protocol used. Usually, all SNMP-enabled devices use the
same settings by default: SNMP version 1, community string public, SNMP port 161).
You only need to change values here if the SNMP-enabled devices in your network use other
settings. Choose between:
§ No: You SNMP-enabled devices use the default configuration. If you're not sure, choose this
option.
§ Yes: Choose this option to enter your own SNMP credentials and settings. More settings will
appear. Choose the SNMP version, enter the community string and SNMP port number, and
define a time out for SNMP connections.
PRTG will store these credentials in the Root 224 group of your device tree. All SNMP-based
devices will automatically inherit and use them for monitoring. You can discontinue
Inherit ance of Set t ings 87 at any level, entering other credentials instead.
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Click the Save & Next button to apply your settings, or click the Skip button to skip this step.
Both buttons will take you to the next step.
If you use the virtual environments VMware or Citrix XenServer, PRTG can monitor them as
well. To do so, please enter root access credentials for those systems. Choose between:
§ No: PRTG will not monitor virtual environments. You can later add those credentials.
§ Yes: Please enter user name and password for VMware or XenServer systems. For VMware,
please also specify the protocol that will be used to connect.
PRTG will store these credentials in the Root 224 group of your device tree. All VMware/
XenServer-based devices will automatically inherit and use them for monitoring. You can
discontinue Inherit ance of Set t ings 87 at any level, entering other credentials instead.
For an overview of all available VMware and XenServer sensors, please see List of Available
Sensor Ty pes 296 , section "Virtual Servers Sensors".
12.05.2014 39
Part 2: Quick Start Guide | 2 TWO—Using the Configuration Guru
Click the Save & Next button to apply your settings, or click the Skip button to skip this step.
Both buttons will take you to the next step.
If you have systems running on Linux, Solaris, or Mac OS X, PRTG can monitor them as well. To
do so, please enter root access credentials for those systems. Choose between:
§ No: PRTG will not monitor devices via SSH/WBEM. You can later add those credentials.
§ Yes: Please enter SSH/WBEM credentials. You can either provide username and password, or
paste a private key. For WBEM access, please also define protocol and port. Additionally,
specify the rights an SSH command will be executed with.
PRTG will store these credentials in the Root 224 group of your device tree. All SSH/WBEM-
based devices will automatically inherit and use them for monitoring. You can discontinue
Inherit ance of Set t ings 87 at any level, entering other credentials instead.
For a general introduction to SSH monitoring, please see Monit oring via SSH 1962 section.
Click the Save & Next button to apply your settings, or click the Skip button to skip this step.
Both buttons will take you to the next step.
PRTG can monitor the availability of your default gateway and DNS servers. It will try to
automatically detect and pre-populate the respective fields with the correct IP addresses.
Please review and/or enter the IP addresses of your default (internet) gateway and your DNS
server(s). Enter each IP address/DNS name in one line.
Note: For most networks, the gateway is the IP address or DNS name of your firewall or
router. If you do not have a second DNS server, simply leave the respective field blank.
PRTG will create a new device for each entry and run an auto-discovery to set up sensors. In
the background, auto-discovery will start immediately after you confirm this step.
Click the Save & Next button to apply your settings, or click the Skip button to skip this step.
Both buttons will take you to the next step.
PRTG can monitor your AD domain controllers, Exchange or other mail servers, as well as
additional servers in your network. PRTG will try to automatically detect and pre-populate the
respective fields with the correct IP addresses. Please review and/or enter the entries for your
Active Directory domain controllers and mail servers. Enter each IP address/DNS name in one
line.
40 12.05.2014
Part 2: Quick Start Guide | 2 TWO—Using the Configuration Guru
PRTG will create a new device for each entry and run an auto-discovery to set up sensors. In
the background, auto-discovery will start immediately after you confirm this step.
Note: Your entries will not be shown in the Configuration Guru after confirming this step but
will be added as devices to your device tree nevertheless. The Configuration Guru option
Monit or LAN Servers will be marked with a green check mark as well if one or more servers
were defined in this section.
Click the Save & Next button to apply your settings, or click the Skip button to skip this step.
Both buttons will take you to the next step.
PRTG can monitor your website and online shop using http. Simply enter the URLs you want to
monitor, each in one line.
PRTG will create a new device for all of your websites, with one sensor for each URL.
Click the Save & Next button to apply your settings, or click the Skip button to skip this step.
Both buttons will take you to the next step.
To see if the cloud services that you usually use are up and running, PRTG can set up http
sensors for those as well. In the list of services, simply switch the radio button to Yes for each
service you want to monitor. Choose from:
PRTG will create a new device for all of cloud services, with one sensor for each URL.
Click the Save & Next button to apply your settings, or click the Skip button to skip this step.
Both buttons will take you to the next step.
12.05.2014 41
Part 2: Quick Start Guide | 2 TWO—Using the Configuration Guru
PRTG can scan an entire network segment, automatically detect devices, and create sensors
using its auto-discovery.
PRTG will try to automatically detect and pre-populate the respective fields with the correct IP
range. Please review and/or enter the entries. In the IPv4 Base field, enter the first three
octets of your network's IP range, for example 192.168.0 or 10.0.0, or whatever IP address
range you use. If you don't change the default values for IPv4 Range St art and End, PRTG will
automatically complete the IP base and scan all IP addresses ending in .1 to .254.
If you need more options regarding the definition of IP ranges, you can run additional auto-
discoveries later. Please see Aut o-Discovery 190 for more details.
Click the Save & Next button to apply your settings, or click the Skip button to skip this step.
Both buttons will take you to the next step.
While you were busy using the guru, PRTG has already created devices and sensors for you.
There are first monitoring values available, too. In the meantime, you can follow PRTG on your
favorite social network by clicking on of the buttons for Facebook, Twitter, or Google +.
Click on the OK! Let me view my new sensors! button to view the device tree.
In order to get familiar with the PRTG web interface, we recommend you proceed with section
General Lay out 108 of the web interface, or with General Lay out 1898 of the Enterprise
Console.
42 12.05.2014
Part 3
Installing the Software
27.11.2012 43
Part 3: Installing the Software |
PRTG Setup
§ Download PRTG 45
44 27.11.2012
Part 3: Installing the Software | 1 Download PRTG
PRTG Download on Paessler Website with Marked Full Version Download Link
Please download the latest publicly available file from the Paessler website. You can also
request a trial key there, which must be entered during installation:
§ ht t p://www.paessler.com/prt g/download
27.11.2012 45
Part 3: Installing the Software | 1 Download PRTG
Note: Every Freeware installation will start as a Trial version, giving you an unlimited number of
sensors for 30 days. After the trial period has expired, your installation will automatically revert
to a Freeware edition with 10 sensors.
Note: A Special Edition is an extended Freeware version. If you meet certain requirements, you
can receive a Special Edition key from us which gives you an extended number of sensors for
free. For details, please see:
§ ht t p://www.paessler.com/prt g/download#30sensors
Downloads and updates are free to customers with an active maintenance contract. Please log
into the Paessler website to get the latest download. You can also find your license key there,
which must be entered during installation:
§ ht t p://www.paessler.com/login
Note: Once installed, you will usually use the Soft ware Aut o-Updat e 1878 function of PRTG to
download and install new versions. This will further ease the process of installing updates.
46 27.11.2012
Part 3: Installing the Software | 2 Update From Previous Versions
Note: We recommend you always have a proper backup of your monitoring data and
configuration. In most cases both will be maintained when upgrading. Anyway, we recommend
a backup before upgrading. Please see More 49 section below.
If you have been running PRTG Network Monitor with version 12, 13 or 14, simply install 51 the
latest version on top of the previous version. Your configuration will be kept. If you have
configured PRTG as a cluster, you only have to install an update on any node server (master or
failover). The new version will then be deployed to the cluster automatically. Note: We
recommend you always have a proper backup of your monitoring data.
Note: As of PRTG 14, Int ernet Explorer 9 is no longer officially support ed for access to the
PRTG web interface.
As of PRTG version 13.2.3, the website folder of the PRTG program directory is not used any
more. This means that if you update from an older PRTG version than 13.2.3 to the current
version, all existing customizations of the web interface will be disabled and have to be
revised. You may find a way for a similar customization that can be applied to the files in the
current webroot folder which contains the web interface files now. For details, please see
section More 49 .
If you are using PRTG 9 now, your configuration will be kept when installing the current PRTG
version in St andalone Mode or when installing a Mast er Node. There are only a few things
you should consider.
§ Discont inued Sensors: Existing instances of the following sensor types will stop working as
of PRTG V12 and must be replaced with their successor sensor types!
If your configuration contains these sensor types, they will stop monitoring after upgrading
to the current version. We recommend you to pause them to keep their data. In order to
continue monitoring, please add the sensors anew (for example, using the auto-discovery).
§ Please inst all .NET 4.0: We strongly recommend installing .NET 4.0 on systems that run the
core server (and the remote probes, if you use those). Otherwise the following features will
not work: VMware 296 auto-discovery and monitoring, Citrix XenServer 343 auto-discovery
and monitoring, SIP Options Ping Sensor 899 , Windows Last Update Sensor 1457 .
28.05.2014 47
Part 3: Installing the Software | 2 Update From Previous Versions
§ Changed Geo Maps Provider: When you update to the current PRTG version, the provider
for geographical maps will automatically be switched from Google Maps to MapQuest (using
Open Street Map data).
§ Windows 2000 Not Support ed: Since PRTG 7 we do not officially support Windows 2000
systems any more. This means, PRTG cannot be installed on systems running Windows 2000,
and you cannot officially monitor Windows 2000 systems (for example, via WMI). However, if
you could successfully monitor your Windows 2000 systems with PRTG 9, this might actually
not be possible any more with the current PRTG version. Especially the WMI Service Sensor
1640 will show an error message when monitoring Windows 2000 systems under the current
PRTG version. For a work around, please see More 49 section below.
If you are using PRTG 7 or 8 now, your configuration will be kept when installing the current
PRTG version in St andalone Mode or when installing a Mast er Node. There are only a few
things you should consider.
Note: If you're running PRTG 7 or 8 we recommend you first update to the latest PRTG 8
version as an intermediate step, in order to make sure all data is carried over correctly. Please
contact technical support 2088 to obtain a download link for PRTG 8. In any case we recommend
you always keep a proper backup of your configuration and monitoring data.
§ Packet Sniffer (Content) sensors are not supported any more. Existing sensors of this type
will automatically be switched to Packet Sniffer (Header) sensors after the update. As a
benefit, you can now also sniff IPv6 traffic.
§ Internet Explorer 8 is no longer supported for access to the PRTG Ajax web interface or to
the mobile web GUI.
§ You may experience a slow Enterprise Console 1894 (former 'Windows GUI') due to different
reasons. For detailed information, please see the knowledge base article linked in the More
49 section below.
§ When installing a failover node on top of an existing stand-alone PRTG 7, 8, 9, 12, or 13+
installation, the configuration cannot be kept and is written to a backup folder. Then, the
new cluster configuration is received from the master node of the cluster. As all nodes work
with the same configuration, a failover node's old configuration and monitoring data can no
longer be used. If you want to keep a configuration of PRTG 7, please install the master node
on top of the old installation and use other servers for the failover node installations.
§ Since PRTG 9 the SNMP sensors use the IPv4 Out going IP set for the probe service (this
setting was formerly ignored by those sensors, using the aut o setting instead). If you
experience failing sensors, please check the setting in the PRTG Probe Administrator 2018 . For
detailed information please see More 49 section below.
§ If you have (manually) configured the PRTG probe or PRTG core service to run under a
different Windows user account (for example, for successful internet access through an ISA
server firewall), please apply the respective Windows user account for the
"PRTGProbeService" and/or "PRTGCoreService" anew after installing the current PRTG version.
For detailed information please see More 49 section below.
48 28.05.2014
Part 3: Installing the Software | 2 Update From Previous Versions
§ Probe core and probe now require: SP1 (or later) on Windows 2003, and SP2 (or later) on
Windows XP.
§ If you use the default data path in your PRTG setup, it will be changed automatically. Up to
version 8 all data was stored in a sub folder reflecting a PRTG version number (v7 or v8). As
of version 9 this sub folder is omitted, and data is stored directly at %ALLUSERSPROFILE%
\Application data\Paessler\PRTG Network Monitor. During setup, all data will be moved to
the new directory. If you use a custom data path it will not be changed.
§ Up to version 8 all data in the registry was stored in a sub key reflecting a PRTG version
number (v7 or v8). As of version 9 this sub key is omitted, and registry data is stored directly
under the key HKEY_LOCAL_MACHINE\SOFTWARE\Paessler\PRTG Network Monitor (on 32-bit
systems) respectively HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Paessler\PRTG
Network Monitor (on 64-bit systems). During setup, all existing registry values will be moved
to the new key.
§ Regarding custom sensors, the interpretation of returned values is handled more strict as of
PRTG 8. If you're using custom sensors with PRTG 7, these may not work with the current
PRTG version if they do not fully apply to the API definition 2031 .
For all other predecessor products, a direct data import into the current version is not
possible.
If you have been using IPCheck 5 or PRTG Traffic Grapher 6, please perform a clean installation
of PRTG Network Monitor and set up your configuration anew. Using PRTG's Aut o-Discovery
190 is the easiest way to quickly configure a monitoring of your entire network. Please see
More
Knowledge Base: How do I backup all data and configuration of my PRTG installation?
§ http://kb.paessler.com/en/topic/523
28.05.2014 49
Part 3: Installing the Software | 2 Update From Previous Versions
Knowledge Base: Some of my SNMP sensors do not work after updating from PRTG 8 to PRTG
9 or later
§ http://kb.paessler.com/en/topic/25663
Knowledge Base: Probe Service or Core Service stop working after updating from PRTG 8 to
PRTG 9 or later
§ http://kb.paessler.com/en/topic/25463
Knowledge Base: How and where does PRTG store its data?
§ http://kb.paessler.com/en/topic/463
Knowledge Base: Can I update from PRTG Traffic Grapher or IP Check 5 to the current PRTG
version?
§ http://kb.paessler.com/en/topic/26553
Knowledge Base: How do I Import Data from PRTG Traffic Grapher 6 or IPCheck Server Monitor
5 in PRTG Network Monitor?
§ http://kb.paessler.com/en/topic/253
50 28.05.2014
Part 3: Installing the Software | 3 Install a PRTG Core Server
Confirm the question of the Windows User Account Control with Yes to allow the program to
install. The usual software installation wizard will guide you through the installation process.
Please select a language for your product and click the OK button. The available language
options depend on both your Windows version and the setup file.
28.05.2014 51
Part 3: Installing the Software | 3 Install a PRTG Core Server
52 28.05.2014
Part 3: Installing the Software | 3 Install a PRTG Core Server
Please enter a valid email address. Your PRTG server will send important and urgent system
alerts to this address. Click the Next button to continue.
Please choose the folder you wish to install the software in. We recommend using the default
value.
28.05.2014 53
Part 3: Installing the Software | 3 Install a PRTG Core Server
As soon as you click Next , the necessary files will be copied to your disk.
After installation, the Ajax Web Int erface 100 is opened in your system's default browser.
Please make sure there is Google Chrome 34 or later (recommended), Mozilla Firefox 28 or
later, or Microsoft Internet Explorer 10 or 11 available on the system, and set as default
browser (see Sy st em Requirement s 21 ).
54 28.05.2014
Part 3: Installing the Software | 3 Install a PRTG Core Server
Only if you entered incorrect license information before you will be asked to enter a correct
license name and key.
Please enter both Name and Key exactly as stated in the email received from Paessler. We
recommend using copy&paste to avoid typing mistakes. For details, please see Ent er a
License Key 57 .
More
Knowledge Base: What is the PRTG Special Edition license?
§ http://kb.paessler.com/en/topic/8063
Knowledge Base: How can I establish a secure web interface connection to PRTG?
§ http://kb.paessler.com/en/topic/273
Knowledge Base: PRTG blocks port 80 although I'm using SSL on port 443. How to free port
80?
§ http://kb.paessler.com/en/topic/5373
28.05.2014 55
Part 3: Installing the Software | 4 Install a PRTG Cluster
For detailed information, please see Failover Clust er Configurat ion 2064 .
More
Knowledge Base: What's the Clustering Feature in PRTG?
§ http://kb.paessler.com/en/topic/6403
56 28.05.2014
Part 3: Installing the Software | 5 Enter a License Key
You should have received license name and key via email. This is either the information for a
Trial or a Commercial Edition.
During the setup process, PRTG will ask you to enter your license information. Please use copy
and paste to fill out the form in the dialog shown by the installer.
§ Trial/Freeware license key : When entering a Trial license key you can experience unlimited
functionality of PRTG during the trial period. Your installation will automatically switch to a
Freeware Edition afterwards. In details how to get your free Trial installer, please see
Download PRTG 45 section.
§ Commercial license key : This key can only be entered if you install the Commercial Edition
of PRTG, available for download in the customer service center. See Download PRTG 46
section for details. Your installation will allow the number of sensors according to your
license.
Usually you do not need to enter a key manually, as it is prompted during installation.
However, there are still scenarios where you want to change your key, for example, when
switching from a Trial Edition to a Special Edition 19 .
If you need to enter new license information, please follow these steps.
Please check first if you have installed the proper edition and then enter the license key.
There are two different installers available for PRTG (see Download 45 section):
§ The publicly available installer only contains the Freeware, Special, and Trial Editions. It does
not accept any commercial license keys.
§ The Commercial installer is only available for download to paying customers.
14.01.2014 57
Part 3: Installing the Software | 5 Enter a License Key
The Commercial Installer must be installed to run the commercial editions of PRTG Network
Monitor. If y ou have purchased a license key for PRTG, please download and inst all t he
lat est Commercial Inst aller from t he Paessler websit e in order t o apply y our license
key . Note: You can install a commercial version "on top" of an existing Trial Edition in order to
maintain your configuration and monitoring data.
Please start the PRTG Server Administ rat or program from the Windows Start Menu. In the
program, select the License tab.
Start M enu Ic on
To use a PRTG license with this installation of PRTG, please enter the license information you
have received from Paessler via email. To avoid typing errors, please copy and paste both the
License Name and the License Key from the email. Both must be transferred exactly as shown
in the email.
58 14.01.2014
Part 3: Installing the Software | 5 Enter a License Key
To make sure your key has been entered correctly please click on the Check Key button. A
popup box will either show success or denial of your license information. License information
is also checked if you change tabs.
In the Licensed Edit ion field you will see an accepted license key.
Click on the Ok button to save and confirm to restart the core server service by clicking on
the Yes button.
14.01.2014 59
Part 3: Installing the Software | 6 Activate the Product
You have to run through the product activation process once in order to use PRTG
continuously (only Freeware and Trial Edition are always activated automatically and do not
require a special procedure). The activation has to be done within ten days after installation
and only takes a few minutes. If you do not activate PRTG for ten days, it will temporarily revert
to the Freeware Edition (with a maximum of 10 sensors) until you activate. Login to the PRTG
web interface 102 to activate.
In the PRTG web interface, choose Set up | PRTG St at us | Act ivat ion St at us from the main
menu.
Click on the button St art Act ivat ion Now to start product activation. PRTG will now connect
with the Paessler license server to check your license (via SSL on port 443). A few seconds
later you should see Act ivat ion OK in the License Activation Status.
Note: The PRTG core server needs an internet connection on port 443 to activate. If a proxy
connection is needed, please configure it in the Sy st em Administ rat ion—Core & Probes 1849
settings. Please see More 61 section for details about activation servers. In case activation
fails, you can activate via email.
In the PRTG Web Interface, choose Set up | PRTG St at us | Act ivat ion St at us from the main
menu.
If there is no internet connection available, you can activate PRTG via email. To do so, first click
on the St art Act ivat ion Now button. You will then see Last message about act ivat ion:
Act ivat ion failed in the License Activation Status.
§ Once the activation via internet fails, the activation via email is available.
§ Click on the St art Act ivat ion per Email tab. You will see an Act ivat ion Request Code.
§ Copy it and send it to the email address shown.
§ Within two business days you will receive an email reply from Paessler, containing an
activation code.
§ Once you've received this email, go the Finalize Act ivat ion per Email tab and copy the
activation code into the according field. Note: Please make sure you only copy the code
itself and nothing else from the email. Also, please omit the "Activation Code Start/End"
markers.
§ Click on Confirm Act ivat ion.
60 28.05.2014
Part 3: Installing the Software | 6 Activate the Product
A few seconds later you should see Act ivat ion OK in the License Activation Status.
More
Knowledge Base: Which servers does PRTG connect to for Software Auto-Update and for
Activation?
§ http://kb.paessler.com/en/topic/32513
28.05.2014 61
Part 3: Installing the Software | 7 Install a PRTG Remote Probe
The remote probe version has to fit the PRTG core server version you will connect to. In order
download your setup program to the computer you want to install it on, please connect to the
Ajax web interface 102 . On the login screen 102 , enter login name and password and from the
main menu, select Set up | Downloads / Add-Ons | Remot e Probe Inst aller. Click on the
Download: Remot e Probe Inst aller button. Your browser will show a download dialog. Save
the setup program to your local hard disk drive.
Confirm the question of the Windows User Account Control with Yes to allow the program to
install. The usual software installation wizard will guide you through the installation process.
62 14.01.2014
Part 3: Installing the Software | 7 Install a PRTG Remote Probe
Please select a language for your product and click the OK button. The available language
options depend on both your Windows version and the setup file.
After accepting the license agreement, you can choose the folder you wish to install the
software in. We recommend using the default value.
14.01.2014 63
Part 3: Installing the Software | 7 Install a PRTG Remote Probe
As soon as you click Next , the necessary files will be copied to your disk.
The PRTG Probe Administrator is shown. Please enter the correct settings in order to connect
with your PRTG core installation. See Remot e Probe Set up 2059 section for more information.
Click Ok to continue.
64 14.01.2014
Part 3: Installing the Software | 7 Install a PRTG Remote Probe
When asked if you want to start the probe service, confirm with Yes. The installation is
completed.
14.01.2014 65
Part 3: Installing the Software | 7 Install a PRTG Remote Probe
More
After you click the Finish button, the PRTG Probe Administrator is shown, allowing you to
configure connections. Please see section Remot e Probe Set up 2059 for more information on
how to connect the remote probe with your PRTG core server installation.
Note: You can also install a Remote Probe directly from PRTG's web interface. For details, refer
to Remot e Probe Quick Inst all 2053 .
66 14.01.2014
Part 3: Installing the Software | 8 Install the Enterprise Console
The version of the Enterprise Console has to fit exactly the PRTG core server version you will
connect to. From the computer you want to install the Enterprise Console on, please connect
to the Ajax 100 web interface. On the login screen 102 of the web interface, enter login name
and password and select the Ent erprise Console (Download for Windows) option. You
browser will show a download dialog. Save the setup program to the local hard disk drive.
Confirm the question of the Windows User Account Control with Yes to allow the program to
install. The usual software installation wizard will guide you through the installation process.
Please select a language for your product and click the OK button. The available language
options depend on both your Windows version and the setup file.
14.01.2014 67
Part 3: Installing the Software | 8 Install the Enterprise Console
After accepting the license agreement, you can choose the folder you wish to install the
software in. We recommend using the default value.
68 14.01.2014
Part 3: Installing the Software | 8 Install the Enterprise Console
Select which icons will be created. We recommend using the default value.
As soon as you click Next , the necessary files will be copied to your disk.
14.01.2014 69
Part 3: Installing the Software | 8 Install the Enterprise Console
More
Please see section Ent erprise Console 1894 for more information on how to use this Graphical
User Interface (GUI).
70 14.01.2014
Part 3: Installing the Software | 9 Uninstall PRTG Products
Step 1
From the Windows Start Menu, select the Uninst all PRTG Net work Monit or icon, the
Uninst all PRTG Ent erprise Console icon, or the Uninst all PRTG Remot e Probe icon, or open
your Windows Control Panel and choose the respective entry in the Programs section.
Depending on the installed products, not all uninstall programs are available.
Step 2
If asked, confirm the question of the Windows User Account Control with Yes to allow the
program to uninstall. The usual software uninstall wizard will guide you through the uninstall
process.
Step 3
28.05.2014 71
Part 3: Installing the Software | 9 Uninstall PRTG Products
Step 4
Step 5
72 28.05.2014
Part 3: Installing the Software | 9 Uninstall PRTG Products
Step 6
After system restart, the software is removed. However, there are still custom data in the PRTG
program folder left. If you have uninstalled an entire PRTG Network Monitor installation or a
remote probe installation, your monitoring data is still stored on the system. To completely
remove all PRTG data, please delete the PRTG Net work Monit or program folder as well as the
Paessler\PRTG Net work Monit or folder in your data path. For more information where data is
stored see Dat a St orage 2074 section.
More
Knowledge Base: Can we remotely and silently uninstall a Remote Probe?
§ http://kb.paessler.com/en/topic/27383
28.05.2014 73
Part 4
Understanding Basic Concepts
14.01.2014 75
Part 4: Understanding Basic Concepts |
§ Clust ering 81
§ Object Hierarchy 83
§ Tags 89
§ Dependencies 90
§ Scheduling 91
§ IPv6 97
76 14.01.2014
Part 4: Understanding Basic Concepts | 1 Architecture and User Interfaces
Ty pe Part of PRTG
Probe(s) 78
The part of PRTG on which the actual monitoring is performed.
There are local probes, remote probes, and cluster probes
available. All monitoring data is forwarded to the central core
server. Probes are configured as Windows services which run
permanently.
14.01.2014 77
Part 4: Understanding Basic Concepts | 1 Architecture and User Interfaces
Ty pe Part of PRTG
Core Server
The core server is the heart of your PRTG system and performs the following processes:
In a cluster 81 , the current master node is responsible for all of these tasks.
The built-in, fast, and secure web server (no additional IIS or Apache is required) supports HTTP
as well as secure HTTPS (via SSL). It serves the web interface when accessed with a browser
and also answers PRTG Application Programming Interface (API) calls (for example, for user
scripts or the Enterprise Console).
Note: Core server and probe(s) are configured as Windows services which are permanently run
by the Windows system without the requirement for a logged-in user.
Probe(s)
On a probe, PRTG performs the actual monitoring with the sensors created on a device (for
example, computer, router, server, firewall, etc.). The probe receives its configuration from the
core server, runs the monitoring processes, and delivers monitoring results back to the core
server. On every system running a PRTG core server, there is always a local probe running with
it on the same machine.
78 14.01.2014
Part 4: Understanding Basic Concepts | 1 Architecture and User Interfaces
PRTG Core Serv er and Loc al Probe Monitoring a Loc al Area Network
The actual monitoring is performed by PRTG probe processes which run on one or more
computers. During installation, the system automatically creates the so-called Local Probe. In a
single-probe installation—which is the default setup—the local probe performs all monitoring.
The PRTG core server inside the corporate LAN (bottom right in the figure above) is able to
monitor services and servers in the entire Local Area Network (LAN). Note: Core server and
probe(s) are configured as Windows services which are permanently run by the Windows
system without the requirement for a logged-in user.
In a cluster setup 81 , a cluster probe runs on all nodes. There is an additional so-called Clust er
Probe. All devices created on it are monitored by all nodes in the cluster, so data from
different perspectives is available and monitoring for these devices always continues, also if
one of the nodes fails.
PRTG automatically monitors system health of its own core server and of each probe in order
to discover overloading situations that may distort monitoring results. To monitor the system
status of the probe computer, PRTG automatically creates a few sensors. These include Core
and Probe Healt h, Sy st em Healt h, Clust er Probe Healt h, Disk Free, and a bandwidth sensor
for all installed network cards. We recommend keeping these sensors, but you can optionally
remove all except the Healt h sensors. They measure various internal system parameters of
the probe system hardware and the probe's internal processes and then computes a resulting
value. Frequent or repeated values below 100% should be investigated. Please check the
channels 124 of a particular sensor for details.
Additional so-called Remot e Probes can be created by the user in order to achieve monitoring
of multiple locations, or for several other scenarios. They are using SSL-secured connections
to the core and allow to securely monitor services and systems inside remote networks which
are not openly accessible or secured by firewalls. For more information, please see Remot e
Probes and Mult iple Probes 2049 section. For a video on this please see More 203 section
below.
More
Video Tutorial: There is a video available on the Paessler video tutorials page.
§ http://www.paessler.com/support/video_tutorials
14.01.2014 79
Part 4: Understanding Basic Concepts | 1 Architecture and User Interfaces
80 14.01.2014
Part 4: Understanding Basic Concepts | 2 Clustering
4.2 Clustering
A PRTG Cluster consists of two or more installations of PRTG 51 that work together to form a
high availability monitoring system. The objective is to reach true 100% uptime for the
monitoring tool. Using clustering 2064 , the uptime will no longer be degraded by failing
connections because of an internet outage at a PRTG server's location, failing hardware, or
because of downtime due to a software update for the operating system or PRTG itself.
A PRTG cluster consists of one Primary Mast er Node and one or more Failover Nodes. Each
node is simply a full installation of PRTG which could perform the whole monitoring and alerting
on its own. Nodes are connected to each other using two TCP/IP connections. They
communicate in both directions and a single node only needs to connect to one other node
to integrate into the cluster.
During normal operation the Primary Mast er is used to configure devices and sensors (using
the web interface 100 or Enterprise Console 1894 ). The master automatically distributes the
configuration to all other nodes in real time. All nodes are permanently monitoring the
network according to this common configuration and each node stores its results into its own
database. This way, the storage of monitoring results also is distributed among the cluster (the
downside of this concept is that monitoring traffic and load on the network is multiplied by the
number of cluster nodes, but this will not be a problem for most usage scenarios). The user
can review the monitoring results by logging into the web interface of any of the cluster nodes
in read only mode. Because the monitoring configuration is centrally managed, it can only be
changed on the master node, though.
By default, all devices created on the Clust er Probe are monitored by all nodes in the cluster,
so data from different perspective is available and monitoring for these devices always
continues, even if one of the nodes fails. In case the Primary Mast er fails, one of the Failover
Nodes takes over the master role and controls the cluster until the master node is back. This
ensures a fail-safe monitoring with gapless data. Note: During the outage of a node, it will not
be able to collect monitoring data. The data of this single node will show gaps. However,
monitoring data for this time span is still available on the other node(s). There is no
functionality to actually fill in other nodes' data into those gaps.
If downtimes or threshold breaches are discovered by one or more nodes, only one
installation, either the Primary Master or the Failover Master, will send out notifications (via
email, SMS text message, etc.). Thus, the administrator will not be flooded with notifications
from all cluster nodes in case of failures.
For detailed information, please see Failover Clust er Configurat ion 2064 .
More
Knowledge Base: What's the Clustering Feature in PRTG?
§ http://kb.paessler.com/en/topic/6403
28.05.2014 81
Part 4: Understanding Basic Concepts | 2 Clustering
82 28.05.2014
Part 4: Understanding Basic Concepts | 3 Object Hierarchy
§ Root group contains all objects in your setup; all probes are directly under the root node.
§ A Probe contains one or more groups.
§ A Group contains one or more devices.
14.01.2014 83
Part 4: Understanding Basic Concepts | 3 Object Hierarchy
§ A Device represents one component in your network which is reachable via an IP address.
On a device are several sensors.
§ A Sensor monitors one single aspect of a device and has at least one channel.
§ A Channel receives the monitoring results and is part of a sensor.
Root Group
The Root group is the topmost instance in PRTG. It contains all other objects in your setup.
Using the inheritance 87 mechanism, we recommend adjusting the default settings for the
Root group 224 . This makes configuration easier later on, because all other objects inherit
these standard settings by default and, thus, you will not have to set up the same
configuration for each object anew.
Probe
Each group (except the Root group) is part of a Probe. This is the platform on which the
monitoring takes place. All objects configured below a probe will be monitored via that probe.
Every PRTG core installation automatically installs a Local Probe service. You can add additional
probes and remote probes to your configuration to include remote devices from outside your
network into the monitoring (see section Mult iple Probes and Remot e Probes 2049 ). In a
cluster, there is an additional Clust er Probe running on all nodes. Devices on the cluster
probe are monitored by all nodes of the cluster, so data from a different perspective is
available and monitoring for these devices will always continue, even if one of the nodes fails.
Group
On each probe, there are one or more Groups, which serve merely structural purposes. Use
groups to arrange similar objects in order to inherit same settings to them. To a group, you
add the devices. You can arrange your devices in different nested groups to reflect the
structure of your network.
Find below a sample configuration: A device tree with local probe, several groups, devices and
their sensors.
84 14.01.2014
Part 4: Understanding Basic Concepts | 3 Object Hierarchy
Device
To each probe or group, you can add Devices that you want to monitor. Each device in your
PRTG configuration represents a real hardware or virtual device in your network. These can be,
for example:
Note: Sometimes you may want to add the same device in PRTG several times, in order to get a
better overview when using many sensors for a very detailed monitoring, or to use different
device settings for different groups of sensors. In PRTG you can simply add multiple devices
with the same IP address or DNS name. The sensors on all of these PRTG devices will then
query the same real hardware device in your network.
PRTG additionally adds a so called Probe Device to the local probe. This is an internal system
device. It has access to the computer on which the probe is running on and monitors its
health parameters with several sensors running on it.
14.01.2014 85
Part 4: Understanding Basic Concepts | 3 Object Hierarchy
Sensor
On each device you can create a number of Sensors. Every sensor monitors one single aspect
of a device. This can be, for example:
Channel
Every sensor has a number of Channels through which it receives the different data streams.
The available channels depend on the type of sensor. One sensor channel can contain, for
example:
86 14.01.2014
Part 4: Understanding Basic Concepts | 4 Inheritance of Settings
You can override this inheritance on any level of the hierarchy by setting a different value for a
specific probe, group, device, or sensor. All objects below will inherit these new settings;
object settings from levels above will stay unchanged.
§ Monitoring interval
§ Notification triggers
§ Authentication settings for several systems
§ Compatibility settings (for certain types of sensors)
§ Channel and unit configuration
§ User access rights 94
§ Tags 89
§ Paused status: If an object is paused by the user, or a schedule, all sensors on it are paused
as well
§ etc.
There is one exception for devices and sensors: The IP address or DNS name of a device and
compatibility settings are always inherited by sensors and can not be changed on sensor level.
The actual overriding of the parent's settings takes place in an object's settings: Remove the
check mark symbol at the beginning of the respective line inherit from [parent object ]. For
example, the screenshot below shows Windows systems credentials settings after removing
the check mark symbol.
14.01.2014 87
Part 4: Understanding Basic Concepts | 4 Inheritance of Settings
For all settings (except passwords), PRTG already includes a set of default values so you can
get started with the software immediately. For example, the following settings will be inherited
by all sensors from the Root group:
You may need to change some of the default entries as you become used to the interface.
However, these settings will initially suffice for most situations.
Before sensor setup, please review the Root group's settings and set the default values to
suit your setup, including necessary credentials for all kinds of systems in your network you
want to monitor (Windows, Linux, virtual servers, etc.).
See section Root Group Set t ings 224 for more details.
If you add notification triggers on probe, group, or devices level, these will also be inherited to
all sensors underneath, unless you cancel inheritance with specific settings.
See section Sensor Not ificat ions Set t ings 1716 for details.
88 14.01.2014
Part 4: Understanding Basic Concepts | 5 Tags
4.5 Tags
For every object in your PRTG setup, you cannot only name objects, but also define tags in an
object's settings 142 to additionally mark an object as a member of certain categories. Although
there are tags predefined when adding objects 204 , you are completely free in the way you add
tags. For example, you can mark all of the bandwidth sensors which are especially important
for you with the tag bandwidth_important. Later, you can view lists of objects with certain tags
(helpful for multi-edit 1736 of settings), or choose sensors by tag when creating reports 1775 . A
clever arrangement of tags can save you a lot of time at some point. Note: You can also
change tags for several objects at a time using the multi-edit 1736 function.
The tags in an object's settings are automatically inherited 87 to all other objects further down
in the hierarchy. So, for example, a device with the tag myExampleTag will automatically and
invisibly inherit this tag to all sensors created on it. This will not be visible in the sensor's tag
settings, but the sensors will appear in the list whenever you search for myExampleTag. This is
useful, for example, when adding sensors by tag in reports 1775 settings. This way, in order to
configure your setup for fetching all sensors on a device by tag, you do not have to tag every
single sensor, but it is enough to tag the device. Inheritance for tags cannot be disabled.
14.01.2014 89
Part 4: Understanding Basic Concepts | 6 Dependencies
4.6 Dependencies
Using dependencies, you can pause sensor monitoring based on the status of another sensor
in order to avoid false alarms and incorrect downtime recording. A dependency stops the
monitoring of one sensor or a set of sensors as soon as a specific sensor is not in an Up
status. This means, for example, you can stop monitoring remote network services when the
corresponding firewall is down due to connection problems.
When using the auto-discovery 190 function, the Ping sensor on a device is by default set as
the master object for this device. This means that monitoring for the entire device is paused if
the Ping sensor is in a Down status. Usually, it does not make sense to monitor other aspects
of a device with other sensors, while the Ping sensor indicates that the device is not even
reachable.
In order to view a list of all dependencies or only selected dependencies, choose Devices |
Dependencies from the main menu 176 .
For more information about the dependency settings, please see the settings of the
respective object 142 you want to set a dependency for.
90 14.01.2014
Part 4: Understanding Basic Concepts | 7 Scheduling
4.7 Scheduling
Using schedules, monitoring of an object can be paused 162 for a certain time, for example,
Sundays between 4 and 8 a.m. A paused sensor will not collect monitoring data, will not
change its status, and will not trigger any notifications 92 . With schedules you can limit the
monitoring time automatically. You can also pause monitoring for planned system maintenance
time spans to avoid false alarms. You can apply different schedules to every object. They are
also used for reports and notifications.
Schedules are user account specific. To change the default pre-defined schedules or to add
your own schedule, please see Account Set t ings—Schedules 1827 section.
Note: If you use failover clustering with nodes in different timezones, scheduling applies at the
local time of each node. For more information, please see section Failover Clust er
Configurat ion—Before Get t ing St art ed 2064 .
14.01.2014 91
Part 4: Understanding Basic Concepts | 8 Notifying
4.8 Notifying
PRTG Network Monitor keeps the administrator or other responsible persons informed about
the current status of the network. There are several methods how the administrator can stay
up to date.
Notifications
This is the most powerful information tool. Whenever PRTG discovers downtime, an overloaded
system, threshold breach (for example, a disk runs full), or similar situations, it can send a
notification. Notifications use various methods by which you can be notified (for example,
email, SMS, pager message, and others). After creating notifications in the system settings, you
can select them on the notifications tab of probes, groups, devices, and sensors, as well as on
the root group. See Not ificat ions 1749 section for more details.
Limits
In a sensor channel's settings 1709 , you can set limits to change the status of the sensor when
certain limits are breached. This way, you can set, for example, a traffic sensor (typically never
in a error status) to Down status whenever bandwidth values are measured that you consider
critical. This sensor will then show up in the alarms list.
Alarms
The alarms list shows all sensors that are currently in a Down, Down (Acknowledged),
Warning, or Unusual status. This is useful to keep track of all irregularities in your network. In
the table list, you can re-sort the items by clicking on the column's header items. See Alarms
144 section for more details.
Logs
In the logs list, the log file with all monitoring events is shown. In a typical setup, a huge
amount of data is produced here. As the activity of every single object is minuted, you can use
this data to check exactly if your setup works as expected. See Logs 147 section for more
information.
Tickets
The tickets list shows items with important system information or action steps to take for the
administrator. You should view every ticket and take appropriate actions. Per default, an email
is sent to the administrator for every new ticket that is created by the system or another user.
If a ticket is assigned to a specific user, this user will get an email by default. See Ticket s 149
section for more information.
92 14.01.2014
Part 4: Understanding Basic Concepts | 9 Data Reporting
To get a report for a single sensor, there is a function included to review historic data in PRTG.
It allows you to generate reports and charts for a single sensor's data. See Hist oric Dat a
Report s 133 section for more information.
Generate Reports
You can use the sophisticated reports machine included in PRTG to create exhaustive reports
for all monitoring data. See Report s 1775 section for more information.
You can also export all monitoring raw data to XML or CSV files and generate your own
reports using any third party software. See Using t he PRTG API (Applicat ion Programming
Int erface) 2031 section for more information.
You can make monitoring data available to other persons using a special user with read-only
rights (see User Access Right s 94 section), or you can create public or semi-public HTML
pages with monitoring data using the Maps feature. See Maps 1794 section for more
information.
Bill Customers
You can also create custom billing reports based on PRTG's monitoring data, using the open
source Billing Tool for PRTG. For details and download, please see More 93 section below.
More
14.01.2014 93
Part 4: Understanding Basic Concepts | 10 User Access Rights
In addition, every single user has specific rights: There are administrator users, read/write
users, and read only users. You can define these settings in Sy st em Administ rat ion—User
Account s 1856 . With these tools, you can create a rights management that allows you to specify
exactly what users will be able to see and edit.
Individual user rights in combination with access rights of the group(s) they belong to conduct
the access rights to certain objects in the device tree. This means that group membership
particularly controls what a user is allowed to do and which objects the user will see when
logged in.
The actual access rights for each object in the device tree can be defined in an object's
settings. You can define different access rights for all sensors, devices, groups, or probes via
the corresponding Cont ext Menus 163 or in the Object Set t ings 142 .
The following classes of access rights for objects are available in hierarchical order as they can
be given to user groups (lowest rights to highest rights):
§ None: The object will not be displayed to the users of the group; no logs, no tickets, no
alarms regarding this object will appear.
§ Read: Only monitoring results can be seen.
§ Writ e: Reviewing monitoring results and editing settings is allowed. In addition, objects can
be added to and deleted from the device tree.
§ Full: Reviewing monitoring results, editing settings, and editing access rights is allowed. In
addition, objects can be added to and deleted from the device tree.
§ Admin right s: If a user group has administrator rights, all options are available, including
creating users, creating user groups, and deleting objects from the device tree. Access
restrictions to objects cannot be set for this type of user group.
94 14.01.2014
Part 4: Understanding Basic Concepts | 10 User Access Rights
Note: Access rights that are defined locally on an object, for example, on a device, override
inherited 87 rights. On a certain object, the highest directly set access right applies for a user
group. If there is no access right set directly on an object, the next higher object level will be
checked for access rights. This process is repeated until defined access rights are found to be
inherited or there is no higher object level.
Different Ac c ess Rights for a Firewall in the Dev ic e Tree Depending on User Groups
Please see the table below for which user rights apply when. Column headings show access
rights of user groups for objects in the device tree; line headings show the type of user.
Note: Users are either in PRTG user groups or in Active Directory Domain user groups. They
cannot be in both. We recommend to use only one type of user group (either PRTG or Active
Directory) to minimize your administration effort.
14.01.2014 95
Part 4: Understanding Basic Concepts | 10 User Access Rights
§ PRTG User Read-only rights Read/write rights Full access Admin rights
Read/Writ e
§ Domain User
Read/Writ e
§ Users in an administ rat or group have always administrator access rights, no matter of the
access rights of an object.
§ Read-only users have just read rights, no matter of the access rights of their group, except
for users which are members of an administrator group.
§ Read/writ e users in a group with full access to an object have full access rights to this
object only.
§ If a user is in more than one group, access rights of the user group with the highest right s
apply .
§ Administrator rights can only be given via the administrator group.
For more information about defining access rights, please see the following sections:
For information about connecting PRTG to an existing Active Directory, please see Act ive
Direct ory Int egrat ion 2029 .
96 14.01.2014
Part 4: Understanding Basic Concepts | 11 IPv6
4.11 IPv6
PRTG supports the IPv6 protocol for most sensor types. You can define whether data from
your network is queried via IPv4 or IPv6: For each device in PRTG you can select whether PRTG
will connect to it using either IPv4 or IPv6. This is a simple selection in the Device Set t ings 272
of each device. Depending on the setting, the sensors created on this device will use the
respective protocol.
In the Out going IP Set t ings of the PRTG Probe Administ rat or 2018 you can additionally
choose which IPv6 address will be used for outgoing monitoring requests. Note: There is the
same option for IPv4, too.
14.01.2014 97
Part 5
Ajax Web Interface—Basic Procedures
14.01.2014 99
Part 5: Ajax Web Interface—Basic Procedures |
Because the web interface works as a Single Page Application (SPA), you will rarely see a full
page refresh to avoid this performance impact due to redundant processing. Only single page
elements will be refreshed when necessary. All object setting dialogs are shown as pop-up
layers, so you will never lose the current context. This speeds up the user experience
appreciably and makes the configuration of objects in PRTG comprehensible.
The following sections introduce the features and concepts of the Ajax Graphical User
Interface (GUI).
100 14.01.2014
Part 5: Ajax Web Interface—Basic Procedures |
§ Sensor St at es 121
§ Alarms 144
§ Logs 147
§ Ticket s 149
§ Pause 162
Related Topics
§ Ent erprise Console 1894
14.01.2014 101
Part 5: Ajax Web Interface—Basic Procedures | 1 Login
5.1 Login
Once the PRTG core server is installed 51 , you can log in to the web interface. In your browser,
load the IP address or DNS name of the computer PRTG is installed on and log in using the
Default Login button.
You can look up and change PRTG's web server settings at any time using the PRTG Server
Administrator 1999 Windows application on the system where the PRTG core server is installed
on. Especially when accessing PRTG from the internet you should use an SSL encrypted
connection. You can easily switch to SSL using the Yes, swit ch t o SSL button shown on the
welcome screen.
In a web browser window, please enter the IP address or URL of the system PRTG is installed
on. When using a cluster, please connect to the primary master node. You can also double
click on the PRTG Net work Monit or icon on the desktop of the system PRTG is installed on.
Note: If you run PRTG on localhost, please do not use the DNS name http://localhost to log in
to the web server, as this may considerably slow down PRTG's web interface. Please use your
local IP address or http://127.0.0.1 instead.
Desktop Ic on
If you see a certificate warning in your browser, you can usually just confirm it. For more
information please see SSL Cert ificat e Warning 105 .
Login Screen
After loading the web interface, the login screen is shown. You can either login as default
administrator or as an other PRTG user. As Administrator user you can use all functionalities of
the web interface. Administrators can create additional users 1856 with administrator rights or
with more restricted privileges (for example, read only users).
102 28.05.2014
Part 5: Ajax Web Interface—Basic Procedures | 1 Login
When logging in for the first time, login name and password for the default administrator login
are both prt gadmin. You can leave the login name and password fields empty and click on
the Default Login button to log in using these default credentials.
Note: After login you should change the default password. To do so, go to Set up | Account
Set t ings | My Account and specify a new password in section User Account .
Note: If you are not logged in into the web interface, you can change the credentials for this
default user account any time in the PRTG Server Administrator 2010 Windows application.
If you have received user credentials from your administrator, please enter them here to login.
Also, when using other administrator credentials, please enter them here.
Depending on the used browser, different Graphical User Interface (GUI) options are shown:
§ Use AJAX Web GUI (All feat ures, opt imized for deskt op access): The standard interface.
We recommend to use this option for PRTG whenever possible. It offers the full functionality
of PRTG. Use Google Chrome 34 or later (recommended) or Mozilla Firefox 28 or later for
best performance. In some browsers, the Ajax option is not shown, for example, in old
browser versions.
· Note: Although you can login using Microsoft Internet Explorer 10 or 11, the Ajax web
interface might not be fully compatible with Internet Explorer! When using Microsoft
Internet Explorer 10 or 11, please set the security level at least to Default level Medium-
high and make sure you do not use the Compat ibilit y View! For detailed information,
please see More 104 section below.
28.05.2014 103
Part 5: Ajax Web Interface—Basic Procedures | 1 Login
§ Use Mobile Web GUI (Limit ed funct ionalit y , opt imized for mobile access): The Mobile
Web GUI 1947 interface is optimized for slow network connections and old browsers. It only
offers read-only functionality and comes with less scripting. It is also a fallback solution when
using a browser that is not supported by the Ajax interface.
§ Download Client Soft ware (for Windows, iOS, Android): This option calls PRTG's download
page in the Mobile Web GUI. You can optionally download the native Windows application
Ent erprise Console to the desktop (called Windows GUI in previous deprecated PRTG
versions). It has to be installed 1894 on the client computer before use. The Enterprise
Console 1894 provides full functionality; however, for some functions the Ajax Web GUI is
opened. As an additional feature, the Enterprise Console can view data of several
independent PRTG core installations in a single application.
You can also access pages on Paessler's website from here for information about the PRTG
apps 1950 PRTG for Android and iPRTG for iOS. These pages contain also the download links
for the apps for your mobile device. Note: Also when using this download option, login
name and password (or a Default Login) are required!
Note: Only Google Chrome 34 or later (recommended) and Mozilla Firefox 28 or later are fully
compatible with the Ajax web interface. For more information about Internet Explorer support,
please see More 104 section below.
More
Knowledge Base: Why are Internet Explorer IE6 and IE7 not supported by PRTG's Ajax Interface?
§ http://kb.paessler.com/en/topic/7633
Knowledge Base: How can I access the AJAX web interface of PRTG with Internet Explorer 9 or
IE10?
§ http://kb.paessler.com/en/topic/46893
104 28.05.2014
Part 5: Ajax Web Interface—Basic Procedures | 2 SSL Certificate Warning
Every browser shows the certificate warning in a different layout. The steps to take are similar
for every browser, yet different in detail:
§ Other 107
Google Chrome
In Google Chrome, click on Proceed any way every time you call the web interface.
Mozilla Firefox
In Mozilla Firefox, click on I Underst and t he Risks and then on the Add Except ion... button.
In the appearing window, leave the check mark for Permanent ly st ore t his except ion and
finally click on the Confirm Securit y Except ion button.
28.05.2014 105
Part 5: Ajax Web Interface—Basic Procedures | 2 SSL Certificate Warning
You only have to go through this procedure once for every Firefox browser and PRTG core
server.
Internet Explorer
In Int ernet Explorer, click on Cont inue t o t his websit e (not recommended) every time you
call the web interface.
106 28.05.2014
Part 5: Ajax Web Interface—Basic Procedures | 2 SSL Certificate Warning
Other
For other browsers, the procedures to confirm the certificate will be similar to the ones
described above.
More
§ Using Your Own SSL Cert ificat e 2076
Knowledge Base: Why don't I get an SSL connection to the PRTG web interface?
§ http://kb.paessler.com/en/topic/11813
28.05.2014 107
Part 5: Ajax Web Interface—Basic Procedures | 3 General Layout
Welcome Page
Once you have run through the Configurat ion Guru 36 , you will see PRTG's welcome page as
default after you log in to the web interface. You can set another homepage in your account
settings 1812 , section Web Int erface.
§ Get Help and Support : Opens the help center where you find links to this manual, to the
Knowledge Base, and the contact Paessler support form 1889 .
108 28.05.2014
Part 5: Ajax Web Interface—Basic Procedures | 3 General Layout
Click on the Review Result s option on the welcome screen to display the tree-like device
view which will be a starting point for everyday use or on Devices in the main menu bar.
28.05.2014 109
Part 5: Ajax Web Interface—Basic Procedures | 3 General Layout
1 Global Header This element contains the main menu at the top, the global
Area 111 status bar, the path to the currently selected object, and a
quick search box.
2 Page Header Bar This element contains the page heading with the name of the
113 current object, several tabs with settings, monitoring data, etc.
of the current object, the object's status bar, quick action
buttons, and the QR code linking to the current URL.
3 Device Tree This selection is part of the page header bar. Using the
View 115 provided options you can define how your device tree is
displayed.
4 Page Content 119 This element contains information about the current object and
all other objects underneath in the tree hierarchy.
5 Page Footer With these icons you have quick access to the PRTG Auto-
Icons Update page, to PRTG's social network accounts, and to the
contact support form 1889 . There is also a link to context
sensitive help.
When running PRTG in a cluster, you will also see a cluster
related element. It shows the name of the node you are logged
in and displays whether this is a master or a failover node. Click
the bar to show the Clust er St at us 1883 . In a failover node, you
can review all data, but changes in the settings will not be
saved. In order to change settings, please log into the master
node of your cluster.
6 Page Footer Shows information about the current version of PRTG, the
logged in user, the time remaining to the next automatic page
refresh, and the current time.
Simply click on an object to see more details about it. In the page heading of the page header
bar 113 you always see which object you're looking at.
When you navigate through PRTG's web interface you will always use one of the following
navigational paths:
§ The main menu provides access to all important aspects of the software.
§ The quick search is often the fastest way to navigate to an object.
§ Using the page's tabs, you can switch between various sub-pages for an object.
§ Many objects offer a context menu that will pop up when you right-click them.
§ Many objects offer a quick-info menu that will pop up when hovering an object
110 28.05.2014
Part 5: Ajax Web Interface—Basic Procedures | 3 General Layout
§ And, finally, you are able to drill down into the object hierarchy of probes, groups, devices,
and sensors in the object tree by merely clicking an sub-object of the currently displayed
object (for example, a sensor on the device page).
These six navigation paths put PRTG's complete functionality at your fingertips. Quite likely you
are already familiar with these techniques from many other websites and web-based user
interfaces.
In the following, the different areas of the web interface are described.
The header area of the web interface is both base for the most important information of your
installation and starting point for all actions. You can view the global status and navigate
through the web interface using the main menu.
Note: This documentation refers to the PRTG Sy st em Administ rat or user accessing the Ajax
interface on a master node. For other user accounts, interfaces, or nodes, not all of the
options might be available as described. When using a cluster installation, failover nodes are
read-only by default.
28.05.2014 111
Part 5: Ajax Web Interface—Basic Procedures | 3 General Layout
1 Main Menu Bar Navigating through the web interface is performed using the
main menu. Please take a few minutes to familiarize yourself
with all menu items and sub-items. A detailed description can be
found in the Main Menu St ruct ure 175 section.
2 Icons Refresh, With the icons on the right you can reload the current page,
Help Center, open the help center or log the current user out.
Logout
3 White Search To search for any monitoring object, enter the name, part of
Box the name, an IP address, a DNS name or a tag in the search box
on the right and hit the enter key. A web page with all items
that fit the search term will be returned—even displaying online
help articles.
4 'Breadcrumbs' Below the main menu, there is always a path shown, leading to
the homepage. Use it to go back to where you came from. It
can also help you to orient yourself in case you get lost. If you
click on a 'breadcrumb' item to open a drop-down menu
showing all available object on the same level. Enter a view
letters to search for a name, or select an object directly. For
example, you can use this to directly access all other sensors
or a device, the other devices within a group, another group on
the same probe, or other probes in your root group.
5 Buttons New These buttons show the number of new alarms and new log
Alarms, New Log entries, as well as the number of new tickets. Click on the
Entries, New respective button to view the Alarms 144 , Logs 147 , or Ticket s
Tickets 149 .
6 Global Sensor This area shows the aggregated status of all sensors you have
Status Symbols configured for monitoring, divided into different sensor states.
Depending on the sensors' status you will see colored boxes
with numbers which symbolize the sensors. For example, you
can see how many sensors are in Up, Down, or Warning state.
Click on a box to view a list of all sensors in the respective
status. For a detailed description, please see Sensor St at es 121
section.
112 28.05.2014
Part 5: Ajax Web Interface—Basic Procedures | 3 General Layout
In the page header under the global header area, you see the name of the current object and
the page content underneath. When displaying a group, aggregated sensor states are shown
in a sensor bar and there is an option to change the tree view. Furthermore, various
information about the current object is reported here.
Note: This documentation refers to the PRTG Sy st em Administ rat or user accessing the Ajax
interface on a master node. For other user accounts, interfaces, or nodes, not all of the
options might be available as described. When using a cluster installation, failover nodes are
read-only by default.
The page header and tabs area consists of the following parts:
28.05.2014 113
Part 5: Ajax Web Interface—Basic Procedures | 3 General Layout
1 Page Heading This line displays the kind of the current object and the name
as page heading. In the screenshot above, it is a group which is
called Root . Here you also can add the current object to
favorites by clicking on the flag, as well as you can define the
object's priority by clicking on one of the five stars (not
available for the Root group). For details, please see section
Priorit y and Favorit es 160 .
3 Context Buttons On the right side are icons which allow you to perform several
actions. Depending on the currently viewed page within PRTG,
you can pause (and resume) or delete this object, add another
object (for example, a sensor to a device), send a link to the
current page per email, perform an immediate scan, open a
related ticket, and show the corresponding object history page
147 . By clicking on the down arrow, you can open the context
4 Object Status This element indicates the current status of the selected
object.
5 Sensor Status This element is visible when viewing a probe, a group (including
Bar Root ), or a device. It is not available when viewing a sensor's
details. The sensor status bar shows the aggregated status of
all sensors for the current object, divided into different sensor
states. They show the number of sensors in the respective
state. For example, you can see how many sensors are in Up,
Down, or Warning state. For a detailed description of sensor
states, please see Sensor St at es 121 section. You can hide
sensors that are in a certain state by removing the check mark
symbol in front of the respective sensor symbol. To show them
again, re-add the check mark.
6 Tree Search In the white search box next to the tree view selection, enter a
key word to search the device tree for matching names. The
tree will then highlight matching devices and sensors by graying
out all others. This can help to gain a quick overview over
sensors monitoring a specific part of your network. For
example, you can enter the keyword "firewall" to highlight
devices and sensors which match this name.
7 Device Tree This element is only visible when viewing a probe or a group. It
View is not available when viewing a device's or sensor's details. For
114 a detailed description, see Switch Device Tree View 115 28.05.2014
below.
8 Scanning This element shows in what time interval PRTG scans the
Interval current object.
Part 5: Ajax Web Interface—Basic Procedures | 3 General Layout
When viewing a probe or group, you can choose the way your device tree is shown.
Using the different circle symbols in the page header bar, you can define how much space is
used to show devices and sensors in a hierarchical tree structure. In four steps, you can
switch from a very condensed view (small circle; marked with 1 in the screenshot) up to an
extra large view (big circle; marked with 4 in the screenshot).
In the classic device tree view you can collapse devices, groups, and probes. Click on the
minus box left to the object's name. The sensor states will be summarized then. Each status of
the sensors on this object will be displayed with the number of sensors currently being in this
status—with the exception of the states Down, Down (Part ial), and Down (Acknowledged).
These will be summarized respectively not before there are more than ten sensors in this
status, otherwise they are displayed individually.
Collapsed Dev ic e With Summarized Ups and Unusuals and Indiv idual Downs
There are two additional options to the simple tree views which enable you to display the
status of all sensors of your entire installation in a single overview. Click on one of the icons
to change the view:
28.05.2014 115
Part 5: Ajax Web Interface—Basic Procedures | 3 General Layout
116 28.05.2014
Part 5: Ajax Web Interface—Basic Procedures | 3 General Layout
§ Colors
A device (or group) element can have different colors, depending on the states of the
sensors running on this device or group (see Sensor St at es 121 ) 121 . A more severe status is
regarded more important and wins the color battle. For example, if a device currently has
sensors in the states Up (green), Paused (blue), and Warning (yellow), the according device
tile in this view would be yellow, indicating that at least one sensor on this device is in
Warning status. If there are any red Down sensors, the according device tile will turn red.
Following, all possible states in both views are listed ordered by their hierarchy:
28.05.2014 117
Part 5: Ajax Web Interface—Basic Procedures | 3 General Layout
118 28.05.2014
Part 5: Ajax Web Interface—Basic Procedures | 3 General Layout
Page Content
The page content of the general layout varies dependent on the selected object. It shows
information about the current object and all other objects underneath in the tree hierarchy.
The deeper down in the hierarchy you select an object, the more detailed is the displayed
information.
By default, a Probe Device is created in the device tree on the local probe. It represents the
probe system running with your PRTG installation. PRTG automatically monitors the system
health of the core server and each probe in order to discover overloading situations that may
distort monitoring results. To monitor the system status of the probe computer, PRTG
automatically creates a few sensors. These include a Core/Probe Healt h Sensor, a WMI
sensor that measures disk usage, and a bandwidth sensor for all installed network cards. It is
recommended to keep these sensors, but you can optionally remove all except the Core/
Probe Healt h sensor. In a cluster installation, PRTG also creates a Clust er Probe Device with
a Clust er Probe Healt h Sensor 355 that monitors the cluster's system health.
You can add (or remove) a device or sensor to favorites by one click on the respective flag
displayed with an object (please see the marks in the screenshot below).
Another one-click option for adding/removing favorites or setting the priority for a selected
device or sensor is given in the page header bar 113 right to the object name (please see
screen number 1 in that subsection). Simply click on the flag for favorites or on a star for
priority.
A black flag means that the respective object is a favorite already; clicking on the black flag will
remove the object from favorites. A gray flag indicates that it is not a favorite yet. Please see
also Priorit y and Favorit es 160 for this concern.
For more details about page contents, please see the following sections:
28.05.2014 119
Part 5: Ajax Web Interface—Basic Procedures | 3 General Layout
More
Knowledge Base: How can I change the width of the devices and group "boxes" shown in the
PRTG 9 device tree?
§ http://kb.paessler.com/en/topic/24963
120 28.05.2014
Part 5: Ajax Web Interface—Basic Procedures | 4 Sensor States
The color of a sensor always shows its current status. Following, you find a list of states a
sensor can show. This list also reflects the hierarchy of states whenever summarized sensor
states are shown (in the device tree 109 , or on geo maps 1744 ) : the higher a status is in the
hierarchy, the higher will be its priority in displaying sensor states. For example, if all the
sensors of a specific device are Up, but one of its sensors reached a Down status, then the
overall status of this device will be Down as well (for example, displayed red in the Tree Map
View 115 ), as this state is hierarchically higher. Note: Down and Down (Part ial) states are
hierarchically equal.
Red/Green Down (Part ial) In a cluster, at least one node reports this
sensor as Down, while at least one other node
reports the same sensor as Up.
28.05.2014 121
Part 5: Ajax Web Interface—Basic Procedures | 4 Sensor States
Black Unknown The sensor has not been checked yet by PRTG
(Gray) or there is an error in (network) communication,
likely on the probe system. If sensors show this
status persistently, a PRTG restart may be
necessary. For extended trouble shooting
please see More 123 section below.
The Down status symbolizes that something is wrong with a monitored device. There can be
various reasons for a down status, for example, an interruption in the physical connection to
the device, an internet connection outage, or a crashed server.
After a failed request, PRTG tries to reach the device again before setting a sensor to Down
status (this is true for almost all types of sensors):
1. If a request to a device fails for the first time, the sensor is set to Warning status. PRTG
repeats the request and tries to re-scan the device immediately.
2. If also the second request fails, the sensor is set to Down status until the device is
reachable again. PRTG tries to reach the device with every scanning interval.
This procedure gives devices and services the chance to recover from a momentary overload
and prevents false alarms. Still, you are informed promptly about any failures occurring.
122 28.05.2014
Part 5: Ajax Web Interface—Basic Procedures | 4 Sensor States
Note: The behavior described above does not apply to a Warning or Down status that is
activated due to a warning or error limit set in the Sensor Channels Set t ings 1709 .
More
Knowledge Base: What to check if sensors are black (gray)?
§ http://kb.paessler.com/en/topic/25643
28.05.2014 123
Part 5: Ajax Web Interface—Basic Procedures | 5 Review Monitoring Data
Overview
The Overview tab shows an overview of the currently selected object and of its sensors. The
pages share a common layout, but include different elements, depending on the kind of object
you look at:
§ For probes and groups, the Overview tab shows a tree-like view with devices and sensors,
a GeoMap, as well as summary graphs for different time spans of the current probe or group.
§ For devices, the Overview tab shows device details, a GeoMap, and summary graphs for
different time spans, colored gauges for high priority sensors, as well as a table list of all
sensors on this device.
Note: In order to display gauges which represent sensor states, corresponding sensors
need to be tagged with 4 stars (****) or 5 stars (*****) in the priority settings 160 . 5 stars
sensors will be represented with bigger gauges than 4 stars sensors.
§ For sensors, the Overview tab shows sensor details, current status, a GeoMap, colored
gauges which represent the last value of particular sensor channels (the primary channel in
biggest size; not available for the Downt ime channel), sensor graphs for different time
spans, a table with all sensor channels, as well as similar sensors 138 which show correlations
in your network.
Note: For sensors using lookups 2039 , we recommend staying below 120 lookup values in the
primary channel to get expressive gauges. For sensors with a priority of 4 stars, the upper limit
is around 40 lookup values.
124 28.05.2014
Part 5: Ajax Web Interface—Basic Procedures | 5 Review Monitoring Data
Dev ic e Ov erv iew Tab with Gauges for High Priority Sensors, Sensors Table List, Geo Map,
and Mini Graphs
Toplists
Toplist s are available for xFlow and Packet Sniffer sensors 291 only. Toplist graphs are
displayed right on the sensor overview page. Please see section Toplist s 1728 .
Select one of the tabs Live Dat a (available for sensors only), 2 day s, 30 day s, or 365 day s to
display an object's monitoring data live (sensors only), or for different time spans and in more
or less detail. Note: The days mentioned here are the default setting. You can change the
detail of the different graphs any time in the system administration 1835 .
28.05.2014 125
Part 5: Ajax Web Interface—Basic Procedures | 5 Review Monitoring Data
2 Day s Tab of a Firewall with Ov erv iew Graph and Sensor Mini Graphs
For probes, groups, and devices, each of the tabs shows a summary graph for the current
object and mini graphs for all sensors on this object, as well as a data table for the current
object. There are never more than 50 mini graphs displayed for performance reasons. Hover a
mini graph to see the graph legend.
The summary graph shows the number of alarms as well as three index graphs. These graphs
indicate response time, CPU usage, and bandwidth usage for all sensors. Index graphs are
similar to a stock index. The shown values are based on the readings of all sensors of this
object. PRTG computes these values using statistics and by comparing the values to the
highest and lowest readings ever recorded.
The three index graphs shows overall (or global) trends in your network. If these values
increase during a specific time frame, then CPU load, bandwidth load, or response time
respectively have worsened during this time. For example, a CPU Load Index value of 90%
means that the average CPU load for all CPU sensors of your current configuration is at 90% of
the highest ever measured CPU usage value.
126 28.05.2014
Part 5: Ajax Web Interface—Basic Procedures | 5 Review Monitoring Data
§ Alarms: Sums up the number of all down states of sensors on this object during the given
time span. This graph provides you a bird's eye view of trouble in your network. It cannot be
hided.
§ Response Time Index: Indicates request times in your network.
§ CPU Load Index: Indicates the CPU usage in your network.
§ Traffic Index: Indicates the bandwidth usage in your network.
See section More 129 for a detailed description of the index graphs.
You can hide single channels individually except the "Alarms" channel. Simply remove the check
mark symbol in front of a channel name besides the graph, and the according channel's line will
disappear. You can also Show all or Hide all channels by clicking on the buttons underneath
the channel names. The graph view will be reset immediately.
28.05.2014 127
Part 5: Ajax Web Interface—Basic Procedures | 5 Review Monitoring Data
For sensors, the tabs show a graph and data table of the selected sensor. When viewing data
of a sensor running on a cluster probe, you can additionally select if you want to show the
data of all nodes, or of one specific node only. Please use the Select Clust er Member bar
below the tabs. Note: Multi-node graphs are never displayed filled here, but with single lines
only. However, historic data reports can have filled multi-node graphs.
While viewing a sensor graph you can hide single sensor channels individually. Simply remove
the check mark symbol in front of a channel name underneath the graph, and the according
channel's line will disappear. You can also Show all or Hide all channels by clicking on the
buttons besides the channel names. The graph view will be reset immediately.
In the upper right corner of every graph, you will find three small icons. Using them, you can do
the following:
§ Zoom graph in new window: This will open a larger version of the graph in a new browser
window.
§ Download t he graph (PNG or SVG): This will show a PNG or SVG file of the graph in a new
browser window. You can then save or copy it for later use.
Historic Data
The Hist oric Dat a tab is available for sensors only. Please see section Hist oric Dat a Report s
133 .
Sensors Lists
Viewing lists of sensors is a great way to keep an eye on your network's status, as you can
select which kind of sensors you would like to see. There are many different sensor list views
available, such as a list of favorite sensors and top 10 lists; lists filtered by current sensor
status, value, availability, tag, or type; there is a sensor cross reference, and many more.
Sensor lists are available from the main menu bar. Click the Sensors entry to show a table list
of all sensors. In the table list 156 appearing, you can re-sort the items by clicking on the
column's header items. Hover to show other menu options. For detailed information about the
available options, please see Main Menu St ruct ure 178 (Sensors) section.
Alarms
The Alarms tab is not available for sensors, but for probes, groups, and devices only. Please
see section Alarms 144 .
Log
The logs tab shows past activities and events regarding the currently selected object. Please
see section Logs 147 .
128 28.05.2014
Part 5: Ajax Web Interface—Basic Procedures | 5 Review Monitoring Data
Related Topics
More
Knowledge Base: How does PRTG compute CPU Index, Traffic Index and Response Time Index?
§ http://kb.paessler.com/en/topic/313
28.05.2014 129
Part 5: Ajax Web Interface—Basic Procedures | 6 Compare Sensors
To open the page to compare graphs of several monitoring objects, from the main menu,
choose Sensors | Compare Sensors. Select how many sensors you want to compare.
Once you have chosen the number of sensors that will be compared, an assistant will open
where you can define your desired sensors and the time span shown in the graphs.
130 14.01.2014
Part 5: Ajax Web Interface—Basic Procedures | 6 Compare Sensors
Opt ions
Time Span Specify the time span for which you want to show the graphs for.
Choose between:
§ 2 day s
§ 30 day s
§ 365 day s
Dat a Comparison
Select the objects you want to show a graph for. Click on Please click here t o edit ! to open
the Object Select or 159 . There will appear as many selection screens as you have defined
before.
14.01.2014 131
Part 5: Ajax Web Interface—Basic Procedures | 6 Compare Sensors
Related Topics
If you want to create a sensor that combines the data of different other sensors, please see
the following sensor type:
§ Sensor Fact ory Sensor 856
132 14.01.2014
Part 5: Ajax Web Interface—Basic Procedures | 7 Historic Data Reports
There are two possibilities to call the function for historic data reports: Either you click on the
Hist oric Dat a tab on a sensor's detail page, or you choose Sensors | View Hist oric Dat a
from the main menu 178 .
The Hist oric Dat a tab is available for sensors only (not for probes, groups, or devices). When
calling the historic data reports via this tab, there is no sensor selection available, because you
have already determined which sensor you would like to create a report for.
14.01.2014 133
Part 5: Ajax Web Interface—Basic Procedures | 7 Historic Data Reports
When calling the historic data reports via the View Hist oric Dat a entry from the Sensors entry
in the main menu, an additional option is available, enabling you to choose the sensor you
want to create a report for.
134 14.01.2014
Part 5: Ajax Web Interface—Basic Procedures | 7 Historic Data Reports
Set t ings
Sensor This field is only visible if you called this function via the main menu.
Select the sensor you would like to create the report for: Click on
the reading-glass symbol to open the object selector. For more
information, please see section Object Select or 159 .
Start Specify the start date and time of the data you want to review. Use
the date time picker to enter the date and time.
End Specify the end date and time of the data you want to review. Use
the date time picker to enter the date and time.
Quick Range In this section several links are provided for a faster selection of
start and end date. Click on any of these links to change the St art
and End values above. Choose between:
§ 1 Day , 2 Day s, 7 Day s, or 14 Day s: Set the date range to the
respective day(s). The current time of today will be the end date.
14.01.2014 135
Part 5: Ajax Web Interface—Basic Procedures | 7 Historic Data Reports
Set t ings
§ Today , Yest erday , Last Week (Mo-Su), Last Week (Su-Sa), Last
Mont h, 2 Mont hs, 6 Mont hs, 12 Mont hs: Set the date range to
the last matching period, starting 00:00, ending 00:00 of the
particularly following day.
Average Interval With this option, you can activate and set up averaging. Select an
interval for which the average value should be calculated. You can
choose between No Int erval (no averaging will be performed and
only raw data displayed), a few seconds, minutes, hours, or a whole
day (24 Hours). A smaller interval will result in a more detailed
report for this sensor. The best settings for you vary, depending
on the scanning interval of the sensor, the selected date period
and, of course, the intended use for the report. It might be useful
to try different settings to see what the results look like. Please
also see the section Aut omat ic Averaging 137 below.
Cluster Node This field is only visible if the sensor is running on a cluster probe.
Select the cluster node's data that will be used for the report.
Choose between:
§ All nodes: Include the data of all cluster nodes in the report.
§ [Several specific nodes]: Use a specific node's data for the report.
The nodes shown are specific to your setup.
File Format Select the output format for the report. Choose between:
§ HTML web page: Display the result directly as HTML web page.
This is also a good option to check results before exporting to
another file format.
§ X ML file: Export the data as Extensible Markup Language (XML)
file. Usually, you browser will show a download dialog.
§ CSV file: Export the data as Comma Seperated Values (CSV) file,
for example, for import into Microsoft Excel. Usually, you browser
will show a download dialog.
Percentile Results Select if percentiles will be shown in the report. Choose between:
§ Off: No percentiles will be calculated.
§ On: Percentiles will be enabled in the report. In the overview
table, additional values will be displayed with averages/sums for
each sensor channel. Please define additional settings below.
For more information about percentiles, please see section
Calculat ing Percent iles 2078 .
136 14.01.2014
Part 5: Ajax Web Interface—Basic Procedures | 7 Historic Data Reports
Percentile This field is only visible if percentile results are enabled above.
Enter which percentile you would like to calculate. Please enter an
integer value.
Percentile Average This field is only visible if percentile results are enabled above.
Enter the averaging interval in seconds that will be used for
percentile calculation. Please enter an integer value.
Percentile Mode This field is only visible if percentile results are enabled above.
Choose between:
§ Discret e: Chooses the next smaller discrete value.
§ Cont inuous: Interpolates between discrete values.
Click on St art to start the generation of a historic data report. Note: Data reporting is limited
to 5 requests per minute.
Automatic Averaging
For performance reasons, PRTG automatically averages monitoring data when calculating data
for large time spans. Data is then averaged regardless of the selected average interval.
Time Span in Report Minimum Level of Det ail (Average Int erval)
Up to 40 days Any
A report for a time span of more than 500 days is not possible. If you try to set a larger time
span, it will be reduced to 365 days automatically.
Related Topics
§ Review Monit oring Dat a 124
§ Report s 1775
14.01.2014 137
Part 5: Ajax Web Interface—Basic Procedures | 8 Similar Sensors
You can adjust the depth of similar sensors analysis in Sy st em Administ rat ion—Monit oring
1840 . You can toggle on/off similarity analysis on group basis in the settings of an object
§ Each sensor's overview page contains a similar sensors section. PRTG lists channels there
which show similarities to channels of the current sensor.
§ In addition, you can call a similar sensors overview page via Sensors | Similar Sensors
Overview from the main menu 178 .
On the overview tab of a sensor, PRTG lists channels which show similarities to channels of the
currently selected sensor. The table will be empty if PRTG detects no similarities regarding the
selected sensor.
Note: PRTG will only show similar sensors here when channels have at least 85% similarity.
Furthermore, the analysis saves up to 15 entries per sensor at most.
138 12.05.2014
Part 5: Ajax Web Interface—Basic Procedures | 8 Similar Sensors
Similar Sensors
Note: The similar sensors section will not be shown when the analysis is turned off or you
have exceeded 1,000 sensor and selected the automatic analysis depth option.
12.05.2014 139
Part 5: Ajax Web Interface—Basic Procedures | 8 Similar Sensors
This page shows the results of the similar sensors analysis from the entire monitoring
database. PRTG will list all channels with similarities to another one here. On the table top, you
have several filter options to display similar sensors as you need it. Choose the object of
interest, the degree of similarity, and if you want to display back references. For more details,
see also section Working wit h Table List s 156 .
Note: PRTG will only show similar sensors here when channels have at least 85% similarity.
Furthermore, the analysis saves up to 15 entries per sensor at most.
You can sort the list by clicking on the column headers. The similar sensors overview page
provides the following information:
Original Channel Shows channels to which other channels are compared. Clicking
on the column header sorts the list according to the order on the
device tree in ascending or descending order.
140 12.05.2014
Part 5: Ajax Web Interface—Basic Procedures | 8 Similar Sensors
Similar Channel Shows a channel compared to the original channel. Clicking on the
column header sorts the list according to the order on the device
tree in ascending or descending order.
Item Count Define how many channel similarities are shown on this page.
Choose between 50, 100, or 500.
Note: The similar sensors overview option will not be shown in the main menu when the
analysis is turned off or you have exceeded 1,000 sensor and selected the automatic analysis
depth option.
12.05.2014 141
Part 5: Ajax Web Interface—Basic Procedures | 9 Object Settings
The Management tab is available when viewing probes or groups. After clicking this tab you
can move devices and sensors right within the tree view. If moving is not possible, the web
interface will start a clone process automatically.
For more information, please see Manage Device Tree 222 section.
General Settings
In the Set t ings tab you can define all settings of the current object. The available options vary,
depending on the kind of object you're changing. Please see the following sections for
information about the respective object types:
Note: The available setting options are different for each sensor, but always the same for
probes, groups, and devices. Sensor Channels Set t ings 1709 are not reachable via tab but
directly on a sensor's overview page via channel gauges and the channels table.
Notifications Settings
In the Not ificat ions tab, notification triggers can be set for every object. When using these
settings for a probe, group, or device, they will be inherited to all sensors on these objects.
Available notification trigger options are the same for all objects.
For more information, please see Sensor Not ificat ions Set t ings 1716 section.
Comments
In the Comment s tab you can enter free text for each object. This can be used for
documentation purposes or to leave information for other users.
142 28.05.2014
Part 5: Ajax Web Interface—Basic Procedures | 9 Object Settings
History
In the Hist ory tab all changes in the settings of an object are logged with a timestamp, the
PRTG user which conducted the change, and a message. The history log keeps the last 100
entries.
Note: On some pages, you can access the history of subordinate objects via the according
context button in the page header bar 113 . This includes Sy st em Administ rat ion 1831 and the
overview pages of User Account s 1856 , User Groups 1861 , Report s 1775 , Libraries 1759 , and Maps
1794 . See section Logs (Main Menu) 147 for details.
Related Topics
§ General Lay out 108
§ Toplist s 1728
28.05.2014 143
Part 5: Ajax Web Interface—Basic Procedures | 10 Alarms
5.10 Alarms
The Alarm list shows all sensors that are currently in a Down, Down (Part ial), Down
(Acknowledged), Warning, or Unusual status. Sensors in other states (for example, Up,
Paused, or Unknown) do not appear here. This is useful to keep track of all irregularities in
your network.
In the table list, you can re-sort the items by clicking on the column's header items.
Alarms List
There are two possibilities to call the alarms list: Either you click on the Alarms tab on the
detail page of a probe, group, or device (not available for sensors), or you choose the Alarms
entry in the main menu.
On an object's detail view, click on the Alarms tab to show a table list of all sensors on this
object that currently show a Down, Down (Part ial), Warning, or Unusual status. You will see a
subset of sensors in an alarm state for the current object only. This is a subset of the entries
available via the Alarms | All option in main menu 181 . The tab is not available on a sensor's
detail page.
144 28.05.2014
Part 5: Ajax Web Interface—Basic Procedures | 10 Alarms
Click the Alarms entry from the main menu 181 to show a table list of all sensors in your
configuration that currently show a Down, Down (Part ial), Down (Acknowledged), Warning,
or Unusual status. You can also show these sensors as gauges. Hover the Alarms entry and
select another option to only show a subset of sensors in certain states. Choose between:
§ All
Shows a list of all sensors which currently show a Down, Down (Part ial), Down
(Acknowledged), Warning, or Unusual status.
§ Show as Gauges
Shows the gauges of all sensors which currently show a Down, Down (Part ial), Down
(Acknowledged), Warning, or Unusual status. The size of the sensor gauges corresponds
to their respective priority.
§ Errors Only
Shows a list of all sensors which currently show a Down, Down (Part ial), or Down
(Acknowledged) status.
§ Warnings Only
Shows a list of all sensors which currently show a Warning status.
§ Unusuals Only
Shows a list of all sensors which currently show an Unusual status.
Acknowledge Alarm
An acknowledged alarm will show up in the alarms list as "acknowledged" (see Sensor St at es
121 ) and will not trigger 1716 any more notifications 1749 . Note: If the alarm condition clears, the
sensor will usually return into an Up status immediately with the next sensor scan.
Selected Objects Shows the sensor(s) for which you want to acknowledge the
alarm. You can acknowledge alarms for more than one sensor
using multi-edit 1736 .
Message Enter a text, for example, the reason why you acknowledge the
alarm.
28.05.2014 145
Part 5: Ajax Web Interface—Basic Procedures | 10 Alarms
Until Enter the date when the acknowledge status will end. Use the date
time picker to enter the date and time. Note: If the alarm condition
still persists after the specified date, the sensor will show a Down
status again.
Only users 1856 with write access rights may acknowledge alarms. Read-only users can be given
the right to acknowledge alarms, too. See section User Account s Set t ings 1856 , section
Account Cont rol.
More
Knowledge Base: Which audible notifications are available in PRTG? Can I change the default
sound?
§ http://kb.paessler.com/en/topic/26303
146 28.05.2014
Part 5: Ajax Web Interface—Basic Procedures | 11 Logs
5.11 Logs
The Logs list shows all past activities and events of your PRTG monitoring setup. This is useful
to keep track of all important activities and, for example, to check whether messages were
sent, etc. In a typical setup, a huge amount of data is produced here. As the activity of every
single object is minuted, you can use this data to check exactly if your setup works as
expected.
To support you when viewing the log files, there are several filters available. Please see
Working wit h Table List s 156 section for more information.
There are two possibilities to call the logs list: Either you click on the Log tab on the detail
page of a probe, group, device, or sensor, or you choose the Logs entry in the main menu.
On an object's detail view, click on the Log tab to show a table list with all log information on
this object. This is a more detailed log than the system log available via the Logs | All option in
main menu 183 .
Click the Logs entry from the main menu 183 to show a table list of all system log entries in
your configuration. Hover the Logs entry and select another option to only show a subset of
entries for certain objects for certain kind of entries. Choose between:
§ All
Show log information for all objects in your configuration, newest first.
14.01.2014 147
Part 5: Ajax Web Interface—Basic Procedures | 11 Logs
§ By Group ›
Show log information for objects in a certain group only, newest first. Hover to show other
menu items. Select All, or follow the menu path (it is specific to your setup) to select a
group you would like to show log information for.
§ St at us Changes ›
Show log information for certain status changes only. Hover to show other menu items.
Follow the menu path to view log entries with a special value in the St at us field only. Select
between Up & Down (shows entries with either Up or Down in the St at us field), Down,
Warning, Unusual, Up, Paused/Resumed (shows entries with either Paused or Resumed in
the St at us field), or Acknowledged Alarms.
§ Sy st em Event s ›
Show log information regarding certain system event types only. Hover to show other menu
items. Select between the following event types: Probe Relat ed, Clust er Relat ed, Aut o-
Discovery , Not ificat ions, or St at us Messages.
§ Object Hist ory
Shows information about changes to the PRTG setup and lists deletions of subordinate
system objects. The object history page has a tab-like interface. Using the tabs you can
navigate through various sub-pages in order to view the changes to all related settings and
deletions of objects. Select between the following tabs: My Account , Sy st em Set up,
Not ificat ions, Schedules, User Account s, User Groups, Report s, Libraries, or Maps.
Note: You can open a specific tab directly with the context button Hist ory in the page
header bar 113 on the corresponding pages.
148 14.01.2014
Part 5: Ajax Web Interface—Basic Procedures | 12 Tickets
5.12 Tickets
PRTG Network Monitor includes its own ticket system. With tickets you can manage and
maintain various issues which may appear while monitoring a network. A ticket in PRTG
contains information about recent events in your PRTG installation which need a closer look by
the administrator or another responsible person. You can see each ticket as a task for a
particular PRTG user.
Each monitoring related task has a lifecycle in the ticket system. PRTG itself can create tickets,
for example, when Aut o-Discovery 190 has finished, as well as PRTG users can create tickets
for every kind of issue. In addition, you can set up notifications which open a ticket when
something uncommon occurs in your network. The task gets alive when a ticket is created.
Responsible PRTG users then take care of this issue. Once the issue has been resolved, the
ticket can be closed and the lifecycle of the task ends.
Every ticket has a unique ID, a priority, and a status, and you can take several actions on each
ticket. You should view every ticket and conduct a corresponding action. This way, you always
keep an overview about each task and its history in your PRTG installation.
PRTG can also send an email to you whenever there is a ticket assigned to you or one of your
tickets has been changed. See section Ticket s as Emails 153 for details and how to turn off
emails about tickets.
28.05.2014 149
Part 5: Ajax Web Interface—Basic Procedures | 12 Tickets
Note: You can turn off the tickets system for particular user groups in Sy st em Administ rat ion
—User Groups 1861 except for the PRTG Administrators group. The users in the admin group will
not receive new ToDo tickets (and notifications about changes) by default but only the PRTG
System Administrator user. You cannot change this behavior. However, you can turn off ticket
emails 153 for every user account.
Types of Tickets
§ New devices or sensors have been created by the auto-discovery process. Note: In the
corresponding ticket, only device templates will be listed through which PRTG created
sensors.
§ A new probe connects to the core and must be acknowledged.
§ A new cluster node connects to the cluster and must be acknowledged.
§ A new version of the software is available.
§ A new report is ready for review.
§ In a few other situations, such as when the system runs out of disk space, for licensing
issues, when an error occurred, etc.
§ A notification 1749 opened a ticket if set in the notification settings.
§ A user opened a ticket.
§ User Ticket s: Tickets created by PRTG users, for example, to assign monitoring related tasks
to a particular PRTG user (or user group)
§ ToDo Ticket s: Tickets created by PRTG to show important system information and in case of
specific system events. They are assigned to the PRTG System Administrator user and cannot
be turned off.
Note: The Relat ed Object of ToDo tickets is Sy st em.
§ Not ificat ion Ticket s: Tickets created via Not ificat ions 1749 in case of monitoring alerts
States of Tickets
Tickets can have three different states depending on the working process regarding the
corresponding issue:
§ Open: New tickets will be open as long as the corresponding issue exists as described in
the ticket.
§ Resolved: The issue as described in the ticket does not persist any longer. Someone took
care of it.
§ Closed: Usually, the ticket has been resolved before, the solution to the issue has been
checked for correctness, and the ticket does not require any other action.
150 28.05.2014
Part 5: Ajax Web Interface—Basic Procedures | 12 Tickets
Note: This option is only shown in the main menu bar if the user group of the current user is
allowed to use the ticket system. You can turn off tickets for particular user groups in Sy st em
Administ rat ion—User Groups 1861 . Users with read-only rights are always excluded from the
ticket system and cannot see the tickets entry in the main menu bar.
You have several options to display a list of tickets which is filtered to your needs. In the main
menu bar 175 , hover on Ticket s to show all available filter options or click directly to show all
tickets assigned to the current user. You can also create a new ticket via the main menu.
Available options are:
§ My Ticket s
Click to show all open tickets which are assigned to the current user. Hover to show other
menu items for filtering these tickets depending on their status:
§ Open
§ Resolved
§ Closed
§ All
§ All Ticket s
Click to show all open tickets of all PRTG users. Hover to show other menu items for filtering
these tickets depending on their status:
§ Open
§ Resolved
§ Closed
§ All
§ ToDo Ticket s
Click to show all open tickets from the type 150 ToDo. Hover to show other menu items for
filtering these tickets depending on their status:
§ Open
Click to show all open ToDo tickets. Hover to show other menu items for filtering these
tickets depending on their event type:
§ Report Relat ed
§ Aut o-Discovery Relat ed
§ Probe Relat ed
§ Sy st em Errors
§ New Soft ware Version
§ Resolved
§ Closed
28.05.2014 151
Part 5: Ajax Web Interface—Basic Procedures | 12 Tickets
§ All
§ Open Ticket
This will open the New Ticket dialog. In the first step, select the object on which you want
to focus in the ticket via the Object Select or 159 . Click on Cont inue. Note: You can leave
this step out when using the context menu 163 of this object in the device tree to open the
ticket.
In step 2, provide the following information and confirm by clicking on Save to create a User
Ticket:
§ Subject : Enter a meaningful title for the ticket which indicates the topic of the issue.
§ Assigned t o: Select a user (or user group) who will be responsible for this issue from the
drop down list.
§ Priorit y : Define a priority 160 from one to five stars.
§ Comment s: Enter a text message. This message should describe the issue in detail.
After selecting the desired filter or opening a new user ticket, a corresponding list of tickets
will appear. In this table list, you can re-sort the items by using the respective options 156 .
Additionally, you have several search options using the inline filter directly above the table. The
following filters are available:
Click on the subject of a ticket to open the ticket's detail page. There you can find all related
information, as well as you can conduct several actions.
152 28.05.2014
Part 5: Ajax Web Interface—Basic Procedures | 12 Tickets
Actions
For best experience with PRTG, check every ticket and select appropriate actions. Note: Only
members of user groups which have the corresponding access rights 94 can view and edit to
tickets which are related to a certain monitoring object.
The following actions are available when viewing the tickets list or a specific ticket:
§ Edit : Opens a dialog where you can change the subject and the priority of the ticket, as well
as you can assign the ticket to another user. Furthermore, you can add a text message to
this ticket. Confirm your changes by clicking on Save.
§ Assign: Opens a dialog in which you can give the ticket to another user. Select a user (or
user group) via the drop down menu. Furthermore, you can add a text message to this
ticket. Confirm your assignment by clicking on Save.
§ Resolve: Opens a dialog where you can resolve the ticket by clicking on Save. The status
resolved indicates that the issue as described in this ticket does not persist. Furthermore,
you can add a text message to this ticket which indicates, for example, what has been done
concerning the issue.
§ Close: Opens a dialog where you can close the ticket by clicking on Save. Usually, this ticket
has been resolved before and the correct solution of the issue has been checked.
Furthermore, you can add a text message to this ticket.
§ Reopen: Opens a dialog where you can reopen a ticket after it has been resolved or closed.
Do so, for example, if the solution of the issue turned out to be incorrect. Furthermore, you
can add a text message to this ticket which indicates, for example, why you have opened
the ticket again. Confirm reopening and assignment by clicking on Save.
Tickets as Emails
You can receive all tickets which are assigned to you or to your user group as emails. You will
be also notified each time this ticket is edited via email. This way, you will keep always
informed about new notifications (if set), important system information (if PRTG System
Administrator), or within the communication with other PRTG users. You can turn off the
setting Ticket s as Emails in Sy st em Administ rat ion—User Account s 1856 . If you disable
emails for tickets for a user account, this particular user will not receive any ticket emails
anymore.
28.05.2014 153
Part 5: Ajax Web Interface—Basic Procedures | 12 Tickets
Note: If you have defined to get tickets as emails and you are PRTG System Administrator, you
will receive emails for ToDo tickets as well, although ToDo tickets are considered to be
opened by the PRTG System Administrator.
More
Paessler Blog: A New Feature Was Assigned to You in PRTG: Ticket System Keeps Track of
Network Monitoring Issues
§ http://www.paessler.com/blog/2014/02/03/prtg/ticket-system-keeps-track-of-network-
monitoring-issues
154 28.05.2014
Part 5: Ajax Web Interface—Basic Procedures | 12 Tickets
§ Sensor St at es 121
§ Alarms 144
§ Logs 147
§ Ticket s 149
§ Pause 162
Related Topics
§ Ent erprise Console 1894
28.05.2014 155
Part 5: Ajax Web Interface—Basic Procedures | 13 Working with Table Lists
On certain overview pages, such as for sensors 178 , tickets 151 , and similar sensors 140 , there is
also an inline filter available directly above the table. The filter options depend on the current
page.
156 28.05.2014
Part 5: Ajax Web Interface—Basic Procedures | 13 Working with Table Lists
Related Topics
158 28.05.2014
Part 5: Ajax Web Interface—Basic Procedures | 14 Object Selector
On the left hand side, you see a device tree specific to your setup that you can browse by
clicking on the corresponding nodes. Click on a device to view its sensors on the right hand
side.
You can directly browse for objects in the device tree by entering a probe name, group name,
or device name into the Search... field above the device tree navigation. You can also use a
substring only. The resulting objects will be displayed immediately without any manual
confirmation.
If you have selected a device on the left hand side, you will see the sensors on this device
here, on the right hand side. Also, the sensor type is shown. Hover a sensor on the right side
to view its parent device and group.
You can also directly search and find sensors by entering its sensor name, group name, device
name, or tag into the Find... box above the sensor list.
14.01.2014 159
Part 5: Ajax Web Interface—Basic Procedures | 15 Priority and Favorites
The priority setting will affect in which order your objects will be displayed when viewing table
lists. Objects with a higher priority are listed first, others underneath, depending on their own
priority.
To change priority settings, right-click an object to open the context menu 163 and select
Priorit y . You can choose between 5 stars ***** (top priority) and one star * (lowest priority).
By default, all objects are set to medium priority (3 stars ***). In the page header bar and in
lists, you can set a priority directly by one click on a star, for example, for sensors on a device
overview page.
To call a list of all your favorite devices or sensors, select Devices | Favorit e Devices or
Sensors | Favorit e Sensors from the main menu. These lists are sorted by priority as well.
You can mark any device or sensor as favorite to add it to the favorite list. Right click on it to
open the context menu 163 . Select Priorit y /Favorit e | Add t o Favorit es. A small black flag
symbol will be added next to the object's name.
Context Menu:
Priority /Fav orites (Add)
To remove an object from the favorites list, select Priorit y /Favorit e | Remove from
Favorit es from the context menu 163 .
160 14.01.2014
Part 5: Ajax Web Interface—Basic Procedures | 15 Priority and Favorites
Context Menu:
Priority /Fav orites (Remov e)
There is also the option to add a device or sensor to favorites by one click in the device tree.
Just click on the small flag symbol right to the respective object name for this concern. If the
flag is black, the specific object is already a favorite; clicking anew on the flag will remove it
from favorites and the flag will turn gray again.
You can add any device or sensor to favorites on its respective details page by clicking on the
small flag symbol in the page header bar 113 . If the flag is black, the selected object is already a
favorite; clicking anew on the flag will remove it from favorites and the flag will turn gray again.
It is also possible to set the priority of the object by a click on one of the five stars in the page
header; five stars ***** means top priority, one star * is the lowest priority.
14.01.2014 161
Part 5: Ajax Web Interface—Basic Procedures | 16 Pause
5.16 Pause
While a sensor is paused, it will not collect any monitoring data, will not change its status 121 ,
and will not trigger any notifications 92 . You can pause monitoring for every object by
selecting Pause from the context menu 163 of a probe, a group, a device, or a sensor. All
sensors on this object will then be paused. You can choose Pause Indefinit ely , or select a
time after which monitoring will be resumed automatically, such as 5 or 15 minut es, 1 or 3
hours, 1 day , or Unt il a certain date. You can also set up a one-time maintenance window to
pause sensors automatically at a specified time.
Note: When selecting the Pause symbol from an object's hover popup 174 or while using multi-
edit 1736 , the object(s) will be paused indefinitely until resumed.
When selecting a pause option, you are prompted to enter a message. This will be shown in
the status message of the object as long as it is paused. Confirm with OK to pause the object;
click Cancel to not pause it.
Note: Monitoring for objects can also be paused by applying a schedule (see Account
Set t ings—Schedules 1827 ) in the Object Set t ings 142 .
If you pause monitoring for an object in the device tree 108 , all child objects underneath will be
paused as well. For example, when pausing a group, all sensors on all devices in it will also be
paused. Once an object is paused, you can resume monitoring any time by selecting Resume
from the context menu 163 . However, you cannot resume monitoring for single child objects
that are paused by a parent object, but only for the object you originally set to pause. Note:
Also after a restart of PRTG, a pause status will be kept.
162 14.01.2014
Part 5: Ajax Web Interface—Basic Procedures | 17 Context Menus
Note: In order to view your browser's context menu, hold down the Ctrl key (Chrome) or the
Shift key (Firefox) while right-clicking. You will then see your browser's instead of the PRTG
menu. This is not possible with Internet Explorer.
The content of the PRTG context menu varies, depending on the type of object you have
selected. Please see the following sub sections for an overview of the available options.
§ Check Now
This will perform an immediate scan for the selected probe. The data for all devices and
sensors in the object hierarchy 83 underneath will be queried.
28.05.2014 163
Part 5: Ajax Web Interface—Basic Procedures | 17 Context Menus
§ Det ails...
This will show the details of the selected probe, such as its status, the groups on the
selected probe, and an overview about the sensor states on the selected probe.
§ Edit ›
The edit menu will appear.
§ Add Device...
This will open an assistant which guides you through adding a new device to the selected
probe. For detailed instructions, please see Add a Device 211 .
§ Sort Alphabet ically
This will sort direct children (groups and devices) of the selected probe in alphabetical order.
The ordering will be stored in the monitoring configuration and cannot be revoked.
§ Delet e...
This will delete the selected probe. You will be asked for confirmation before anything is
actually deleted.
§ Move ›
The move menu will appear.
164 28.05.2014
Part 5: Ajax Web Interface—Basic Procedures | 17 Context Menus
§ If the probe is already in a paused state, Resume will appear in the context menu instead
of Pause ›.
§ You can pause and resume monitoring on the selected probe. The monitoring for all
sensors in the object hierarchy 83 underneath will be paused resp. resumed. You can
choose between: Pause Indefinit ely ..., pause For 5 Minut es..., For 15 Minut es..., For 1
Hour..., For 3 Hours..., For 1 Day ..., or Pause Unt il.... If you choose Pause Unt il... a
popup window will appear where you can define a date. Monitoring will be resumed after
this date.
§ You can directly add a One-t ime maint enance window to pause monitoring during a
planned downtime. In the appearing window, use the date time picker to enter the start
date and time of the maintenance window, as well as the end time, for the selected object.
28.05.2014 165
Part 5: Ajax Web Interface—Basic Procedures | 17 Context Menus
§ Priorit y ›
The priority menu will appear.
§ Define the priority of the selected probe. For details, please see Priorit y and Favorit es
160 .
§ Depending on what time interval you choose, Last 2 day s..., Last 30 day s..., or Last 365
day s..., the Hist oric Dat a Report s 133 tab for the specified interval will be opened.
§ Hist oric Dat a › Creat e Report ... will open an assistant to add a report. For details, please
see Report s St ep by St ep 1778 .
§ Send Link by email
You can send the link to the selected probe by email. This will open a new email using your
system's standard email client. It will contain a direct link to the selected probe's details
page.
§ Open Ticket
This will open the New Ticket dialog. For details, see section Ticket s 152 .
Note: The context menu of the Root group is special and differs from the other groups' menu.
§ Check Now
This will perform an immediate scan for the selected group. The data for all devices and
sensors in the object hierarchy 83 underneath will be queried.
§ Det ails...
This will show the details of the selected group, such as its status, the devices on the
selected group, and an overview about the sensor states on the selected group.
§ Edit ›
The edit menu will appear.
166 28.05.2014
Part 5: Ajax Web Interface—Basic Procedures | 17 Context Menus
§ Set t ings...
This will open the Group Set t ings 253 tab.
§ Not ificat ions...
This will open the Not ificat ions 1749 tab.
§ Access Right s...
This will open a popup to edit access rights 94 .
§ Rename...
This will open a popup to edit the name of the selected group.
§ Management ...
This will open the management 222 tab.
§ Add Group...
This will open an assistant which guides you through the process of adding a new group to
the selected group. For detailed instructions, please see Add a Group 205 .
§ Add Device...
This will open an assistant which guides you through adding a new device to the selected
group. For detailed instructions, please see Add a Device 211 .
§ Run Aut o-Discovery
If you select this option, an automatic search is started, adding new sensors to the selected
group. The search is running in the background. If found, you will see new sensors after a
few minutes automatically. For more information, please see Aut o-Discovery 191 (Run Aut o-
Discovery Now).
§ Sort Alphabet ically
This will sort direct children (devices and other groups) of the selected group in alphabetical
order. The ordering will be stored in the monitoring configuration and cannot be revoked.
§ Delet e...
This will delete the selected group. You will be asked for confirmation before anything is
actually deleted.
§ Clone
This will open an assistant which guides you through cloning the selected group. For
detailed instructions, please see Clone Object 1734 .
§ Move ›
The move menu will appear.
§ This will move the selected group. Choose between:
§ Move › Top: This will move the group to the top of the mother node (here usually a
probe or another group).
§ Move › Up: This will move the group one entry up under the mother node.
§ Move › Down: This will move the group one entry down under the mother node.
§ Move › Bot t om: This will move the group to the bottom of the mother node.
28.05.2014 167
Part 5: Ajax Web Interface—Basic Procedures | 17 Context Menus
§ Move › To Ot her Group: This will move the group to another group. An assistant
will appear in this case with information about the selected group and the sub-
objects which also will be moved. Please choose a target group from the list.
§ Move › Management ...: This will open the management 222 tab.
§ Pause ›
The pause menu will appear.
· If the group is already in a paused state, Resume will appear in the context menu instead
of Pause ›.
· You can pause and resume monitoring on the selected group. The monitoring for all
sensors in the object hierarchy 83 underneath will be paused resp. resumed. You can
choose between: Pause Indefinit ely ..., pause For 5 Minut es..., For 15 Minut es..., For 1
Hour..., For 3 Hours..., For 1 Day ..., or Pause Unt il.... If you choose Pause Unt il... a
popup window will appear where you can define a date. Monitoring will be resumed after
this date.
· You can directly add a One-t ime maint enance window to pause monitoring during a
planned downtime. In the appearing window, use the date time picker to enter the start
date and time of the maintenance window, as well as the end time, for the selected object.
§ Priorit y ›
The priority menu will appear. Define the priority of the selected group. For details, please
see Priorit y and Favorit es 160 .
168 28.05.2014
Part 5: Ajax Web Interface—Basic Procedures | 17 Context Menus
§ Set t ings...
This will open the Device Set t ings 272 tab.
§ Not ificat ions...
This will open the Not ificat ions 1749 tab.
§ Access Right s...
This will open a popup to edit access rights 94 .
§ Rename...
This will open a popup to edit the name of the selected device.
§ Add Sensor...
This will open an assistant which guides you through adding a new sensor to the selected
device. For detailed instructions, please see Add a Sensor 220 .
28.05.2014 169
Part 5: Ajax Web Interface—Basic Procedures | 17 Context Menus
§ You can pause and resume monitoring on the selected device. The monitoring for all
sensors in the object hierarchy 83 underneath will be paused resp. resumed. You can
choose between: Pause Indefinit ely ..., pause For 5 Minut es..., For 15 Minut es..., For 1
Hour..., For 3 Hours..., For 1 Day ..., or Pause Unt il.... If you choose Pause Unt il... a
popup window will appear where you can define a date. Monitoring will be resumed after
this date.
§ You can directly add a One-t ime maint enance window to pause monitoring during a
planned downtime. In the appearing window, use the date time picker to enter the start date
and time of the maintenance window, as well as the end time, for the selected object.
§ Priorit y /Favorit e ›
The priority/favorite menu will appear. Define the priority of the selected device, or add resp.
remove the device to resp. from the favorites. For details, please see Priorit y and
Favorit es 160 .
§ Go To Service URL...
This will open the service page you have defined in the Device Set t ings 272 .
§ New window wit h HTTP...
This will open a new browser window with Hypertext Transfer Protocol (HTTP) and the IP
address / DNS name of the device.
§ New window wit h HTTPS...
This will open a new browser window with Hypertext Transfer Protocol Secure (HTTPS) and
the IP address / DNS name of the device.
§ New window wit h FTP...
This will open a new browser window with File Transfer Protocol (FTP) and the IP address /
DNS name of the device.
170 28.05.2014
Part 5: Ajax Web Interface—Basic Procedures | 17 Context Menus
28.05.2014 171
Part 5: Ajax Web Interface—Basic Procedures | 17 Context Menus
§ You can acknowledge an alarm for the selected sensor. An acknowledged alarm will
show up in the alarms list as "acknowledged" (see Sensor St at es 121 ) and will not trigger
1716 any more notifications 1749 . You can choose between: Acknowledge Indefinit ely ...,
acknowledge For 5 Minut es..., For 15 Minut es..., For 1 Hour..., For 3 Hours..., For 1
Day ..., or Unt il.... If you choose Unt il... a popup window will appear where you can
define a date. If the alarm condition still exists after this date, the sensor will show a
Down status again. Note: If the alarm condition clears, the sensor will usually return into
an Up status immediately with the next sensor scan. For details about acknowledging an
alarm, please see Alarms 145 section.
§ Delet e...
This will delete the selected sensor. You will be asked for confirmation before anything is
actually deleted.
§ Clone
This will open an assistant which guides you through cloning the selected sensor. For
detailed instructions, please see Clone Object 1734 .
§ Move ›
The move menu will appear. This will move the selected sensor. Choose between:
§ Move › Top: This will move the sensor to the top of the mother node (here a
device).
§ Move › Up: This will move the sensor one entry up under the device.
§ Move › Down: This will move the sensor one entry down under the device.
§ Move › Bot t om: This will move the sensor to the bottom of the device.
§ Pause ›
The pause menu will appear. If the sensor is already in a paused state, Resume will appear in
the context menu instead of Pause ›.
172 28.05.2014
Part 5: Ajax Web Interface—Basic Procedures | 17 Context Menus
§ You can pause and resume monitoring on the selected sensor. You can choose
between: Pause Indefinit ely ..., pause For 5 Minut es..., For 15 Minut es..., For 1 Hour...,
For 3 Hours..., For 1 Day ..., or Pause Unt il.... If you choose Pause Unt il... a popup
window will appear where you can define a date. Monitoring will be resumed after this
date.
§ You can directly add a One-t ime maint enance window to pause monitoring during a
planned downtime. In the appearing window, use the date time picker to enter the start date
and time of the maintenance window, as well as the end time, for the selected object.
§ Simulat e Error St at us
This will set the selected sensor to a simulated error state. As for the paused state, Resume
will appear in the context menu if a the selected sensor is already in a simulated error state.
§ Priorit y /Favorit e ›
The priority/feature menu will appear.
§ Define the priority of the selected sensor. For details, please see Priorit y and Favorit es
160 .
28.05.2014 173
Part 5: Ajax Web Interface—Basic Procedures | 18 Hover Popup
Note: The hover popup does only appear if your browser is the currently focused window on
your desktop. It disappears with every (automatic) page refresh.
Menu Icons
At the top of the hover popup window, several icons are shown which enable you to view or
edit the current object. These are the most important options from this object's context menu
163 which is shown when right-clicking it.
174 14.01.2014
Part 5: Ajax Web Interface—Basic Procedures | 19 Main Menu Structure
Note: This documentation refers to the PRTG Sy st em Administ rat or user accessing the Ajax
interface on a master node. For other user accounts, interfaces, or nodes, not all of the
options might be available as described. When using a cluster installation, failover nodes are
read-only by default.
§ Home 175
§ Devices 176
§ Libraries 178
§ Sensors 178
§ Alarms 181
§ Maps 182
§ Reports 182
§ Logs 183
§ Tickets 183
§ Setup 184
Home
Click to open the user's homepage. The default setting is PRTG's welcome page. The
homepage can be changed in the user's account settings 1812 . Hover to show other menu
items.
28.05.2014 175
Part 5: Ajax Web Interface—Basic Procedures | 19 Main Menu Structure
§ Dashboard 1 – Dashboard 3
The dashboards provide different preset overviews with the status of your sensors. Choose
the one that fits your needs. Note: Dashboards are not customizable. You can create your
own overview pages using the Maps 1794 feature.
§ Swit ch Clust er Node ›
This option is only available if PRTG runs in Clust ering 81 mode. Show available cluster
nodes. Hover to show other menu items. Follow the menu path (it is specific to your setup)
to select another cluster node. The current Master node is shown in bold letters. Click on a
node's name and you will leave the current node and connect to the other, showing the
same page there.
§ Sit emap
The sitemap contains a flat text view of all menu items. You can easily search for key words
using the search function in your browser (usually shortcut CTRL-F).
§ Go t o Mobile Web GUI
This switches to the Mobile Web GUI 1947 optimized for low bandwidth and mobile devices.
Less scripting is used for more compatibility. However, this is a read-only interface.
§ Welcome t o PRTG
Shows the welcome screen which leads you to the major sections of the web interface.
§ Configurat ion Guru
This will open the Configurat ion Guru welcome page. For details about the guru, please see
section Using t he Configurat ion Guru 36 .
§ Make This My Homepage
Change the page that is loaded when you click on the Home button in the main menu.
Select this menu item on any page and its URL will be set as the current user's homepage
immediately. This setting is user sensitive. The default homepage is /welcome.htm. You can
change this setting any time by clicking on this menu item again, or by changing the
Homepage URL in the My Account 1812 settings.
Devices
Click to show a group view of all your devices, starting with the Root group which contains all
other groups of your setup. Hover to show other menu items.
176 28.05.2014
Part 5: Ajax Web Interface—Basic Procedures | 19 Main Menu Structure
§ Group View ›
Shows a tree view of all probes and groups in your setup. Click to show a group view of all
your devices, starting with the Root group which contains all other groups of your setup.
Hover to show other menu items. Follow the menu path (it is specific to your setup) to view
the devices in a specific probe or group only.
§ Device List ›
Shows a list view of all devices in your setup. Click to show a table list of all devices in your
setup. Hover to show other menu items. Choose Favorit e Devices to show a list of all
devices marked as Favorit e 160 . Note: Follow the menu path (it is specific to your setup) to
view a table list of the devices in a specific probe or group only. In the table list 156
appearing, you can re-sort the items by clicking on the column's header items.
§ Favorit e Devices
Shows a table list of all devices marked as Favorit e 160 . Note: To mark any device as a
favorite device, select Priorit y /Favorit e | Add t o Favorit es from its context menu or click
on the small flag on a device's details page.
§ Dependencies ›
Shows an overview list of the dependencies configured for the objects in your setup. Hover
the menu item to show other menu items. Choose between Select ed Dependencies and
Mast er Dependencies to view a list of all dependencies or explicit ones. Follow the menu
path (it is specific to your setup) to view dependencies of the objects in a specific probe or
group only.
§ Add Group
Start an assistant which guides you through the process of adding a new group to your
setup. For more information, please see section Creat e Object s Manually 204 . Tip: You can
create new groups much faster by choosing Add Group... from a probe's or group's context
menu!
§ Add Aut o-Discovery Group
Start an assistant which guides you through the process of adding a new auto-discovery
group to your setup. PRTG will create a new group and run an auto-discovery in your
network in order to add devices and sensors for these devices automatically. For more
information, please see section Using t he Aut o-Discovery 190 Tip: You can create new
groups much faster by choosing Add Aut o-Discovery Group... from a probe's or group's
context menu!
28.05.2014 177
Part 5: Ajax Web Interface—Basic Procedures | 19 Main Menu Structure
§ Add Device
Start an assistant which guides you through the process of adding a new device to an
existing group. During the process, you can choose if PRTG should run an auto-discover for
the new device in order to add sensors automatically. For more information, please see
section Creat e Object s Manually 204 . Tip: You can create new devices much faster by
choosing Add Device... from a group's context menu!
Libraries
Click to call the Libraries feature where you can view or add custom views of your network's
status and monitoring data. For more information, please see Libraries 1759 section. Hover to
show other menu items.
§ All
Calls the Libraries feature where you can view or add custom device tree views of your
network's status and monitoring data.
§ Add Library
Lets you directly add 1762 a new library.
§ Select Library ›
Show existing libraries. Hover to show other menu items. Follow the menu path (it is specific
to your setup) to select a library.
Sensors
Click to show a table list of all sensors. In the table list 156 appearing, you can re-sort the items
by clicking on the column's header items, as well as you can filter the list by related object and
tag with the inline filter directly above the table.
Hover Sensors in the main menu bar to show other menu items. Note: In the column Last
Value only the last value of the sensor's primary channel will be shown.
178 28.05.2014
Part 5: Ajax Web Interface—Basic Procedures | 19 Main Menu Structure
§ All
Shows a table list of all sensors. In the table list appearing, you can re-sort the items by
clicking on the column's header items. Note: In the column Last Value only the last value of
the sensor's primary channel will be shown.
§ Add Sensor
Start an assistant which guides you through the process of adding a new sensor to an
existing device. For more information, please see section Add a Sensor 220 . During the
process, you can also choose to create a new device. This will bring you to the "Add Device"
assistant you can call from the "Devices" menu directly.
§ Favorit e Sensors
Shows a table list of all sensors marked as Favorit e 160 . Note: To mark any sensor as a
favorite sensor, select Priorit y /Favorit e | Add t o Favorit es from its context menu or click
on the small flag on a device's details page.
§ Top 10 List s ›
This is an option to show a dashboard view with different Top 10 lists regarding best/worst
uptime, Ping, bandwidth usage, website response times, memory usage, and system uptime.
Click to show Top 10 lists out of all sensors. Hover to show other menu items. Follow the
menu path (it is specific to your setup) to view Top 10 lists out of a specific probe or group
only. Note: The sensors will be selected by default tags.
§ By Current Value ›
This is an option to show a filtered sensor list. Hover to show other menu items. Follow the
menu path to view table lists 156 of Fast est or Slowest sensors regarding
§ Ping
§ Port
§ Webpages
§ IMAP/POP3/SMTP
§ FTP
28.05.2014 179
Part 5: Ajax Web Interface—Basic Procedures | 19 Main Menu Structure
180 28.05.2014
Part 5: Ajax Web Interface—Basic Procedures | 19 Main Menu Structure
§ Cross Reference ›
The cross reference shows information about all sensors including the set interval, access
rights, notification trigger settings, schedule, and dependency. Click to show a sensor cross
reference for all sensors. Hover to show other menu items. Follow the menu path (it is
specific to your setup) to view cross reference information for sensors in a specific probe or
group only, or to view them by type or tag.
§ Compare Sensors ›
Calls a function to compare graphs of two or more monitoring objects. Hover to show other
menu items. Follow the menu path to open an assistant for comparing several monitoring
objects. For more information, please see Compare Sensors 130 section.
§ View Hist oric Dat a
Calls a function for quick generation of sensor data reports. For more information, please
see Hist oric Dat a Report s 133 section.
§ Similar Sensors Overview
Calls an overview page listing similar sensors. For more information, please see Similar
Sensors 138 section.
Alarms
Click to show a all sensors that currently show a Down, Down (Part ial), Warning, or Unusual
status. In the table list 156 appearing, you can re-sort the items by clicking on the column's
header items. If you select Show as Gauges, the sensor gauges will be displayed in a size
corresponding to their priority. Hover to show other menu items.
§ All
Shows a list of all sensors which currently show a Down, Down (Part ial), Down
(Acknowledged), Warning, or Unusual status.
§ Show as Gauges
Shows the gauges of all sensors which currently show a Down, Down (Part ial), Down
(Acknowledged), Warning, or Unusual status. The size of the sensor gauges corresponds
to their respective priority.
§ Errors Only
Shows a list of all sensors which currently show a Down, Down (Part ial), or Down
(Acknowledged) status.
§ Warnings Only
Shows a list of all sensors which currently show a Warning status.
28.05.2014 181
Part 5: Ajax Web Interface—Basic Procedures | 19 Main Menu Structure
§ Unusuals Only
Shows a list of all sensors which currently show an Unusual status.
Maps
Click to call the Maps feature where you can view or add custom views of your network's
status and monitoring data. For more information, please see Maps 1794 section. Hover to show
other menu items.
§ All
Calls the Maps feature where you can view or add custom views of your network's status
and monitoring data.
§ Add Map
Lets you directly add 1797 a new map.
§ Select Map ›
Show existing maps. Hover to show other menu items. Follow the menu path (it is specific
to your setup) to select a map.
Reports
Click to call the Reports feature where you can view or add reports of your monitoring data.
For more information, please see Report s 1775 section. Hover to show other menu items.
§ All
Calls the Reports feature where you can view or add reports of your monitoring data.
§ Add Report
Lets you directly add a new report.
§ Select Report ›
Show existing reports. Hover to show other menu items. Follow the menu path (it is specific
to your setup) to select a report.
182 28.05.2014
Part 5: Ajax Web Interface—Basic Procedures | 19 Main Menu Structure
Logs
Click to show log information for all objects in your configuration, newest first. In the table list
156 appearing, you can filter the items by using the respective options 156 . Hover to show
other menu items. For more information, please see Logs 147 section.
§ All
Show log information for all objects in your configuration, newest first.
§ By Group ›
Show log information for objects in a certain group only, newest first. Hover to show other
menu items. Select All, or follow the menu path (it is specific to your setup) to select a
group you would like to show log information for.
§ St at us Changes ›
Show log information for certain status changes only. Hover to show other menu items.
Follow the menu path to view log entries with a special value in the St at us field only. Select
between Up & Down (shows entries with either Up or Down in the St at us field), Down,
Warning, Unusual, Up, Paused/Resumed (shows entries with either Paused or Resumed in
the St at us field), or Acknowledged Alarms.
§ Sy st em Event s ›
Show log information regarding certain system event types only. Hover to show other menu
items. Select between the following event types: Probe Relat ed, Clust er Relat ed, Aut o-
Discovery , Not ificat ions, or St at us Messages.
§ Object Hist ory
Shows information about changes to the PRTG setup and lists deletions of subordinate
system objects. The object history page has a tab-like interface. Using the tabs you can
navigate through various sub-pages in order to view the changes to all related settings and
deletions of objects. Select between the following tabs: My Account , Sy st em Set up,
Not ificat ions, Schedules, User Account s, User Groups, Report s, Libraries, or Maps.
Note: You can open a specific tab directly with the context button Hist ory in the page
header bar 113 on the corresponding pages.
Tickets
Tickets show important system information or action steps to take for the administrator. For
best experience with PRTG, check every ticket and conduct appropriate actions. Click to show
all tickets which are assigned to the current user. In the table list 156 appearing, you can re-sort
the items by clicking on the column's header items, as well as you can filter the list with the
inline filter directly above the table. Hover to show other menu items. For more information,
please see section Ticket s 149 .
28.05.2014 183
Part 5: Ajax Web Interface—Basic Procedures | 19 Main Menu Structure
You have several options to display a list of tickets which is filtered to your needs. You can
also create a new ticket via the main menu. Available options are:
§ My Ticket s
Click to show all open tickets which are assigned to the current user. Hover to show other
menu items for filtering these tickets depending on their status.
§ All Ticket s
Click to show all open tickets of all PRTG users. Hover to show other menu items for filtering
these tickets depending on their status.
§ ToDo Ticket s
Click to show all open tickets from the type ToDo. Hover to show other menu items for
filtering these tickets depending on their status.
§ Open Ticket
This will open the New Ticket dialog. Provide the needed information and confirm by clicking
on Save to create a User Ticket.
For more information about available options, please refer to section Ticket s 149 .
Setup
Click to show the setup page. Hover to show other menu items. For more information, please
see Set up 1810 section.
§ Overview
Shows the setup page 1810 .
§ Account Set t ings ›
Hover to show menu items of the account settings. Choose from:
184 28.05.2014
Part 5: Ajax Web Interface—Basic Procedures | 19 Main Menu Structure
§ My Account 1812
§ Schedules 1827
§ Probes 1849
§ Clust er 1855
§ Downloads / Add-Ons ›
Shows additional downloads for PRTG. Choose from:
§ PRTG Ent erprise Console 1885
§ PRTG St at us ›
Hover to show menu items of the PRTG status. Choose from:
§ Sy st em St at us 1869
§ Clust er St at us 1883
28.05.2014 185
Part 5: Ajax Web Interface—Basic Procedures | 19 Main Menu Structure
Click this symbol to refresh all elements on the current page to display current data. Unlike the
reload function of your browser, this merely refreshes the single page elements, not the whole
page. During the refresh process, this symbol flashes.
Shows the help center which supports you if you have any questions regarding your PRTG
setup.
Logs out the current user and shows the login screen 102 .
Search Box
Use the search box to find objects and reports, and other items by name or tag, or to search
for help.
Context Menu
Additionally, there are Cont ext Menus 163 available for all objects. Right-click on an object to
open it.
186 28.05.2014
Part 6
Ajax Web Interface—Device and Sensor Setup
14.01.2014 187
Part 6: Ajax Web Interface—Device and Sensor Setup |
Because the web interface works as a Single Page Application (SPA), you will rarely see a full
page refresh to avoid this performance impact due to redundant processing. Only single page
elements will be refreshed when necessary. All object setting dialogs are shown as pop-up
layers, so you will never lose the current context. This speeds up the user experience
appreciably and makes the configuration of objects in PRTG comprehensible.
The following sections introduce device and sensor setup in the Ajax Graphical User Interface
(GUI).
188 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup |
Related Topics
§ Ent erprise Console 1894
14.01.2014 189
Part 6: Ajax Web Interface—Device and Sensor Setup | 1 Auto-Discovery
6.1 Auto-Discovery
PRTG's auto-discovery function is a great way to automatically create a sophisticated and
concise set of sensors for your complete network. It is mainly suitable for LAN discovery since
it involves a lot of SNMP and WMI. For video instructions, please see the More 203 section
below.
For a quick start auto-discovery, please see TWO—Using t he Configurat ion Guru 36 section.
§ St ep 1
Scanning a network segment for devices using Ping (for groups only).
§ St ep 2
Assessing the device type for all devices discovered in Step 1 (using SNMP, WMI, and other
protocols).
§ St ep 3a
Creating sensor sets that match the discovered device types of step 2. This is done based
on built-in device templates with recommended sensors for many device types.
St ep 3b (opt ional)
Creating sensor sets using user created device templates (see Creat e Device Templat e 1741
section).
The auto-discovery can be used on a group level for a range of IP addresses, or for individual
devices which you might have created manually. It can be run just once, on demand via the
context menu, or scheduled every hour, day or week. Running the auto-discovery every day
or week will automatically create new sensors when new devices are connected to the
network. As soon as new devices or sensors are discovered, new Ticket s 149 are created
(which are mailed to the system administrator by default).
§ PRTG can not discover devices that can not be pinged, since Step 1 uses pings. If, for
example, a firewall blocks echo requests, a device behind it cannot be discovered.
§ You should supply authentication settings for Windows Sy st ems, Linux (SSH/WBEM)
Sy st ems, VMware/X EN Servers, and SNMP Devices in order to fully exploit the power of
this feature. We recommend defining these in the Root group settings 224 .
§ If a device has more than one IP address, it may show up more than once in the discovery
results, even though PRTG tries to identify these situations.
§ If a device already exists on the same probe, the auto-discovery will skip this device and not
create a duplicate.
§ Using frequent auto-discoveries of large network segments can lead to performance issues.
We therefore recommend to only schedule regular auto-discoveries where necessary. For
detailed information see the More 203 section below.
190 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 1 Auto-Discovery
You can run an auto-discovery at any time for a group or a device. To do so, right-click on the
respective object and from the context menu, select Run Aut o-Discovery . PRTG will
immediately start searching for new objects which can be added to the device tree. If used for
a group, PRTG will add devices and sensors, if found. If used for a device, it will add new
sensors, if found.
Note: The auto-discovery will also re-add devices or sensors you have manually deleted. If you
do not want this, please create objects manually 204 only.
§ On the welcome screen 108 , click on the Perform Net work Aut o-Discovery option,
§ or select Devices | Add Aut o-Discovery Group from the main menu.
To start an automatic detection of devices and sensors in your network an assistant will
appear, leading you through two steps. For faster setup, you can select Add Aut o-Discovery
Group... in the context menu 163 of a probe or group to which you want to add the new
group. This will skip step 1 and lead you directly to step 2.
Note: This documentation refers to the PRTG Sy st em Administ rat or user accessing the Ajax
interface on a master node. For other user accounts, interfaces, or nodes, not all of the
options might be available as described. When using a cluster installation, failover nodes are
read-only by default.
28.05.2014 191
Part 6: Ajax Web Interface—Device and Sensor Setup | 1 Auto-Discovery
§ St ep 1
Please choose a probe or group you want to add the new group to. Click on Cont inue.
§ St ep 2
Add auto-discovery settings as described below.
Group Name Enter a meaningful name to identify the group. The name will be
shown by default in the devices tree and in all alarms.
Tags Enter one or more tags; confirm each tag by hitting the space,
comma, or enter key. You can use tags to group objects and use
tag-filtered views later on. Tags are not case sensitive. Tags are
automatically inherited 89 .
192 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 1 Auto-Discovery
Group Ty pe
Sensor Management Select the method for automatic network discovery. Choose
between:
§ Aut omat ic device ident ificat ion (st andard, recommended):
Detect mainly based on Ping, SNMP, and WMI. This option should
work fine for most installations.
§ Aut omat ic device ident ificat ion (det ailed, may creat e many
sensors): Detect in a more detailed way and create more
sensors. This option uses all standard device templates for auto-
discovery. It is suitable for small network segments and
whenever you want to monitor the maximum number of sensors
available.
§ Aut omat ic sensor creat ion using specific device t emplat e(s):
Manually define the device templates used for auto-discovery.
From the list below, select one or more templates.
Device Template(s) This option is only visible if using specific device templates (last
option) is enabled above. Please choose one or more templates by
adding a check mark in front of the respective template name. You
can also select and deselect all items by using the check box in the
table head. These will be used for auto-discovery on the current
device. Choose from:
§ ADSL
§ Cisco ASA VPN
§ Cisco Device (Generic)
§ Dell MDI
§ DNS Server
§ Environment Jacart a
§ Environment Poseidon
§ Frit zbox
§ FTP Server
§ Generic Device (PING only )
§ Generic Device (SNMP-enabled)
§ Generic Device (SNMP-enabled, Det ailed)
§ HTTP Web Server
§ Hy per V Host Server
§ Linux/UNIX Device (SNMP or SSH enabled)
§ Mail Server (Generic)
28.05.2014 193
Part 6: Ajax Web Interface—Device and Sensor Setup | 1 Auto-Discovery
create new sensors. Templates which were not applied will not be
shown in the ticket.
Discovery Schedule Define when the auto-discovery will be run. Choose between:
194 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 1 Auto-Discovery
IP Selection Method Define how you want to define the IP range for auto-discovery.
Choose between:
§ Class C base IP wit h st art /end (IPv4): Define an IPv4 class C
address range.
§ List of individual IPs and DNS names (IPv4): Enter a list of
individual IPv4 addresses or DNS names.
§ IP and Subnet (IPv4): Enter an IPv4 address and subnet mask.
§ IP wit h oct et range (IPv4): Enter an IPv4 address range for every
IP octet individually. With this, you can define very customizable IP
ranges.
§ List of individual IPs and DNS names (IPv6): Enter a list of
individual IPv6 addresses or DNS names.
§ Use comput ers from t he act ive direct ory (maximum 1000
comput ers): Search in the active directory for computers to
perform auto-discovery.
Note: Only subnets with up to 65,536 IP addresses can be
discovered! If you define a range with a higher number of
addresses, discovery will stop before it is completed.
IPv4 Base This field is only visible if Class C network detection is selected
above. Enter a class C network as IP base for the auto-discovery.
Enter the first three octets of an IPv4 IP address, for example,
192.168.0
28.05.2014 195
Part 6: Ajax Web Interface—Device and Sensor Setup | 1 Auto-Discovery
IPv4 Range Start This field is only visible if Class C network detection is selected
above. Enter the IP octet of the class C network specified above
from which PRTG will start the auto-discovery. This will complete
the IP base above to an IPv4 address. For example, enter 1 to
discover from 192.168.0.1.
IPv4 Range End This field is only visible if Class C network detection is selected
above. Enter the IP octet of the class C network specified above at
which PRTG will stop the auto-discovery. This will complete the IP
base above to an IPv4 address. For example, enter 254 to discover
up to 192.168.0.254.
IPv4/DNS Name List This field is only visible if the IP list option is selected above. Enter a
IPv6/DNS Name List list of IP addresses or DNS names which the auto-discovery will
scan. Enter each address in a separate line.
IPv4 and Subnet (IPv4) This field is only visible if the IP and subnet option is selected
above. Enter an expression in the format address/subnet , e.g.
192.168.3.0/255.255.255.0. You can also use the short form like
192.168.3.0/24 in this example. PRTG will scan the complete host
range (without network and broadcast address) defined by the IP
address and the subnet mask.
IP with Octet Range This field is only visible if the octet range option is selected above.
Enter an expression in the format a1.a2.a3.a4, where a1, a2, a3,
and a4 are each a number between 0-255, or a range with two
numbers and a hyphen like 1-127. All permutations of all ranges are
calculated, e.g. 10.0.1-10.1-100 results in 1,000 addresses that
PRTG will scan during auto-discovery.
Organizational Unit This field is only visible if active directory is selected above. Enter
an organizational unit (OU) to restrict the active directory search to
computers which are part of this OU. Just enter the name of the OU
without any other term (i.e., without "OU" in front). If you leave this
field empty, there will not be any restriction.
If you have sub-OUs, too, please consider the correct syntax in the
format Y,OU=X : OUs that are part of another OU have to be listed
together with their parent(s). Enter the sub-OU followed by ,OU=
and the name of the parent OU. For example, assuming that the
organizational unit 'Y' is part of the OU named 'X'. Then the syntax
would be Y,OU=X. For three OUs 'X', 'Y' part of 'X', and 'Z' part of 'Y',
the syntax would be Z,OU=Y,OU=X. Note that the order is
important, sub-OUs have to be listed left of its according parents!
Name Resolution Define how newly discovered devices will be monitored. This only
affects new devices. The setting for existing devices will be kept.
Choose between:
§ Use DNS / WMI / SNMP names (recommended): Monitor newly
discovered devices via their DNS, WMI, or SNMP names (if
available).
196 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 1 Auto-Discovery
Device Rescan Define if you want to rescan known devices. Choose between:
§ Skip aut o-discovery for known devices/IPs (recommended):
Do not re-scan known devices or IP addresses, but only scan for
new devices/IPs when auto-discovering. This can avoid re-
creation of manually deleted sensors. PRTG will also avoid adding
devices that are already included elsewhere in your configuration,
e.g. in other groups.
§ Perform aut o-discovery for known devices/IPs: Re-scan
known devices and IP addresses with every auto-discovery. This
will re-create manually deleted sensors on existing devices.
We recommend using the default value.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
If you have not set credentials yet, set them now before starting the auto-discovery in order
to fully exploit the power of this feature!
Domain or Computer Define the authority for Windows access. This is used for Windows
Name Management Instrumentation (WMI) and other Windows sensors. If
you want to use a Windows local user account on the target
device, please enter the computer name here. If you want to use a
Windows domain user account (recommended), please enter the
(Active Directory) domain name here. If not explicitly defined, PRTG
will automatically add a prefix in order to use the NT LAN Manager
(NTLM) protocol. Please do not leave this field empty.
Username Enter the username for Windows access. Usually, you will use
credentials with administrator privileges.
Password Enter the password for Windows access. Usually, you will use
credentials with administrator privileges.
28.05.2014 197
Part 6: Ajax Web Interface—Device and Sensor Setup | 1 Auto-Discovery
Username Enter a login name for the access via SSH and WBEM. Usually, you
will use credentials with administrator privileges.
Login Define which authentication method will be used for login. Choose
between:
§ Login via Password: Provide a password for login. Enter below.
§ Login via Privat e Key : Provide a private key for authentication.
Note: PRTG can only handle keys in OpenSSH format which are
not encrypted. You cannot use password protected keys here. In
the text field, please paste the entire private key, including the
"BEGIN" and "END" lines. Please make sure the according public
key is provided on the target machine. For details, please see
Monit oring via SSH 1962 .
Password This field is only visible if password login is selected above. Enter a
password for the Linux access via SSH and WBEM. Usually, you will
use credentials with administrator privileges.
Private Key This field is only visible if private key login is selected above. Paste
a private key into the field (OpenSSH format, unencrypted). Usually,
you will use credentials with administrator privileges. Note: If you
do not insert a private key for the first time, but change the private
key, you need to restart your PRTG core server service in order for
the private key change to take effect! For details, please see
Monit oring via SSH 1962 .
For WBEM Use Protocol Define the protocol that will be used for WBEM. This setting is only
relevant when using WBEM sensors. Choose between:
§ HTTP: Use an unencrypted connection for WBEM.
§ HTTPS: Use an SSL-encrypted connection for WBEM.
For WBEM Use Port Define the port that will be used for WBEM. This setting is only
relevant when using WBEM sensors. Choose between:
§ Set aut omat ically (port 5988 or 5989): Use one of the
standard ports, depending on whether unencrypted or encrypted
connection is chosen above.
§ Set manually : Use a custom port. Define below.
WBEM Port This setting is only visible if manual port selection is enabled above.
Enter the WBEM port number.
SSH Port Define the port number which will be used for SSH connections.
Note: By default, this setting is automatically used for all SSH
sensors 296 , unless you define a different port number in the sensor
settings.
198 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 1 Auto-Discovery
SSH Rights Elevation Define with which rights the command will be executed on the
target system. Choose between:
§ Run t he command as t he user connect ing (default ): Use the
rights of the user who establishes the SSH connection.
§ Run t he command as anot her user using 'sudo': Use the rights
of another user, for example, the administrator.
§ Run t he command as anot her user using 'su': Use the rights of
another target user.
Target Username This field is only visible if sudo or su is enabled above. Enter a
username to run the specified command as another user than root.
If you leave this field empty, the command will be run as root.
Ensure that you set the Linux password even you use a public/
private key for authentication. This is not necessary if the user is
allowed to execute the command without a password.
Password Target User This field is only visible if su is enabled above. Enter the password
for the specified target user.
User Enter a login name for access to VMware and XEN servers. Usually,
you will use credentials with administrator privileges.
Password Enter a password for access to VMware and XEN servers. Usually,
you will use credentials with administrator privileges.
VMware Protocol Define the protocol used for the connection to VMware and
XenServer. Choose between:
§ HTTPS (recommended): Use an SSL-encrypted connection to
VMware and XenServers.
§ HTTP: Use an unencrypted connection to VMware and
XenServers.
SNMP Version Select the SNMP version that will be used for device connection.
Choose between:
§ v1: Use the simple standard v1 protocol for SNMP connections.
This protocol only offers clear-text data transmission, but it is
usually supported by all devices.
28.05.2014 199
Part 6: Ajax Web Interface—Device and Sensor Setup | 1 Auto-Discovery
§ v2c: Use the more advanced v2c protocol for SNMP connections.
Data is still transferred as clear-text, but it supports 64-bit
counters.
§ v3: Use the latest v3 protocol for SNMP connections. It provides
secure authentication and data encryption.
Note for SNMP v3: Due to internal limitations you can only monitor
a limited number of sensors per second using SNMP v3. The limit is
somewhere between 1 and 50 sensors per second (depending on
the SNMP latency of your network). This means that using an
interval of 60 seconds you are limited to between 60 and 3000
SNMP v3 sensors for each probe. If you experience an increased
"Interval Delay" or "Open Requests" reading of the probe health
sensor, you need to distribute the load over multiple probes. SNMP
v1 and v2 do not have this limitation.
Community String This setting is only visible if SNMP version v1 or v2c are enabled
above. Enter the community string of your devices. This is a kind of
"clear-text password" used for simple authentication. We
recommend using the default value.
Authentication Type This setting is only visible if SNMP version v3 is enabled above.
Choose between:
§ MD5: Use Message-Digest Algorithm 5 (MD5) for authentication.
§ SHA: Use Secure Hash Algorithm (SHA) for authentication.
The chosen type has to match the authentication type of your
device.
Note: If you do not want to use authentication, but you need SNMP
v3, for example, because your device requires context, you can
leave the field password empty. In this case,
SNMP_SEC_LEVEL_NOAUTH will be used and authentication will be
deactivated entirely.
Encryption Type This setting is only visible if SNMP version v3 is enabled above.
Select an encryption type. Choose between:
§ DES: Use Data Encryption Standard (DES) as encryption
algorithm.
200 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 1 Auto-Discovery
Data Encryption Key This setting is only visible if SNMP version v3 is enabled above.
Enter an encryption key here. If you provide a key in this field,
SNMP data packets will be encrypted using the encryption
algorithm selected above, providing increased security. The
provided key here has to match the encryption key of your device.
Note: If the key entered in this field does not match the key
configured in the target SNMP device, you will not get an error
message! Please enter a string or leave the field empty.
Context Name This setting is only visible if SNMP version v3 is enabled above.
Enter a context name only if it is required by the configuration of
the device. Context is a collection of management information
accessible by an SNMP device. Please enter a string.
SNMP Port Enter the port used for SNMP communication. We recommend using
the default value.
SNMP Timeout (sec.) Enter a timeout in seconds for the request. If the reply takes longer
than this value the request is aborted and an error message is
triggered.
28.05.2014 201
Part 6: Ajax Web Interface—Device and Sensor Setup | 1 Auto-Discovery
HTTP Proxy Settings The proxy settings determine how a sensor connects to a given
URL. You can enter data for a proxy server that will be used when
connecting via HTTP or HTTPS. Note: This setting is valid for the
monitoring only and determines the behavior of sensors. In order
to change proxy settings for the core server, please see Sy st em
Administ rat ion—Core & Probes 1849 .
Name Enter the IP address or DNS name of the proxy server to use. If you
leave this field empty, no proxy will be used.
Port Enter the port number of the proxy. Often, port 8080 is used.
Please enter an integer value.
User If the proxy requires authentication, enter the username for the
proxy login. Note: Only basic authentication is available! Please
enter a string or leave the field empty.
Password If the proxy requires authentication, enter the password for the
proxy login. Note: Only basic authentication is available! Please
enter a string or leave the field empty.
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists.
§ Read: Users in this group can see the object and review its
settings.
§ Writ e: Users in this group can see the object, as well as review
and edit its settings. However, they cannot edit access rights
settings.
§ Full: Users in this group can see the object, as well as review and
edit its settings and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings.
Click on the Cont inue button to store your settings. If you change tabs or use the main menu,
all changes to the settings will be lost!
202 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 1 Auto-Discovery
Auto-Discovery in Progress
While auto-discovery is running you may experience a lower system performance as usual,
because PRTG works in the background in order to discover your network. Depending on the
IP ranges defined (up to 65,536 addresses) , the discovery may run up to several days before
complete. You can review the status of the discovery process as follows:
§ In the device tree, behind the group or device name, you will see a percentage value
showing the progress of auto-discovery.
§ During auto-discovery, the web interface will display a box in the lower right corner, showing
the number of active auto-discovery tasks.
§ In order to stop a running auto-discovery, right-click the group or device, and select Pause |
For 5 minut es... from the context menu 163 . Monitoring will be paused for 5 minutes, and
auto-discovery tasks will be shut down.
Related Topics
More
Video Tutorial: There is a video available on the Paessler video tutorials page.
§ http://www.paessler.com/support/video_tutorials
28.05.2014 203
Part 6: Ajax Web Interface—Device and Sensor Setup | 2 Create Objects Manually
The procedure depends on the kind of object you want to add. Choose between:
Please see Mult iple Probes and Remot e Probes 2049 section for more information.
204 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 2 Create Objects Manually
1 Add a Group
Note: This documentation refers to the PRTG Sy st em Administ rat or user accessing the Ajax
interface on a master node. For other user accounts, interfaces, or nodes, not all of the
options might be available as described. When using a cluster installation, failover nodes are
read-only by default.
In order to add a group manually, select Devices | Add Group from the main menu. An
assistant will appear, leading you through two steps. For faster setup, you can select Add
Group... in the context menu 163 of a probe or group to which you want to add the new
group. This will skip step 1 and lead you directly to step 2.
§ St ep 1
Please choose a probe or group you want to add the new group to. Click on Cont inue.
§ St ep 2
Add group settings as described below.
Group Name Enter a meaningful name to identify the group. The name will be
shown by default in the devices tree and in all alarms.
Tags Enter one or more tags; confirm each tag by hitting the space,
comma, or enter key. You can use tags to group objects and use
tag-filtered views later on. Tags are not case sensitive. Tags are
automatically inherited 89 .
14.01.2014 205
Part 6: Ajax Web Interface—Device and Sensor Setup | 2 Create Objects Manually
1 Add a Group
Domain or Computer Define the authority for Windows access. This is used for Windows
Name Management Instrumentation (WMI) and other Windows sensors. If
you want to use a Windows local user account on the target
device, please enter the computer name here. If you want to use a
Windows domain user account (recommended), please enter the
(Active Directory) domain name here. If not explicitly defined, PRTG
will automatically add a prefix in order to use the NT LAN Manager
(NTLM) protocol. Please do not leave this field empty.
Username Enter the username for Windows access. Usually, you will use
credentials with administrator privileges.
Password Enter the password for Windows access. Usually, you will use
credentials with administrator privileges.
Username Enter a login name for the access via SSH and WBEM. Usually, you
will use credentials with administrator privileges.
Login Define which authentication method will be used for login. Choose
between:
§ Login via Password: Provide a password for login. Enter below.
§ Login via Privat e Key : Provide a private key for authentication.
Note: PRTG can only handle keys in OpenSSH format which are
not encrypted. You cannot use password protected keys here. In
the text field, please paste the entire private key, including the
"BEGIN" and "END" lines. Please make sure the according public
key is provided on the target machine. For details, please see
Monit oring via SSH 1962 .
Password This field is only visible if password login is selected above. Enter a
password for the Linux access via SSH and WBEM. Usually, you will
use credentials with administrator privileges.
Private Key This field is only visible if private key login is selected above. Paste
a private key into the field (OpenSSH format, unencrypted). Usually,
you will use credentials with administrator privileges. Note: If you
do not insert a private key for the first time, but change the private
key, you need to restart your PRTG core server service in order for
the private key change to take effect! For details, please see
Monit oring via SSH 1962 .
For WBEM Use Protocol Define the protocol that will be used for WBEM. This setting is only
relevant when using WBEM sensors. Choose between:
§ HTTP: Use an unencrypted connection for WBEM.
206 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 2 Create Objects Manually
1 Add a Group
For WBEM Use Port Define the port that will be used for WBEM. This setting is only
relevant when using WBEM sensors. Choose between:
§ Set aut omat ically (port 5988 or 5989): Use one of the
standard ports, depending on whether unencrypted or encrypted
connection is chosen above.
§ Set manually : Use a custom port. Define below.
WBEM Port This setting is only visible if manual port selection is enabled above.
Enter the WBEM port number.
SSH Port Define the port number which will be used for SSH connections.
Note: By default, this setting is automatically used for all SSH
sensors 296 , unless you define a different port number in the sensor
settings.
SSH Rights Elevation Define with which rights the command will be executed on the
target system. Choose between:
§ Run t he command as t he user connect ing (default ): Use the
rights of the user who establishes the SSH connection.
§ Run t he command as anot her user using 'sudo': Use the rights
of another user, for example, the administrator.
§ Run t he command as anot her user using 'su': Use the rights of
another target user.
Target Username This field is only visible if sudo or su is enabled above. Enter a
username to run the specified command as another user than root.
If you leave this field empty, the command will be run as root.
Ensure that you set the Linux password even you use a public/
private key for authentication. This is not necessary if the user is
allowed to execute the command without a password.
Password Target User This field is only visible if su is enabled above. Enter the password
for the specified target user.
User Enter a login name for access to VMware and XEN servers. Usually,
you will use credentials with administrator privileges.
Password Enter a password for access to VMware and XEN servers. Usually,
you will use credentials with administrator privileges.
14.01.2014 207
Part 6: Ajax Web Interface—Device and Sensor Setup | 2 Create Objects Manually
1 Add a Group
VMware Protocol Define the protocol used for the connection to VMware and
XenServer. Choose between:
§ HTTPS (recommended): Use an SSL-encrypted connection to
VMware and XenServers.
§ HTTP: Use an unencrypted connection to VMware and
XenServers.
SNMP Version Select the SNMP version that will be used for device connection.
Choose between:
§ v1: Use the simple standard v1 protocol for SNMP connections.
This protocol only offers clear-text data transmission, but it is
usually supported by all devices.
§ v2c: Use the more advanced v2c protocol for SNMP connections.
Data is still transferred as clear-text, but it supports 64-bit
counters.
§ v3: Use the latest v3 protocol for SNMP connections. It provides
secure authentication and data encryption.
Note for SNMP v3: Due to internal limitations you can only monitor
a limited number of sensors per second using SNMP v3. The limit is
somewhere between 1 and 50 sensors per second (depending on
the SNMP latency of your network). This means that using an
interval of 60 seconds you are limited to between 60 and 3000
SNMP v3 sensors for each probe. If you experience an increased
"Interval Delay" or "Open Requests" reading of the probe health
sensor, you need to distribute the load over multiple probes. SNMP
v1 and v2 do not have this limitation.
Community String This setting is only visible if SNMP version v1 or v2c are enabled
above. Enter the community string of your devices. This is a kind of
"clear-text password" used for simple authentication. We
recommend using the default value.
Authentication Type This setting is only visible if SNMP version v3 is enabled above.
Choose between:
§ MD5: Use Message-Digest Algorithm 5 (MD5) for authentication.
§ SHA: Use Secure Hash Algorithm (SHA) for authentication.
The chosen type has to match the authentication type of your
device.
208 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 2 Create Objects Manually
1 Add a Group
Note: If you do not want to use authentication, but you need SNMP
v3, for example, because your device requires context, you can
leave the field password empty. In this case,
SNMP_SEC_LEVEL_NOAUTH will be used and authentication will be
deactivated entirely.
Encryption Type This setting is only visible if SNMP version v3 is enabled above.
Select an encryption type. Choose between:
§ DES: Use Data Encryption Standard (DES) as encryption
algorithm.
§ AES: Use Advanced Encryption Standard (AES) as encryption
algorithm.
The chosen type has to match the encryption type of your device.
Data Encryption Key This setting is only visible if SNMP version v3 is enabled above.
Enter an encryption key here. If you provide a key in this field,
SNMP data packets will be encrypted using the encryption
algorithm selected above, providing increased security. The
provided key here has to match the encryption key of your device.
Note: If the key entered in this field does not match the key
configured in the target SNMP device, you will not get an error
message! Please enter a string or leave the field empty.
Context Name This setting is only visible if SNMP version v3 is enabled above.
Enter a context name only if it is required by the configuration of
the device. Context is a collection of management information
accessible by an SNMP device. Please enter a string.
SNMP Port Enter the port used for SNMP communication. We recommend using
the default value.
SNMP Timeout (sec.) Enter a timeout in seconds for the request. If the reply takes longer
than this value the request is aborted and an error message is
triggered.
14.01.2014 209
Part 6: Ajax Web Interface—Device and Sensor Setup | 2 Create Objects Manually
1 Add a Group
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists.
§ Read: Users in this group can see the object and review its
settings.
§ Writ e: Users in this group can see the object, as well as review
and edit its settings. However, they cannot edit access rights
settings.
§ Full: Users in this group can see the object, as well as review and
edit its settings and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings.
Click on the Cont inue button to store your settings. If you change tabs or use the main menu,
all changes to the settings will be lost!
210 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 2 Create Objects Manually
2 Add a Device
Note: This documentation refers to the PRTG Sy st em Administ rat or user accessing the Ajax
interface on a master node. For other user accounts, interfaces, or nodes, not all of the
options might be available as described. When using a cluster installation, failover nodes are
read-only by default.
To manually add a device, select Devices | Add Device from the main menu. An assistant will
appear, leading you through two steps. For faster setup, you can select Add Device... in the
context menu 163 of a group to which you want to add the new device. This will skip step 1
and lead you directly to step 2.
§ St ep 1
Please choose a group you want to add the new device to. Click on Cont inue.
§ St ep 2
Add device settings as described below.
Device Name Enter a meaningful name to identify the device. The name will be
shown by default in the device tree and in all alarms.
IP Version Define which IP protocol PRTG will use to connect to this device.
The setting is valid for all sensors created on this device. Choose
between:
§ Connect using IPv4: Use IP version 4 for all requests to this
device.
14.01.2014 211
Part 6: Ajax Web Interface—Device and Sensor Setup | 2 Create Objects Manually
2 Add a Device
IP Address/DNS Name Enter the IP address (either v4 or v6, depending on your selection
above) or DNS name for the device. Most sensors created on this
device will inherit this setting and they will try to connect to this
address for monitoring. Note: There are some sensor types that
still have their own setting for IP address/DNS name. Those
sensors will use their own settings.
Tags Enter one or more tags; confirm each tag by hitting space, comma,
or enter key. You can use tags to group sensors and use tag-
filtered views later on. Tags are not case sensitive. Tags are
automatically inherited 89 .
Device Icon Choose a device icon from the list. It will be shown in the device
tree.
Device Ty pe
Sensor Management Select which type of auto-discovery you would like to perform for
this device. Choose between:
§ Manual (no aut o-discovery ): Do not auto-discover any sensors,
but only add sensors manually.
§ Aut omat ic device ident ificat ion (st andard, recommended):
Use a small set of auto-discovery templates. This will scan your
LAN and usually create a view standard sensors on your device.
§ Aut omat ic device ident ificat ion (det ailed, may creat e many
sensors: Use an extended set of auto-discovery templates. This
will scan your LAN and usually create many sensors on your
device.
§ Aut omat ic sensor creat ion using specific device t emplat es:
Use specific auto-discovery templates only. Please select
templates below. This will scan your LAN and add sensors
defined in the template.
Discovery Schedule This option is only visible if one of the auto-discovery options is
selected above. Define when the auto-discovery will be run.
Choose between:
§ Once: Perform auto-discovery only once. For existing devices,
this will initiate a one-time sensor update for the current device.
§ Hourly : Perform auto-discovery for new sensors every hour.
§ Daily : Perform auto-discovery for new sensors every day.
212 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 2 Create Objects Manually
2 Add a Device
Device Ty pe
Device Template(s) This option is only visible if using specific device templates (last
option) is enabled above. Please choose one or more templates by
adding a check mark in front of the respective template name. You
can also select and deselect all items by using the check box in the
table head. These will be used for auto-discovery on the current
device. Choose from:
§ ADSL
§ Cisco ASA VPN
§ Cisco Device (Generic)
§ Dell MDI
§ DNS Server
§ Environment Jacart a
§ Environment Poseidon
§ Frit zbox
§ FTP Server
§ Generic Device (PING only )
§ Generic Device (SNMP-enabled)
§ Generic Device (SNMP-enabled, Det ailed)
§ HTTP Web Server
§ Hy per V Host Server
§ Linux/UNIX Device (SNMP or SSH enabled)
§ Mail Server (Generic)
§ Mail Server (MS Exchange)
§ Microsoft Sharepoint 2010
§ NAS LenovoEMC
§ NAS QNAP
§ NAS Sy nology
§ Net App
§ NTP Server
§ Print er (HP)
§ RDP Server
§ RMON compat ible device
14.01.2014 213
Part 6: Ajax Web Interface—Device and Sensor Setup | 2 Create Objects Manually
2 Add a Device
Device Ty pe
create new sensors. Templates which were not applied will not be
shown in the ticket.
Domain or Computer Define the authority for Windows access. This is used for Windows
Name Management Instrumentation (WMI) and other Windows sensors. If
you want to use a Windows local user account on the target
device, please enter the computer name here. If you want to use a
Windows domain user account (recommended), please enter the
(Active Directory) domain name here. If not explicitly defined, PRTG
will automatically add a prefix in order to use the NT LAN Manager
(NTLM) protocol. Please do not leave this field empty.
214 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 2 Create Objects Manually
2 Add a Device
Username Enter the username for Windows access. Usually, you will use
credentials with administrator privileges.
Password Enter the password for Windows access. Usually, you will use
credentials with administrator privileges.
Username Enter a login name for the access via SSH and WBEM. Usually, you
will use credentials with administrator privileges.
Login Define which authentication method will be used for login. Choose
between:
§ Login via Password: Provide a password for login. Enter below.
§ Login via Privat e Key : Provide a private key for authentication.
Note: PRTG can only handle keys in OpenSSH format which are
not encrypted. You cannot use password protected keys here. In
the text field, please paste the entire private key, including the
"BEGIN" and "END" lines. Please make sure the according public
key is provided on the target machine. For details, please see
Monit oring via SSH 1962 .
Password This field is only visible if password login is selected above. Enter a
password for the Linux access via SSH and WBEM. Usually, you will
use credentials with administrator privileges.
Private Key This field is only visible if private key login is selected above. Paste
a private key into the field (OpenSSH format, unencrypted). Usually,
you will use credentials with administrator privileges. Note: If you
do not insert a private key for the first time, but change the private
key, you need to restart your PRTG core server service in order for
the private key change to take effect! For details, please see
Monit oring via SSH 1962 .
For WBEM Use Protocol Define the protocol that will be used for WBEM. This setting is only
relevant when using WBEM sensors. Choose between:
§ HTTP: Use an unencrypted connection for WBEM.
§ HTTPS: Use an SSL-encrypted connection for WBEM.
For WBEM Use Port Define the port that will be used for WBEM. This setting is only
relevant when using WBEM sensors. Choose between:
§ Set aut omat ically (port 5988 or 5989): Use one of the
standard ports, depending on whether unencrypted or encrypted
connection is chosen above.
14.01.2014 215
Part 6: Ajax Web Interface—Device and Sensor Setup | 2 Create Objects Manually
2 Add a Device
WBEM Port This setting is only visible if manual port selection is enabled above.
Enter the WBEM port number.
SSH Port Define the port number which will be used for SSH connections.
Note: By default, this setting is automatically used for all SSH
sensors 296 , unless you define a different port number in the sensor
settings.
SSH Rights Elevation Define with which rights the command will be executed on the
target system. Choose between:
§ Run t he command as t he user connect ing (default ): Use the
rights of the user who establishes the SSH connection.
§ Run t he command as anot her user using 'sudo': Use the rights
of another user, for example, the administrator.
§ Run t he command as anot her user using 'su': Use the rights of
another target user.
Target Username This field is only visible if sudo or su is enabled above. Enter a
username to run the specified command as another user than root.
If you leave this field empty, the command will be run as root.
Ensure that you set the Linux password even you use a public/
private key for authentication. This is not necessary if the user is
allowed to execute the command without a password.
Password Target User This field is only visible if su is enabled above. Enter the password
for the specified target user.
User Enter a login name for access to VMware and XEN servers. Usually,
you will use credentials with administrator privileges.
Password Enter a password for access to VMware and XEN servers. Usually,
you will use credentials with administrator privileges.
VMware Protocol Define the protocol used for the connection to VMware and
XenServer. Choose between:
§ HTTPS (recommended): Use an SSL-encrypted connection to
VMware and XenServers.
§ HTTP: Use an unencrypted connection to VMware and
XenServers.
216 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 2 Create Objects Manually
2 Add a Device
SNMP Version Select the SNMP version that will be used for device connection.
Choose between:
§ v1: Use the simple standard v1 protocol for SNMP connections.
This protocol only offers clear-text data transmission, but it is
usually supported by all devices.
§ v2c: Use the more advanced v2c protocol for SNMP connections.
Data is still transferred as clear-text, but it supports 64-bit
counters.
§ v3: Use the latest v3 protocol for SNMP connections. It provides
secure authentication and data encryption.
Note for SNMP v3: Due to internal limitations you can only monitor
a limited number of sensors per second using SNMP v3. The limit is
somewhere between 1 and 50 sensors per second (depending on
the SNMP latency of your network). This means that using an
interval of 60 seconds you are limited to between 60 and 3000
SNMP v3 sensors for each probe. If you experience an increased
"Interval Delay" or "Open Requests" reading of the probe health
sensor, you need to distribute the load over multiple probes. SNMP
v1 and v2 do not have this limitation.
Community String This setting is only visible if SNMP version v1 or v2c are enabled
above. Enter the community string of your devices. This is a kind of
"clear-text password" used for simple authentication. We
recommend using the default value.
Authentication Type This setting is only visible if SNMP version v3 is enabled above.
Choose between:
§ MD5: Use Message-Digest Algorithm 5 (MD5) for authentication.
§ SHA: Use Secure Hash Algorithm (SHA) for authentication.
The chosen type has to match the authentication type of your
device.
Note: If you do not want to use authentication, but you need SNMP
v3, for example, because your device requires context, you can
leave the field password empty. In this case,
SNMP_SEC_LEVEL_NOAUTH will be used and authentication will be
deactivated entirely.
14.01.2014 217
Part 6: Ajax Web Interface—Device and Sensor Setup | 2 Create Objects Manually
2 Add a Device
Encryption Type This setting is only visible if SNMP version v3 is enabled above.
Select an encryption type. Choose between:
§ DES: Use Data Encryption Standard (DES) as encryption
algorithm.
§ AES: Use Advanced Encryption Standard (AES) as encryption
algorithm.
The chosen type has to match the encryption type of your device.
Data Encryption Key This setting is only visible if SNMP version v3 is enabled above.
Enter an encryption key here. If you provide a key in this field,
SNMP data packets will be encrypted using the encryption
algorithm selected above, providing increased security. The
provided key here has to match the encryption key of your device.
Note: If the key entered in this field does not match the key
configured in the target SNMP device, you will not get an error
message! Please enter a string or leave the field empty.
Context Name This setting is only visible if SNMP version v3 is enabled above.
Enter a context name only if it is required by the configuration of
the device. Context is a collection of management information
accessible by an SNMP device. Please enter a string.
SNMP Port Enter the port used for SNMP communication. We recommend using
the default value.
SNMP Timeout (sec.) Enter a timeout in seconds for the request. If the reply takes longer
than this value the request is aborted and an error message is
triggered.
218 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 2 Create Objects Manually
2 Add a Device
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Click on the Cont inue button to store your settings. If you change tabs or use the main menu,
all changes to the settings will be lost!
14.01.2014 219
Part 6: Ajax Web Interface—Device and Sensor Setup | 2 Create Objects Manually
3 Add a Sensor
Note: This documentation refers to the PRTG Sy st em Administ rat or user accessing the Ajax
interface on a master node. For other user accounts, interfaces, or nodes, not all of the
options might be available as described. When using a cluster installation, failover nodes are
read-only by default.
In order to add a sensor manually, select Sensors | Add Sensor from the main menu. An
assistant will appear, leading you through two steps. For faster setup, you can select Add
Sensor... in the context menu 163 of a device to which you want to add the new sensor. This
will skip step 1 and lead you directly to step 2.
§ St ep 1
Please select Add sensor t o an exist ing device and choose a device you want to add the
new sensor to. Click on Cont inue.
220 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 2 Create Objects Manually
3 Add a Sensor
§ St ep 2
The Add Sensor assistant is shown (see screenshot above). Select a sensor you want to
add and enter the needed settings. You can filter the listed sensors by type, by target
system, and by the used technology. You can choose one aspect per filter. Alternatively or
additionally, you can use the live search by typing in a key term (or a substring) in the Search
box. PRTG also suggests sensor types to create on the selected device; this
recommendation is automatically calculated based on the current user's sensor usage and
shows the ten commonest sensor types by default (if enough sensor types are already in
use). The chosen filter also applies to the recommendation. See section More if you want to
adjust the number of most used sensor types which are shown here or to hide this option
completely.
For more information about a sensor type, please see the manual section of the respective
sensor. See List of Available Sensor Ty pes 291 section to find detailed information about
every sensor type.
More
Knowledge Base: How can I change the number of entries in most used sensor types?
§ http://kb.paessler.com/en/topic/59788
28.05.2014 221
Part 6: Ajax Web Interface—Device and Sensor Setup | 3 Manage Device Tree
In order to arrange objects in the tree, you have the following options:
Drag&Drop a Sensor
You can either move a sensor within the same device, or clone a sensor to another device.
§ Within the same device, drag any sensor and drop it to the place where you want to have it.
A shade will show the future position. When dropping, the sensor will be moved to this
position and existing sensors will be lined up after it. This is a very easy way to reposition
your sensors.
§ Drag any sensor from one device and drop it on another to clone a sensor. This will create
the same sensor type, with the same settings, on the new device, while maintaining the
original sensor. A shade will show the future position. Note: Cloned sensors are put to
Pause status initially to give you the chance to change any settings before monitoring
begins. Please check the settings 142 and resume 162 monitoring.
Note: You cannot clone 'fixed' objects, such as the root group or a probe device. You cannot
clone the sensor types QoS (Qualit y of Service) One Way Sensor 820 and QoS (Qualit y of
Service) Round Trip Sensor 826 .
Note: In order to clone entire groups or devices, please use the Clone Object 1734 functionality
accessible via the objects' Context Menu 163 .
§ Within the same probe or group, drag any group or device and move it up or down in the
device tree. A small red arrow will appear, showing the future position. When dropping, the
group or device will be moved to this position and existing probes, groups, and devices will
be lined up underneath. This is a very easy way to reposition your groups or devices.
§ Drag any group or device from one probe or group and drop it on another probe or group.
A small red arrow will appear, showing the future position. When dropping, the group or
device will be moved to the new probe or group. Existing groups and devices will be lined
up underneath. This is a very easy way to change the probe a group or device is part of, or
to add groups or devices to other groups.
222 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 3 Manage Device Tree
§ Hold down the Ctrl key and select multiple groups, devices, or sensors (one of a kind).
§ In the appearing dialog, select the settings you would like to edit, change the according
values and click on Save. The changes will be applied to all selected objects.
The dialog is the same as described in the Mult i-Edit 1738 (Edit Settings) section.
Related Topics
14.01.2014 223
Part 6: Ajax Web Interface—Device and Sensor Setup | 4 Root Group Settings
The Root group is the highest instance in the object hierarchy of your PRTG setup and parent
to all other objects. Therefore, all objects inherit settings from the Root group. If you define
important settings on this high level, work will be easier later on. So, before you create your
own sensors, it is a good idea to review the Root group's settings to ensure they suit your
network. There are already reasonable presets made with installation.
Note: If necessary, you can override every setting for every single child object later. To do so,
simply disable the respective Inherit option of an object.
The following settings are available in the Set t ings tab. As you may not need all of these, just
regard those settings you really need, ignoring the others. All settings you define here can
easily be inherited to all other objects in your setup.
Note: This documentation refers to the PRTG Sy st em Administ rat or user accessing the Ajax
interface on a master node. For other user accounts, interfaces, or nodes, not all of the
options might be available as described. When using a cluster installation, failover nodes are
read-only by default.
Group Name Enter a meaningful name to identify the group. The name will be
shown by default in the devices tree and in all alarms.
224 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 4 Root Group Settings
Locat ion
Location (for geo When using geo maps using Google's API 1744 please enter a location
maps) in the first line. Objects will then be displayed on a geographical
map with a flag, showing the current status using a color code
similar to the sensor status icons 121 (green - yellow - orange - red).
You can enter a full postal address, city and country only, or
latitude and longitude. It is possible to enter any text before,
between, and after the coordinates, PRTG will parse latitude and
longitude automatically; for example: 49.452778 11.077778 or
enter 49.452778 any 11.077778 text
A minus sign (-) in the first line will hide an object from geo maps. In
this case you can enter location information in line two and
following.
You can define a specific label for each location: enter a string
denoting the label in the first line and provide geo coordinates in
the second line. This object will be displayed then with the label in
PRTG's geo map.
Domain or Computer Define the authority for Windows access. This is used for Windows
Name Management Instrumentation (WMI) and other Windows sensors. If
you want to use a Windows local user account on the target
device, please enter the computer name here. If you want to use a
Windows domain user account (recommended), please enter the
(Active Directory) domain name here. If not explicitly defined, PRTG
will automatically add a prefix in order to use the NT LAN Manager
(NTLM) protocol. Please do not leave this field empty.
Username Enter the username for Windows access. Usually, you will use
credentials with administrator privileges.
Password Enter the password for Windows access. Usually, you will use
credentials with administrator privileges.
Username Enter a login name for the access via SSH and WBEM. Usually, you
will use credentials with administrator privileges.
Login Define which authentication method will be used for login. Choose
between:
§ Login via Password: Provide a password for login. Enter below.
14.01.2014 225
Part 6: Ajax Web Interface—Device and Sensor Setup | 4 Root Group Settings
Password This field is only visible if password login is selected above. Enter a
password for the Linux access via SSH and WBEM. Usually, you will
use credentials with administrator privileges.
Private Key This field is only visible if private key login is selected above. Paste
a private key into the field (OpenSSH format, unencrypted). Usually,
you will use credentials with administrator privileges. Note: If you
do not insert a private key for the first time, but change the private
key, you need to restart your PRTG core server service in order for
the private key change to take effect! For details, please see
Monit oring via SSH 1962 .
For WBEM Use Protocol Define the protocol that will be used for WBEM. This setting is only
relevant when using WBEM sensors. Choose between:
§ HTTP: Use an unencrypted connection for WBEM.
§ HTTPS: Use an SSL-encrypted connection for WBEM.
For WBEM Use Port Define the port that will be used for WBEM. This setting is only
relevant when using WBEM sensors. Choose between:
§ Set aut omat ically (port 5988 or 5989): Use one of the
standard ports, depending on whether unencrypted or encrypted
connection is chosen above.
§ Set manually : Use a custom port. Define below.
WBEM Port This setting is only visible if manual port selection is enabled above.
Enter the WBEM port number.
SSH Port Define the port number which will be used for SSH connections.
Note: By default, this setting is automatically used for all SSH
sensors 296 , unless you define a different port number in the sensor
settings.
SSH Rights Elevation Define with which rights the command will be executed on the
target system. Choose between:
§ Run t he command as t he user connect ing (default ): Use the
rights of the user who establishes the SSH connection.
226 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 4 Root Group Settings
§ Run t he command as anot her user using 'sudo': Use the rights
of another user, for example, the administrator.
§ Run t he command as anot her user using 'su': Use the rights of
another target user.
Target Username This field is only visible if sudo or su is enabled above. Enter a
username to run the specified command as another user than root.
If you leave this field empty, the command will be run as root.
Ensure that you set the Linux password even you use a public/
private key for authentication. This is not necessary if the user is
allowed to execute the command without a password.
Password Target User This field is only visible if su is enabled above. Enter the password
for the specified target user.
User Enter a login name for access to VMware and XEN servers. Usually,
you will use credentials with administrator privileges.
Password Enter a password for access to VMware and XEN servers. Usually,
you will use credentials with administrator privileges.
VMware Protocol Define the protocol used for the connection to VMware and
XenServer. Choose between:
§ HTTPS (recommended): Use an SSL-encrypted connection to
VMware and XenServers.
§ HTTP: Use an unencrypted connection to VMware and
XenServers.
SNMP Version Select the SNMP version that will be used for device connection.
Choose between:
§ v1: Use the simple standard v1 protocol for SNMP connections.
This protocol only offers clear-text data transmission, but it is
usually supported by all devices.
§ v2c: Use the more advanced v2c protocol for SNMP connections.
Data is still transferred as clear-text, but it supports 64-bit
counters.
§ v3: Use the latest v3 protocol for SNMP connections. It provides
secure authentication and data encryption.
14.01.2014 227
Part 6: Ajax Web Interface—Device and Sensor Setup | 4 Root Group Settings
Note for SNMP v3: Due to internal limitations you can only monitor
a limited number of sensors per second using SNMP v3. The limit is
somewhere between 1 and 50 sensors per second (depending on
the SNMP latency of your network). This means that using an
interval of 60 seconds you are limited to between 60 and 3000
SNMP v3 sensors for each probe. If you experience an increased
"Interval Delay" or "Open Requests" reading of the probe health
sensor, you need to distribute the load over multiple probes. SNMP
v1 and v2 do not have this limitation.
Community String This setting is only visible if SNMP version v1 or v2c are enabled
above. Enter the community string of your devices. This is a kind of
"clear-text password" used for simple authentication. We
recommend using the default value.
Authentication Type This setting is only visible if SNMP version v3 is enabled above.
Choose between:
§ MD5: Use Message-Digest Algorithm 5 (MD5) for authentication.
§ SHA: Use Secure Hash Algorithm (SHA) for authentication.
The chosen type has to match the authentication type of your
device.
Note: If you do not want to use authentication, but you need SNMP
v3, for example, because your device requires context, you can
leave the field password empty. In this case,
SNMP_SEC_LEVEL_NOAUTH will be used and authentication will be
deactivated entirely.
Encryption Type This setting is only visible if SNMP version v3 is enabled above.
Select an encryption type. Choose between:
§ DES: Use Data Encryption Standard (DES) as encryption
algorithm.
§ AES: Use Advanced Encryption Standard (AES) as encryption
algorithm.
The chosen type has to match the encryption type of your device.
228 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 4 Root Group Settings
Data Encryption Key This setting is only visible if SNMP version v3 is enabled above.
Enter an encryption key here. If you provide a key in this field,
SNMP data packets will be encrypted using the encryption
algorithm selected above, providing increased security. The
provided key here has to match the encryption key of your device.
Note: If the key entered in this field does not match the key
configured in the target SNMP device, you will not get an error
message! Please enter a string or leave the field empty.
Context Name This setting is only visible if SNMP version v3 is enabled above.
Enter a context name only if it is required by the configuration of
the device. Context is a collection of management information
accessible by an SNMP device. Please enter a string.
SNMP Port Enter the port used for SNMP communication. We recommend using
the default value.
SNMP Timeout (sec.) Enter a timeout in seconds for the request. If the reply takes longer
than this value the request is aborted and an error message is
triggered.
When experiencing problems while monitoring via Windows sensors, you can set some
compatibility options for trouble shooting.
Preferred Data Source Define the method Windows sensors will use to query data. This
setting is valid only for hybrid sensors offering performance
counter and Windows Management Instrumentation (WMI)
technology. The setting will be ignored for all other sensors!
Choose between:
§ Performance Count ers and fallback t o WMI (recommended):
Try to query data via performance counters. If this is not possible,
establish a connection via WMI. This is the recommended setting
to best balance resource usage and functionality.
§ Performance Count ers only : Query data via performance
counters only. If this is not possible, a sensor will return no data.
§ WMI only : Query data via WMI only. If this is not possible, a
sensor will return no data.
Timeout Method Specify the time the sensor will wait for the return of its WMI query
before aborting it with an error message. Choose between:
14.01.2014 229
Part 6: Ajax Web Interface—Device and Sensor Setup | 4 Root Group Settings
Timeout Value (Sec.) This field is only visible if the manual timeout method is selected
above. Specify the time the sensor will wait for the return of its
WMI query before aborting with an error message. Please enter an
integer value.
When experiencing problems while monitoring via Simple Network Management Protocol
(SNMP) sensors, you can set some compatibility options for trouble shooting.
SNMP Delay (ms) Add a time in milliseconds that will be waited between two SNMP
requests. This can help increase device compatibility. Please enter
an integer value. We recommend using the default value. If you
experience SNMP connection failures, please increase it. You can
define a delay between 0 and 100, higher delays are not supported
and will be discarded.
Failed Requests Define if an SNMP sensor will try again after a request fails.
§ Ret ry (recommended): Try again if an SNMP request fails. This
can help prevent false error messages due to temporary timeout
failures.
§ Do not ret ry : Do not retry if an SNMP request fails. With this
setting enabled an SNMP sensor will be set to error status earlier.
Overflow Values Define how PRTG will handle overflow values. Some devices do not
handle internal buffer overflows correctly. This can cause false
peaks.
§ Ignore overflow values (recommended): Ignore overflow
values and do not include them in the monitoring data.
§ Handle overflow values as valid result s: Regard all overflow
values as regular data and include them in the monitoring data.
We recommend using the default value. If you experience problems,
change this option.
Zero Values Define how PRTG will handle zero values. Some devices send
incorrect zero values. This can cause false peaks.
230 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 4 Root Group Settings
32-bit/64-bit Counters Define which kind of traffic counters PRTG will search for on a
device.
§ Use 64-bit count ers if available (recommended): The interface
scan will use 64-bit traffic counters, if available. This can avoid
buffer overflows in the devices.
§ Use 32-bit count ers only : The interface scan will always use 32-
bit traffic counters, even if 64-bit counters are available. This can
lead to more reliable monitoring for some devices.
We recommend using the default value. If you experience problems,
change this option.
Request Mode Define which kind of request method PRTG uses for SNMP sensors.
§ Use mult i get (recommended): Bundle multiple SNMP requests
into one request.
§ Use single get : Use one request for each SNMP value. This can
increase compatibility with older devices.
We recommend using the default value. If you experience problems,
change this option.
Port Name Template Define how the name of SNMP sensors created on a device will be
put together. Enter a template using several variables. When adding
new sensors, PRTG scans the interface for available counters at
certain OIDs. At each OID usually several fields are available with
interface descriptions. They are different for every device/OID.
PRTG will use the information in these fields to name the sensors. If
a field is empty or not available, an empty string is added to the
name. As default, ([port ]) [ifalias] is set as port name template,
which will create a name such as (001) Ethernet1, for example. You
can use any field names available at a certain OID of your device,
among which are:
§ [port ]: The port number of the monitored interface.
§ [ifalias]: The 'alias' name for the monitored interface as specified
by a network manager, providing a non-volatile handling.
§ [ifname]: The textual name of the monitored interface as
assigned by the local device.
14.01.2014 231
Part 6: Ajax Web Interface—Device and Sensor Setup | 4 Root Group Settings
Port Name Update Define how PRTG will react if you change port names in your
physical device (e.g. a switch or router). Choose between:
§ Keep port names (use t his if y ou edit t he names in PRTG): Do
not automatically adjust sensor names. This is the best option if
you want to change names in PRTG manually.
§ Aut omat ic sensor name updat e if name changes in device: If
PRTG detects changes of port names in your physical device, it
will try to automatically adjust sensor names accordingly. For
detailed information please see More section below.
Port Identification Define which field will be used for SNMP interface identification.
Choose between:
§ Aut omat ic (recommended): Tries the ifAlias field first to identify
an SNMP interface and then ifDescr. Note: ifName will not be tried
automatically.
§ Use ifAlias: For most devices ifAlias is the best field to get
unique interface names.
§ Use ifDescr: Use this option if the port order of your device
changes after a reboot, and there is no ifAlias field available. For
example, this is the best option for Cisco ASA devices. Note:
When using this option it is important that your device returns
unique interface names in the ifDescr field.
§ Use ifName: You can also use this option if there is no unique
ifAlias available. Note: When using this option it is important that
your device returns unique interface names in the ifName field.
§ No Port Updat e: Use this option to disable automatic port
identification.
Start Port For SNMP Traffic sensors, define at which port number PRTG will
start to create sensors. Use 0 for automatic. We recommend using
the default value.
232 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 4 Root Group Settings
End Port For SNMP Traffic sensors, define at which port number PRTG will
stop to create sensors. Use 0 for automatic. We recommend using
the default value.
SNMP Debug Log Define if you want to create an SNMP log file for debugging
purposes. This is only recommended for debugging low level SNMP
issues. Choose between:
§ No log (recommended): No SNMP debug log file will be created.
§ Enable debug log: An SNMP log file is written to the Logs
(Debug) directory (on the Master node, if in a cluster). This is for
debugging purposes. The file will be overridden with each
scanning interval. For information on how to find the folder used
for storage, please see Dat a St orage 2074 section.
HTTP Proxy Settings The proxy settings determine how a sensor connects to a given
URL. You can enter data for a proxy server that will be used when
connecting via HTTP or HTTPS. Note: This setting is valid for the
monitoring only and determines the behavior of sensors. In order
to change proxy settings for the core server, please see Sy st em
Administ rat ion—Core & Probes 1849 .
Name Enter the IP address or DNS name of the proxy server to use. If you
leave this field empty, no proxy will be used.
Port Enter the port number of the proxy. Often, port 8080 is used.
Please enter an integer value.
User If the proxy requires authentication, enter the username for the
proxy login. Note: Only basic authentication is available! Please
enter a string or leave the field empty.
Password If the proxy requires authentication, enter the password for the
proxy login. Note: Only basic authentication is available! Please
enter a string or leave the field empty.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
14.01.2014 233
Part 6: Ajax Web Interface—Device and Sensor Setup | 4 Root Group Settings
Schedule Select a schedule from the list. Schedules can be used to pause
monitoring for a certain time span (days, hours) throughout the
week. You can create new schedules and edit existing ones in the
account settings 1817 . Note: Schedules are generally inherited. New
schedules will be added to existing ones, so all schedules are
active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency settings are available only in Probe Settings 238 , Group Settings 253 , Device
Settings 272 , and Sensor Settings 290 .
234 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 4 Root Group Settings
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
14.01.2014 235
Part 6: Ajax Web Interface—Device and Sensor Setup | 4 Root Group Settings
Unusual Detection Define if unusual detection is enabled for sensors. You can
configure the behavior of unusual detection (or disable it
completely) in the system settings 1839 .
§ Enabled: Enable unusual detection for this group. Sensors in this
group will turn to orange color if unusual activity is detected.
§ Disabled: Disable unusual detection for this group. Unusual
values will be ignored for sensors in this group; they will not
show an unusual sensor status.
Similar Sensors Define if similar sensors detection is enabled for sensors. You can
Detection configure the depth of analysis of similar sensors detection (or
disable it completely) in the system settings 1840 .
§ Enabled: Enable similar sensors detection for this group.
Sensors in this group will be considered during similarity analysis.
§ Disabled: Disable similar detection for this group. Sensors in this
group will not be taken into account during similarity analysis.
Click on the Save button to store your settings. If you change tabs or use the main menu, all
changes to the settings will be lost!
Notifications
The status or the data of a sensor can trigger notifications. Using this mechanism, you can
configure external alerting tailored to you needs. In an object's detail page, click on the
Not ificat ions tab to change sensor notification triggers. The defined triggers will be inherited
down to sensor level. For detailed information, please see Sensor Not ificat ions Set t ings 1716
section.
Others
For more general information about settings, please see Object Set t ings 142 section.
More
Knowledge Base: How does PRTG compute CPU Index, Traffic Index and Response Time Index?
§ http://kb.paessler.com/en/topic/313
Knowledge Base: How can I add my own device icons for use in the PRTG web interface?
§ http://kb.paessler.com/en/topic/7313
Knowledge Base: How can I change the defaults for names automatically generated for new
SNMP sensors?
236 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 4 Root Group Settings
§ http://kb.paessler.com/en/topic/7363
Knowledge Base: Automatically update port name and number for SNMP Traffic sensors when
the device changes them
§ http://kb.paessler.com/en/topic/25893
14.01.2014 237
Part 6: Ajax Web Interface—Device and Sensor Setup | 5 Probe Settings
You can add additional remote probes to your setup to extend you monitoring to networks
that are not directly reachable by your PRTG core installation or cluster.
Probe Settings
The following settings are available in the Set t ings tab of every probe. As you may not need
all of these for every probe, just regard those settings you really need, ignoring the others.
We recommend defining as many settings as possible in the Root 224 group, so you can inherit
them to all other objects further down in the tree hierarchy.
Note: This documentation refers to the PRTG Sy st em Administ rat or user accessing the Ajax
interface on a master node. For other user accounts, interfaces, or nodes, not all of the
options might be available as described. When using a cluster installation, failover nodes are
read-only by default.
Probe Name Enter a meaningful name to identify the probe. The name will be
shown by default in the devices tree and in all alarms.
Tags Enter one or more tags; confirm each tag by hitting space, comma,
or enter key. You can use tags to group objects and use tag-
filtered views later on. Tags are not case sensitive.
Priority Select a priority for the probe. This setting determines where the
probe will be placed in list views. Top priority will be at the top of a
list. You can choose from one star (low priority) to five stars (top
priority).
238 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 5 Probe Settings
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Locat ion
Location (for geo When using geo maps using Google's API 1744 please enter a location
maps) in the first line. Objects will then be displayed on a geographical
map with a flag, showing the current status using a color code
similar to the sensor status icons 121 (green - yellow - orange - red).
You can enter a full postal address, city and country only, or
latitude and longitude. It is possible to enter any text before,
between, and after the coordinates, PRTG will parse latitude and
longitude automatically; for example: 49.452778 11.077778 or
enter 49.452778 any 11.077778 text
A minus sign (-) in the first line will hide an object from geo maps. In
this case you can enter location information in line two and
following.
You can define a specific label for each location: enter a string
denoting the label in the first line and provide geo coordinates in
the second line. This object will be displayed then with the label in
PRTG's geo map.
Domain or Computer Define the authority for Windows access. This is used for Windows
Name Management Instrumentation (WMI) and other Windows sensors. If
you want to use a Windows local user account on the target
device, please enter the computer name here. If you want to use a
Windows domain user account (recommended), please enter the
(Active Directory) domain name here. If not explicitly defined, PRTG
will automatically add a prefix in order to use the NT LAN Manager
(NTLM) protocol. Please do not leave this field empty.
Username Enter the username for Windows access. Usually, you will use
credentials with administrator privileges.
Password Enter the password for Windows access. Usually, you will use
credentials with administrator privileges.
14.01.2014 239
Part 6: Ajax Web Interface—Device and Sensor Setup | 5 Probe Settings
Username Enter a login name for the access via SSH and WBEM. Usually, you
will use credentials with administrator privileges.
Login Define which authentication method will be used for login. Choose
between:
§ Login via Password: Provide a password for login. Enter below.
§ Login via Privat e Key : Provide a private key for authentication.
Note: PRTG can only handle keys in OpenSSH format which are
not encrypted. You cannot use password protected keys here. In
the text field, please paste the entire private key, including the
"BEGIN" and "END" lines. Please make sure the according public
key is provided on the target machine. For details, please see
Monit oring via SSH 1962 .
Password This field is only visible if password login is selected above. Enter a
password for the Linux access via SSH and WBEM. Usually, you will
use credentials with administrator privileges.
Private Key This field is only visible if private key login is selected above. Paste
a private key into the field (OpenSSH format, unencrypted). Usually,
you will use credentials with administrator privileges. Note: If you
do not insert a private key for the first time, but change the private
key, you need to restart your PRTG core server service in order for
the private key change to take effect! For details, please see
Monit oring via SSH 1962 .
For WBEM Use Protocol Define the protocol that will be used for WBEM. This setting is only
relevant when using WBEM sensors. Choose between:
§ HTTP: Use an unencrypted connection for WBEM.
§ HTTPS: Use an SSL-encrypted connection for WBEM.
For WBEM Use Port Define the port that will be used for WBEM. This setting is only
relevant when using WBEM sensors. Choose between:
§ Set aut omat ically (port 5988 or 5989): Use one of the
standard ports, depending on whether unencrypted or encrypted
connection is chosen above.
§ Set manually : Use a custom port. Define below.
WBEM Port This setting is only visible if manual port selection is enabled above.
Enter the WBEM port number.
SSH Port Define the port number which will be used for SSH connections.
Note: By default, this setting is automatically used for all SSH
sensors 296 , unless you define a different port number in the sensor
settings.
240 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 5 Probe Settings
SSH Rights Elevation Define with which rights the command will be executed on the
target system. Choose between:
§ Run t he command as t he user connect ing (default ): Use the
rights of the user who establishes the SSH connection.
§ Run t he command as anot her user using 'sudo': Use the rights
of another user, for example, the administrator.
§ Run t he command as anot her user using 'su': Use the rights of
another target user.
Target Username This field is only visible if sudo or su is enabled above. Enter a
username to run the specified command as another user than root.
If you leave this field empty, the command will be run as root.
Ensure that you set the Linux password even you use a public/
private key for authentication. This is not necessary if the user is
allowed to execute the command without a password.
Password Target User This field is only visible if su is enabled above. Enter the password
for the specified target user.
User Enter a login name for access to VMware and XEN servers. Usually,
you will use credentials with administrator privileges.
Password Enter a password for access to VMware and XEN servers. Usually,
you will use credentials with administrator privileges.
VMware Protocol Define the protocol used for the connection to VMware and
XenServer. Choose between:
§ HTTPS (recommended): Use an SSL-encrypted connection to
VMware and XenServers.
§ HTTP: Use an unencrypted connection to VMware and
XenServers.
SNMP Version Select the SNMP version that will be used for device connection.
Choose between:
§ v1: Use the simple standard v1 protocol for SNMP connections.
This protocol only offers clear-text data transmission, but it is
usually supported by all devices.
14.01.2014 241
Part 6: Ajax Web Interface—Device and Sensor Setup | 5 Probe Settings
§ v2c: Use the more advanced v2c protocol for SNMP connections.
Data is still transferred as clear-text, but it supports 64-bit
counters.
§ v3: Use the latest v3 protocol for SNMP connections. It provides
secure authentication and data encryption.
Note for SNMP v3: Due to internal limitations you can only monitor
a limited number of sensors per second using SNMP v3. The limit is
somewhere between 1 and 50 sensors per second (depending on
the SNMP latency of your network). This means that using an
interval of 60 seconds you are limited to between 60 and 3000
SNMP v3 sensors for each probe. If you experience an increased
"Interval Delay" or "Open Requests" reading of the probe health
sensor, you need to distribute the load over multiple probes. SNMP
v1 and v2 do not have this limitation.
Community String This setting is only visible if SNMP version v1 or v2c are enabled
above. Enter the community string of your devices. This is a kind of
"clear-text password" used for simple authentication. We
recommend using the default value.
Authentication Type This setting is only visible if SNMP version v3 is enabled above.
Choose between:
§ MD5: Use Message-Digest Algorithm 5 (MD5) for authentication.
§ SHA: Use Secure Hash Algorithm (SHA) for authentication.
The chosen type has to match the authentication type of your
device.
Note: If you do not want to use authentication, but you need SNMP
v3, for example, because your device requires context, you can
leave the field password empty. In this case,
SNMP_SEC_LEVEL_NOAUTH will be used and authentication will be
deactivated entirely.
Encryption Type This setting is only visible if SNMP version v3 is enabled above.
Select an encryption type. Choose between:
§ DES: Use Data Encryption Standard (DES) as encryption
algorithm.
242 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 5 Probe Settings
Data Encryption Key This setting is only visible if SNMP version v3 is enabled above.
Enter an encryption key here. If you provide a key in this field,
SNMP data packets will be encrypted using the encryption
algorithm selected above, providing increased security. The
provided key here has to match the encryption key of your device.
Note: If the key entered in this field does not match the key
configured in the target SNMP device, you will not get an error
message! Please enter a string or leave the field empty.
Context Name This setting is only visible if SNMP version v3 is enabled above.
Enter a context name only if it is required by the configuration of
the device. Context is a collection of management information
accessible by an SNMP device. Please enter a string.
SNMP Port Enter the port used for SNMP communication. We recommend using
the default value.
SNMP Timeout (sec.) Enter a timeout in seconds for the request. If the reply takes longer
than this value the request is aborted and an error message is
triggered.
When experiencing problems while monitoring via Windows sensors, you can set some
compatibility options for trouble shooting.
Preferred Data Source Define the method Windows sensors will use to query data. This
setting is valid only for hybrid sensors offering performance
counter and Windows Management Instrumentation (WMI)
technology. The setting will be ignored for all other sensors!
Choose between:
§ Performance Count ers and fallback t o WMI (recommended):
Try to query data via performance counters. If this is not possible,
establish a connection via WMI. This is the recommended setting
to best balance resource usage and functionality.
§ Performance Count ers only : Query data via performance
counters only. If this is not possible, a sensor will return no data.
§ WMI only : Query data via WMI only. If this is not possible, a
sensor will return no data.
14.01.2014 243
Part 6: Ajax Web Interface—Device and Sensor Setup | 5 Probe Settings
Timeout Method Specify the time the sensor will wait for the return of its WMI query
before aborting it with an error message. Choose between:
§ Use 1.5x scanning int erval (recommended): Use a default of
one and a half times the scanning interval set for the sensor (see
below in this settings).
§ Set manually : Enter a timeout value manually.
We recommend using the default value. Only if you experience
ongoing timeout errors, try increasing the timeout value.
Timeout Value (Sec.) This field is only visible if the manual timeout method is selected
above. Specify the time the sensor will wait for the return of its
WMI query before aborting with an error message. Please enter an
integer value.
When experiencing problems while monitoring via Simple Network Management Protocol
(SNMP) sensors, you can set some compatibility options for trouble shooting.
SNMP Delay (ms) Add a time in milliseconds that will be waited between two SNMP
requests. This can help increase device compatibility. Please enter
an integer value. We recommend using the default value. If you
experience SNMP connection failures, please increase it. You can
define a delay between 0 and 100, higher delays are not supported
and will be discarded.
Failed Requests Define if an SNMP sensor will try again after a request fails.
§ Ret ry (recommended): Try again if an SNMP request fails. This
can help prevent false error messages due to temporary timeout
failures.
§ Do not ret ry : Do not retry if an SNMP request fails. With this
setting enabled an SNMP sensor will be set to error status earlier.
Overflow Values Define how PRTG will handle overflow values. Some devices do not
handle internal buffer overflows correctly. This can cause false
peaks.
§ Ignore overflow values (recommended): Ignore overflow
values and do not include them in the monitoring data.
§ Handle overflow values as valid result s: Regard all overflow
values as regular data and include them in the monitoring data.
We recommend using the default value. If you experience problems,
change this option.
244 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 5 Probe Settings
Zero Values Define how PRTG will handle zero values. Some devices send
incorrect zero values. This can cause false peaks.
§ Ignore zero values for delt a sensors (recommended): Ignore
zero values and do not include them in the monitoring data.
§ Handle zero values as valid result s for delt a sensors: Regard
all zero values as regular data and include them in the monitoring
data.
We recommend using the default value. If you experience problems,
change this option.
32-bit/64-bit Counters Define which kind of traffic counters PRTG will search for on a
device.
§ Use 64-bit count ers if available (recommended): The interface
scan will use 64-bit traffic counters, if available. This can avoid
buffer overflows in the devices.
§ Use 32-bit count ers only : The interface scan will always use 32-
bit traffic counters, even if 64-bit counters are available. This can
lead to more reliable monitoring for some devices.
We recommend using the default value. If you experience problems,
change this option.
Request Mode Define which kind of request method PRTG uses for SNMP sensors.
§ Use mult i get (recommended): Bundle multiple SNMP requests
into one request.
§ Use single get : Use one request for each SNMP value. This can
increase compatibility with older devices.
We recommend using the default value. If you experience problems,
change this option.
Port Name Template Define how the name of SNMP sensors created on a device will be
put together. Enter a template using several variables. When adding
new sensors, PRTG scans the interface for available counters at
certain OIDs. At each OID usually several fields are available with
interface descriptions. They are different for every device/OID.
PRTG will use the information in these fields to name the sensors. If
a field is empty or not available, an empty string is added to the
name. As default, ([port ]) [ifalias] is set as port name template,
which will create a name such as (001) Ethernet1, for example. You
can use any field names available at a certain OID of your device,
among which are:
§ [port ]: The port number of the monitored interface.
§ [ifalias]: The 'alias' name for the monitored interface as specified
by a network manager, providing a non-volatile handling.
14.01.2014 245
Part 6: Ajax Web Interface—Device and Sensor Setup | 5 Probe Settings
Port Name Update Define how PRTG will react if you change port names in your
physical device (e.g. a switch or router). Choose between:
§ Keep port names (use t his if y ou edit t he names in PRTG): Do
not automatically adjust sensor names. This is the best option if
you want to change names in PRTG manually.
§ Aut omat ic sensor name updat e if name changes in device: If
PRTG detects changes of port names in your physical device, it
will try to automatically adjust sensor names accordingly. For
detailed information please see More section below.
Port Identification Define which field will be used for SNMP interface identification.
Choose between:
§ Aut omat ic (recommended): Tries the ifAlias field first to identify
an SNMP interface and then ifDescr. Note: ifName will not be tried
automatically.
§ Use ifAlias: For most devices ifAlias is the best field to get
unique interface names.
§ Use ifDescr: Use this option if the port order of your device
changes after a reboot, and there is no ifAlias field available. For
example, this is the best option for Cisco ASA devices. Note:
When using this option it is important that your device returns
unique interface names in the ifDescr field.
§ Use ifName: You can also use this option if there is no unique
ifAlias available. Note: When using this option it is important that
your device returns unique interface names in the ifName field.
§ No Port Updat e: Use this option to disable automatic port
identification.
246 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 5 Probe Settings
Start Port For SNMP Traffic sensors, define at which port number PRTG will
start to create sensors. Use 0 for automatic. We recommend using
the default value.
End Port For SNMP Traffic sensors, define at which port number PRTG will
stop to create sensors. Use 0 for automatic. We recommend using
the default value.
SNMP Debug Log Define if you want to create an SNMP log file for debugging
purposes. This is only recommended for debugging low level SNMP
issues. Choose between:
§ No log (recommended): No SNMP debug log file will be created.
§ Enable debug log: An SNMP log file is written to the Logs
(Debug) directory (on the Master node, if in a cluster). This is for
debugging purposes. The file will be overridden with each
scanning interval. For information on how to find the folder used
for storage, please see Dat a St orage 2074 section.
HTTP Proxy Settings The proxy settings determine how a sensor connects to a given
URL. You can enter data for a proxy server that will be used when
connecting via HTTP or HTTPS. Note: This setting is valid for the
monitoring only and determines the behavior of sensors. In order
to change proxy settings for the core server, please see Sy st em
Administ rat ion—Core & Probes 1849 .
Name Enter the IP address or DNS name of the proxy server to use. If you
leave this field empty, no proxy will be used.
Port Enter the port number of the proxy. Often, port 8080 is used.
Please enter an integer value.
User If the proxy requires authentication, enter the username for the
proxy login. Note: Only basic authentication is available! Please
enter a string or leave the field empty.
Password If the proxy requires authentication, enter the password for the
proxy login. Note: Only basic authentication is available! Please
enter a string or leave the field empty.
14.01.2014 247
Part 6: Ajax Web Interface—Device and Sensor Setup | 5 Probe Settings
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Clust er Usage
Scanning Distribution This box is only visible if you're running a PRTG cluster. Sometimes
you want to exclude a certain node from monitoring the sensors
running on this probe, group, or device, for example, if a device is
not reachable from every node configured in your cluster. In the list
of cluster nodes, please select the nodes that will not be included
in sensor scans. By default, this setting is inherited 87 to all objects
underneath.
Schedule Select a schedule from the list. Schedules can be used to pause
monitoring for a certain time span (days, hours) throughout the
week. You can create new schedules and edit existing ones in the
account settings 1817 . Note: Schedules are generally inherited. New
schedules will be added to existing ones, so all schedules are
active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance Ends At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
248 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 5 Probe Settings
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current object will be dependent
on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds.
14.01.2014 249
Part 6: Ajax Web Interface—Device and Sensor Setup | 5 Probe Settings
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
250 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 5 Probe Settings
Unusual Detection Define if unusual detection is enabled for sensors. You can
configure the behavior of unusual detection (or disable it
completely) in the system settings 1839 .
§ Enabled: Enable unusual detection for this group. Sensors in this
group will turn to orange color if unusual activity is detected.
§ Disabled: Disable unusual detection for this group. Unusual
values will be ignored for sensors in this group; they will not
show an unusual sensor status.
Similar Sensors Define if similar sensors detection is enabled for sensors. You can
Detection configure the depth of analysis of similar sensors detection (or
disable it completely) in the system settings 1840 .
§ Enabled: Enable similar sensors detection for this group.
Sensors in this group will be considered during similarity analysis.
§ Disabled: Disable similar detection for this group. Sensors in this
group will not be taken into account during similarity analysis.
Click on the Save button to store your settings. If you change tabs or use the main menu, all
changes to the settings will be lost!
Notifications
The status or the data of a sensor can trigger notifications. Using this mechanism, you can
configure external alerting tailored to you needs. In an object's detail page, click on the
Not ificat ions tab to change sensor notification triggers. The defined triggers will be inherited
down to sensor level. For detailed information, please see Sensor Not ificat ions Set t ings 1716
section.
Others
For more general information about settings, please see Object Set t ings 142 section.
More
Knowledge Base: How does PRTG compute CPU Index, Traffic Index and Response Time Index?
§ http://kb.paessler.com/en/topic/313
Knowledge Base: How can I add my own device icons for use in the PRTG web interface?
§ http://kb.paessler.com/en/topic/7313
Knowledge Base: How can I change the defaults for names automatically generated for new
SNMP sensors?
14.01.2014 251
Part 6: Ajax Web Interface—Device and Sensor Setup | 5 Probe Settings
§ http://kb.paessler.com/en/topic/7363
Knowledge Base: Automatically update port name and number for SNMP Traffic sensors when
the device changes them
§ http://kb.paessler.com/en/topic/25893
252 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 6 Group Settings
Add Group
The Add Group dialog appears when adding a new group to a parent group. It only shows the
setting fields that are imperative for creating the group. Therefore, you will not see all setting
fields in this dialog. For example, the Group St at us option is not available in this step.
You can change all settings in the group's Set t ings tab later.
Group Settings
The following settings are available in the Set t ings tab of every group. As you may not need
all of these for every group, just regard those settings you really need, ignoring the others.
Note: This documentation does not refer to the setting of the special Root group. The
settings available there differ from those described here.
We recommend defining as many settings as possible in the Root 224 group, so you can inherit
them to all other objects further down in the tree hierarchy.
Note: This documentation refers to the PRTG Sy st em Administ rat or user accessing the Ajax
interface on a master node. For other user accounts, interfaces, or nodes, not all of the
options might be available as described. When using a cluster installation, failover nodes are
read-only by default.
Group Name Enter a meaningful name to identify the group. The name will be
shown by default in the devices tree and in all alarms.
Tags Enter one or more tags; confirm each tag by hitting space, comma,
or enter key. You can use tags to group objects and use tag-
filtered views later on. Tags are not case sensitive.
14.01.2014 253
Part 6: Ajax Web Interface—Device and Sensor Setup | 6 Group Settings
Priority Select a priority for the group. This setting determines where the
group will be placed in list views. Top priority will be at the top of a
list. You can choose from one star (low priority) to five stars (top
priority).
Group Ty pe
Sensor Management Select which type of auto-discovery you would like to perform for
this group. Choose between:
§ Manual (no aut o-discovery ): Do not auto-discover any sensors,
but only add sensors manually.
§ Aut omat ic device ident ificat ion (st andard, recommended):
Use a small set of auto-discovery templates. This will scan your
LAN and usually create a view standard sensors on your device.
§ Aut omat ic device ident ificat ion (det ailed, may creat e many
sensors: Use an extended set of auto-discovery templates. This
will scan your LAN and usually create many sensors on your
device.
§ Aut omat ic sensor creat ion using specific device t emplat es:
Use specific auto-discovery templates only. Please select
templates below. This will scan your LAN and add sensors
defined in the template.
Device Template(s) This option is only visible if using specific device templates (last
option) is enabled above. Please choose one or more templates by
adding a check mark in front of the respective template name. You
can also select and deselect all items by using the check box in the
table head. These will be used for auto-discovery on the current
device. Choose from:
§ ADSL
§ Cisco ASA VPN
§ Cisco Device (Generic)
§ Dell MDI
§ DNS Server
§ Environment Jacart a
§ Environment Poseidon
§ Frit zbox
§ FTP Server
§ Generic Device (PING only )
254 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 6 Group Settings
14.01.2014 255
Part 6: Ajax Web Interface—Device and Sensor Setup | 6 Group Settings
create new sensors. Templates which were not applied will not be
shown in the ticket.
Discovery Schedule Define when the auto-discovery will be run. Choose between:
§ Once: Perform auto-discovery only once. New devices and
sensors will be added once. You can run auto-discovery manually
any time using an object's context menu 163 .
§ Hourly : Perform auto-discovery for new devices and sensors
every 60 minutes. Note: Please use this option with caution!
Frequently executed auto-discoveries might cause performance
issues, especially when large network segments are scanned
every hour.
§ Daily : Perform auto-discovery for new devices and sensors every
24 hours. The first auto-discovery will run immediately, all other
discoveries will start on the time defined in the Aut o-Discovery
Set t ings section of the Sy st em Administ rat ion—Monit oring
1841 settings.
IP Selection Method Define how you want to define the IP range for auto-discovery.
Choose between:
§ Class C base IP wit h st art /end (IPv4): Define an IPv4 class C
address range.
§ List of individual IPs and DNS names (IPv4): Enter a list of
individual IPv4 addresses or DNS names.
§ IP and Subnet (IPv4): Enter an IPv4 address and subnet mask.
§ IP wit h oct et range (IPv4): Enter an IPv4 address range for every
IP octet individually. With this, you can define very customizable IP
ranges.
§ List of individual IPs and DNS names (IPv6): Enter a list of
individual IPv6 addresses or DNS names.
§ Use comput ers from t he act ive direct ory (maximum 1000
comput ers): Search in the active directory for computers to
perform auto-discovery.
Note: Only subnets with up to 65,536 IP addresses can be
discovered! If you define a range with a higher number of
addresses, discovery will stop before it is completed.
256 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 6 Group Settings
IPv4 Base This field is only visible if Class C network detection is selected
above. Enter a class C network as IP base for the auto-discovery.
Enter the first three octets of an IPv4 IP address, for example,
192.168.0
IPv4 Range Start This field is only visible if Class C network detection is selected
above. Enter the IP octet of the class C network specified above
from which PRTG will start the auto-discovery. This will complete
the IP base above to an IPv4 address. For example, enter 1 to
discover from 192.168.0.1.
IPv4 Range End This field is only visible if Class C network detection is selected
above. Enter the IP octet of the class C network specified above at
which PRTG will stop the auto-discovery. This will complete the IP
base above to an IPv4 address. For example, enter 254 to discover
up to 192.168.0.254.
IPv4/DNS Name List This field is only visible if the IP list option is selected above. Enter a
IPv6/DNS Name List list of IP addresses or DNS names which the auto-discovery will
scan. Enter each address in a separate line.
IPv4 and Subnet (IPv4) This field is only visible if the IP and subnet option is selected
above. Enter an expression in the format address/subnet , e.g.
192.168.3.0/255.255.255.0. You can also use the short form like
192.168.3.0/24 in this example. PRTG will scan the complete host
range (without network and broadcast address) defined by the IP
address and the subnet mask.
IP with Octet Range This field is only visible if the octet range option is selected above.
Enter an expression in the format a1.a2.a3.a4, where a1, a2, a3,
and a4 are each a number between 0-255, or a range with two
numbers and a hyphen like 1-127. All permutations of all ranges are
calculated, e.g. 10.0.1-10.1-100 results in 1,000 addresses that
PRTG will scan during auto-discovery.
Organizational Unit This field is only visible if active directory is selected above. Enter
an organizational unit (OU) to restrict the active directory search to
computers which are part of this OU. Just enter the name of the OU
without any other term (i.e., without "OU" in front). If you leave this
field empty, there will not be any restriction.
If you have sub-OUs, too, please consider the correct syntax in the
format Y,OU=X : OUs that are part of another OU have to be listed
together with their parent(s). Enter the sub-OU followed by ,OU=
and the name of the parent OU. For example, assuming that the
organizational unit 'Y' is part of the OU named 'X'. Then the syntax
would be Y,OU=X. For three OUs 'X', 'Y' part of 'X', and 'Z' part of 'Y',
the syntax would be Z,OU=Y,OU=X. Note that the order is
important, sub-OUs have to be listed left of its according parents!
14.01.2014 257
Part 6: Ajax Web Interface—Device and Sensor Setup | 6 Group Settings
Name Resolution Define how newly discovered devices will be monitored. This only
affects new devices. The setting for existing devices will be kept.
Choose between:
§ Use DNS / WMI / SNMP names (recommended): Monitor newly
discovered devices via their DNS, WMI, or SNMP names (if
available).
§ Use IP addresses: Monitor newly discovered devices via their IP
address.
We recommend using the default value.
Device Rescan Define if you want to rescan known devices. Choose between:
§ Skip aut o-discovery for known devices/IPs (recommended):
Do not re-scan known devices or IP addresses, but only scan for
new devices/IPs when auto-discovering. This can avoid re-
creation of manually deleted sensors. PRTG will also avoid adding
devices that are already included elsewhere in your configuration,
e.g. in other groups.
§ Perform aut o-discovery for known devices/IPs: Re-scan
known devices and IP addresses with every auto-discovery. This
will re-create manually deleted sensors on existing devices.
We recommend using the default value.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Locat ion
Location (for geo When using geo maps using Google's API 1744 please enter a location
maps) in the first line. Objects will then be displayed on a geographical
map with a flag, showing the current status using a color code
similar to the sensor status icons 121 (green - yellow - orange - red).
You can enter a full postal address, city and country only, or
latitude and longitude. It is possible to enter any text before,
between, and after the coordinates, PRTG will parse latitude and
longitude automatically; for example: 49.452778 11.077778 or
enter 49.452778 any 11.077778 text
A minus sign (-) in the first line will hide an object from geo maps. In
this case you can enter location information in line two and
following.
258 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 6 Group Settings
Locat ion
You can define a specific label for each location: enter a string
denoting the label in the first line and provide geo coordinates in
the second line. This object will be displayed then with the label in
PRTG's geo map.
Domain or Computer Define the authority for Windows access. This is used for Windows
Name Management Instrumentation (WMI) and other Windows sensors. If
you want to use a Windows local user account on the target
device, please enter the computer name here. If you want to use a
Windows domain user account (recommended), please enter the
(Active Directory) domain name here. If not explicitly defined, PRTG
will automatically add a prefix in order to use the NT LAN Manager
(NTLM) protocol. Please do not leave this field empty.
Username Enter the username for Windows access. Usually, you will use
credentials with administrator privileges.
Password Enter the password for Windows access. Usually, you will use
credentials with administrator privileges.
Username Enter a login name for the access via SSH and WBEM. Usually, you
will use credentials with administrator privileges.
Login Define which authentication method will be used for login. Choose
between:
§ Login via Password: Provide a password for login. Enter below.
§ Login via Privat e Key : Provide a private key for authentication.
Note: PRTG can only handle keys in OpenSSH format which are
not encrypted. You cannot use password protected keys here. In
the text field, please paste the entire private key, including the
"BEGIN" and "END" lines. Please make sure the according public
key is provided on the target machine. For details, please see
Monit oring via SSH 1962 .
Password This field is only visible if password login is selected above. Enter a
password for the Linux access via SSH and WBEM. Usually, you will
use credentials with administrator privileges.
14.01.2014 259
Part 6: Ajax Web Interface—Device and Sensor Setup | 6 Group Settings
Private Key This field is only visible if private key login is selected above. Paste
a private key into the field (OpenSSH format, unencrypted). Usually,
you will use credentials with administrator privileges. Note: If you
do not insert a private key for the first time, but change the private
key, you need to restart your PRTG core server service in order for
the private key change to take effect! For details, please see
Monit oring via SSH 1962 .
For WBEM Use Protocol Define the protocol that will be used for WBEM. This setting is only
relevant when using WBEM sensors. Choose between:
§ HTTP: Use an unencrypted connection for WBEM.
§ HTTPS: Use an SSL-encrypted connection for WBEM.
For WBEM Use Port Define the port that will be used for WBEM. This setting is only
relevant when using WBEM sensors. Choose between:
§ Set aut omat ically (port 5988 or 5989): Use one of the
standard ports, depending on whether unencrypted or encrypted
connection is chosen above.
§ Set manually : Use a custom port. Define below.
WBEM Port This setting is only visible if manual port selection is enabled above.
Enter the WBEM port number.
SSH Port Define the port number which will be used for SSH connections.
Note: By default, this setting is automatically used for all SSH
sensors 296 , unless you define a different port number in the sensor
settings.
SSH Rights Elevation Define with which rights the command will be executed on the
target system. Choose between:
§ Run t he command as t he user connect ing (default ): Use the
rights of the user who establishes the SSH connection.
§ Run t he command as anot her user using 'sudo': Use the rights
of another user, for example, the administrator.
§ Run t he command as anot her user using 'su': Use the rights of
another target user.
Target Username This field is only visible if sudo or su is enabled above. Enter a
username to run the specified command as another user than root.
If you leave this field empty, the command will be run as root.
Ensure that you set the Linux password even you use a public/
private key for authentication. This is not necessary if the user is
allowed to execute the command without a password.
260 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 6 Group Settings
Password Target User This field is only visible if su is enabled above. Enter the password
for the specified target user.
User Enter a login name for access to VMware and XEN servers. Usually,
you will use credentials with administrator privileges.
Password Enter a password for access to VMware and XEN servers. Usually,
you will use credentials with administrator privileges.
VMware Protocol Define the protocol used for the connection to VMware and
XenServer. Choose between:
§ HTTPS (recommended): Use an SSL-encrypted connection to
VMware and XenServers.
§ HTTP: Use an unencrypted connection to VMware and
XenServers.
SNMP Version Select the SNMP version that will be used for device connection.
Choose between:
§ v1: Use the simple standard v1 protocol for SNMP connections.
This protocol only offers clear-text data transmission, but it is
usually supported by all devices.
§ v2c: Use the more advanced v2c protocol for SNMP connections.
Data is still transferred as clear-text, but it supports 64-bit
counters.
§ v3: Use the latest v3 protocol for SNMP connections. It provides
secure authentication and data encryption.
Note for SNMP v3: Due to internal limitations you can only monitor
a limited number of sensors per second using SNMP v3. The limit is
somewhere between 1 and 50 sensors per second (depending on
the SNMP latency of your network). This means that using an
interval of 60 seconds you are limited to between 60 and 3000
SNMP v3 sensors for each probe. If you experience an increased
"Interval Delay" or "Open Requests" reading of the probe health
sensor, you need to distribute the load over multiple probes. SNMP
v1 and v2 do not have this limitation.
14.01.2014 261
Part 6: Ajax Web Interface—Device and Sensor Setup | 6 Group Settings
Community String This setting is only visible if SNMP version v1 or v2c are enabled
above. Enter the community string of your devices. This is a kind of
"clear-text password" used for simple authentication. We
recommend using the default value.
Authentication Type This setting is only visible if SNMP version v3 is enabled above.
Choose between:
§ MD5: Use Message-Digest Algorithm 5 (MD5) for authentication.
§ SHA: Use Secure Hash Algorithm (SHA) for authentication.
The chosen type has to match the authentication type of your
device.
Note: If you do not want to use authentication, but you need SNMP
v3, for example, because your device requires context, you can
leave the field password empty. In this case,
SNMP_SEC_LEVEL_NOAUTH will be used and authentication will be
deactivated entirely.
Encryption Type This setting is only visible if SNMP version v3 is enabled above.
Select an encryption type. Choose between:
§ DES: Use Data Encryption Standard (DES) as encryption
algorithm.
§ AES: Use Advanced Encryption Standard (AES) as encryption
algorithm.
The chosen type has to match the encryption type of your device.
Data Encryption Key This setting is only visible if SNMP version v3 is enabled above.
Enter an encryption key here. If you provide a key in this field,
SNMP data packets will be encrypted using the encryption
algorithm selected above, providing increased security. The
provided key here has to match the encryption key of your device.
Note: If the key entered in this field does not match the key
configured in the target SNMP device, you will not get an error
message! Please enter a string or leave the field empty.
262 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 6 Group Settings
Context Name This setting is only visible if SNMP version v3 is enabled above.
Enter a context name only if it is required by the configuration of
the device. Context is a collection of management information
accessible by an SNMP device. Please enter a string.
SNMP Port Enter the port used for SNMP communication. We recommend using
the default value.
SNMP Timeout (sec.) Enter a timeout in seconds for the request. If the reply takes longer
than this value the request is aborted and an error message is
triggered.
When experiencing problems while monitoring via Windows sensors, you can set some
compatibility options for trouble shooting.
Preferred Data Source Define the method Windows sensors will use to query data. This
setting is valid only for hybrid sensors offering performance
counter and Windows Management Instrumentation (WMI)
technology. The setting will be ignored for all other sensors!
Choose between:
§ Performance Count ers and fallback t o WMI (recommended):
Try to query data via performance counters. If this is not possible,
establish a connection via WMI. This is the recommended setting
to best balance resource usage and functionality.
§ Performance Count ers only : Query data via performance
counters only. If this is not possible, a sensor will return no data.
§ WMI only : Query data via WMI only. If this is not possible, a
sensor will return no data.
Timeout Method Specify the time the sensor will wait for the return of its WMI query
before aborting it with an error message. Choose between:
§ Use 1.5x scanning int erval (recommended): Use a default of
one and a half times the scanning interval set for the sensor (see
below in this settings).
§ Set manually : Enter a timeout value manually.
We recommend using the default value. Only if you experience
ongoing timeout errors, try increasing the timeout value.
14.01.2014 263
Part 6: Ajax Web Interface—Device and Sensor Setup | 6 Group Settings
Timeout Value (Sec.) This field is only visible if the manual timeout method is selected
above. Specify the time the sensor will wait for the return of its
WMI query before aborting with an error message. Please enter an
integer value.
When experiencing problems while monitoring via Simple Network Management Protocol
(SNMP) sensors, you can set some compatibility options for trouble shooting.
SNMP Delay (ms) Add a time in milliseconds that will be waited between two SNMP
requests. This can help increase device compatibility. Please enter
an integer value. We recommend using the default value. If you
experience SNMP connection failures, please increase it. You can
define a delay between 0 and 100, higher delays are not supported
and will be discarded.
Failed Requests Define if an SNMP sensor will try again after a request fails.
§ Ret ry (recommended): Try again if an SNMP request fails. This
can help prevent false error messages due to temporary timeout
failures.
§ Do not ret ry : Do not retry if an SNMP request fails. With this
setting enabled an SNMP sensor will be set to error status earlier.
Overflow Values Define how PRTG will handle overflow values. Some devices do not
handle internal buffer overflows correctly. This can cause false
peaks.
§ Ignore overflow values (recommended): Ignore overflow
values and do not include them in the monitoring data.
§ Handle overflow values as valid result s: Regard all overflow
values as regular data and include them in the monitoring data.
We recommend using the default value. If you experience problems,
change this option.
Zero Values Define how PRTG will handle zero values. Some devices send
incorrect zero values. This can cause false peaks.
§ Ignore zero values for delt a sensors (recommended): Ignore
zero values and do not include them in the monitoring data.
§ Handle zero values as valid result s for delt a sensors: Regard
all zero values as regular data and include them in the monitoring
data.
We recommend using the default value. If you experience problems,
change this option.
264 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 6 Group Settings
32-bit/64-bit Counters Define which kind of traffic counters PRTG will search for on a
device.
§ Use 64-bit count ers if available (recommended): The interface
scan will use 64-bit traffic counters, if available. This can avoid
buffer overflows in the devices.
§ Use 32-bit count ers only : The interface scan will always use 32-
bit traffic counters, even if 64-bit counters are available. This can
lead to more reliable monitoring for some devices.
We recommend using the default value. If you experience problems,
change this option.
Request Mode Define which kind of request method PRTG uses for SNMP sensors.
§ Use mult i get (recommended): Bundle multiple SNMP requests
into one request.
§ Use single get : Use one request for each SNMP value. This can
increase compatibility with older devices.
We recommend using the default value. If you experience problems,
change this option.
Port Name Template Define how the name of SNMP sensors created on a device will be
put together. Enter a template using several variables. When adding
new sensors, PRTG scans the interface for available counters at
certain OIDs. At each OID usually several fields are available with
interface descriptions. They are different for every device/OID.
PRTG will use the information in these fields to name the sensors. If
a field is empty or not available, an empty string is added to the
name. As default, ([port ]) [ifalias] is set as port name template,
which will create a name such as (001) Ethernet1, for example. You
can use any field names available at a certain OID of your device,
among which are:
§ [port ]: The port number of the monitored interface.
§ [ifalias]: The 'alias' name for the monitored interface as specified
by a network manager, providing a non-volatile handling.
§ [ifname]: The textual name of the monitored interface as
assigned by the local device.
§ [ifindex]: A unique value, greater than zero, for the monitored
interface.
§ [ifdescr]: A textual string containing information about the
monitored device or interface, for example, manufacturer,
product name, version.
§ [ifspeed]: An estimate of the monitored interface's current
bandwidth (KBit/s).
14.01.2014 265
Part 6: Ajax Web Interface—Device and Sensor Setup | 6 Group Settings
Port Name Update Define how PRTG will react if you change port names in your
physical device (e.g. a switch or router). Choose between:
§ Keep port names (use t his if y ou edit t he names in PRTG): Do
not automatically adjust sensor names. This is the best option if
you want to change names in PRTG manually.
§ Aut omat ic sensor name updat e if name changes in device: If
PRTG detects changes of port names in your physical device, it
will try to automatically adjust sensor names accordingly. For
detailed information please see More section below.
Port Identification Define which field will be used for SNMP interface identification.
Choose between:
§ Aut omat ic (recommended): Tries the ifAlias field first to identify
an SNMP interface and then ifDescr. Note: ifName will not be tried
automatically.
§ Use ifAlias: For most devices ifAlias is the best field to get
unique interface names.
§ Use ifDescr: Use this option if the port order of your device
changes after a reboot, and there is no ifAlias field available. For
example, this is the best option for Cisco ASA devices. Note:
When using this option it is important that your device returns
unique interface names in the ifDescr field.
§ Use ifName: You can also use this option if there is no unique
ifAlias available. Note: When using this option it is important that
your device returns unique interface names in the ifName field.
§ No Port Updat e: Use this option to disable automatic port
identification.
Start Port For SNMP Traffic sensors, define at which port number PRTG will
start to create sensors. Use 0 for automatic. We recommend using
the default value.
End Port For SNMP Traffic sensors, define at which port number PRTG will
stop to create sensors. Use 0 for automatic. We recommend using
the default value.
SNMP Debug Log Define if you want to create an SNMP log file for debugging
purposes. This is only recommended for debugging low level SNMP
issues. Choose between:
§ No log (recommended): No SNMP debug log file will be created.
266 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 6 Group Settings
HTTP Proxy Settings The proxy settings determine how a sensor connects to a given
URL. You can enter data for a proxy server that will be used when
connecting via HTTP or HTTPS. Note: This setting is valid for the
monitoring only and determines the behavior of sensors. In order
to change proxy settings for the core server, please see Sy st em
Administ rat ion—Core & Probes 1849 .
Name Enter the IP address or DNS name of the proxy server to use. If you
leave this field empty, no proxy will be used.
Port Enter the port number of the proxy. Often, port 8080 is used.
Please enter an integer value.
User If the proxy requires authentication, enter the username for the
proxy login. Note: Only basic authentication is available! Please
enter a string or leave the field empty.
Password If the proxy requires authentication, enter the password for the
proxy login. Note: Only basic authentication is available! Please
enter a string or leave the field empty.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Clust er Usage
Scanning Distribution This box is only visible if you're running a PRTG cluster. Sometimes
you want to exclude a certain node from monitoring the sensors
running on this probe, group, or device, for example, if a device is
not reachable from every node configured in your cluster. In the list
of cluster nodes, please select the nodes that will not be included
in sensor scans. By default, this setting is inherited 87 to all objects
underneath.
14.01.2014 267
Part 6: Ajax Web Interface—Device and Sensor Setup | 6 Group Settings
Schedule Select a schedule from the list. Schedules can be used to pause
monitoring for a certain time span (days, hours) throughout the
week. You can create new schedules and edit existing ones in the
account settings 1817 . Note: Schedules are generally inherited. New
schedules will be added to existing ones, so all schedules are
active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance Ends At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
268 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 6 Group Settings
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current object will be dependent
on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds.
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
14.01.2014 269
Part 6: Ajax Web Interface—Device and Sensor Setup | 6 Group Settings
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
Unusual Detection Define if unusual detection is enabled for sensors. You can
configure the behavior of unusual detection (or disable it
completely) in the system settings 1839 .
§ Enabled: Enable unusual detection for this group. Sensors in this
group will turn to orange color if unusual activity is detected.
§ Disabled: Disable unusual detection for this group. Unusual
values will be ignored for sensors in this group; they will not
show an unusual sensor status.
Similar Sensors Define if similar sensors detection is enabled for sensors. You can
Detection configure the depth of analysis of similar sensors detection (or
disable it completely) in the system settings 1840 .
§ Enabled: Enable similar sensors detection for this group.
Sensors in this group will be considered during similarity analysis.
§ Disabled: Disable similar detection for this group. Sensors in this
group will not be taken into account during similarity analysis.
Sensor Limit This setting allows the administrator to set a limit for the maximum
number of sensors in this group. Subgroups are also included. If
sensors exceed this limitation, they will be paused. This is of
special interest for a Managed Service Provider (MSP). Choose
between:
§ Allow unlimit ed number of sensors: Disable a limitation of the
number of sensors for this group. Any number of sensors can be
added to this group.
270 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 6 Group Settings
Maximum Number of This field is only visible if limitation is enabled above. Define how
Sensors many sensors can be added to this group. Please enter an integer
value.
Click on the Save button to store your settings. If you change tabs or use the main menu, all
changes to the settings will be lost!
Notifications
The status or the data of a sensor can trigger notifications. Using this mechanism, you can
configure external alerting tailored to you needs. In an object's detail page, click on the
Not ificat ions tab to change sensor notification triggers. The defined triggers will be inherited
down to sensor level. For detailed information, please see Sensor Not ificat ions Set t ings 1716
section.
Others
For more general information about settings, please see Object Set t ings 142 section.
More
Knowledge Base: How does PRTG compute CPU Index, Traffic Index and Response Time Index?
§ http://kb.paessler.com/en/topic/313
Knowledge Base: How can I add my own device icons for use in the PRTG web interface?
§ http://kb.paessler.com/en/topic/7313
Knowledge Base: How can I change the defaults for names automatically generated for new
SNMP sensors?
§ http://kb.paessler.com/en/topic/7363
Knowledge Base: Automatically update port name and number for SNMP Traffic sensors when
the device changes them
§ http://kb.paessler.com/en/topic/25893
14.01.2014 271
Part 6: Ajax Web Interface—Device and Sensor Setup | 7 Device Settings
Add Device
The Add Device dialog appears when adding a new device to a group. It only shows the
setting fields that are imperative for creating the device. Therefore, you will not see all setting
fields in this dialog. For example, the Device St at us option is not available in this step.
You can change all settings in the device's Set t ings tab later.
Device Settings
The following settings are available in the Set t ings tab of every device. As you may not need
all of these for every device, just regard those settings you really need, ignoring the others.
We recommend defining as many settings as possible in the Root 224 group, so you can inherit
them to all other objects further down in the tree hierarchy.
For device settings, there is also multi-edit available. This enables you to change properties of
many devices at a time. For more details, please see Mult i-Edit List s 1736 section.
Note: This documentation refers to the PRTG Sy st em Administ rat or user accessing the Ajax
interface on a master node. For other user accounts, interfaces, or nodes, not all of the
options might be available as described. When using a cluster installation, failover nodes are
read-only by default.
Device Name Enter a meaningful name to identify the device. The name will be
shown by default in the device tree and in all alarms.
IP Version Define which IP protocol PRTG will use to connect to this device.
The setting is valid for all sensors created on this device. Choose
between:
§ Connect using IPv4: Use IP version 4 for all requests to this
device.
§ Connect using IPv6: Use IP version 6 for all requests to this
device.
272 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 7 Device Settings
IP Address/DNS Name Enter the IP address (either v4 or v6, depending on your selection
above) or DNS name for the device. Most sensors created on this
device will inherit this setting and they will try to connect to this
address for monitoring. (However, some sensor types still have
their own setting for IP address/DNS name.)
Tags Enter one or more tags; confirm each tag by hitting space, comma,
or enter key. You can use tags to group sensors and use tag-
filtered views later on. Tags are not case sensitive. We recommend
using the default value. You can add additional tags to it, if you like.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Device Icon Choose a device icon from the list. It will be shown in the device
tree. For information on how to add your custom icons, please see
the link in the More 288 section below.
Service URL Specify a URL you would like to open directly when choosing
Device Tools | Go To Service URL from the device's context menu
168 . For example, you can configure this option to call the address
Device Ty pe
Sensor Management Select which type of auto-discovery you would like to perform for
this device. Choose between:
§ Manual (no aut o-discovery ): Do not auto-discover any sensors,
but only add sensors manually.
§ Aut omat ic device ident ificat ion (st andard, recommended):
Use a small set of auto-discovery templates. This will scan your
LAN and usually create a view standard sensors on your device.
§ Aut omat ic device ident ificat ion (det ailed, may creat e many
sensors: Use an extended set of auto-discovery templates. This
will scan your LAN and usually create many sensors on your
device.
14.01.2014 273
Part 6: Ajax Web Interface—Device and Sensor Setup | 7 Device Settings
Device Ty pe
§ Aut omat ic sensor creat ion using specific device t emplat es:
Use specific auto-discovery templates only. Please select
templates below. This will scan your LAN and add sensors
defined in the template.
Discovery Schedule This option is only visible if one of the auto-discovery options is
selected above. Define when the auto-discovery will be run.
Choose between:
§ Once: Perform auto-discovery only once. For existing devices,
this will initiate a one-time sensor update for the current device.
§ Hourly : Perform auto-discovery for new sensors every hour.
§ Daily : Perform auto-discovery for new sensors every day.
§ Weekly : Perform auto-discovery for new sensors every week.
Device Template(s) This option is only visible if using specific device templates (last
option) is enabled above. Please choose one or more templates by
adding a check mark in front of the respective template name. You
can also select and deselect all items by using the check box in the
table head. These will be used for auto-discovery on the current
device. Choose from:
§ ADSL
§ Cisco ASA VPN
§ Cisco Device (Generic)
§ Dell MDI
§ DNS Server
§ Environment Jacart a
§ Environment Poseidon
§ Frit zbox
§ FTP Server
§ Generic Device (PING only )
§ Generic Device (SNMP-enabled)
§ Generic Device (SNMP-enabled, Det ailed)
§ HTTP Web Server
§ Hy per V Host Server
§ Linux/UNIX Device (SNMP or SSH enabled)
§ Mail Server (Generic)
§ Mail Server (MS Exchange)
274 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 7 Device Settings
Device Ty pe
create new sensors. Templates which were not applied will not be
shown in the ticket.
14.01.2014 275
Part 6: Ajax Web Interface—Device and Sensor Setup | 7 Device Settings
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Locat ion
Location (for geo When using geo maps using Google's API 1744 please enter a location
maps) in the first line. Objects will then be displayed on a geographical
map with a flag, showing the current status using a color code
similar to the sensor status icons 121 (green - yellow - orange - red).
You can enter a full postal address, city and country only, or
latitude and longitude. It is possible to enter any text before,
between, and after the coordinates, PRTG will parse latitude and
longitude automatically; for example: 49.452778 11.077778 or
enter 49.452778 any 11.077778 text
A minus sign (-) in the first line will hide an object from geo maps. In
this case you can enter location information in line two and
following.
You can define a specific label for each location: enter a string
denoting the label in the first line and provide geo coordinates in
the second line. This object will be displayed then with the label in
PRTG's geo map.
Domain or Computer Define the authority for Windows access. This is used for Windows
Name Management Instrumentation (WMI) and other Windows sensors. If
you want to use a Windows local user account on the target
device, please enter the computer name here. If you want to use a
Windows domain user account (recommended), please enter the
(Active Directory) domain name here. If not explicitly defined, PRTG
will automatically add a prefix in order to use the NT LAN Manager
(NTLM) protocol. Please do not leave this field empty.
Username Enter the username for Windows access. Usually, you will use
credentials with administrator privileges.
Password Enter the password for Windows access. Usually, you will use
credentials with administrator privileges.
276 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 7 Device Settings
Username Enter a login name for the access via SSH and WBEM. Usually, you
will use credentials with administrator privileges.
Login Define which authentication method will be used for login. Choose
between:
§ Login via Password: Provide a password for login. Enter below.
§ Login via Privat e Key : Provide a private key for authentication.
Note: PRTG can only handle keys in OpenSSH format which are
not encrypted. You cannot use password protected keys here. In
the text field, please paste the entire private key, including the
"BEGIN" and "END" lines. Please make sure the according public
key is provided on the target machine. For details, please see
Monit oring via SSH 1962 .
Password This field is only visible if password login is selected above. Enter a
password for the Linux access via SSH and WBEM. Usually, you will
use credentials with administrator privileges.
Private Key This field is only visible if private key login is selected above. Paste
a private key into the field (OpenSSH format, unencrypted). Usually,
you will use credentials with administrator privileges. Note: If you
do not insert a private key for the first time, but change the private
key, you need to restart your PRTG core server service in order for
the private key change to take effect! For details, please see
Monit oring via SSH 1962 .
For WBEM Use Protocol Define the protocol that will be used for WBEM. This setting is only
relevant when using WBEM sensors. Choose between:
§ HTTP: Use an unencrypted connection for WBEM.
§ HTTPS: Use an SSL-encrypted connection for WBEM.
For WBEM Use Port Define the port that will be used for WBEM. This setting is only
relevant when using WBEM sensors. Choose between:
§ Set aut omat ically (port 5988 or 5989): Use one of the
standard ports, depending on whether unencrypted or encrypted
connection is chosen above.
§ Set manually : Use a custom port. Define below.
WBEM Port This setting is only visible if manual port selection is enabled above.
Enter the WBEM port number.
SSH Port Define the port number which will be used for SSH connections.
Note: By default, this setting is automatically used for all SSH
sensors 296 , unless you define a different port number in the sensor
settings.
14.01.2014 277
Part 6: Ajax Web Interface—Device and Sensor Setup | 7 Device Settings
SSH Rights Elevation Define with which rights the command will be executed on the
target system. Choose between:
§ Run t he command as t he user connect ing (default ): Use the
rights of the user who establishes the SSH connection.
§ Run t he command as anot her user using 'sudo': Use the rights
of another user, for example, the administrator.
§ Run t he command as anot her user using 'su': Use the rights of
another target user.
Target Username This field is only visible if sudo or su is enabled above. Enter a
username to run the specified command as another user than root.
If you leave this field empty, the command will be run as root.
Ensure that you set the Linux password even you use a public/
private key for authentication. This is not necessary if the user is
allowed to execute the command without a password.
Password Target User This field is only visible if su is enabled above. Enter the password
for the specified target user.
User Enter a login name for access to VMware and XEN servers. Usually,
you will use credentials with administrator privileges.
Password Enter a password for access to VMware and XEN servers. Usually,
you will use credentials with administrator privileges.
VMware Protocol Define the protocol used for the connection to VMware and
XenServer. Choose between:
§ HTTPS (recommended): Use an SSL-encrypted connection to
VMware and XenServers.
§ HTTP: Use an unencrypted connection to VMware and
XenServers.
SNMP Version Select the SNMP version that will be used for device connection.
Choose between:
§ v1: Use the simple standard v1 protocol for SNMP connections.
This protocol only offers clear-text data transmission, but it is
usually supported by all devices.
278 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 7 Device Settings
§ v2c: Use the more advanced v2c protocol for SNMP connections.
Data is still transferred as clear-text, but it supports 64-bit
counters.
§ v3: Use the latest v3 protocol for SNMP connections. It provides
secure authentication and data encryption.
Note for SNMP v3: Due to internal limitations you can only monitor
a limited number of sensors per second using SNMP v3. The limit is
somewhere between 1 and 50 sensors per second (depending on
the SNMP latency of your network). This means that using an
interval of 60 seconds you are limited to between 60 and 3000
SNMP v3 sensors for each probe. If you experience an increased
"Interval Delay" or "Open Requests" reading of the probe health
sensor, you need to distribute the load over multiple probes. SNMP
v1 and v2 do not have this limitation.
Community String This setting is only visible if SNMP version v1 or v2c are enabled
above. Enter the community string of your devices. This is a kind of
"clear-text password" used for simple authentication. We
recommend using the default value.
Authentication Type This setting is only visible if SNMP version v3 is enabled above.
Choose between:
§ MD5: Use Message-Digest Algorithm 5 (MD5) for authentication.
§ SHA: Use Secure Hash Algorithm (SHA) for authentication.
The chosen type has to match the authentication type of your
device.
Note: If you do not want to use authentication, but you need SNMP
v3, for example, because your device requires context, you can
leave the field password empty. In this case,
SNMP_SEC_LEVEL_NOAUTH will be used and authentication will be
deactivated entirely.
Encryption Type This setting is only visible if SNMP version v3 is enabled above.
Select an encryption type. Choose between:
§ DES: Use Data Encryption Standard (DES) as encryption
algorithm.
14.01.2014 279
Part 6: Ajax Web Interface—Device and Sensor Setup | 7 Device Settings
Data Encryption Key This setting is only visible if SNMP version v3 is enabled above.
Enter an encryption key here. If you provide a key in this field,
SNMP data packets will be encrypted using the encryption
algorithm selected above, providing increased security. The
provided key here has to match the encryption key of your device.
Note: If the key entered in this field does not match the key
configured in the target SNMP device, you will not get an error
message! Please enter a string or leave the field empty.
Context Name This setting is only visible if SNMP version v3 is enabled above.
Enter a context name only if it is required by the configuration of
the device. Context is a collection of management information
accessible by an SNMP device. Please enter a string.
SNMP Port Enter the port used for SNMP communication. We recommend using
the default value.
SNMP Timeout (sec.) Enter a timeout in seconds for the request. If the reply takes longer
than this value the request is aborted and an error message is
triggered.
When experiencing problems while monitoring via Windows sensors, you can set some
compatibility options for trouble shooting.
Preferred Data Source Define the method Windows sensors will use to query data. This
setting is valid only for hybrid sensors offering performance
counter and Windows Management Instrumentation (WMI)
technology. The setting will be ignored for all other sensors!
Choose between:
§ Performance Count ers and fallback t o WMI (recommended):
Try to query data via performance counters. If this is not possible,
establish a connection via WMI. This is the recommended setting
to best balance resource usage and functionality.
§ Performance Count ers only : Query data via performance
counters only. If this is not possible, a sensor will return no data.
§ WMI only : Query data via WMI only. If this is not possible, a
sensor will return no data.
280 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 7 Device Settings
Timeout Method Specify the time the sensor will wait for the return of its WMI query
before aborting it with an error message. Choose between:
§ Use 1.5x scanning int erval (recommended): Use a default of
one and a half times the scanning interval set for the sensor (see
below in this settings).
§ Set manually : Enter a timeout value manually.
We recommend using the default value. Only if you experience
ongoing timeout errors, try increasing the timeout value.
Timeout Value (Sec.) This field is only visible if the manual timeout method is selected
above. Specify the time the sensor will wait for the return of its
WMI query before aborting with an error message. Please enter an
integer value.
When experiencing problems while monitoring via Simple Network Management Protocol
(SNMP) sensors, you can set some compatibility options for trouble shooting.
SNMP Delay (ms) Add a time in milliseconds that will be waited between two SNMP
requests. This can help increase device compatibility. Please enter
an integer value. We recommend using the default value. If you
experience SNMP connection failures, please increase it. You can
define a delay between 0 and 100, higher delays are not supported
and will be discarded.
Failed Requests Define if an SNMP sensor will try again after a request fails.
§ Ret ry (recommended): Try again if an SNMP request fails. This
can help prevent false error messages due to temporary timeout
failures.
§ Do not ret ry : Do not retry if an SNMP request fails. With this
setting enabled an SNMP sensor will be set to error status earlier.
Overflow Values Define how PRTG will handle overflow values. Some devices do not
handle internal buffer overflows correctly. This can cause false
peaks.
§ Ignore overflow values (recommended): Ignore overflow
values and do not include them in the monitoring data.
§ Handle overflow values as valid result s: Regard all overflow
values as regular data and include them in the monitoring data.
We recommend using the default value. If you experience problems,
change this option.
14.01.2014 281
Part 6: Ajax Web Interface—Device and Sensor Setup | 7 Device Settings
Zero Values Define how PRTG will handle zero values. Some devices send
incorrect zero values. This can cause false peaks.
§ Ignore zero values for delt a sensors (recommended): Ignore
zero values and do not include them in the monitoring data.
§ Handle zero values as valid result s for delt a sensors: Regard
all zero values as regular data and include them in the monitoring
data.
We recommend using the default value. If you experience problems,
change this option.
32-bit/64-bit Counters Define which kind of traffic counters PRTG will search for on a
device.
§ Use 64-bit count ers if available (recommended): The interface
scan will use 64-bit traffic counters, if available. This can avoid
buffer overflows in the devices.
§ Use 32-bit count ers only : The interface scan will always use 32-
bit traffic counters, even if 64-bit counters are available. This can
lead to more reliable monitoring for some devices.
We recommend using the default value. If you experience problems,
change this option.
Request Mode Define which kind of request method PRTG uses for SNMP sensors.
§ Use mult i get (recommended): Bundle multiple SNMP requests
into one request.
§ Use single get : Use one request for each SNMP value. This can
increase compatibility with older devices.
We recommend using the default value. If you experience problems,
change this option.
Port Name Template Define how the name of SNMP sensors created on a device will be
put together. Enter a template using several variables. When adding
new sensors, PRTG scans the interface for available counters at
certain OIDs. At each OID usually several fields are available with
interface descriptions. They are different for every device/OID.
PRTG will use the information in these fields to name the sensors. If
a field is empty or not available, an empty string is added to the
name. As default, ([port ]) [ifalias] is set as port name template,
which will create a name such as (001) Ethernet1, for example. You
can use any field names available at a certain OID of your device,
among which are:
§ [port ]: The port number of the monitored interface.
§ [ifalias]: The 'alias' name for the monitored interface as specified
by a network manager, providing a non-volatile handling.
282 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 7 Device Settings
Port Name Update Define how PRTG will react if you change port names in your
physical device (e.g. a switch or router). Choose between:
§ Keep port names (use t his if y ou edit t he names in PRTG): Do
not automatically adjust sensor names. This is the best option if
you want to change names in PRTG manually.
§ Aut omat ic sensor name updat e if name changes in device: If
PRTG detects changes of port names in your physical device, it
will try to automatically adjust sensor names accordingly. For
detailed information please see More section below.
Port Identification Define which field will be used for SNMP interface identification.
Choose between:
§ Aut omat ic (recommended): Tries the ifAlias field first to identify
an SNMP interface and then ifDescr. Note: ifName will not be tried
automatically.
§ Use ifAlias: For most devices ifAlias is the best field to get
unique interface names.
§ Use ifDescr: Use this option if the port order of your device
changes after a reboot, and there is no ifAlias field available. For
example, this is the best option for Cisco ASA devices. Note:
When using this option it is important that your device returns
unique interface names in the ifDescr field.
§ Use ifName: You can also use this option if there is no unique
ifAlias available. Note: When using this option it is important that
your device returns unique interface names in the ifName field.
§ No Port Updat e: Use this option to disable automatic port
identification.
14.01.2014 283
Part 6: Ajax Web Interface—Device and Sensor Setup | 7 Device Settings
Start Port For SNMP Traffic sensors, define at which port number PRTG will
start to create sensors. Use 0 for automatic. We recommend using
the default value.
End Port For SNMP Traffic sensors, define at which port number PRTG will
stop to create sensors. Use 0 for automatic. We recommend using
the default value.
SNMP Debug Log Define if you want to create an SNMP log file for debugging
purposes. This is only recommended for debugging low level SNMP
issues. Choose between:
§ No log (recommended): No SNMP debug log file will be created.
§ Enable debug log: An SNMP log file is written to the Logs
(Debug) directory (on the Master node, if in a cluster). This is for
debugging purposes. The file will be overridden with each
scanning interval. For information on how to find the folder used
for storage, please see Dat a St orage 2074 section.
HTTP Proxy Settings The proxy settings determine how a sensor connects to a given
URL. You can enter data for a proxy server that will be used when
connecting via HTTP or HTTPS. Note: This setting is valid for the
monitoring only and determines the behavior of sensors. In order
to change proxy settings for the core server, please see Sy st em
Administ rat ion—Core & Probes 1849 .
Name Enter the IP address or DNS name of the proxy server to use. If you
leave this field empty, no proxy will be used.
Port Enter the port number of the proxy. Often, port 8080 is used.
Please enter an integer value.
User If the proxy requires authentication, enter the username for the
proxy login. Note: Only basic authentication is available! Please
enter a string or leave the field empty.
Password If the proxy requires authentication, enter the password for the
proxy login. Note: Only basic authentication is available! Please
enter a string or leave the field empty.
284 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 7 Device Settings
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Clust er Usage
Scanning Distribution This box is only visible if you're running a PRTG cluster. Sometimes
you want to exclude a certain node from monitoring the sensors
running on this probe, group, or device, for example, if a device is
not reachable from every node configured in your cluster. In the list
of cluster nodes, please select the nodes that will not be included
in sensor scans. By default, this setting is inherited 87 to all objects
underneath.
Schedule Select a schedule from the list. Schedules can be used to pause
monitoring for a certain time span (days, hours) throughout the
week. You can create new schedules and edit existing ones in the
account settings 1817 . Note: Schedules are generally inherited. New
schedules will be added to existing ones, so all schedules are
active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance Ends At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
14.01.2014 285
Part 6: Ajax Web Interface—Device and Sensor Setup | 7 Device Settings
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current object will be dependent
on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds.
286 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 7 Device Settings
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
14.01.2014 287
Part 6: Ajax Web Interface—Device and Sensor Setup | 7 Device Settings
Unusual Detection Define if unusual detection is enabled for sensors. You can
configure the behavior of unusual detection (or disable it
completely) in the system settings 1839 .
§ Enabled: Enable unusual detection for this group. Sensors in this
group will turn to orange color if unusual activity is detected.
§ Disabled: Disable unusual detection for this group. Unusual
values will be ignored for sensors in this group; they will not
show an unusual sensor status.
Similar Sensors Define if similar sensors detection is enabled for sensors. You can
Detection configure the depth of analysis of similar sensors detection (or
disable it completely) in the system settings 1840 .
§ Enabled: Enable similar sensors detection for this group.
Sensors in this group will be considered during similarity analysis.
§ Disabled: Disable similar detection for this group. Sensors in this
group will not be taken into account during similarity analysis.
Click on the Save button to store your settings. If you change tabs or use the main menu, all
changes to the settings will be lost!
Notifications
The status or the data of a sensor can trigger notifications. Using this mechanism, you can
configure external alerting tailored to you needs. In an object's detail page, click on the
Not ificat ions tab to change sensor notification triggers. The defined triggers will be inherited
down to sensor level. For detailed information, please see Sensor Not ificat ions Set t ings 1716
section.
Others
For more general information about settings, please see Object Set t ings 142 section.
More
Knowledge Base: How does PRTG compute CPU Index, Traffic Index and Response Time Index?
§ http://kb.paessler.com/en/topic/313
Knowledge Base: How can I add my own device icons for use in the PRTG web interface?
§ http://kb.paessler.com/en/topic/7313
Knowledge Base: How can I change the defaults for names automatically generated for new
SNMP sensors?
288 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 7 Device Settings
§ http://kb.paessler.com/en/topic/7363
Knowledge Base: Automatically update port name and number for SNMP Traffic sensors when
the device changes them
§ http://kb.paessler.com/en/topic/25893
14.01.2014 289
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
There is a dedicated manual section for every sensor type with details about the available
settings. For more information, please see List of Available Sensors 291 section.
For sensor settings, there is also multi-edit available. This enables you to change properties of
many sensors at a time. For more details, please see Mult i-Edit List s 1736 section.
For information about sensor settings, please see the following sections:
290 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
1 List of Available Sensor Types
This chapter lists all available sensors, arranged both by different categories and in alphabetical
order. Note: In the Add a Sensor 220 assistant, PRTG offers you various options to filter for
fitting sensor types easily.
§ More 308
Common Sensors
§ HTTP Sensor 486
28.05.2014 291
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
1 List of Available Sensor Types
292 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
1 List of Available Sensor Types
SNMP Sensors
§ SNMP APC Hardware Sensor 927
28.05.2014 293
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
1 List of Available Sensor Types
294 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
1 List of Available Sensor Types
28.05.2014 295
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
1 List of Available Sensor Types
Linux/Unix/OS X Sensors
§ SNMP Linux Disk Free Sensor 1122
296 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
1 List of Available Sensor Types
28.05.2014 297
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
1 List of Available Sensor Types
298 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
1 List of Available Sensor Types
28.05.2014 299
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
1 List of Available Sensor Types
300 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
1 List of Available Sensor Types
Custom Sensors
The version numbers show when the respective sensor type was originally introduced to
PRTG.
28.05.2014 301
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
1 List of Available Sensor Types
302 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
1 List of Available Sensor Types
28.05.2014 303
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
1 List of Available Sensor Types
304 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
1 List of Available Sensor Types
28.05.2014 305
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
1 List of Available Sensor Types
306 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
1 List of Available Sensor Types
28.05.2014 307
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
1 List of Available Sensor Types
More
Did not find what you are looking for? Have a look into the Additional Sensor Types (Custom
Sensors) 1706 section.
308 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
2 Active Directory Replication Errors Sensor
The Active Directory Replication Errors sensor uses its parent device's Windows credentials to
check domain controllers for replication errors. It can show the number of consecutive sync
failures, if the source is deleted, if the scheduled sync is disabled, when the last sync attempt
took place, the result of the last sync, when there was the last sync success, the number of
modified consecutive sync failures, and the number of pending replication operations.
Please make sure you enter valid domain credentials in the parent device's settings.
This sensor type uses lookups to determine the status values of some sensor channels. For
details, please see section Define Lookups 2039 .
Note: This sensor type can have a high impact on the performance of your monitoring system.
Please use it with care! We recommend using not more than 50 sensors, on each probe, of this
type of sensor.
This sensor type requires the Microsoft .NET Framework to be installed on the computer
running the PRTG probe: Either on the local system (on every node, if on a cluster probe), or
on the system running the remote probe 2050 . If the framework is missing, you cannot create
this sensor. Note: You need to install the exact version required (a higher version will usually
not work; an exception applies to .NET 3.5 which comprises .NET 2.0 and .NET 3.0). Generally, it
is possible to run several .NET Framework versions on the same machine side-by-side. Please
install the latest update available for the required version.
This sensor only works if the computer running the PRTG probe is part of the domain whose
AD should be monitored. The probe runs either on the local system (on every node, if on a
cluster probe), or on the system running the remote probe 2050 . If this requirement is not met,
the sensor will fail.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on. In the parent device's 276 Credent ials for Windows Sy st ems settings,
please prefer using Windows domain credentials.
Note: If you use local credentials, please make sure the same Windows user accounts (with
same username and password) exist on both the system running the PRTG probe and the
target computer. Otherwise the sensor cannot connect correctly.
Note: Your Windows credentials may not contain any double quotation marks ("). If they do,
this sensor will not work!
12.05.2014 309
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
2 Active Directory Replication Errors Sensor
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor replications, PRTG will create one sensor for each replication neighbor you
choose. The settings you make in this dialog are valid for all of the sensors that are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Replication Neighbor Select the replication neighbor whose replication you want to add
a sensor for. A list of all available items is shown with their name.
Select the desired items by adding check marks in front of the
respective lines. One sensor will be created for each selection. You
can also select and deselect all items by using the check box in the
table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
310 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
2 Active Directory Replication Errors Sensor
Replication Neighbor Shows the replication neighbor whose replication this sensor
monitors. Once a sensor is created this value cannot be changed. It
is shown for reference purposes only. If you need to change this,
please add the sensor anew.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
12.05.2014 311
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
2 Active Directory Replication Errors Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
312 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
2 Active Directory Replication Errors Sensor
§ Mast er object for parent : Make this sensor the master object
for its parent device. The sensor will influence the behavior of
the device it is created on: If the sensor is in a Down status, the
device will be paused. For example, it is a good idea to make a
Ping sensor the master object for its parent device to pause
monitoring for all other sensors on the device in case the device
cannot even be pinged. Additionally, the sensor will be paused if
the parent group of its parent device is in a Down status, or if it
is paused by another dependency.
Note: Testing your dependencies is easy! Simply choose Simulat e
Error St at us from the context menu of an object that other
objects depend on. A few seconds later all dependent objects
should be paused.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
12.05.2014 313
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
2 Active Directory Replication Errors Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
314 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
2 Active Directory Replication Errors Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
12.05.2014 315
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
3 ADO SQL Sensor
The ADO SQL sensor monitors a database using an ActiveX Data Objects (ADO) connection. It
connects to the server and shows the response time. Additionally, it can read the number of
records and a value.
Note: For security reasons, you can only create a sensor on a device for which Windows
Credentials have been defined. With these credentials, the PRTG probe must be able to
connect to the Windows domain. If you don't enter valid credentials, you will get an Access
denied error message when scanning. For detailed information, please see More 322 section
below.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
316 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
3 ADO SQL Sensor
Connection String Enter the string that will be used to connect to the database. For
example, such a string could be: Provider=SQLOLEDB.1;Data
Source=10.0.0.200\SQLEXPRESS;User
ID=user;Password=userpass;Initial Catalog=Northwind. For more
information on how to build connection strings, please see More
322 section below.
Dat a
SQL Expression Enter a valid SQL statement to execute on the server. In your
SELECT statement, please specify the field name explicitly. Do not
use SELECT *! For example, a correct expression could be: SELECT
AVG(UnitPrice) FROM Products. When a cursor is returned (i.e. with
a SELECT statement), only the first row of data will be processed.
Record Count If you want to know how many records in your database were
affected by your SQL expression as defined above, you can count
the number of concerned records. Choose between:
§ Do not count number of records: Affected records will not be
counted.
§ Count number of records: The number of affected records will
be counted. Note: Enabling this option might increase the
execution time of this sensor.
Post-Processing If the SQL expression returns a result set, please define if you want
to further process it. Choose between:
§ Ignore result set : Do not do anything with the data returned.
§ Process numerical result : Regard the result set returned as
integer or float. You can set the sensor to Warning or Down
status for specific thresholds. Define below.
§ Process st ring result : Regard the result set returned as a string.
You can set the sensor to error for certain sub-strings contained
or missing. Define below.
§ Monit or for changes: Monitor if the result set has changed
since last check. The sensor will send an internal message
indicating that its value has changed. In combination with a
Change Trigger, you can use this mechanism to trigger a
notification 1716 whenever a sensor value changes.
Condition "Warning" This field is only visible if numeric results is enabled above. Define a
condition of the returned numeric SQL result set that will set the
sensor to a Warning status. Choose between:
28.05.2014 317
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
3 ADO SQL Sensor
Value This field is only visible if numeric results is enabled above. Enter a
value of the returned numeric SQL result set that will set the
sensor into a Warning status. Please enter an integer or float
value.
Condition "Down" This field is only visible if numeric results is enabled above. Define a
condition of the returned numeric SQL result set that will set the
sensor to a Down status. Choose between:
§ none: Do not set the sensor to Down status for any condition.
§ equals: Result set must be the same as the value provided
below.
§ is above: Result set must be above the value provided below.
§ lower t han: Result set must be below the value provided below.
§ does not equal: Result set must be unequal to the value
provided below.
Note: This threshold check the SQL result set only. You can set
additional thresholds in the sensor's channel settings 1709 .
Value This field is only visible if numeric results is enabled above. Enter a
value of the returned numeric SQL result set that will set the
sensor to a Down status. Please enter an integer value.
Response Must Include This field is only visible if string results is enabled above. Enter a
string that must be part of the returned SQL string. If it is not, the
sensor will be set to an error state. Please enter a string or leave
the field empty.
Response Must Not This field is only visible if string results is enabled above. Enter a
include string that must not be part of the returned SQL string. If it is, the
sensor will be set to an error state. Please enter a string or leave
the field empty.
318 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
3 ADO SQL Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
28.05.2014 319
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
3 ADO SQL Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
320 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
3 ADO SQL Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
28.05.2014 321
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
3 ADO SQL Sensor
More
Knowledge Base: Monitoring (Almost) Any SQL Server Through ADO with PRTG Network
Monitor
§ http://kb.paessler.com/en/topic/2053
Knowledge Base: How do I correctly configure credentials for ADO SQL sensors?
§ http://kb.paessler.com/en/topic/13103
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
322 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
4 Amazon CloudWatch Sensor
The Amazon CloudWatch sensor monitors performance of Amazon Cloud services, such as
Elastic Compute Cloud (EC2), Simple Queue Service (SQS), Elastic Load Balancing (ELB), Elastic
Block Store (EBS), Simple Notification Service (SNS), Relational Database Service (RDS), and
ElastiCache.
Depending on the selected service, the sensor can show CPU utilization, network load in and
out, and disk read and write speed.
Note: The CloudWatch option must be enabled for the instance you want to monitor (you can
do this, for example, using Amazon's AWS console). Amazon will charge you (a small amount)
for each "Amazon CloudWatch API Request" query the sensor sends to the Amazon servers.
Depending on the service, each Amazon CloudWatch sensor sends about 10 to 30 requests
with each scanning interval. Last time we checked the Amazon price list, they charged max.
US$ 0.014 per 1,000 requests (depending on your region). Please see More 329 section for
detailed information.
Note: This sensor type can have a high impact on the performance of your monitoring system.
Please use it with care! We recommend using not more than 50 sensors, on each probe, of this
type of sensor.
This sensor type requires the Microsoft .NET Framework to be installed on the computer
running the PRTG probe: Either on the local system (on every node, if on a cluster probe), or
on the system running the remote probe 2050 . If the framework is missing, you cannot create
this sensor. Note: You need to install the exact version required (a higher version will usually
not work; an exception applies to .NET 3.5 which comprises .NET 2.0 and .NET 3.0). Generally, it
is possible to run several .NET Framework versions on the same machine side-by-side. Please
install the latest update available for the required version.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
PRTG will perform a meta scan before you actually add this sensor type and requires basic
information for this scan in advance. Provide the requested information in the appearing
window. During the scan, PRTG will recognize all items available for monitoring based on your
input. The following settings differ in comparison to the sensor's settings page:
28.05.2014 323
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
4 Amazon CloudWatch Sensor
Note: The CloudWatch option must be enabled for the instance you
want to monitor (you can do this e.g. using Amazon's AWS
console).
Select which service instances you want to monitor. PRTG will create one sensor for each
instance you choose. The settings you make in this dialog are valid for all of the sensors that
are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Service Instance Select the instances you want to add a sensor for. A list of all
available items is shown with their name. Select the desired items
by adding check marks in front of the respective lines. One sensor
will be created for each selection. You can also select and deselect
all items by using the check box in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
324 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
4 Amazon CloudWatch Sensor
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
AWS Access Key ID Enter your access key. You can obtain it from aws.amazon.com.
AWS Secret Access Enter your secret access key. You can obtain it from
Key aws.amazon.com.
Region Shows the region your instance is located at. Once a sensor is
created this value cannot be changed. It is shown for reference
purposes only. If you need to change this, please add the sensor
anew.
Period (Interval) Define in what granularity you want to receive datapoints from
CloudWatch. Choose between:
§ 1 Minut e
§ 2 Minut es
§ 5 Minut es
§ 10 Minut es
§ 30 Minut es
§ 1 Hour
28.05.2014 325
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
4 Amazon CloudWatch Sensor
Instance Shows the Instance ID of the Amazon Web Services instance this
sensor is monitoring. When using the "Simple Notification Service
(SNS)" service, this field is not visible. Once a sensor is created this
value cannot be changed. It is shown for reference purposes only.
If you need to change this, please add the sensor anew.
Topic Name This field is only visible if you selected a "Simple Notification Service
(SNS)" instance before. It shows the topic name that is monitored
by this sensor. The sensor will show the number and size of
messages published, and the number of notifications delivered and
failed. Each sensor can monitor one topic name only. Once a
sensor is created this value cannot be changed. It is shown for
reference purposes only. If you need to change this, please add
the sensor anew.
Availability Zone This field is only visible if you selected a "Elastic Load Balancing
(ELB)" instance before. Enter the name of the Availability Zone of
your Load Balancer you want to monitor. If you leave this field
empty, the average value of all zones will be taken.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
326 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
4 Amazon CloudWatch Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Note: For Amazon CloudWatch sensors, the scanning interval cannot be inherited. Please use
the individual settings of the sensor to define the interval in which data is received.
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
28.05.2014 327
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
4 Amazon CloudWatch Sensor
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
328 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
4 Amazon CloudWatch Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
More
Knowledge Base: How do I define access rights for Amazon CloudWatch queries?
28.05.2014 329
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
4 Amazon CloudWatch Sensor
§ http://kb.paessler.com/en/topic/38083
Knowledge Base: How much does Amazon charge for using the CloudWatch API?
§ http://kb.paessler.com/en/topic/37543
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
330 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
5 AVM FRITZ!Box WAN Interface Sensor
The AVM FRITZ!Box WAN Interface Sensor monitors the internet traffic of a FRITZ!Box internet
access router from European manufacturer AVM. It returns the incoming and outgoing internet
traffic.
Note: There are no credentials necessary, but transmission of status information via Universal
Plug and Play (UPnP) must be enabled in the network settings of your FRITZ!Box. See More 335
section below for detailed information.
Note: This sensor type might not support FRITZ!Boxes with firmware of Kabel Deutschland.
Also, it might only support FRITZ!Boxes until operating system version 6.03. See section More
335 below for details.
Note: This sensor type can have a high impact on the performance of your monitoring system.
Please use it with care! We recommend using not more than 50 sensors, on each probe, of this
type of sensor.
This sensor type requires the Microsoft .NET Framework to be installed on the computer
running the PRTG probe: Either on the local system (on every node, if on a cluster probe), or
on the system running the remote probe 2050 . If the framework is missing, you cannot create
this sensor. Note: You need to install the exact version required (a higher version will usually
not work; an exception applies to .NET 3.5 which comprises .NET 2.0 and .NET 3.0). Generally, it
is possible to run several .NET Framework versions on the same machine side-by-side. Please
install the latest update available for the required version.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
28.05.2014 331
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
5 AVM FRITZ!Box WAN Interface Sensor
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
332 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
5 AVM FRITZ!Box WAN Interface Sensor
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
28.05.2014 333
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
5 AVM FRITZ!Box WAN Interface Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
334 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
5 AVM FRITZ!Box WAN Interface Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
More
Knowledge Base: How do I activate UPnP for my Fritz!Box?
28.05.2014 335
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
5 AVM FRITZ!Box WAN Interface Sensor
§ http://kb.paessler.com/en/topic/38603
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
336 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
6 Cisco IP SLA Sensor
The Cisco IP SLA sensor monitors Voice over IP (VoIP) network parameters using IP Service
Level Agreement (SLA) from Cisco via Simple Network Management Protocol (SNMP). It shows
different aspects provided by the queried device.
For a general introduction to the technology behind Quality of Service monitoring, please see
Monit oring Qualit y of Service 1971 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
IP SLA Specific
IP SLAs Select the IP SLAs you want to add a sensor for. A list of all
available items is shown with their name. Select the desired items
by adding check marks in front of the respective lines. One sensor
will be created for each selection. You can also select and deselect
all items by using the check box in the table head. The list options
depend on the configuration of the queried device. If you're
missing a type here, please check your device's configuration. PRTG
can support the following operations:
§ echo
§ pat hEcho
§ fileIO
§ script
§ udpEcho
§ t cpConnect
§ ht t p
§ dns
§ jit t er
§ dlsw
§ dhcp
§ ft p
§ pat h-jit t er
07.02.2013 337
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
6 Cisco IP SLA Sensor
IP SLA Specific
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
IP SLA Specific
ID
Type
These fields show SLA specific settings provided by the queried
SLA device. Once a sensor is created this value cannot be changed.
Name (Tag)
It is shown for reference purposes only. If you need to change this,
please add the sensor anew.
Owner
Frequency
338 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
6 Cisco IP SLA Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
07.02.2013 339
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
6 Cisco IP SLA Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
340 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
6 Cisco IP SLA Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
07.02.2013 341
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
6 Cisco IP SLA Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
342 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
7 Citrix XenServer Host Sensor
The Citrix XenServer Host Sensor monitors a Xen host server via Hypertext Transfer Protocol
(HTTP). It shows CPU, memory, and network usage, as well as the number of running virtual
machines and load average.
Note: The parent device must be a Citrix XenServer (version 5.0 or later).
For this sensor type credentials for Xen servers must be defined for the device you want to
use the sensor on.
Note: This sensor type can have a high impact on the performance of your monitoring system.
Please use it with care! We recommend using not more than 50 sensors, on each probe, of this
type of sensor.
This sensor type requires the Microsoft .NET Framework to be installed on the computer
running the PRTG probe: Either on the local system (on every node, if on a cluster probe), or
on the system running the remote probe 2050 . If the framework is missing, you cannot create
this sensor. Note: You need to install the exact version required (a higher version will usually
not work; an exception applies to .NET 3.5 which comprises .NET 2.0 and .NET 3.0). Generally, it
is possible to run several .NET Framework versions on the same machine side-by-side. Please
install the latest update available for the required version.
In a XenServer pool there is one "pool master" that manages the pool. Incoming queries on
any host are automatically forwarded to the pool master. If you want to monitor your virtual
machines, or host servers, simply create respective sensors on a device that represents one
host server of your pool. Internal processes will make sure that monitoring will take place and
continue independently from the physical host. Note: In PRTG's device tree, the sensors for
virtual machines will always remain on the host you originally created it on, also if it is currently
running on a different host.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
If you select more than one host, multiple sensors are created at once in the Add Sensor
dialog. The settings you make in this dialog are valid for all of the sensors that are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
07.02.2013 343
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
7 Citrix XenServer Host Sensor
Host Select the hosts you want to add a sensor for, including the ones
that are not running. A list of all available items is shown with their
name. Select the desired items by adding check marks in front of
the respective lines. One sensor will be created for each selection.
You can also select and deselect all items by using the check box
in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Name Shows the name of the host monitored by this sensor. Once a
sensor is created this value cannot be changed. It is shown for
reference purposes only. If you need to change this, please add
the sensor anew.
344 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
7 Citrix XenServer Host Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
07.02.2013 345
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
7 Citrix XenServer Host Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
346 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
7 Citrix XenServer Host Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
07.02.2013 347
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
7 Citrix XenServer Host Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
348 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
8 Citrix XenServer Virtual Machine Sensor
The Citrix XenServer Virtual Machine Sensor monitors a virtual machine on a Xen server via
Hypertext Transfer Protocol (HTTP). It shows CPU usage and free memory in percent.
Note: The parent device must be a Citrix XenServer (version 5.0 or later).
For this sensor type credentials for Xen servers must be defined for the device you want to
use the sensor on.
Note: This sensor type can have a high impact on the performance of your monitoring system.
Please use it with care! We recommend using not more than 50 sensors, on each probe, of this
type of sensor.
This sensor type requires the Microsoft .NET Framework to be installed on the computer
running the PRTG probe: Either on the local system (on every node, if on a cluster probe), or
on the system running the remote probe 2050 . If the framework is missing, you cannot create
this sensor. Note: You need to install the exact version required (a higher version will usually
not work; an exception applies to .NET 3.5 which comprises .NET 2.0 and .NET 3.0). Generally, it
is possible to run several .NET Framework versions on the same machine side-by-side. Please
install the latest update available for the required version.
In a XenServer pool there is one "pool master" that manages the pool. Incoming queries on
any host are automatically forwarded to the pool master. If you want to monitor your virtual
machines, or host servers, simply create respective sensors on a device that represents one
host server of your pool. Internal processes will make sure that monitoring will take place and
continue independently from the physical host. Note: In PRTG's device tree, the sensors for
virtual machines will always remain on the host you originally created it on, also if it is currently
running on a different host.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Note: PRTG requests a full list of all virtual machines configured on the device. Therefore, it may
take a few seconds before the dialog is loaded.
If you select more than one virtual machine, multiple sensors are created at once in the Add
Sensor dialog. The following settings for this sensor differ in the 'Add Sensor' dialog in
comparison to the sensor's settings page:
07.02.2013 349
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
8 Citrix XenServer Virtual Machine Sensor
Virtual Machine Select the Virtual Machine (VM) you want to add a sensor for,
including the ones that are not running. A list of all available items
is shown with their name. Select the desired items by adding check
marks in front of the respective lines. One sensor will be created
for each selection. You can also select and deselect all items by
using the check box in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Name Shows the name of the virtual machine. Once a sensor is created
this value cannot be changed. It is shown for reference purposes
only. If you need to change this, please add the sensor anew.
350 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
8 Citrix XenServer Virtual Machine Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
07.02.2013 351
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
8 Citrix XenServer Virtual Machine Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
352 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
8 Citrix XenServer Virtual Machine Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
07.02.2013 353
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
8 Citrix XenServer Virtual Machine Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
354 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
9 Cluster Probe Health Sensor
The Cluster Probe Health sensor is a system device indicating PRTG's own system health
status. It is created automatically with a PRTG cluster installation and cannot be deleted. It
measures various internal system parameters of the cluster system and the probe's internal
processes and then computes a resulting value. Frequent or repeated health values below 100
% should be investigated, please check the sensor's channels for details.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
27.11.2012 355
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
9 Cluster Probe Health Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
356 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
9 Cluster Probe Health Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
27.11.2012 357
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
9 Cluster Probe Health Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
358 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
10 Core Health Sensor
The Core Health sensor monitors internal PRTG parameters. It shows the state of the PRTG
core server. It is created automatically by PRTG and cannot be deleted. This sensor type
checks various parameters of your PRTG core which have an impact on the stability of the
system:
§ Healt h: This index value sums up the core state into a value between 100% (healthy) and 0%
(failing). Frequent or repeated health values below 100% should be investigated.
§ CPU Load: This channel shows the current percentage CPU load. Extensive CPU load can lead
to false, incomplete, and incorrect monitoring results. This value usually should stay below
50%.
§ Handles: This is a counter for the data structures of the operating system. It is responsible
for internal resource management. Repeated obviously increasing values should be
investigated.
§ Commit t ed Memory : This channel shows the amount of memory committed to the PRTG
core server as reported by the memory manager.
§ Free Page File Memory : This channel shows the amount of free page file memory currently
available on the system. Page file memory is aggregated RAM and the size of page file. It is
the maximum amount of memory that is available on the system to be used for all currently
running processes. If it gets too low the system can crash, at least some applications will
throw "Out of memory" errors.
§ Free Phy sical Memory : This channel shows the amount of free physical memory currently
available on the system. This is the RAM that is physically built-in in the computer. If it gets
too low the system will become very slow and PRTG is not usable in a reasonable way
anymore. It can happen that some sensors will not be displayed correctly in that case, they
will appear disabled (grayed out).
§ Free Virt ual Memory : This channel shows the accessible address space on the system for
PRTG. PRTG cannot use more memory than reported here, independently from free page file
and physical memory. On a 32bit OS (operating system) the maximum is 2 GB (3 GB with
special settings under Windows); on a 64bit OS it is 4 GB if PRTG is running as 32bit version,
and unlimited as 64bit version (only Core). If free virtual memory gets too low, PRTG will
throw "Out of memory" errors or the message "not enough storage to process this
command" (visible in the Core log).
§ Threads: This channel shows the number of program parts which are currently running
simultaneously. This number can increase with heavy load. The number should not exceed
100 in normal operation.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
03.05.2013 359
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
10 Core Health Sensor
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
360 03.05.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
10 Core Health Sensor
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
03.05.2013 361
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
10 Core Health Sensor
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
362 03.05.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
11 Dell PowerVault MDi Sensor
The Dell PowerVault MDi sensor monitors a virtual disk on a Dell PowerVault MD3000i,
MD3620i, MD3000f, or MD3620f. It may work with additional models, too. This sensor can
show current, maximum, and total IOs, current and maximum speed, as well as read and cache
hit percentages.
This sensor requires an installation of Dell's "Modular Disk Storage Manager" program. This has
to be installed on the computer running the PRTG probe: Either on the local system (on every
node, if on a cluster probe), or on the system running the remote probe 2050 . For details about
setup, please see More 367 section below.
Note: Please create this sensor on a device which has the SAN's IP address configured in the
"IP address/DNS name" field.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
If you select more than one disk, multiple sensors are created at once in the Add Sensor
dialog. The settings you make in this dialog are valid for all of the sensors that are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Virtual Disks Select the disks you want to add a sensor for. A list of all available
items is shown with their name. Select the desired items by adding
check marks in front of the respective lines. One sensor will be
created for each selection. You can also select and deselect all
items by using the check box in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
28.05.2014 363
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
11 Dell PowerVault MDi Sensor
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Virtual Disk Shows the name of the virtual disk monitored by this sensor. Once
a sensor is created this value cannot be changed. It is shown for
reference purposes only. If you need to change this, please add
the sensor anew.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
364 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
11 Dell PowerVault MDi Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
28.05.2014 365
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
11 Dell PowerVault MDi Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
366 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
11 Dell PowerVault MDi Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
More
Where do I find the Dell PowerVault Modular Disk Storage Manager for use with my MDi SAN?
§ http://kb.paessler.com/en/topic/38743
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
28.05.2014 367
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
11 Dell PowerVault MDi Sensor
Others
For more general information about settings, please see Object Set t ings 142 section.
368 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
12 DHCP Sensor
The DHCP sensor monitors a Dynamic Host Configuration Protocol (DHCP) server. It sends a
broadcast message to the network and waits for a DHCP server to respond. If a server
responds, the sensor shows both the address of the server and the offered IP in the sensor's
Message field. You can check the server's response using Regular Expressions 2048 . The
sensor's channels include response time (msec) and the lease time given by the server (in
days).
This sensor can be set up on a Probe Device only! On sensor creation, choose the network
card on the probe system which will be used to send the broadcast message.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor DHCP servers, PRTG will create one sensor for each network interface you
choose. The settings you make in this dialog are valid for all of the sensors that are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
DHCP Specific
Specify Network Select the network adapters you want to add a sensor for. A list of
Interface all available items is shown with their name. Select the desired
items by adding check marks in front of the respective lines. One
sensor will be created for each selection. You can also select and
deselect all items by using the check box in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
08.10.2013 369
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
12 DHCP Sensor
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
DHCP Specific
MAC Shows the MAC address of the network adapter that is used to
send the broadcast message to the network. Once a sensor is
created this value cannot be changed. It is shown for reference
purposes only. If you need to change this, please add the sensor
anew.
Client IP Specify if you want to check the returned client IP with a regular
expression. Choose between:
§ Don't check: The IP will only appear in the sensor message
without further processes.
§ Check: Enter the regular expression you want to use below.
Client IP Must Include This field will only appear if you chose to check the client IP above.
In the response of the DHCP server, search using a regular
expression. If the answer for the client IP does not contain the
defined string, the sensor will change to a Down status. For
example, enter 10\.0\.5\..* to make sure any answering DHCP
server returns an client IP address starting with "10.0.5.". If it
doesn't, the sensor will show an error. For more details, see
Regular Expressions 2048 section. Leave empty to not use this field.
Client IP Must Not This field will only appear if you chose to check the client IP above.
Include In the response of the DHCP server, search using a regular
expression. If the answer for the client IP contains the defined
string, the sensor will change to a Down status. See example
above. For more details, see Regular Expressions 2048 section.
Leave empty to not use this field.
Server IP Specify if you want to check the returned server IP with a regular
expression. Choose between:
370 08.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
12 DHCP Sensor
DHCP Specific
Server IP Must Include This field will only appear if you chose to check the server IP above.
In the response of the DHCP server, search using a regular
expression. If the answer for the server IP does not contain the
defined string, the sensor will change to a Down status. See
example above. For more details, see Regular Expressions 2048
section. Leave empty to not use this field.
Server IP Must Not This field will only appear if you chose to check the server IP above.
Include In the response of the DHCP server, search using a regular
expression. If the answer for the server IP contains the defined
string, the sensor will change to a Down status. See example
above. For more details, see Regular Expressions 2048 section.
Leave empty to not use this field.
Timeout (sec) Enter a timeout in seconds for the request. If the reply takes longer
than this value the request is aborted and an error message is
triggered.
DHCP Server Change If there is more than one DHCP server in the network that may
answer to the broadcast message, the sensor can receive an
answer from a different DHCP server, compared to the last scan of
the sensor. In this case, PRTG can write an entry to the system
Logs 147 . Choose between:
§ Ignore: Do not write a log entry if the DHCP server changes.
§ Writ e log ent ry : Write an entry to the system Logs whenever
the DHCP server changes between two sensor scans.
Note: Regardless of this setting, those entries will always be added
to the sensor Log.
Offered IP Change If the IP address offered by the DHCP server changes between two
sensor scans, PRTG can write an entry to the system Logs 147 .
Choose between:
08.10.2013 371
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
12 DHCP Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
372 08.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
12 DHCP Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
08.10.2013 373
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
12 DHCP Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
374 08.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
12 DHCP Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
08.10.2013 375
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
13 DNS Sensor
The DNS sensor monitors a Domain Name Service (DNS) server. It resolves a domain name and
compares it to a given IP address. The sensor shows the response time and goes to an error
state if the DNS server does not resolve a given domain name correctly.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
DNS Specific
Timeout (sec) Enter a timeout in seconds for the request. If the reply takes longer
than this value the request is aborted and an error message is
triggered.
376 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
13 DNS Sensor
DNS Specific
Port Enter the number of the port the sensor will try to connect to. This
must be the port the sensor's parent device is running the DNS
service on. Usually you will use port 53. We recommend using the
default value. Note: The sensor will connect to the IP Address or
DNS Name value of the device it is created on.
Domain Enter the domain name that will be resolved by the sensor using
the Domain Name Service (DNS) server specified in the sensor's
parent device's settings. You can enter an internet domain name
here (for example, example.com), or a DNS name in your internal
network (such as computer-xyz); depending on the type of DNS
server you will monitor. You can also enter an IP address here.
Query Type Select the type of query that should be sent to the DNS server.
Choose between:
§ Host address IPv4 (A)
§ Host address IPv6 (AAAA)
§ Aut horit at ive name server (NS)
§ St art of a zone of aut horit y marker (SOA)
§ Domain name point er (PTR)
§ Mail exchange (MX )
§ Canonical name for an alias (CNAME)
Check Result Define if the result received from the DNS server will be checked.
Choose between:
§ Ignore result : Any valid answer of the DNS server will be
accepted by the sensor.
§ Check result : Check if the response contains certain strings.
Define below.
Value This field is only visible if result checking is enabled above. Enter
elements that must be contained in the response of the DNS
server. Enter each entry in one line. At least one of the elements
must be contained in the received result. If none of the element
matches the response, the sensor will show a red Down status.
For example, you can enter an IP address here if your Domain field
contains a host name. Only if the host name is resolved to the
correct IP address your sensor will show a green Up status.
Write Result Define what will be done with the results the sensor receives.
Choose between:
§ Discard sensor result : Do not store the results.
27.11.2012 377
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
13 DNS Sensor
DNS Specific
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
378 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
13 DNS Sensor
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
27.11.2012 379
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
13 DNS Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
380 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
13 DNS Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
27.11.2012 381
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
14 Enterprise Virtual Array Sensor
The Enterprise Virtual Array sensor monitors an HP StorageWorks Enterprise Virtual Array (EVA)
using the sssu.exe from HP Command View EVA Software. It can show the status of several
EVA modules, for example, status of system, controllers, enclosures, disks, disk groups,
folders, hosts, snapshots, data replication, cabinets, and many more, depending on the
available measurement components. If devices have measuring tools for fans and temperature,
the corresponding data will be displayed as well.
For these EVA components, this sensor type can show the operational status, predicted
failures, accessible media, allocation in percent, availability for VRaids in bytes, exaggerated
bytes, group host access, the number of grouped and ungrouped disks, the age of snapshots,
and the license status.
Note: You have to explicitly specify the credentials of the EVA in the sensor settings.
This sensor type uses lookups to determine the status values of some sensor channels. For
details, please see section Define Lookups 2039 .
Important notice: Currently, this sensor type is in bet a status. The methods of operating can
change at any time, as well as the available settings. Do not expect that all functions will work
properly, or that this sensor works as expected at all. Be aware that this type of sensor can be
removed again from PRTG at any time.
The EVA sensor needs the HP Command View EVA Software to be installed on the probe
system. If you do not want to install the whole command view tool, you can alternatively use
another approach. For details, please see section More 387 .
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
PRTG will perform a meta scan before you actually add this sensor type and requires basic
information for this scan in advance. Provide the requested information in the appearing
window. During the scan, PRTG will recognize all items available for monitoring based on your
input. The following settings differ in comparison to the sensor's settings page:
Scanning Mode Specify the depth of the meta scan. Choose between:
§ Basic: We recommend using this scanning mode. Various
modules of your EVA will be available for monitoring.
382 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
14 Enterprise Virtual Array Sensor
§ Full Det ail: PRTG will scan for each disk of your EVA. Every disk
will be listed in the module selection.
Select which modules you want to monitor. PRTG will create one sensor for each module you
choose. The settings you make in this dialog are valid for all of the sensors that are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Modules Select the modules you want to add a sensor for. A list of all
available items is shown with their name. Select the desired items
by adding check marks in front of the respective lines. One sensor
will be created for each selection. You can also select and deselect
all items by using the check box in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
28.05.2014 383
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
14 Enterprise Virtual Array Sensor
Module Shows the monitored module. You can adjust this setting if the
module was renamed or moved to another folder. This way, PRTG
can find the module again and the monitoring history will not be
lost.
Description
Sensor Result Define what will be done with the results the sensor receives.
Choose between:
§ Discard sensor result : Do not store the results.
§ Writ e sensor result t o disk (Filename: "Result of Sensor
[ID].t xt "): Store the last result received to the "Logs (Sensors)"
directory (on the Master node, if in a cluster). This is for
debugging purposes. The file will be overridden with each
scanning interval. For information on how to find the folder used
for storage, please see Dat a St orage 2074 section.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
384 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
14 Enterprise Virtual Array Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
28.05.2014 385
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
14 Enterprise Virtual Array Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
386 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
14 Enterprise Virtual Array Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
More
HP Command View EVA Software
28.05.2014 387
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
14 Enterprise Virtual Array Sensor
§ http://www8.hp.com/us/en/products/storage-software/product-detail.html?oid=471497
Knowledge Base: Do I really have to install the whole Command View on the probe to use the
EVA sensor?
§ http://kb.paessler.com/en/topic/55983
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
388 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
15 Event Log (Windows API) Sensor
The Event Log (Windows API) sensor monitors Event Log entries using Windows Application
Programming Interface (API). It shows the number of new records per second (speed).
You can set the sensor to a desired status individually according to a new event log entry. For
details and how to find out the correct filter, see section More 395 .
Note: This sensor type can have a high impact on the performance of your monitoring system.
Please use it with care! We recommend using not more than 50 sensors, on each probe, of this
type of sensor.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
28.05.2014 389
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
15 Event Log (Windows API) Sensor
Log File Specify the log file the sensor will monitor. The Windows event log
provides several different log files which are shown below. Choose
between:
§ Applicat ion
§ Sy st em
§ Securit y
§ Direct ory Service
§ DNS Server
§ File Replicat ion Service
Event Type Specify the type of event that will be considered by this sensor.
Other event type will not be processed. Choose between the
following event types:
§ Any
§ Error
§ Warning
§ Informat ion
§ Securit y Audit Success
§ Securit y Audit Failure
Filter by Source Filter all received events for a certain event source. If enabled, only
messages matching the defined value will be considered by the
sensor. Choose between:
· Off: Do not filter by event source.
· On: Enable filtering by event source.
Match String (Event This field is only visible if filtering is enabled above. Enter a source
Source) from which the events are to come from. Only events from a
source matching this string will be regarded, others ignored. Please
enter a string.
Filter by ID Filter all received events for a certain event ID. If enabled, only
messages matching the defined value(s) will be considered by the
sensor. Choose between:
· Off: Do not filter by event ID.
390 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
15 Event Log (Windows API) Sensor
Match Value (Event ID) This field is only visible if filtering is enabled above. Enter one or
more event IDs (comma separated) from which the events are to
come from. Only events with an ID matching one of the values will
be regarded. Please enter one integer value or more comma
separated integer values.
Filter by Category Filter all received events for a certain event category. If enabled,
only messages matching the defined value will be considered by
the sensor. Choose between:
· Off: Do not filter by event category.
· On: Enable filtering by event category.
Match String (Event This field is only visible if filtering is enabled above. Enter a category
Category) which the events are to have. Only events with a category
matching this string will be regarded. Please enter a string.
Filter by Event User Filter all received events for a certain event user. If enabled, only
messages matching the defined value will be considered by the
sensor. Choose between:
· Off: Do not filter by event user.
· On: Enable filtering by event user.
Match String (Event This field is only visible if filtering is enabled above. Enter a user
User) name which the event are to be assigned to. Only events with a
user name matching this string will be regarded. Please enter a
string.
Filter by Event Filter all received events for a certain event computer. If enabled,
Computer only messages matching the defined value will be considered by
the sensor. Choose between:
· Off: Do not filter by event computer.
· On: Enable filtering by event computer.
Match String (Event This field is only visible if filtering is enabled above. Enter a
Computer) computer name which the events are to be assigned to. Only
events with a computer name matching this string will be regarded.
Please enter a string.
Filter by Event Filter all received events for a certain event message. If enabled,
Message only messages matching the defined value will be considered by
the sensor. Choose between:
28.05.2014 391
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
15 Event Log (Windows API) Sensor
Match String (Event This field is only visible if filtering is enabled above. Enter a message
Message) which the event must contain. Only events with a message
matching this string will be regarded. Please enter a string.
Note: The Event Log (Windows API) Sensor always performs a substring match. Please do not
use any placeholder character. For example, enter RAS for any event source containing this
string in partial or whole form.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
392 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
15 Event Log (Windows API) Sensor
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
28.05.2014 393
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
15 Event Log (Windows API) Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
394 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
15 Event Log (Windows API) Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
More
Knowledge Base: Event Log Sensors: Setting Correct Status and Source Filter
§ http://kb.paessler.com/en/topic/59803
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
28.05.2014 395
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
15 Event Log (Windows API) Sensor
Others
For more general information about settings, please see Object Set t ings 142 section.
396 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
16 Exchange Backup (Powershell) Sensor
The Exchange Backup (Powershell) sensor monitors backups of an Exchange server using
Remote PowerShell. It shows several states of an Exchange database backup, for example, the
last full backup, the last differential backup, and if currently a backup is running.
Note: The parent device for this sensor must be an Exchange server version 2010 or higher.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on.
This sensor type uses PowerShell commands. In order to monitor devices with this sensor,
Remot e PowerShell and Remot e Exchange Management Shell have to be enabled on the
server. Ensure that you have installed PowerShell 2.0 or later on your probe machine. For
more information, please see section More below.
In order to connect to Exchange servers, this sensor type needs the fully qualified domain
name (FQDN). In PRTG's device settings of the Exchange server, provide the FQDN instead of
the IP address. For more information, please see section More below.
The user of this sensor needs elevated rights on the Exchange system. It is not sufficient to
have administrator rights. Please see section More below for detailed information on rights
management.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor backups of Exchange server databases, PRTG will create one sensor for
each database you choose. The settings you make in this dialog are valid for all of the sensors
that are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
03.04.2014 397
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
16 Exchange Backup (Powershell) Sensor
Exchange Databases Select the databases you want to add a sensor for. A list of all
to be monitored on available items is shown with their name. Select the desired items
this server by adding check marks in front of the respective lines. One sensor
will be created for each selection. You can also select and deselect
all items by using the check box in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Sensor Result Define what will be done with the results the sensor receives.
Choose between:
§ Discard sensor result : Do not store the results.
398 03.04.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
16 Exchange Backup (Powershell) Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
03.04.2014 399
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
16 Exchange Backup (Powershell) Sensor
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
400 03.04.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
16 Exchange Backup (Powershell) Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
03.04.2014 401
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
16 Exchange Backup (Powershell) Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
More
Knowledge Base: Resolving Exchange PowerShell Sensors Issues
§ http://kb.paessler.com/en/topic/54353
Knowledge Base: How do I enable and use remote commands in Windows PowerShell?
§ http://kb.paessler.com/en/topic/44453
Knowledge Base: My Powershell sensor returns an error message. What can I do?
§ http://kb.paessler.com/en/topic/59473
Knowledge Base: "No Logon Servers Available" when Using PowerShell Sensors
§ http://kb.paessler.com/en/topic/59745
402 03.04.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
16 Exchange Backup (Powershell) Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
03.04.2014 403
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
17 Exchange Database (Powershell) Sensor
Note: The parent device for this sensor must be an Exchange server version 2010 or higher.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on.
This sensor type uses PowerShell commands. In order to monitor devices with this sensor,
Remot e PowerShell and Remot e Exchange Management Shell have to be enabled on the
server. Ensure that you have installed PowerShell 2.0 or later on your probe machine. For
more information, please see section More below.
In order to connect to Exchange servers, this sensor type needs the fully qualified domain
name (FQDN). In PRTG's device settings of the Exchange server, provide the FQDN instead of
the IP address. For more information, please see section More below.
The user of this sensor needs elevated rights on the Exchange system. It is not sufficient to
have administrator rights. Please see section More below for detailed information on rights
management.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor databases of an Exchange server, PRTG will create one sensor for each
database you choose. The settings you make in this dialog are valid for all of the sensors that
are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
404 03.04.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
17 Exchange Database (Powershell) Sensor
Exchange Databases Select the databases you want to add a sensor for. A list of all
to be monitored on available items is shown with their name. Select the desired items
this server by adding check marks in front of the respective lines. One sensor
will be created for each selection. You can also select and deselect
all items by using the check box in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
AutoRemount Define if you want the sensor to try to remount the database
Database automatically if it is unmounted. Choose between:
§ Try t o remount
§ Just report t he current reading, keep unmount ed if so
03.04.2014 405
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
17 Exchange Database (Powershell) Sensor
Sensor Result Define what will be done with the results the sensor receives.
Choose between:
§ Discard sensor result : Do not store the results.
§ Writ e sensor result t o disk (Filename: "Result of Sensor
[ID].t xt "): Store the last result received to the "Logs (Sensors)"
directory (on the Master node, if in a cluster). This is for
debugging purposes. The file will be overridden with each
scanning interval. For information on how to find the folder used
for storage, please see Dat a St orage 2074 section.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
406 03.04.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
17 Exchange Database (Powershell) Sensor
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
03.04.2014 407
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
17 Exchange Database (Powershell) Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
408 03.04.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
17 Exchange Database (Powershell) Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
More
Knowledge Base: Resolving Exchange PowerShell Sensors Issues
§ http://kb.paessler.com/en/topic/54353
Knowledge Base: How do I enable and use remote commands in Windows PowerShell?
§ http://kb.paessler.com/en/topic/44453
Knowledge Base: My Powershell sensor returns an error message. What can I do?
§ http://kb.paessler.com/en/topic/59473
Knowledge Base: "No Logon Servers Available" when Using PowerShell Sensors
§ http://kb.paessler.com/en/topic/59745
03.04.2014 409
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
17 Exchange Database (Powershell) Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
410 03.04.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
18 Exchange Mailbox (Powershell) Sensor
The Exchange Mailbox (Powershell) sensor monitors mailboxes of an Exchange server using
Remote PowerShell. It shows several states of a mailbox, for example, total size of items, the
number of items, and the time of the last login.
Note: The parent device for this sensor must be an Exchange server version 2010 or higher.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on.
This sensor type uses PowerShell commands. In order to monitor devices with this sensor,
Remot e PowerShell and Remot e Exchange Management Shell have to be enabled on the
server. Ensure that you have installed PowerShell 2.0 or later on your probe machine. For
more information, please see section More below.
In order to connect to Exchange servers, this sensor type needs the fully qualified domain
name (FQDN). In PRTG's device settings of the Exchange server, provide the FQDN instead of
the IP address. For more information, please see section More below.
The user of this sensor needs elevated rights on the Exchange system. It is not sufficient to
have administrator rights. Please see section More below for detailed information on rights
management.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor mailboxes of Exchange servers, PRTG will create one sensor for each
mailbox you choose. The settings you make in this dialog are valid for all of the sensors that
are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
03.04.2014 411
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
18 Exchange Mailbox (Powershell) Sensor
Mailboxes to be Select the mailboxes you want to add a sensor for. A list of all
monitored available items is shown with their name. Select the desired items
by adding check marks in front of the respective lines. One sensor
will be created for each selection. You can also select and deselect
all items by using the check box in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Mailbox Name Shows the name of the monitored mailbox. Once a sensor is
created this value cannot be changed. It is shown for reference
purposes only. If you need to change this, please add the sensor
anew.
Sensor Result Define what will be done with the results the sensor receives.
Choose between:
§ Discard sensor result : Do not store the results.
412 03.04.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
18 Exchange Mailbox (Powershell) Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
03.04.2014 413
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
18 Exchange Mailbox (Powershell) Sensor
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
414 03.04.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
18 Exchange Mailbox (Powershell) Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
03.04.2014 415
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
18 Exchange Mailbox (Powershell) Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
More
Knowledge Base: Resolving Exchange PowerShell Sensors Issues
§ http://kb.paessler.com/en/topic/54353
Knowledge Base: How do I enable and use remote commands in Windows PowerShell?
§ http://kb.paessler.com/en/topic/44453
Knowledge Base: My Powershell sensor returns an error message. What can I do?
§ http://kb.paessler.com/en/topic/59473
Knowledge Base: "No Logon Servers Available" when Using PowerShell Sensors
§ http://kb.paessler.com/en/topic/59745
416 03.04.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
18 Exchange Mailbox (Powershell) Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
03.04.2014 417
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
19 Exchange Mail Queue (Powershell) Sensor
The Exchange Mail Queue (Powershell) sensor monitors the number of items in the outgoing
mail queue of an Exchange server using Remote PowerShell. It shows, for example, queued
mails, retrying mails, unreachable mails, and poisonous mails. See section More 423 below for
an explanation of the transport queue types.
Note: The parent device for this sensor must be an Exchange server version 2010 or higher.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on.
This sensor type uses PowerShell commands. In order to monitor devices with this sensor,
Remot e PowerShell and Remot e Exchange Management Shell have to be enabled on the
server. Ensure that you have installed PowerShell 2.0 or later on your probe machine. For
more information, please see section More below.
In order to connect to Exchange servers, this sensor type needs the fully qualified domain
name (FQDN). In PRTG's device settings of the Exchange server, provide the FQDN instead of
the IP address. For more information, please see section More below.
The user of this sensor needs elevated rights on the Exchange system. It is not sufficient to
have administrator rights. Please see section More below for detailed information on rights
management.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor message queues of Exchange servers, PRTG will create one sensor for
each role you choose. The settings you make in this dialog are valid for all of the sensors that
are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
418 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
19 Exchange Mail Queue (Powershell) Sensor
Hub-Transport or Edge- Select the roles you want to add a sensor for. A list of all available
Server items is shown with their name. Select the desired items by adding
check marks in front of the respective lines. One sensor will be
created for each selection. You can also select and deselect all
items by using the check box in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Sensor Result Define what will be done with the results the sensor receives.
Choose between:
§ Discard sensor result : Do not store the results.
§ Writ e sensor result t o disk (Filename: "Result of Sensor
[ID].t xt "): Store the last result received to the "Logs (Sensors)"
directory (on the Master node, if in a cluster). This is for
debugging purposes. The file will be overridden with each
scanning interval. For information on how to find the folder used
for storage, please see Dat a St orage 2074 section.
28.05.2014 419
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
19 Exchange Mail Queue (Powershell) Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
420 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
19 Exchange Mail Queue (Powershell) Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
28.05.2014 421
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
19 Exchange Mail Queue (Powershell) Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
422 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
19 Exchange Mail Queue (Powershell) Sensor
More
Knowledge Base: My Powershell sensor returns an error message. What can I do?
§ http://kb.paessler.com/en/topic/59473
Knowledge Base: "No Logon Servers Available" when Using PowerShell Sensors
§ http://kb.paessler.com/en/topic/59745
Knowledge Base: Types of Transport Queues in Microsoft Exchange
§ http://kb.paessler.com/en/topic/55413
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
28.05.2014 423
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
20 Exchange Public Folder (Powershell) Sensor
The Exchange Public Folder (Powershell) sensor monitors public folders of an Exchange server
using Remote PowerShell. It shows several states of a public folder, for example, its total size,
the number of items, and the time of the last access.
Note: The parent device for this sensor must be an Exchange server version 2010 or higher.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on.
This sensor type uses PowerShell commands. In order to monitor devices with this sensor,
Remot e PowerShell and Remot e Exchange Management Shell have to be enabled on the
server. Ensure that you have installed PowerShell 2.0 or later on your probe machine. For
more information, please see section More below.
In order to connect to Exchange servers, this sensor type needs the fully qualified domain
name (FQDN). In PRTG's device settings of the Exchange server, provide the FQDN instead of
the IP address. For more information, please see section More below.
The user of this sensor needs elevated rights on the Exchange system. It is not sufficient to
have administrator rights. Please see section More below for detailed information on rights
management.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor public folders of Exchange servers, PRTG will create one sensor for each
folder you choose. The settings you make in this dialog are valid for all of the sensors that are
created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
424 03.04.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
20 Exchange Public Folder (Powershell) Sensor
Public Folder Select the folders you want to add a sensor for. A list of all
available items is shown with their name. Select the desired items
by adding check marks in front of the respective lines. One sensor
will be created for each selection. You can also select and deselect
all items by using the check box in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Public Folder Shows the name of the monitored folder. Once a sensor is created
this value cannot be changed. It is shown for reference purposes
only. If you need to change this, please add the sensor anew.
Sensor Result Define what will be done with the results the sensor receives.
Choose between:
§ Discard sensor result : Do not store the results.
03.04.2014 425
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
20 Exchange Public Folder (Powershell) Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
426 03.04.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
20 Exchange Public Folder (Powershell) Sensor
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
03.04.2014 427
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
20 Exchange Public Folder (Powershell) Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
428 03.04.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
20 Exchange Public Folder (Powershell) Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
More
Knowledge Base: Resolving Exchange PowerShell Sensors Issues
§ http://kb.paessler.com/en/topic/54353
Knowledge Base: How do I enable and use remote commands in Windows PowerShell?
§ http://kb.paessler.com/en/topic/44453
Knowledge Base: My Powershell sensor returns an error message. What can I do?
§ http://kb.paessler.com/en/topic/59473
Knowledge Base: "No Logon Servers Available" when Using PowerShell Sensors
§ http://kb.paessler.com/en/topic/59745
03.04.2014 429
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
20 Exchange Public Folder (Powershell) Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
430 03.04.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
21 EXE/Script Sensor
The EXE/Script sensor runs an executable file (EXE, DLL) or a script (batch file, VBScript,
Powershell) on the computer running the local or remote probe. This option is provided as
part of PRTG's Application Programming Interface (API). The sensor shows the execution time,
and can show one value returned by the executable file or script (in one channel only). For
details about the return value format please see the Applicat ion Programming Int erface
(API) Definit ion 2031 .
Note: The executable or script file must be stored on the system of the probe the sensor is
created on: If used on a remote probe, the file must be stored on the system running the
remote probe. In a cluster setup, please copy the file to every cluster node.
Note: If you want to execute a custom Windows Management Instrumentation Query Language
(WQL) script, please use the WMI Cust om Sensor 1529 .
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
19.07.2013 431
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
21 EXE/Script Sensor
Script Select an executable file from the list. It will be executed with every
scanning interval. In this list, files in the corresponding /Cust om
Sensors/EX E sub-directory of the probe system's PRTG program
directory are shown (see Dat a St orage 2074 ). In order for the files
to appear in this list, please store them into this folder. Store files
ending in BAT, CMD, DLL, EXE, PS1, and VBS. In order for the sensor
to show the expected values and sensor status, your files must
use the right format for the returned values (in this case,
value:message to standard output). The file's exitcode will
determine the sensor status. For detailed information on how to
build custom sensors and for the expected return format, please
see the API documentation (Applicat ion Programming Int erface
(API) Definit ion 2031 ). There, find detailed information the the
"Custom Sensors" tab.
Note: Please do not use the folder \Custom Sensors\Powershell
Scripts to store your files. This remnant from previous software
versions is not used any more and may usually be deleted.
Note: When using custom sensors on the Clust er Probe, please
copy your files to every cluster node installation.
Value Type Define what kind of values your executable or script file gives back.
Choose between:
§ Int eger: An integer is expected as return value. If the script gives
back a float, PRTG will display the value 0.
§ Float : A float is expected as return value, with a dot (.) between
pre-decimal position and decimal places. In this setting, the
sensor will also display integer values unless they don't produce
a buffer overflow.
§ Count er: Your script returns an integer which increases. PRTG
will show the difference between the values of two sensor
scans. Note: A counter must return an integer; float is not
supported here!
Channel Name Enter a name for the channel in which the returned values will be
shown. This is for display purposes only. Please enter a string.
Unit String Enter a string describing the unit of the returned values. This is for
display purposes only. Please enter a string.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
432 19.07.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
21 EXE/Script Sensor
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
EXE/Script Shows the executable or script file that is executed with each
sensor scan, as defined on sensor creation. Once a sensor is
created this value cannot be changed. It is shown for reference
purposes only. If you need to change this, please add the sensor
anew.
19.07.2013 433
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
21 EXE/Script Sensor
Security Context Define the Windows user account that will be used to run the
executable or script file. Choose between:
§ Use securit y cont ext of probe service: Run the selected file
under the same Windows user account the probe is running on.
By default, this is the Windows system user account (if not
manually changed).
§ Use Windows credent ials of parent device: Use the Windows
user account defined in the settings of the parent device this
sensor is created on. Please go to sensor's parent device's
settings to change these Windows credentials.
Mutex Name Define any desired mutex name for the process. All EXE/Script
sensors having the same mutex name will be executed serially (not
simultaneously). This is useful if you use a lot of sensors and want
to avoid high resource usage caused by processes running
simultaneously. For links to more information, please see the More
438 section below. Please enter a string or leave the field empty.
Timeout (sec.) Enter a timeout in seconds for the request. If the reply takes longer
than this value the external process is killed and an error message
is triggered.
Value Type Shows the expected value type, chosen on sensor creation. Once
a sensor is created this value cannot be changed. It is shown for
reference purposes only. If you need to change this, please add
the sensor anew. Note: The sensor cannot handle string values.
If Value Changes Define what shall be done in case the value of this sensor changes.
You can choose between:
§ Ignore changes (default ): No action will be taken on change.
§ Trigger 'On Change' not ificat ion: The sensor will send an
internal message indicating that its value has changed. In
combination with a Change Trigger, you can use this mechanism
to trigger a notification 1716 whenever the sensor value changes.
434 19.07.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
21 EXE/Script Sensor
EXE Result Define what will be done with the result the executable file gives
back. Choose between:
§ Discard EX E result : Do not store the requested web page.
§ Writ e EX E result t o disk: Store the last result received from the
script with the file name "Result of Sensor [ID].txt" to the "Logs
(Sensors)" directory (on the Master node, if in a cluster). This is
for debugging purposes. The file will be overridden with each
scanning interval. For information on how to find the folder used
for storage, please see Dat a St orage 2074 section.
§ Writ e EX E result t o disk in case of error: Store the last result
received from the script only if the sensor is in a down status.
The file name is "Result of Sensor [ID].txt" in the "Logs (Sensors)"
directory. Enable this option if you do not want failures to be
overwritten by a following success of the script.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
19.07.2013 435
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
21 EXE/Script Sensor
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
436 19.07.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
21 EXE/Script Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
19.07.2013 437
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
21 EXE/Script Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
More
Information about custom scripts and executables
438 19.07.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
21 EXE/Script Sensor
Knowledge Base: What is the Mutex Name in PRTG's EXE/Script Sensor's settings?
§ http://kb.paessler.com/en/topic/6673
Knowledge Base: How and Where Does PRTG Store its Data?
§ http://kb.paessler.com/en/topic/463
Knowledge Base: How can I test if parameters are correctly transmitted to my script when
using an EXE/Script sensor?
§ http://kb.paessler.com/en/topic/11283
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
19.07.2013 439
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
22 EXE/Script Advanced Sensor
The EXE/Script Advanced sensor runs an executable file (EXE, DLL) or a script (batch file,
VBScript, Powershell) on the computer running the local or remote probe. This option is
provided as part of PRTG's Application Programming Interface (API). The sensor can show values
returned by the executable file or script in multiple channels. The return value of this sensor
must be valid XML. For details about the return value format please see the Applicat ion
Programming Int erface (API) Definit ion 2031 .
Note: The executable or script file must be stored on the system of the probe the sensor is
created on: If used on a remote probe, the file must be stored on the system running the
remote probe. In a cluster setup, please copy the file to every cluster node.
Note: If you want to execute a custom Windows Management Instrumentation Query Language
(WQL) script, please use the WMI Cust om Sensor 1529 .
PRTG does not support more than 50 sensor channels officially. Depending on the data used
with this sensor type, you might exceed the maximum number of supported sensor channels.
In this case, PRTG will try to display all sensor channels. However, please be aware that you will
experience limited usability and performance.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
EXE/Script Select an executable file from the list. It will be executed with every
scanning interval. In this list, files in the corresponding /Cust om
Sensors/EX EX ML sub-directory of the probe system's PRTG
program directory are shown (see Dat a St orage 2074 ). In order for
the files to appear in this list, please store them into this folder.
Store files ending in BAT, CMD, DLL, EXE, PS1, and VBS. In order for
the sensor to show the expected values and sensor status, your
files must return the expected XML format to standard output.
Values and message must be embedded in the XML. For detailed
information on how to build custom sensors and for the expected
return format, please see the API documentation (Applicat ion
Programming Int erface (API) Definit ion 2031 ). There, find detailed
information the the "Custom Sensors" tab.
440 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
22 EXE/Script Advanced Sensor
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
12.05.2014 441
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
22 EXE/Script Advanced Sensor
442 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
22 EXE/Script Advanced Sensor
12.05.2014 443
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
22 EXE/Script Advanced Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Note: The St ack Unit option for stacking graphs will only work if you explicitly define the
same <unit> for at least two channels. For detailed information about sensor settings please
see the API documentation (Applicat ion Programming Int erface (API) Definit ion 2031 ).
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
444 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
22 EXE/Script Advanced Sensor
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
12.05.2014 445
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
22 EXE/Script Advanced Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
446 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
22 EXE/Script Advanced Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
More
Information about custom scripts and executables
12.05.2014 447
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
22 EXE/Script Advanced Sensor
Knowledge Base: What is the Mutex Name in PRTG's EXE/Script Sensor's settings?
§ http://kb.paessler.com/en/topic/6673
Knowledge Base: How and Where Does PRTG Store its Data?
§ http://kb.paessler.com/en/topic/463
Knowledge Base: How can I test if parameters are correctly transmitted to my script when
using an EXE/Script sensor?
§ http://kb.paessler.com/en/topic/11283
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
448 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
23 File Sensor
The File sensor monitors a file located on the probe's local disk, or a file accessible via Server
Message Block (SMB). You can monitor file content and file time stamp changes. The sensor
shows the file size, and a last modified value in days and hours.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
28.05.2014 449
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
23 File Sensor
Sensor Specific
File Name Enter the full path to the file this sensor will monitor. For example,
enter C:\Windows\file.txt. If the file is located on a network device
use the Uniform Naming Convention (UNC) path without the server
part (you would only enter share\folder\file.txt). The server part (\
\server\) is taken from this sensor's parent device's settings. Please
enter a valid path and file name. Note: In order to provide any
shares, the LanmanServer "Server" Windows service must be
running on the target computer.
Check If Specify when the sensor will send an alert. Choose between:
§ File exist s: The sensor will send an alert if the file does not exist.
§ File does not exist : The sensor will send an alert if the file
exists.
Monitor File Content Specify if the sensor will send a change notification when the
content of the file changes (based on a checksum). Choose
between:
§ Ignore changes: No action will be taken on change.
§ Trigger 'change' not ificat ion: The sensor will send an internal
message indicating that its value has changed. In combination
with a Change Trigger, you can use this mechanism to trigger a
notification 1716 whenever the sensor value changes.
Monitor File Time Specify if the sensor will send a change notification when the
Stamp content of the file's time stamp changes. Choose between:
§ Ignore changes: No action will be taken on change.
§ Trigger 'change' not ificat ion: The sensor will send an internal
message indicating that its value has changed. In combination
with a Change Trigger, you can use this mechanism to trigger a
notification 1716 whenever the sensor value changes.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
450 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
23 File Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
28.05.2014 451
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
23 File Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
452 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
23 File Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
28.05.2014 453
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
23 File Sensor
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
More
Knowledge Base: What can I do if PRTG doesn't succeed with monitoring a share? PE029 PE032
§ http://kb.paessler.com/en/topic/513
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
454 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
24 File Content Sensor
The File Content sensor checks a text file for certain strings and returns the line number of the
last match and the number of total matches. Additionally, matching lines are quoted in the
sensor message field.
Note: This sensor does not support UTF-16 encoded files! In this case, please try use a custom
sensor like the EX E/Script Sensor 431 or the EX E/Script Advanced Sensor 440 .
Note: This sensor type can have a high impact on the performance of your monitoring system.
Please use it with care! We recommend using not more than 50 sensors, on each probe, of this
type of sensor.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
28.05.2014 455
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
24 File Content Sensor
File Name Enter the full path to the file this sensor will monitor. For example,
enter C:\Windows\file.txt. If the file is located on a network device
use the Uniform Naming Convention (UNC) path without the server
part (you would only enter share\folder\file.txt). The server part (\
\server\) is taken from this sensor's parent device's settings. Please
enter a valid path and file name. Note: In order to provide any
shares, the LanmanServer "Server" Windows service must be
running on the target computer. Note: If you define a file on your
network here, please be aware that this might produce high
network traffic, because PRTG will query the entire file with every
scanning interval.
Search String Define the string inside the log file you would like to check for. The
input is not case-sensitive. Please enter a string.
Search Method Define the method you want to provide the search string with. The
pattern must be contained in one line and only the last matching
line will be given back. Choose between:
§ Simple st ring search: Search for a simple string.
§ Regular Expression: Search using a regular expression. For
more details, see Regular Expressions 2048 section.
Warning Behaviour Define under which condition the sensor will show a Warning
status. Choose between:
§ Go int o warning st at us when st ring is not found: The sensor
will show a Warning status if there is no match. Otherwise it will
remain in Up status.
§ Go int o warning st at us when st ring is found: The sensor will
show a Warning status if there is a match. Otherwise it will remain
in Up status.
If Value Changes Define what shall be done in case the value of this sensor changes.
You can choose between:
§ Ignore changes: No action will be taken on change.
§ Trigger 'change' not ificat ion: The sensor will send an internal
message indicating that its value has changed. In combination
with a Change Trigger, you can use this mechanism to trigger a
notification 1716 whenever the sensor value changes.
456 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
24 File Content Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
28.05.2014 457
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
24 File Content Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
458 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
24 File Content Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
28.05.2014 459
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
24 File Content Sensor
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
460 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
25 Folder Sensor
The Folder sensor monitors a folder using Server Message Block (SMB). You can monitor file
changes and file ages. It shows the folder size and file count, as well as the oldest and newest
file value in days and hours.
Note: The Folder sensor counts all files in a folder, including hidden files.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
28.05.2014 461
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
25 Folder Sensor
Folder Monit or
Folder Name Enter the full path to the folder this sensor will monitor. For
example, enter C:\Windows. If the file is located on a network
device, use the Uniform Naming Convention (UNC) path without the
server part (you would only enter share\folder). The server part (\
\server\) is taken from this sensor's parent device's settings. Please
enter a valid path name. Note: In order to provide any shares, the
LanmanServer "Server" Windows service must be running on the
target computer.
Monitor Folder Specify if the sensor will send a change notification when the
Changes content of the folder changes. Choose between:
· Ignore changes: Changes to the folder will not trigger a change
notification.
· Trigger 'On Change' not ificat ion: The sensor will trigger a
change notification if a file changes its timestamp or filename, or if
there are new or deleted files.
Check of File Ages Specify if the sensor will monitor the folder for certain file ages.
Choose between:
· Don't check: Do not check for the age of the files in the
specified folder(s).
· Show Warning if older: Set the sensor to warning status if one
of the files in the specified folder is older than a specific time unit.
· Show Error if older: Set the sensor to error status if one of the
files in the specified folder is older than a specific time unit.
· Show Warning if y ounger: Set the sensor to warning status if
one of the files in the specified folder is younger than a specific
time unit.
· Show Error if y ounger: Set the sensor to error status if one of
the files in the specified folder is younger than a specific time
unit.
File Age Limit This field is only visible if a file age check is enabled above. Enter
the age of a file in the folder that will trigger the sensor's status
change if undershot respectively overrun. Please enter an integer
value. The value will be interpreted as days, hours, or minutes;
according to your setting below.
462 28.05.2014
File Age Limit Unit This field is only visible if a file age check is enabled above. Specify
the unit for the file age value you entered above. Choose between:
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
25 Folder Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
28.05.2014 463
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
25 Folder Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
464 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
25 Folder Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
28.05.2014 465
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
25 Folder Sensor
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
More
Knowledge Base: What can I do if PRTG doesn't succeed with monitoring a share? PE029 PE032
§ http://kb.paessler.com/en/topic/513
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
466 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
26 FTP Sensor
The FTP sensor monitors file servers using File Transfer Protocol (FTP) and FTP over SSL (FTPS).
It shows the response time.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Sensor Specific
Timeout (Sec.) Enter a timeout in seconds for the request. If the reply takes longer
than this value the request is aborted and an error message is
triggered. The highest timeout supported is 900 seconds (15
minutes). Please enter an integer value.
14.01.2014 467
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
26 FTP Sensor
Sensor Specific
Port Enter the number of the port the sensor will try to connect to. For
non-secure connections usually port 21 is used, for implicit secure
connections usually port 990. Please enter an integer value. We
recommend using the default value. If you do not get a connection,
please try another port number.
FTP Mode Specify which FTP mode will be used for the connection. Choose
between:
§ Use act ive mode
§ Use passive mode
We recommend using the default value. If you do not get a
connection, please try the passive mode.
Username Enter a username for the FTP login. Please enter a string or leave
the field empty.
Password Enter a password for the FTP login. Please enter a string or leave
the field empty.
TLS (Transport-Level- Specify if an encryption will be used for the connection. Choose
Security) between:
§ Don't use SSL (Basic FTP, recommended): In most cases, you
will use basic FTP without encryption.
§ Use Explicit SSL/TLS if available: The sensor will try to connect
via Explicit SSL. If SSL/TLS is not supported by the server, the
sensor will try to connect without SSL/TLS and is set to Up if this
works. If the server supports SSL/TLS but the connection fails
(for example, due to a TLS handshake failure), the sensor will turn
into Down status.
§ Enforce Explicit SSL/TLS: The connection must be established
using Explicit SSL/TLS. Otherwise, the sensor will go into Down
status.
§ Use Implicit SSL/TLS: The sensor will try to connect using
Implicit SSL/TLS. Negotiating authentication and security is not
allowed in implicit mode.The client is expected to challenge the
FTP server with a TLS/SSL ClientHello message. If the server does
not receive such a message, it will drop the connection. The
sensor will go into Down status.
468 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
26 FTP Sensor
Note: Ensure that you choose the method your FTP server uses! If
your server uses Implicit SSL/TLS, the Explicit SSL/TLS connection
will not work.
Sensor Result Define what will be done with the result of the sensor. Choose
between:
§ Discard sensor result : Do not store the sensor result.
§ Writ e sensor result t o disk (Filename: "Result of Sensor
[ID].t xt "): Store the last result received from the sensor to the
"Logs (Sensor)" directory (on the Master node, if in a cluster). File
name: Result of Sensor [ID].txt. This is for debugging purposes.
The file will be overridden with each scanning interval. For
information on how to find the folder used for storage, please
see Dat a St orage 2074 section.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
14.01.2014 469
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
26 FTP Sensor
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
470 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
26 FTP Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
14.01.2014 471
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
26 FTP Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
472 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
27 FTP Server File Count Sensor
The FTP Server File Count sensor logs in to an FTP server and returns the number of files
available in the directory listing.
Note: This sensor type can have a high impact on the performance of your monitoring system.
Please use it with care! We recommend using not more than 50 sensors, on each probe, of this
type of sensor.
This sensor type requires the Microsoft .NET Framework to be installed on the computer
running the PRTG probe: Either on the local system (on every node, if on a cluster probe), or
on the system running the remote probe 2050 . If the framework is missing, you cannot create
this sensor. Note: You need to install the exact version required (a higher version will usually
not work; an exception applies to .NET 3.5 which comprises .NET 2.0 and .NET 3.0). Generally, it
is possible to run several .NET Framework versions on the same machine side-by-side. Please
install the latest update available for the required version.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Channel Name Enter a name for the channel in which the returned values will be
shown. This is for display purposes only. Please enter a string.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
07.02.2013 473
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
27 FTP Server File Count Sensor
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
FTP URL Enter the URL to check (this sensor does not use the IP Address/
DNS value of the parent device).
Username Define the username for the login. Please enter a string.
Password Define the password for the login. Please enter a string.
Count Only New Files Define if only new files will be counted. Choose between:
§ No: Always show the total number of files.
§ Yes: Show the number of new files since the last scanning
interval. Note: With the next sensor scan, any new files from the
previous scan will be regarded as old.
If Value Changes Define what shall be done in case the value of this sensor changes.
You can choose between:
§ Ignore changes: No action will be taken on change.
§ Trigger 'change' not ificat ion: The sensor will send an internal
message indicating that its value has changed. In combination
with a Change Trigger, you can use this mechanism to trigger a
notification 1716 whenever the sensor value changes.
474 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
27 FTP Server File Count Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
07.02.2013 475
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
27 FTP Server File Count Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
476 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
27 FTP Server File Count Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
07.02.2013 477
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
27 FTP Server File Count Sensor
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
478 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
28 Google Analytics Sensor
The Google Analytics sensor queries data from a Google Analytics account via Hypertext
Transfer Protocol (HTTP). It shows the values for different metrics in different sensor channels.
Note: This sensor type can have a high impact on the performance of your monitoring system.
Please use it with care! We recommend using not more than 50 sensors, on each probe, of this
type of sensor.
This sensor type requires the Microsoft .NET Framework to be installed on the computer
running the PRTG probe: Either on the local system (on every node, if on a cluster probe), or
on the system running the remote probe 2050 . If the framework is missing, you cannot create
this sensor. Note: You need to install the exact version required (a higher version will usually
not work; an exception applies to .NET 3.5 which comprises .NET 2.0 and .NET 3.0). Generally, it
is possible to run several .NET Framework versions on the same machine side-by-side. Please
install the latest update available for the required version.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
28.05.2014 479
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
28 Google Analytics Sensor
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Period (Interval) Enter how often the sensor will query data. Choose between:
§ 1 Day
§ 2 Day s
§ 3 Day s
§ 1 Week
Username Please enter the username of the Google Analytics account you
want to query. Please enter a string.
Password Please enter the password of the Google Analytics account you
want to query. Please enter a string.
Profile ID Enter the 8-digits profile ID of the Google Analytics account. For
help, please see More 484 section below.
Metrics Enter a comma separated list with all metrics you want to query. A
default set of metrics is already predefined. For help, please see
More 484 section below.
Days Define for how many days the sensor will query data. Enter 1 to
query yesterday's data only, or define any number of days. Please
enter an integer value.
Average Define if the sensor will query averaged data. Select between:
§ Use: Query averaged data. This setting only takes effect if your
entered more than "1" in the Day s setting above. Data will be
averaged over the number of days.
§ Don't use: Do not query averaged data, but receive raw data.
480 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
28 Google Analytics Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Note: For Google Analytics sensors, the scanning interval cannot be inherited. Please use the
individual settings of the sensor to define the interval in which data is received.
28.05.2014 481
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
28 Google Analytics Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
482 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
28 Google Analytics Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
28.05.2014 483
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
28 Google Analytics Sensor
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
HTTP Proxy Settings The proxy settings determine how a sensor connects to a given
URL. You can enter data for a proxy server that will be used when
connecting via HTTP or HTTPS. Note: This setting is valid for the
monitoring only and determines the behavior of sensors. In order
to change proxy settings for the core server, please see Sy st em
Administ rat ion—Core & Probes 1849 .
Name Enter the IP address or DNS name of the proxy server to use. If you
leave this field empty, no proxy will be used.
Port Enter the port number of the proxy. Often, port 8080 is used.
Please enter an integer value.
User If the proxy requires authentication, enter the username for the
proxy login. Note: Only basic authentication is available! Please
enter a string or leave the field empty.
Password If the proxy requires authentication, enter the password for the
proxy login. Note: Only basic authentication is available! Please
enter a string or leave the field empty.
More
Knowledge Base: Where do I find my Google Analytics profile ID?
§ http://kb.paessler.com/en/topic/35363
484 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
28 Google Analytics Sensor
§ http://kb.paessler.com/en/topic/35373
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
28.05.2014 485
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
29 HTTP Sensor
The HTTP sensor monitors a web server using Hypertext Transfer Protocol (HTTP). It shows the
loading time. This is the easiest way to monitor if a website (or a specific website element) is
reachable.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
HTTP Specific
Timeout (Sec.) Enter a timeout in seconds for the HTTP request. If the reply takes
longer than this value the request is aborted and an error message
is triggered. The maximum value is 900 seconds (15 minutes).
486 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
29 HTTP Sensor
HTTP Specific
URL Please enter the URL the sensor will connect to. It has to be URL
encoded! If you enter an absolute URL, this address will be
independent from the IP address/DNS name setting of the device
this sensor is created on. You can enter an URL leading to a
webpage (to measure the page source code's loading time), or
enter the URL of an image or of another page asset to measure
this element's availability and loading time. PRTG uses a smart URL
replacement which allows you to use the parent device's IP
address/DNS name setting as part of the URL. For more
information, please see section Smart URL Replacement below.
Request Method The request method determines how the given URL is requested.
§ GET: Request the website directly, like browsing the web. We
recommend using this setting for a simple check of a web page.
§ POST: Send post form data to the URL. If this setting is chosen,
you must enter the data that will be sent in the Post dat a field
below.
§ HEAD: Only request the HTTP header from the server; without the
actual web page. Although this saves bandwidth since less data
is transferred, it is not recommended because the measured
request time is not the one experienced by your users and you
might not be notified for slow results or timeouts.
Postdata This field is only visible when POST is selected in the Request
Met hod setting above. Please enter the data part for the POST
request here. Note: No XML is allowed here!
Content Type This setting is only visible when POST is selected in the Request
Met hod setting above. Define the content type of a POST request.
Choose between:
§ Default (applicat ion/x-www-form-urlencoded): This is the
default content type used to encode the form data set for
submission to the server.
§ Cust om: If you need another content type than default, enter
this content type below.
Custom Content Type This field is only visible when Cust om is selected above. Define the
content type which is needed, e.g., XML, JSON, HTTP.
SSL Specific
SSL Method This setting is relevant only when using https in the URL field. We
recommend using the default value. If you experience connection
problems, please select another SSL method from the list. Choose
between:
14.01.2014 487
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
29 HTTP Sensor
SSL Specific
§ SSL V2
§ SSL V2 or V3: This is the default setting.
§ SSL V3
§ TLS V1
Note: Other TLS versions are not supported.
Note: This sensor type implicitly supports Server Name Identification (SNI), an extension to the
TLS protocol.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
488 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
29 HTTP Sensor
HTTP Proxy Settings The proxy settings determine how a sensor connects to a given
URL. You can enter data for a proxy server that will be used when
connecting via HTTP or HTTPS. Note: This setting is valid for the
monitoring only and determines the behavior of sensors. In order
to change proxy settings for the core server, please see Sy st em
Administ rat ion—Core & Probes 1849 .
Name Enter the IP address or DNS name of the proxy server to use. If you
leave this field empty, no proxy will be used.
Port Enter the port number of the proxy. Often, port 8080 is used.
Please enter an integer value.
User If the proxy requires authentication, enter the username for the
proxy login. Note: Only basic authentication is available! Please
enter a string or leave the field empty.
Password If the proxy requires authentication, enter the password for the
proxy login. Note: Only basic authentication is available! Please
enter a string or leave the field empty.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
14.01.2014 489
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
29 HTTP Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
490 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
29 HTTP Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
14.01.2014 491
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
29 HTTP Sensor
Instead of entering a complete address in the URL field of an HTTP sensor, you can merely
enter the protocol followed by colon and three slashes (that means you can enter either
http:/// or https:/// or even a simple slash / as equivalent for http:///). PRTG will then fill in the
parent device's IP address or DNS name in front of the third slash automatically. Whether this
results in a valid URL or not, depends on the IP address or DNS name of the device where this
HTTP sensor is created on. In combination with cloning devices, the smart URL replacement
makes it easy to create many like devices.
For example, if you create a device with DNS name www.example.com and you put an HTTP
sensor on it, you can provide values the following ways:
§ Providing the value https:/// in the URL field, PRTG will automatically create the URL https://
www.example.com/ from that.
§ Using the value /help in the URL field, PRTG will automatically create and monitor the URL
http://www.example.com/help
§ It is also possible to provide a port number in the URL field which will be taken over by the
device's DNS name and internally added, for example, http://:8080/
Note: Smart URL replacement does not work for sensors running on the "Probe Device".
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
492 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
30 HTTP Advanced Sensor
The HTTP Advanced sensor monitors the source code of a web page using Hypertext Transfer
Protocol (HTTP). It supports authentication, content checks, and other advanced parameters. It
shows the loading time, bytes received, download bandwidth (speed), and time to first byte.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
HTTP Specific
Timeout (Sec.) Enter a timeout in seconds for the HTTP request. If the reply takes
longer than this value the request is aborted and an error message
is triggered. The maximum value is 900 seconds (15 minutes).
28.05.2014 493
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
30 HTTP Advanced Sensor
HTTP Specific
URL Please enter the URL the sensor will connect to. It has to be URL
encoded! If you enter an absolute URL, this address will be
independent from the IP address/DNS name setting of the device
this sensor is created on. You can enter an URL leading to a
webpage (to measure the page source code's loading time), or
enter the URL of an image or of another page asset to measure
this element's availability and loading time. PRTG uses a smart URL
replacement which allows you to use the parent device's IP
address/DNS name setting as part of the URL. For more
information, please see section Smart URL Replacement below.
Request Method The request method determines how the given URL is requested.
§ GET: Request the website directly, like browsing the web. We
recommend using this setting for a simple check of a web page.
§ POST: Send post form data to the URL. If this setting is chosen,
you must enter the data that will be sent in the Post dat a field
below.
§ HEAD: Only request the HTTP header from the server; without the
actual web page. Although this saves bandwidth since less data
is transferred, it is not recommended because the measured
request time is not the one experienced by your users and you
might not be notified for slow results or timeouts.
Postdata This field is only visible when POST is selected in the Request
Met hod setting above. Please enter the data part for the POST
request here. Note: No XML is allowed here!
Content Type This setting is only visible when POST is selected in the Request
Met hod setting above. Define the content type of a POST request.
Choose between:
§ Default (applicat ion/x-www-form-urlencoded): This is the
default content type used to encode the form data set for
submission to the server.
§ Cust om: If you need another content type than default, enter
this content type below.
Custom Content Type This field is only visible when Cust om is selected above. Define the
content type which is needed, e.g., XML, JSON, HTTP.
HTTP Engine
Monitoring Engine If you encounter unexpected errors with the standard method that
is used to monitor an URL, try to use the compatibility mode which
is based on .Net (introduced in PRTG v13.x.7). Choose between:
494 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
30 HTTP Advanced Sensor
HTTP Engine
SSL Specific
SSL Method This setting is relevant only when using https in the URL field. We
recommend using the default value. If you experience connection
problems, please select another SSL method from the list. Choose
between:
§ SSL V2
§ SSL V2 or V3: This is the default setting.
§ SSL V3
§ TLS V1
Note: Other TLS versions are not supported.
SSL Method When using the compatibility mode, the SSL specific settings are a
bit different to the default SSL settings. SSL V2 is not available. You
can choose between:
§ SSL V3
§ TLS V1
§ SSL V3 or TLS V1: This is the default setting.
Check SSL Certificates Specify if the certificate of the monitored URL will be checked.
Choose between:
§ Do not check used cert ificat es: This the default setting.
28.05.2014 495
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
30 HTTP Advanced Sensor
Note: This sensor type implicitly supports Server Name Identification (SNI), an extension to the
TLS protocol.
Protocol Version Define the HTTP protocol version that will be used when
connecting to the URL. Choose between:
§ HTTP 1.0
§ HTTP 1.1: This is the default setting.
User Agent Choose which user agent string will be sent by this sensor when
connecting to the URL defined above. Choose between:
§ Use PRTG's Default St ring: Do not enter a specific user agent,
use default setting. Usually, this is: Mozilla/5.0 (compatible; PRTG
Network Monitor (www.paessler.com); Windows)
§ Use a Cust om St ring: Use a custom user agent. Define below.
Custom User Agent This field is only visible if custom user agent is enabled above. Enter
a string which will be used as user agent when connecting to the
URL specified above.
Content Changes Define what will be done in case the content of the monitored web
page (element) changes. You can choose between:
Check For Existing Key Define whether the the result at the configured URL will be
Words (Positive) checked for keywords. Choose between:
§ Disable: Do not search for keywords.
§ Enable key word check (posit ive): In the result returned at the
URL, check if a key word exists.
Note: The content check is only intended for html websites and
might not work with other target URLs.
496 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
30 HTTP Advanced Sensor
Response Must Include This field is only visible if keyword checking is enabled above.
Define which string must be part of the source code at the given
URL. You can either enter plain text or a Regular Expression 2048 . If
the data does not include the search pattern, the sensor will be set
to an error state. Please enter a string.
For Key Word Search Define in which format you have entered the search expression in
Use the field above.
§ Plain Text : Search for the string as plain text. The characters *
and ? work here as placeholder, whereas * stands for no or any
number of characters and ? stands for exactly one character (as
known from Windows search). This behavior cannot be disabled,
so the literal search for these characters is not possible with
plain text search.
Check For Existing Key Define whether the the result at the configured URL will be
Words (Negative) checked for keywords. Choose between:
§ Disable: Do not search for keywords.
§ Enable key word check (negat ive): In the result returned at the
URL, check if a key word does not exist.
Note: The content check is only intended for html websites and
might not work with other target URLs.
Response must not This field is only visible if keyword checking is enabled above.
include Define which string must not be part of the source code at the
given URL. You can either enter plain text or a Regular Expression
2048 . If the data does include this string, the sensor will be set to an
For Key Word Search Define in which format you have entered the search expression in
Use the field above.
§ Plain Text : Search for the string as plain text. The characters *
and ? work here as placeholder, whereas * stands for no or any
number of characters and ? stands for exactly one character (as
known from Windows search). This behavior cannot be disabled,
so the literal search for these characters is not possible with
plain text search.
§ Regular Expression: Treat the search pattern as a Regular
Expression 2048 .
28.05.2014 497
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
30 HTTP Advanced Sensor
Limit Download (kb) Enter a maximum amount of data that will be transferred per every
single request. If you set content checks, please be aware that
only the content downloaded up to this limit can be checked for
search expressions.
Result Handling Define what will be done with the web page loaded at the given
URL. Choose between:
Note: This sensor loads the source code at the given URL. If you set up a content check, only
this source code is checked for the keywords. The code is not necessarily identical to the one
used to display the page when opening the same URL in a web browser, as there may be a
reload configured or certain information may be inserted after loading, e.g. via Javascript. PRTG
does not follow links to embedded objects nor does it execute scripts. Only the first page at
the given URL is loaded and checked against the expressions configured. For debugging,
please use the Result option to write the source code file to disk and look up what exactly
PRTG gets when calling the URL. If the URL configured does not point to a web page, but to a
binary file, for example, to an image, you usually won't check for content.
Authentication Define if the web page at the configured URL need authentication.
Choose between:
§ No aut hent icat ion needed
§ Web page needs aut hent icat ion
Authentication Method This field is only visible if authentication is enabled above. Please
select the authentication method the given URL is protected with.
Choose between:
498 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
30 HTTP Advanced Sensor
· Basic access aut hent icat ion (HTTP): Use simple HTTP
authentication. This is the default setting and suitable for most
cases. Note: This authentication method will transmit credentials
as plain text!
· Windows NT LAN Manager (NTLM): Use the Microsoft NTLM
protocol for authentication. This is sometimes used in Intranets
for single sign-on.
We recommend using the default value.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
28.05.2014 499
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
30 HTTP Advanced Sensor
HTTP Proxy Settings The proxy settings determine how a sensor connects to a given
URL. You can enter data for a proxy server that will be used when
connecting via HTTP or HTTPS. Note: This setting is valid for the
monitoring only and determines the behavior of sensors. In order
to change proxy settings for the core server, please see Sy st em
Administ rat ion—Core & Probes 1849 .
Name Enter the IP address or DNS name of the proxy server to use. If you
leave this field empty, no proxy will be used.
Port Enter the port number of the proxy. Often, port 8080 is used.
Please enter an integer value.
User If the proxy requires authentication, enter the username for the
proxy login. Note: Only basic authentication is available! Please
enter a string or leave the field empty.
Password If the proxy requires authentication, enter the password for the
proxy login. Note: Only basic authentication is available! Please
enter a string or leave the field empty.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
500 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
30 HTTP Advanced Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
28.05.2014 501
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
30 HTTP Advanced Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
502 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
30 HTTP Advanced Sensor
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
Instead of entering a complete address in the URL field of an HTTP sensor, you can merely
enter the protocol followed by colon and three slashes (that means you can enter either
http:/// or https:/// or even a simple slash / as equivalent for http:///). PRTG will then fill in the
parent device's IP address or DNS name in front of the third slash automatically. Whether this
results in a valid URL or not, depends on the IP address or DNS name of the device where this
HTTP sensor is created on. In combination with cloning devices, the smart URL replacement
makes it easy to create many like devices.
For example, if you create a device with DNS name www.example.com and you put an HTTP
sensor on it, you can provide values the following ways:
§ Providing the value https:/// in the URL field, PRTG will automatically create the URL https://
www.example.com/ from that.
§ Using the value /help in the URL field, PRTG will automatically create and monitor the URL
http://www.example.com/help
§ It is also possible to provide a port number in the URL field which will be taken over by the
device's DNS name and internally added, for example, http://:8080/
Note: Smart URL replacement does not work for sensors running on the "Probe Device".
More
Knowledge Base: Which user agent should I use in the HTTP Advanced sensor's settings?
§ http://kb.paessler.com/en/topic/30593
28.05.2014 503
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
30 HTTP Advanced Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
504 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
31 HTTP Apache ModStatus PerfStats Sensor
The HTTP Apache ModStatus PerfStats sensor monitors performance statistics of an Apache
web server using mod_status over HTTP. It can show the CPU load, the uptime (in seconds), the
requests per second, the bytes per request, and the number of current busy and idle worker
threads of the Apache at scan time.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
HTTP Specific
Timeout (Sec.) Enter a timeout in seconds for the HTTP request. If the reply takes
longer than this value the request is aborted and an error message
is triggered. The maximum value is 900 seconds (15 minutes).
24.10.2013 505
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
31 HTTP Apache ModStatus PerfStats Sensor
HTTP Specific
URL Please enter the URL to the mod_status module on your Apache
server; PRTG will append a "/server_status?auto" part automatically.
If you enter an absolute URL, this address will be independent from
the IP address/DNS name setting of the device this sensor is
created on. PRTG uses a smart URL replacement which allows you
to use the parent device's IP address/DNS name setting as part of
the URL. For more information, please see section Smart URL
Replacement below.
SSL Specific
SSL Method This setting is relevant only when using https in the URL field. We
recommend using the default value. If you experience connection
problems, please select another SSL method from the list. Choose
between:
§ SSL V2
§ SSL V2 or V3: This is the default setting.
§ SSL V3
§ TLS V1
Note: Other TLS versions are not supported.
Note: This sensor type implicitly supports Server Name Identification (SNI), an extension to the
TLS protocol.
Authentication Define if the web page at the configured URL need authentication.
Choose between:
§ No aut hent icat ion needed
§ Web page needs aut hent icat ion
Authentication Method This field is only visible if authentication is enabled above. Please
select the authentication method the given URL is protected with.
Choose between:
506 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
31 HTTP Apache ModStatus PerfStats Sensor
· Basic access aut hent icat ion (HTTP): Use simple HTTP
authentication. This is the default setting and suitable for most
cases. Note: This authentication method will transmit credentials
as plain text!
· Windows NT LAN Manager (NTLM): Use the Microsoft NTLM
protocol for authentication. This is sometimes used in Intranets
for single sign-on.
We recommend using the default value.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
24.10.2013 507
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
31 HTTP Apache ModStatus PerfStats Sensor
HTTP Proxy Settings The proxy settings determine how a sensor connects to a given
URL. You can enter data for a proxy server that will be used when
connecting via HTTP or HTTPS. Note: This setting is valid for the
monitoring only and determines the behavior of sensors. In order
to change proxy settings for the core server, please see Sy st em
Administ rat ion—Core & Probes 1849 .
Name Enter the IP address or DNS name of the proxy server to use. If you
leave this field empty, no proxy will be used.
Port Enter the port number of the proxy. Often, port 8080 is used.
Please enter an integer value.
User If the proxy requires authentication, enter the username for the
proxy login. Note: Only basic authentication is available! Please
enter a string or leave the field empty.
Password If the proxy requires authentication, enter the password for the
proxy login. Note: Only basic authentication is available! Please
enter a string or leave the field empty.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
508 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
31 HTTP Apache ModStatus PerfStats Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
24.10.2013 509
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
31 HTTP Apache ModStatus PerfStats Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
510 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
31 HTTP Apache ModStatus PerfStats Sensor
Instead of entering a complete address in the URL field of an HTTP sensor, you can merely
enter the protocol followed by colon and three slashes (that means you can enter either
http:/// or https:/// or even a simple slash / as equivalent for http:///). PRTG will then fill in the
parent device's IP address or DNS name in front of the third slash automatically. Whether this
results in a valid URL or not, depends on the IP address or DNS name of the device where this
HTTP sensor is created on. In combination with cloning devices, the smart URL replacement
makes it easy to create many like devices.
For example, if you create a device with DNS name www.example.com and you put an HTTP
sensor on it, you can provide values the following ways:
§ Providing the value https:/// in the URL field, PRTG will automatically create the URL https://
www.example.com/ from that.
§ Using the value /help in the URL field, PRTG will automatically create and monitor the URL
http://www.example.com/help
§ It is also possible to provide a port number in the URL field which will be taken over by the
device's DNS name and internally added, for example, http://:8080/
Note: Smart URL replacement does not work for sensors running on the "Probe Device".
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
24.10.2013 511
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
32 HTTP Apache ModStatus Totals Sensor
The HTTP Apache ModStatus Totals sensor monitors accesses and transfered data (in kBytes)
of an Apache web server using mod_status over HTTP.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
HTTP Specific
Timeout (Sec.) Enter a timeout in seconds for the HTTP request. If the reply takes
longer than this value the request is aborted and an error message
is triggered. The maximum value is 900 seconds (15 minutes).
512 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
32 HTTP Apache ModStatus Totals Sensor
HTTP Specific
URL Please enter the URL to the mod_status module on your Apache
server; PRTG will append a "/server_status?auto" part automatically.
If you enter an absolute URL, this address will be independent from
the IP address/DNS name setting of the device this sensor is
created on. PRTG uses a smart URL replacement which allows you
to use the parent device's IP address/DNS name setting as part of
the URL. For more information, please see section Smart URL
Replacement below.
SSL Specific
SSL Method This setting is relevant only when using https in the URL field. We
recommend using the default value. If you experience connection
problems, please select another SSL method from the list. Choose
between:
§ SSL V2
§ SSL V2 or V3: This is the default setting.
§ SSL V3
§ TLS V1
Note: Other TLS versions are not supported.
Note: This sensor type implicitly supports Server Name Identification (SNI), an extension to the
TLS protocol.
Authentication Define if the web page at the configured URL need authentication.
Choose between:
§ No aut hent icat ion needed
§ Web page needs aut hent icat ion
Authentication Method This field is only visible if authentication is enabled above. Please
select the authentication method the given URL is protected with.
Choose between:
24.10.2013 513
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
32 HTTP Apache ModStatus Totals Sensor
· Basic access aut hent icat ion (HTTP): Use simple HTTP
authentication. This is the default setting and suitable for most
cases. Note: This authentication method will transmit credentials
as plain text!
· Windows NT LAN Manager (NTLM): Use the Microsoft NTLM
protocol for authentication. This is sometimes used in Intranets
for single sign-on.
We recommend using the default value.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
514 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
32 HTTP Apache ModStatus Totals Sensor
HTTP Proxy Settings The proxy settings determine how a sensor connects to a given
URL. You can enter data for a proxy server that will be used when
connecting via HTTP or HTTPS. Note: This setting is valid for the
monitoring only and determines the behavior of sensors. In order
to change proxy settings for the core server, please see Sy st em
Administ rat ion—Core & Probes 1849 .
Name Enter the IP address or DNS name of the proxy server to use. If you
leave this field empty, no proxy will be used.
Port Enter the port number of the proxy. Often, port 8080 is used.
Please enter an integer value.
User If the proxy requires authentication, enter the username for the
proxy login. Note: Only basic authentication is available! Please
enter a string or leave the field empty.
Password If the proxy requires authentication, enter the password for the
proxy login. Note: Only basic authentication is available! Please
enter a string or leave the field empty.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
24.10.2013 515
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
32 HTTP Apache ModStatus Totals Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
516 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
32 HTTP Apache ModStatus Totals Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
24.10.2013 517
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
32 HTTP Apache ModStatus Totals Sensor
Instead of entering a complete address in the URL field of an HTTP sensor, you can merely
enter the protocol followed by colon and three slashes (that means you can enter either
http:/// or https:/// or even a simple slash / as equivalent for http:///). PRTG will then fill in the
parent device's IP address or DNS name in front of the third slash automatically. Whether this
results in a valid URL or not, depends on the IP address or DNS name of the device where this
HTTP sensor is created on. In combination with cloning devices, the smart URL replacement
makes it easy to create many like devices.
For example, if you create a device with DNS name www.example.com and you put an HTTP
sensor on it, you can provide values the following ways:
§ Providing the value https:/// in the URL field, PRTG will automatically create the URL https://
www.example.com/ from that.
§ Using the value /help in the URL field, PRTG will automatically create and monitor the URL
http://www.example.com/help
§ It is also possible to provide a port number in the URL field which will be taken over by the
device's DNS name and internally added, for example, http://:8080/
Note: Smart URL replacement does not work for sensors running on the "Probe Device".
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
518 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
33 HTTP Content Sensor
The HTTP Content sensor monitors a numerical value returned by a Hypertext Transfer Protocol
(HTTP) request. In the returned HTML page, each value must be placed between square
brackets [ ].
PRTG does not support more than 50 sensor channels officially. Depending on the data used
with this sensor type, you might exceed the maximum number of supported sensor channels.
In this case, PRTG will try to display all sensor channels. However, please be aware that you will
experience limited usability and performance.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
HTTP Specific
Value Type Define what kind of values your HTML file gives back. Choose
between:
§ Int eger: An integer is expected as return value.
§ Float : A float is expected as return value, with a dot (.) between
pre-decimal position and decimal places. In this setting, the
sensor will also display integer values unless they don't produce
a buffer overflow.
Note: The sensor cannot handle string values.
Number of Channels Define how many values your HTML file gives back. Each value will
be handled in its own sensor channel. Each value must be placed
between square brackets [ ]. Enter the number of bracket-value
pairs that will be returned at the defined URL. Note: Do not enter a
number less than the number of values returned. Otherwise you
will get an error message.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
28.05.2014 519
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
33 HTTP Content Sensor
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
HTTP Specific
Timeout (Sec.) Enter a timeout in seconds for the HTTP request. If the reply takes
longer than this value the request is aborted and an error message
is triggered. The maximum value is 900 seconds (15 minutes).
Script URL Please enter the URL the sensor will connect to. It has to be URL
encoded! If you enter an absolute URL, this address will be
independent from the IP address/DNS name setting of the device
this sensor is created on. PRTG uses a smart URL replacement
which allows you to use the parent device's IP address/DNS name
setting as part of the URL. For more information, please see
section Smart URL Replacement below.
Value Type The kind of values the HTML file gives back. Once a sensor is
created this value cannot be changed. It is shown for reference
purposes only. If you need to change this, please add the sensor
anew.
SSL Specific
SSL Method This setting is relevant only when using https in the URL field. We
recommend using the default value. If you experience connection
problems, please select another SSL method from the list. Choose
between:
§ SSL V2
§ SSL V2 or V3: This is the default setting.
§ SSL V3
520 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
33 HTTP Content Sensor
SSL Specific
§ TLS V1
Note: Other TLS versions are not supported.
Note: This sensor type implicitly supports Server Name Identification (SNI), an extension to the
TLS protocol.
Content Changes Define what will be done in case the content of the monitored web
page changes. You can choose between:
· Ignore changes: No action will be taken on change.
· Trigger 'change' not ificat ion: The sensor will send an internal
message indicating that the web page content has changed. In
combination with a Change Trigger, you can use this mechanism
to trigger a notification 1716 whenever the web page content
changes.
Sensor Result Define what will be done with the results the sensor receives.
Choose between:
§ Discard sensor result : Do not store the results.
§ Writ e sensor result t o disk (Filename: "Result of Sensor
(ID].t xt "): Store the last result received to the "Logs (Sensors)"
directory (on the Master node, if in a cluster). This is for
debugging purposes. The file will be overridden with each
scanning interval. For information on how to find the folder used
for storage, please see Dat a St orage 2074 section.
Authentication Define if the web page at the configured URL need authentication.
Choose between:
§ No aut hent icat ion needed
§ Web page needs aut hent icat ion
28.05.2014 521
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
33 HTTP Content Sensor
Authentication Method This field is only visible if authentication is enabled above. Please
select the authentication method the given URL is protected with.
Choose between:
· Basic access aut hent icat ion (HTTP): Use simple HTTP
authentication. This is the default setting and suitable for most
cases. Note: This authentication method will transmit credentials
as plain text!
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
522 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
33 HTTP Content Sensor
Example
You would configure the HTTP Content sensor using the mentioned script URL, value type
Float , and number of channels 2. The sensor will call the URL with every scanning interval
and only regard the two values in square brackets [ ], handling each of them in one sensor
channel. The additional description text and HTML tags are not necessary; in this example
they are added in case a human calls the URL.
Note: If you define the number of channels as 1, only the first value will be read by the
sensor; the second value will be ignored. Using 3 as number of channels will result in a
sensor error message.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
28.05.2014 523
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
33 HTTP Content Sensor
HTTP Proxy Settings The proxy settings determine how a sensor connects to a given
URL. You can enter data for a proxy server that will be used when
connecting via HTTP or HTTPS. Note: This setting is valid for the
monitoring only and determines the behavior of sensors. In order
to change proxy settings for the core server, please see Sy st em
Administ rat ion—Core & Probes 1849 .
Name Enter the IP address or DNS name of the proxy server to use. If you
leave this field empty, no proxy will be used.
Port Enter the port number of the proxy. Often, port 8080 is used.
Please enter an integer value.
User If the proxy requires authentication, enter the username for the
proxy login. Note: Only basic authentication is available! Please
enter a string or leave the field empty.
Password If the proxy requires authentication, enter the password for the
proxy login. Note: Only basic authentication is available! Please
enter a string or leave the field empty.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
524 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
33 HTTP Content Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
28.05.2014 525
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
33 HTTP Content Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
526 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
33 HTTP Content Sensor
Instead of entering a complete address in the URL field of an HTTP sensor, you can merely
enter the protocol followed by colon and three slashes (that means you can enter either
http:/// or https:/// or even a simple slash / as equivalent for http:///). PRTG will then fill in the
parent device's IP address or DNS name in front of the third slash automatically. Whether this
results in a valid URL or not, depends on the IP address or DNS name of the device where this
HTTP sensor is created on. In combination with cloning devices, the smart URL replacement
makes it easy to create many like devices.
For example, if you create a device with DNS name www.example.com and you put an HTTP
sensor on it, you can provide values the following ways:
§ Providing the value https:/// in the URL field, PRTG will automatically create the URL https://
www.example.com/ from that.
§ Using the value /help in the URL field, PRTG will automatically create and monitor the URL
http://www.example.com/help
§ It is also possible to provide a port number in the URL field which will be taken over by the
device's DNS name and internally added, for example, http://:8080/
Note: Smart URL replacement does not work for sensors running on the "Probe Device".
More
Knowledge Base article: How can I monitor internal values of a web application with PRTG?
· http://kb.paessler.com/en/topic/4
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
28.05.2014 527
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
34 HTTP Full Web Page Sensor
The HTTP Full Web Page sensor monitors the full download time of a web page including assets
such as images etc. In the background, it opens the web page in a browser instance to
perform the measurement. Links are not followed. The sensor shows the loading time of the
full page. Note: Be careful with this sensor, as it can generate considerable internet traffic if
used with a low scanning interval!
Note: This sensor type can have a high impact on the performance of your monitoring system.
Please use it with care! We recommend using not more than 50 sensors, on each probe, of this
type of sensor.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
528 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
34 HTTP Full Web Page Sensor
Timeout (Sec.) Enter a timeout in seconds for the HTTP request. If the reply takes
longer than this value the request is aborted and an error message
is triggered. The maximum value is 900 seconds (15 minutes).
URL Please enter the URL the sensor will load. It has to be URL
encoded! If you enter an absolute URL, this address will be
independent from the IP address/DNS name setting of the device
this sensor is created on. PRTG uses a smart URL replacement
which allows you to use the parent device's IP address/DNS name
setting as part of the URL. For more information, please see
section Smart URL Replacement below.
Browser Engine Define which browser will be used to load the web page. Choose
between:
§ Chromium (recommended): Use the "WebKit" engine that is
delivered with PRTG to perform the loading test. With each
scanning interval, PRTG will load the URL defined above in an
instance of "Chromium" and measure the time until the page is
fully loaded. This is the recommended setting.
§ Phant omJS (Headless Webkit ): Use the "PhantomJS" engine. This
engine can have a high impact on your probe system's CPU and
memory load, but there are additional options for result handling
available (see below).
§ Int ernet Explorer: With each scanning interval, the URL defined
above is loaded in the background in an instance of Internet
Explorer. PRTG uses the Internet Explorer of the system running
the PRTG probe. Note: For full functionality we strongly
recommend installing Internet Explorer 8 or higher on the system
running the PRTG probe. The probe machine is either the local
system (on every node, if on a cluster probe), or the system
running the remote probe 2050 on which the sensor is created on.
Note: For all browser engines, the same proxy settings are used
that are configured for the Windows user account the PRTG probe
is running on (this is usually the Windows local "system" user
account, if not changed). Those settings are accessible via the
Internet Explorer of this system. If you want to e.g. use a proxy for
this full web page sensor test, please adjust the Internet Explorer's
settings accordingly (on the computer running the probe; on all
nodes, if in a cluster).
Security Context Define the Windows user account that will be used to run the
browser engine. Choose between:
§ Use securit y cont ext of probe service (default ): Run the
browser engine under the same Windows user account the
probe is running on. By default, this is the local Windows "system"
user account (if not manually changed).
28.05.2014 529
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
34 HTTP Full Web Page Sensor
Result Handling This setting is only visible if the PhantomJS engine is selected
above. This browser engine can render and store screenshots of
the loaded web page. Choose between:
§ Discard loaded web page (recommended): Do not store the
requested web page.
§ St ore lat est screenshot of t he web page: Render and store
the last result of the web page to the "Logs (Sensors)" directory
(on the remote system, when used on a remote probe; on the
Master node, if in a cluster). This is for debugging purposes. The
file will be overridden with each scanning interval. It will be named
after the pattern "Fullpage of Sensor (ID).jpg". For information on
how to find the folder used for storage, please see Dat a
St orage 2074 section.
§ St ore ongoing screenshot s of t he web page (use wit h
caut ion!): Render and store one new screenshot of the web
page with each sensor scan, and store the pictures in the
"Screenshots (Fullpage Sensor)" directory (on the remote system,
when used on a remote probe). For information on how to find
the folder used for storage, please see Dat a St orage 2074
section. This option can be used to create a visual history of the
web page. Note: Depending on the monitored website and the
scanning interval of the sensor, a very high amount of data can
be created! Use with care, and make sure you set appropriate
data purging limits in the Sy st em Administ rat ion—Core &
Probes 1852 settings.
Note: If necessary, you can change the window size of the
rendered screenshots. See section More 534 for details.
530 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
34 HTTP Full Web Page Sensor
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
28.05.2014 531
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
34 HTTP Full Web Page Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
532 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
34 HTTP Full Web Page Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
28.05.2014 533
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
34 HTTP Full Web Page Sensor
Instead of entering a complete address in the URL field of an HTTP sensor, you can merely
enter the protocol followed by colon and three slashes (that means you can enter either
http:/// or https:/// or even a simple slash / as equivalent for http:///). PRTG will then fill in the
parent device's IP address or DNS name in front of the third slash automatically. Whether this
results in a valid URL or not, depends on the IP address or DNS name of the device where this
HTTP sensor is created on. In combination with cloning devices, the smart URL replacement
makes it easy to create many like devices.
For example, if you create a device with DNS name www.example.com and you put an HTTP
sensor on it, you can provide values the following ways:
§ Providing the value https:/// in the URL field, PRTG will automatically create the URL https://
www.example.com/ from that.
§ Using the value /help in the URL field, PRTG will automatically create and monitor the URL
http://www.example.com/help
§ It is also possible to provide a port number in the URL field which will be taken over by the
device's DNS name and internally added, for example, http://:8080/
Note: Smart URL replacement does not work for sensors running on the "Probe Device".
More
Knowledge Base: What to do when I see a CreateUniqueTempDir() error message for my HTTP
Full Webpage Sensor?
§ http://kb.paessler.com/en/topic/40783
Knowledge Base: HTTP Full Web Page sensor is "unable to navigate". What can I do?
§ http://kb.paessler.com/en/topic/59999
Knowledge Base: How can I change the size of PhantomJS full web page screenshots?
§ http://kb.paessler.com/en/topic/60247
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
534 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
34 HTTP Full Web Page Sensor
Others
For more general information about settings, please see Object Set t ings 142 section.
28.05.2014 535
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
35 HTTP Push Count Sensor
The HTTP Push Count sensor counts received messages which are pushed via an Hypertext
Transfer Protocol (HTTP) request to the PRTG server. It provides a URL that can be used to
push messages to the PRTG server using HTTP.
This function is known as webhook. Basically, a webhook works like a push notification:
Webhooks are usually triggered by some event (for example, a new comment to a blog post)
and send according information to a specified URL. The HTTP Push Count sensor then displays
the number of pushed and received messages.
Use the following URL to receive the HTTP requests of the webhook:
ht t p://<probe_ip>:<port_number>/<token>
Replace the parameters <probe_ip>, <port_number>, and <token> with the corresponding
values. You can define port number and identification token in the sensor settings; the "probe
IP" is the IP address of the system your PRTG probe with the sensor is running on.
Example: http://127.0.0.1:5050/XYZ123
Note: You can use several sensors with the same port and identification token. In this case,
the number of push messages will be shown in each of these sensors.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
536 03.04.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
35 HTTP Push Count Sensor
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
HTTP Push
Port Enter the port number on which this sensor listens for incoming
HTTP requests. Default is 5050.
Identification Token This is the token that is used to find the matching sensor for the
incoming message. While you create the sensor, this token is
{__guid__}. It will be replaced with an automatically generated token
after you have completed the sensor creation. If you want to use
another identification token, you can edit it while or after sensor
creation. Note: The token will not be replaced automatically if you
change it already during sensor creation.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
03.04.2014 537
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
35 HTTP Push Count Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
538 03.04.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
35 HTTP Push Count Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
03.04.2014 539
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
35 HTTP Push Count Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
540 03.04.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
35 HTTP Push Count Sensor
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
03.04.2014 541
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
36 HTTP Push Data Sensor
The HTTP Push Data sensor displays data from received messages which are pushed via an
Hypertext Transfer Protocol (HTTP) request to the PRTG server. It provides a URL that can be
used to push messages to the PRTG server using HTTP.
This function is known as webhook. Basically, a webhook works like a push notification:
Webhooks are usually triggered by some event (for example, a new comment to a blog post)
and send according information to a specified URL. The HTTP Push Data sensor then displays
the data of pushed and received messages.
Use the following URL to receive the HTTP requests of the webhook:
Replace the parameters <probe_ip>, <port_number>, <token>, and <integer_or_float> with the
corresponding values. The &t ext parameter is optional: You can omit it.
§ You can define port number and ident ificat ion t oken in the sensor settings.
§ The probe IP is the IP address of the system on which your PRTG probe with this sensor is
running on.
§ The value can be an integer or a float value, depending on the data of your application; you
have to set the value type accordingly in the sensor settings. This parameter will be the
sensor value.
Note: If this parameter is missing, the sensor status will be set into a down status.
§ You can opt ionally add a custom text message by replacing the parameter <text message>
with it. The text will be shown as sensor message. If there is no value but only a text, the
text will be shown as error message.
Note: This text message has to be URL encoded (for example, the whitespaces in the sample
URL below); most browsers achieve this automatically.
Example:
http://127.0.0.1:5050/XYZ123?value=0&text=this%20is%20a%20message
Note: You can use several sensors with the same port and identification token. In this case,
the data of push messages will be shown in each of these sensors.
Important notice: Currently, this sensor type is in bet a status. The methods of operating can
change at any time, as well as the available settings. Do not expect that all functions will work
properly, or that this sensor works as expected at all. Be aware that this type of sensor can be
removed again from PRTG at any time.
542 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
36 HTTP Push Data Sensor
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
28.05.2014 543
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
36 HTTP Push Data Sensor
HTTP Push
Port Enter the port number on which this sensor listens for incoming
HTTP requests. Default is 5050.
Identification Token This is the token that is used to find the matching sensor for the
incoming message. While you create the sensor, this token is
{__guid__}. It will be replaced with an automatically generated token
after you have completed the sensor creation. If you want to use
another identification token, you can edit it while or after sensor
creation. Note: The token will not be replaced automatically if you
change it already during sensor creation.
No Incoming Data Define which status the sensor will attain if no push message has
been received for at least two sensor scans. Choose between:
§ Ignore and keep last st at us (default ): The sensor will remain in
the status as defined by the last message received.
§ Swit ch t o "Unknown" st at us: The sensor will turn into the
Unknown status if there has not been received any message for
at least two sensor scans.
Value Type Define which type the value of the received data has. If this setting
does not match, the sensor will go into an Error status. Choose
between:
§ Int eger
§ Float (with dot "." as delimiter)
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
544 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
36 HTTP Push Data Sensor
Sensor Display
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
28.05.2014 545
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
36 HTTP Push Data Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
546 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
36 HTTP Push Data Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
28.05.2014 547
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
36 HTTP Push Data Sensor
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
548 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
37 HTTP Push Data Advanced Sensor
The HTTP Push Data Advanced sensor displays data from received messages which are pushed
via an Hypertext Transfer Protocol (HTTP) request to the PRTG server. It provides a URL that
can be used to push messages to the PRTG server using HTTP. It can show pushed values in
multiple channels.
This function is known as webhook. Basically, a webhook works like a push notification:
Webhooks are usually triggered by some event (for example, a new comment to a blog post)
and send according information to a specified URL. The HTTP Push Data Advanced sensor then
displays the data of pushed and received messages.
The data which is pushed to this sensor must be valid XML. For details about the return value
format please see the Applicat ion Programming Int erface (API) Definit ion 2031 .
Use the following URLs to receive the HTTP requests of the webhook:
The XML encoded value of the content parameter has to match the format as defined in the
API documentation 2031 in section Cust om Sensors—Advanced EX E/Script Sensor,
Advanced SSH Script Sensor, and Advanced HTTP Push Dat a Sensor.
This HTTP request method sends the XML encoded HTTP body as POST data. The body has to
match the format as defined in the API documentation 2031 in section Cust om Sensors—
Advanced EX E/Script Sensor, Advanced SSH Script Sensor, and Advanced HTTP Push
Dat a Sensor. We strongly recommend the HTTP content type application/xml.
Replace the parameters <probe_ip>, <port_number>, <token> and <valid XML> (for GET
requests) with the corresponding values:
§ You can define port number and ident ificat ion t oken in the sensor settings.
§ The probe IP is the IP address of the system on which your PRTG probe with this sensor is
running on.
§ The content of GET requests has to be valid XML in the PRTG API format.
Note: The content has to be URL encoded (for example, the whitespaces in the sample URL
below); most browsers achieve this automatically.
Minimum example for t he GET met hod which returns one static channel value:
http://127.0.0.1:5050/XYZ123?content=<prtg><result><channel>MyChannel</channel><value>10</value><
Note: You can use several sensors with the same port and identification token. In this case,
the data of push messages will be shown in each of these sensors.
12.05.2014 549
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
37 HTTP Push Data Advanced Sensor
Important notice: Currently, this sensor type is in bet a status. The methods of operating can
change at any time, as well as the available settings. Do not expect that all functions will work
properly, or that this sensor works as expected at all. Be aware that this type of sensor can be
removed again from PRTG at any time.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
550 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
37 HTTP Push Data Advanced Sensor
HTTP Push
Port Enter the port number on which this sensor listens for incoming
HTTP requests. Default is 5050.
Identification Token This is the token that is used to find the matching sensor for the
incoming message. While you create the sensor, this token is
{__guid__}. It will be replaced with an automatically generated token
after you have completed the sensor creation. If you want to use
another identification token, you can edit it while or after sensor
creation. Note: The token will not be replaced automatically if you
change it already during sensor creation.
No Incoming Data Define which status the sensor will attain if no push message has
been received for at least two sensor scans. Choose between:
§ Ignore and keep last st at us (default ): The sensor will remain in
the status as defined by the last message received.
§ Swit ch t o "Unknown" st at us: The sensor will turn into the
Unknown status if there has not been received any message for
at least two sensor scans.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
12.05.2014 551
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
37 HTTP Push Data Advanced Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
552 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
37 HTTP Push Data Advanced Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
12.05.2014 553
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
37 HTTP Push Data Advanced Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
554 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
37 HTTP Push Data Advanced Sensor
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
12.05.2014 555
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
38 HTTP SSL Certificate Expiry Sensor
The HTTP SSL Certificate Expiry Sensor checks a specific https-URL and returns the number of
days remaining until the site's SSL certificate expires. It shows a Warning when only 60 days
are left, and an Error status when only 30 days are remaining until the certificate expires.
Note: This sensor does not work on probes running on Windows Server 2003 (including SP1
and SP2).
Note: This sensor type can have a high impact on the performance of your monitoring system.
Please use it with care! We recommend using not more than 50 sensors, on each probe, of this
type of sensor.
This sensor type requires the Microsoft .NET Framework to be installed on the computer
running the PRTG probe: Either on the local system (on every node, if on a cluster probe), or
on the system running the remote probe 2050 . If the framework is missing, you cannot create
this sensor. Note: You need to install the exact version required (a higher version will usually
not work; an exception applies to .NET 3.5 which comprises .NET 2.0 and .NET 3.0). Generally, it
is possible to run several .NET Framework versions on the same machine side-by-side. Please
install the latest update available for the required version.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
556 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
38 HTTP SSL Certificate Expiry Sensor
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
URL Enter the absolute URL to check (this sensor does not use the IP
Address/DNS value of the parent device). It has to be URL
encoded!
SSLv3 Connection Define if you want to allow SSLv3 only for connections to the URL
configured above. Choose between:
§ Use SSLv3 if available
§ Force usage of SSLv3
Certificate Name Define if you want to check if the defined URL matches the
Validation certificate. Choose between:
§ The cert ificat e must mat ch t he DNS name
§ Accept any cert ificat e
28.05.2014 557
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
38 HTTP SSL Certificate Expiry Sensor
HTTP Proxy Settings The proxy settings determine how a sensor connects to a given
URL. You can enter data for a proxy server that will be used when
connecting via HTTP or HTTPS. Note: This setting is valid for the
monitoring only and determines the behavior of sensors. In order
to change proxy settings for the core server, please see Sy st em
Administ rat ion—Core & Probes 1849 .
Name Enter the IP address or DNS name of the proxy server to use. If you
leave this field empty, no proxy will be used.
Port Enter the port number of the proxy. Often, port 8080 is used.
Please enter an integer value.
User If the proxy requires authentication, enter the username for the
proxy login. Note: Only basic authentication is available! Please
enter a string or leave the field empty.
Password If the proxy requires authentication, enter the password for the
proxy login. Note: Only basic authentication is available! Please
enter a string or leave the field empty.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
558 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
38 HTTP SSL Certificate Expiry Sensor
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
28.05.2014 559
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
38 HTTP SSL Certificate Expiry Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
560 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
38 HTTP SSL Certificate Expiry Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
28.05.2014 561
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
39 HTTP Transaction Sensor
The HTTP Transaction sensor monitors an interactive website, such as a web shop, by
performing a transaction using a set of Hypertext Transfer Protocol (HTTP) URLs. The sensor
monitors whether logins or shopping carts work properly. It returns the loading time.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
HTTP Specific
Timeout (Sec.) Enter a timeout in seconds for all HTTP requests. If the complete
transaction takes longer than this value the request is aborted and
an error message is triggered. The maximum value is 900 seconds
(15 minutes).
562 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
39 HTTP Transaction Sensor
HTTP Specific
Single URL Timeout Enter a timeout in seconds for one single HTTP request. If the reply
(Sec.) of any single request takes longer than this value the transaction is
aborted and an error message is triggered. The maximum value is
900 seconds (15 minutes).
HTTP Engine
Monitoring Engine If you encounter unexpected errors with the standard method that
is used to monitor an URL, try to use the compatibility mode which
is based on .Net (introduced in PRTG v13.x.7). Choose between:
§ Default /High Performance (recommended): This is the default
monitoring method for this sensor type.
§ Alt ernat e/Compat ibilit y Mode: Try this method as an
alternative for websites that do not work with the default
approach. Using the compatibility mode, this sensor will execute
an external exe. Thus, this method will need more resources, but
it can be helpful in particular cases. Note: If you select the
compatibility mode, the options for the SSL method will be
slightly different. You can also check for trusted certificates.
Please see below.
Note: When using the Compatibility Mode, Smart URL
Replacement will not work, i.e., this sensor does not use the IP
Address/DNS value of the parent device automatically then.
SSL Specific
SSL Method This setting is relevant only when using https in the URL field. We
recommend using the default value. If you experience connection
problems, please select another SSL method from the list. Choose
between:
§ SSL V2
§ SSL V2 or V3: This is the default setting.
§ SSL V3
§ TLS V1
Note: Other TLS versions are not supported.
28.05.2014 563
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
39 HTTP Transaction Sensor
SSL Method When using the compatibility mode, the SSL specific settings are a
bit different to the default SSL settings. SSL V2 is not available. You
can choose between:
§ SSL V3
§ TLS V1
§ SSL V3 or TLS V1: This is the default setting.
Check SSL Certificates Specify if the certificate of the monitored URL will be checked.
Choose between:
§ Do not check used cert ificat es: This the default setting.
§ Check if t he used cert ificat es are t rust ed: If the certificate of
the server is not trusted, the sensor will go into a Down status
and display a corresponding message.
Note: This sensor type implicitly supports Server Name Identification (SNI), an extension to the
TLS protocol.
Limit Download (kb) Enter a maximum amount of data that will be transferred per every
single request. If you set content checks below, please be aware
that only the content downloaded within this limit can be checked
for certain search expressions.
Cookie Management Select if cookies will be used for the transaction. Choose between:
· Use cookies (recommended): Allow cookies to be set and read
during the transaction cycle.
· Ignore cookies: Do not allow cookies. Use this option if you
want to test the transaction without the use of cookies.
We recommend using the default value.
Result Handling Define what will be done with the web page loaded at the given
URL. Choose between:
· Discard HTML result : Do not store the requested web page.
· St ore lat est HTML result : Store the last result of the requested
web page to the "Logs (Sensors)" directory (on the Master node,
if in a cluster). This is for debugging purposes, especially in
combination with content checks. The file will be overridden with
each scanning interval. For information on how to find the folder
used for storage, please see Dat a St orage 2074 section.
564 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
39 HTTP Transaction Sensor
Authentication Define if the web page at the configured URL need authentication.
Choose between:
§ No aut hent icat ion needed
§ Web page needs aut hent icat ion
Authentication Method This field is only visible if authentication is enabled above. Please
select the authentication method the given URL is protected with.
Choose between:
· Basic access aut hent icat ion (HTTP): Use simple HTTP
authentication. This is the default setting and suitable for most
cases. Note: This authentication method will transmit credentials
as plain text!
· Windows NT LAN Manager (NTLM): Use the Microsoft NTLM
protocol for authentication. This is sometimes used in Intranets
for single sign-on.
We recommend using the default value.
You can define up to 10 different transaction URLs which will all be called in a row. Only if the
complete transaction can be completed, the sensor will be in an Up status 121 . Using this
mechanism you can set up an extended monitoring with multiple URLs. Please enter settings
for at least one transaction URL. You can use as many steps as needed and disable the other
steps.
Transaction Step #x This setting is available for URL #2 through #10. Define if you want
to use this step for your transaction check. Choose between:
§ Disable st ep #x: Do not use this step. Choose this option if you
do not need all 10 steps for your transaction check.
§ Enable st ep #x: Enable this step. Further options will be viewed,
as described below.
28.05.2014 565
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
39 HTTP Transaction Sensor
URL Please enter the URL the sensor will connect to. It has to be URL
encoded! If you enter an absolute URL, this address will be
independent from the IP address/DNS name setting of the device
this sensor is created on. PRTG uses a smart URL replacement
which allows you to use the parent device's IP address/DNS name
setting as part of the URL. For more information, please see
section Smart URL Replacement below.
Request Method The request method determines how the given URL is requested.
· GET: Request the website directly, like browsing the web. We
recommend using this setting for a simple check of a web page.
· POST: Send post form data to the URL. If this setting is chosen,
you must enter the data that will be sent in the Post dat a field
below.
· HEAD: Only request the HTTP header from the server; without the
actual web page. Although this saves bandwidth since less data
is transferred, it is not recommended because the measured
request time is not the one experienced by your users and you
might not be notified for slow results or timeouts.
Postdata This field is only active when POST is selected in the Request
Met hod setting above. Please enter the data part for the post
request here. Note: No XML is allowed here!
Check For Existing Key Define whether the result at the configured URL will be checked for
Words (Positive) keywords. Choose between:
§ Disable: Do not search for keywords.
§ Enable key word check (posit ive): In the result returned at the
URL, check if a key word exists.
Note: The content check is only intended for html websites and
might not work with other target URLs.
Response Must Include Define which string must be part of the web at the given URL. If the
data does not include this string, the sensor will be set to an error
state. Please enter a string. Note: Only simple text search is
available here. The characters * and ? work here as placeholder,
whereas * stands for no or any number of characters and ? stands
for exactly one character (as known from Windows search). This
behavior cannot be disabled, so the literal search for these
characters is not possible.
Check For Existing Key Define whether the the result at the configured URL will be
Words (Negative) checked for keywords. Choose between:
§ Disable: Do not search for keywords.
566 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
39 HTTP Transaction Sensor
§ Enable key word check (negat ive): In the result returned at the
URL, check if a key word does not exist.
Note: The content check is only intended for html websites and
might not work with other target URLs.
Response Must Not Define which string must not be part of the web at the given URL. If
Include the data does include this string, the sensor will be set to an error
state. Please enter a string. Note: Only simple text search is
available here. The characters * and ? work here as placeholder,
whereas * stands for no or any number of characters and ? stands
for exactly one character (as known from Windows search). This
behavior cannot be disabled, so the literal search for these
characters is not possible.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
HTTP Proxy Settings The proxy settings determine how a sensor connects to a given
URL. You can enter data for a proxy server that will be used when
connecting via HTTP or HTTPS. Note: This setting is valid for the
monitoring only and determines the behavior of sensors. In order
to change proxy settings for the core server, please see Sy st em
Administ rat ion—Core & Probes 1849 .
Name Enter the IP address or DNS name of the proxy server to use. If you
leave this field empty, no proxy will be used.
Port Enter the port number of the proxy. Often, port 8080 is used.
Please enter an integer value.
User If the proxy requires authentication, enter the username for the
proxy login. Note: Only basic authentication is available! Please
enter a string or leave the field empty.
Password If the proxy requires authentication, enter the password for the
proxy login. Note: Only basic authentication is available! Please
enter a string or leave the field empty.
28.05.2014 567
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
39 HTTP Transaction Sensor
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
568 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
39 HTTP Transaction Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
28.05.2014 569
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
39 HTTP Transaction Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Instead of entering a complete address in the URL field of an HTTP sensor, you can merely
enter the protocol followed by colon and three slashes (that means you can enter either
http:/// or https:/// or even a simple slash / as equivalent for http:///). PRTG will then fill in the
parent device's IP address or DNS name in front of the third slash automatically. Whether this
results in a valid URL or not, depends on the IP address or DNS name of the device where this
HTTP sensor is created on. In combination with cloning devices, the smart URL replacement
makes it easy to create many like devices.
For example, if you create a device with DNS name www.example.com and you put an HTTP
sensor on it, you can provide values the following ways:
§ Providing the value https:/// in the URL field, PRTG will automatically create the URL https://
www.example.com/ from that.
§ Using the value /help in the URL field, PRTG will automatically create and monitor the URL
http://www.example.com/help
§ It is also possible to provide a port number in the URL field which will be taken over by the
device's DNS name and internally added, for example, http://:8080/
570 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
39 HTTP Transaction Sensor
Note: Smart URL replacement does not work for sensors running on the "Probe Device".
More
Knowledge Base: Configuration Tips for HTTP Transaction Sensors needed
§ http://kb.paessler.com/en/topic/443
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
28.05.2014 571
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
40 HTTP XML/REST Value Sensor
The HTTP XML/REST Value sensor retrieves an XML file from a given URL and parses it. It can
return the values of specific nodes.
Note: This sensor type can have a high impact on the performance of your monitoring system.
Please use it with care! We recommend using not more than 50 sensors, on each probe, of this
type of sensor.
This sensor type requires the Microsoft .NET Framework to be installed on the computer
running the PRTG probe: Either on the local system (on every node, if on a cluster probe), or
on the system running the remote probe 2050 . If the framework is missing, you cannot create
this sensor. Note: You need to install the exact version required (a higher version will usually
not work; an exception applies to .NET 3.5 which comprises .NET 2.0 and .NET 3.0). Generally, it
is possible to run several .NET Framework versions on the same machine side-by-side. Please
install the latest update available for the required version.
PRTG does not support more than 50 sensor channels officially. Depending on the data used
with this sensor type, you might exceed the maximum number of supported sensor channels.
In this case, PRTG will try to display all sensor channels. However, please be aware that you will
experience limited usability and performance.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Channel Name Enter a name for the channel which will display the value at the
given URL. The name can be changed later in the Sensor Channels
Set t ings 1709 .
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
572 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
40 HTTP XML/REST Value Sensor
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
URL Enter the absolute URL that returns the XML file (this sensor does
not use the IP Address/DNS value of the parent device). It has to
be URL encoded!
XML Node (and Enter the name of the node this sensor will check, or enter a node
optional property) name and a property name to check a property value. To obtain a
value from nested tags, please enter the tag names separated by a
slash symbol, for example, use myTag/myTagInside as XML node
value. Note: You can also check values in JavaScript Object
Notation (JSON) notation. Please see Checking JSON 579 section
below.
Note: You can try using XPath syntax here but it will not work in all
cases and we do not provide any technical support for XPath
issues.For further documentation about XPath please see More 572
section below.
HTTP Username If the URL requires authentication, enter the username. Please
enter a string or leave the field empty.
HTTP Password If the URL requires authentication, enter the password. Please
enter a string or leave the field empty.
28.05.2014 573
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
40 HTTP XML/REST Value Sensor
Count XML Nodes This setting is only visible if the return number option is enabled
above. Define which count will be returned. Choose between:
§ Occurrences of t he select ed X ML node: Return how often the
defined XML node occurs at the defined URL.
§ Child nodes of t he select ed X ML node: Return the number of
child nodes that exist below the node at the defined URL.
§ Sibling nodes of t he select ed X ML node: Return the number of
sibling nodes that exist next to the node at the defined URL.
Custom Content Type Only visible when "Custom" is enabled above. Enter a custom
content type like text/xml or text/html.
574 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
40 HTTP XML/REST Value Sensor
Characters to Remove Only visible when using value of XML node is enabled above.
Optionally enter a string which will be removed from the returned
XML value. Use this to remove any unwanted characters from the
result, for example, a thousands separator from numeric values.
Please enter a string or leave the field empty.
Decimal Delimiter This setting is only visible if "use value" is enabled above. If the
sensor value of the selected XML node is of the type float, you can
define any character here which is the decimal delimiter. Enter one
character or leave the field empty.
Force SSL V3 Define if you only want to allow SSL V3 connections to the URL
defined above. Choose between:
§ No
§ Yes
If Value Changes Define what shall be done in case the value of this sensor changes.
You can choose between:
· Ignore changes (default ): No action will be taken on change.
· Trigger 'change' not ificat ion: The sensor will send an internal
message indicating that its value has changed. In combination
with a Change Trigger, you can use this mechanism to trigger a
notification 1716 whenever the sensor value changes.
Results Define what will be done with the results given back. Choose
between:
· Discard result : Do not store the requested web page.
· Writ e result t o disk (Filename: "Result of Sensor [ID].t xt "):
Store the last result received from to the "Logs (Sensors)"
directory (on the Master node, if in a cluster). This is for
debugging purposes. The file will be overridden with each
scanning interval. For information on how to find the folder used
for storage, please see More 438 section below.
Unit String Enter a string that will be added to the values as a unit description.
This is for display purposes only.
28.05.2014 575
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
40 HTTP XML/REST Value Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
576 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
40 HTTP XML/REST Value Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
28.05.2014 577
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
40 HTTP XML/REST Value Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
578 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
40 HTTP XML/REST Value Sensor
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
Checking JSON
With the X ML Node (and opt ional propert y ) field you can also check values that are returned
in JavaScript Object Notation (JSON) notation under the defined URL.
28.05.2014 579
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
40 HTTP XML/REST Value Sensor
Example
Depending on your entries in the X ML Node field, the sensor will process the respective
values:
Ent ry in Sensor's "X ML Node" Field (from Processed Value (from Example Above)
Example Above)
object/value content
object/AnotherValue AnotherContent
object contentAnotherContent
arraytest[1] one
arraytest[2] two
About Namespaces
580 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
40 HTTP XML/REST Value Sensor
Example
If you set this sensor to Use Namespaces (this is the default setting), it will expect the full
node name, including the namespace information, in the X ML Node (and opt ional propert y )
field. In the example above, this would be myNamespace:myNode.
If your node names are unique even without the namespace information, you can simplify the
settings by setting this sensor to Remove Namespaces. The sensor will then expect the
node name only in the X ML Node (and opt ional propert y ) field. In the example above, this
would be myNode.
More
Knowledge Base: Is there a tool available that can help me building queries for the XML/Rest
Sensor?
§ http://kb.paessler.com/en/topic/48783
Knowledge Base: How do I extract values from XML nodes (with nested tags) using PRTG's
XML/Rest Value Sensor?
§ http://kb.paessler.com/en/topic/43223
Knowledge Base: How can I use XPath with PRTG's XML/Rest Value Sensor?
§ http://kb.paessler.com/en/topic/26393
Knowledge Base: HTTP XML/REST Value Sensor shows protocol violation. What can I do?
§ http://kb.paessler.com/en/topic/26793
Knowledge Base: Why does my HTTP XML/REST Value Sensor return a 404 error?
§ http://kb.paessler.com/en/topic/46503
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
28.05.2014 581
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
40 HTTP XML/REST Value Sensor
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
582 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
41 Hyper-V Cluster Shared Volume Disk Free Sensor
The Hyper-V Cluster Shared Volume Disk Free sensor monitors a Microsoft Hyper-V cluster
shared volume via PowerShell and shows the available disk space. Note: The parent device for
this sensor must be a Windows Server running Hyper-V.
Note: We recommend using System Center Virtual Machine Manager (SCVMM) as parent device,
because this way PRTG will continue to monitor your virtual machines also when they change
the physical host using Live Migration.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on.
Note: This sensor type can have a high impact on the performance of your monitoring system.
Please use it with care! We recommend using not more than 50 sensors, on each probe, of this
type of sensor.
The Hyper-V Cluster Shared Volume Disk Free sensor uses PowerShell commands. In order to
monitor devices with this sensor Remot e PowerShell has to be enabled. For detailed
information, please see More 589 section below.
This sensor type needs the WSFC (Windows Server Failover Clustering) PowerShell Interface to
be installed on the target machine. You can list all modules in the PowerShell console with the
command Get -Module -List Available. Here FailoverClust ers has to appear. Under Windows
2008 and 2012 the interface is part of the VMM Administrator Console, or the VMM 2012
Management Console, respectively.
The interface is everywhere available where the WSFC feature is installed: Windows Server
2008 R2 (SP1) Full and Core (not installed by default); Microsoft Hyper-V Server 2008 R2 (SP1);
Remote Server Administration Tools (RSAT) for Windows 7 (SP1).
This sensor type requires the Microsoft .NET Framework to be installed on the computer
running the PRTG probe: Either on the local system (on every node, if on a cluster probe), or
on the system running the remote probe 2050 . If the framework is missing, you cannot create
this sensor. Note: You need to install the exact version required (a higher version will usually
not work; an exception applies to .NET 3.5 which comprises .NET 2.0 and .NET 3.0). Generally, it
is possible to run several .NET Framework versions on the same machine side-by-side. Please
install the latest update available for the required version.
04.06.2014 583
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
41 Hyper-V Cluster Shared Volume Disk Free Sensor
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor cluster disks, PRTG will create one sensor for each disk. The settings you
make in this dialog are valid for all of the sensors that are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Disk Select the disks you want to add a sensor for. A list of all available
items is shown with their name. Select the desired items by adding
check marks in front of the respective lines. One sensor will be
created for each selection. You can also select and deselect all
items by using the check box in the table head. Note: Please make
sure the resource name of your disks do not contain unsupported
characters, especially avoid the hash ('#') sign. We recommend to
not rename resource disk name once you've set up monitoring. For
detailed information, please see More 602 section below.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
584 04.06.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
41 Hyper-V Cluster Shared Volume Disk Free Sensor
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Disk Shows further information about the disk. Once a sensor is created
this value cannot be changed. It is shown for reference purposes
only. If you need to change this, please add the sensor anew.
If Value Changes Define what will be done in case the value of a sensor channel
changes. Choose between:
§ Ignore changes: No action will be taken on change.
§ Trigger 'change' not ificat ion: The sensor will send an internal
message indicating that its value has changed. In combination
with a Change Trigger, you can use this mechanism to trigger a
notification 1716 whenever the sensor value changes.
Sensor Result Define what will be done with the result of the sensor. Choose
between:
§ Discard sensor result : Do not store the sensor result.
§ Writ e sensor result t o disk (Filename: "Result of Sensor
[ID].t xt "): Store the last result received from the sensor to the
"Logs (Sensor)" directory (on the Master node, if in a cluster). File
name: Result of Sensor [ID].txt. This is for debugging purposes.
The file will be overridden with each scanning interval. For
information on how to find the folder used for storage, please
see Dat a St orage 2074 section.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
04.06.2014 585
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
41 Hyper-V Cluster Shared Volume Disk Free Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
586 04.06.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
41 Hyper-V Cluster Shared Volume Disk Free Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
04.06.2014 587
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
41 Hyper-V Cluster Shared Volume Disk Free Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
588 04.06.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
41 Hyper-V Cluster Shared Volume Disk Free Sensor
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
More
Knowledge Base: Why don't my Hyper-V sensors work after changing names?
§ http://kb.paessler.com/en/topic/15533
Knowledge Base: How do I enable and use remote commands in Windows PowerShell?
§ http://kb.paessler.com/en/topic/44453
Knowledge Base: My Powershell sensor returns an error message. What can I do?
§ http://kb.paessler.com/en/topic/59473
Knowledge Base: "No Logon Servers Available" when Using PowerShell Sensors
§ http://kb.paessler.com/en/topic/59745
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
04.06.2014 589
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
42 Hyper-V Host Server Sensor
The Hyper-V Host Server sensor monitors a Microsoft Hyper-V host server via Windows
Performance Counters or Windows Management Instrumentation (WMI), as configured in the
"Windows Compatibility Options" of the parent device. It shows CPU usage in percent of
guests, hypervisor, and total, as well as host health critical values, the number of deposited
pages, and network traffic. Network traffic sums up the total bytes per second (received and
sent) on all ports of your virtual switch.
Note: The parent device for this sensor must be a Windows Server running Hyper-V.
Note: We recommend using System Center Virtual Machine Manager (SCVMM) as parent device,
because this way PRTG will continue to monitor your virtual machines also when they change
the physical host using Live Migration.
Note: By default, this sensor type uses a hybrid approach, first trying to query data via
Windows Performance Counters (which needs less system resources), and using Windows
Management Instrumentation (WMI) as a fallback in case Performance Counters are not
available. When running in fallback mode, the sensor will re-try to connect via Performance
Counters after 24 hours. The default behavior can be changed in the Windows Compat ibilit y
Opt ions of the parent device's settings 280 this sensor is created on.
Sensors using the Windows Management Instrumentation (WMI) protocol have high impact on
the system performance! Try to stay below 200 WMI sensors per probe 77 . Above this number,
please consider using multiple Remot e Probes 2050 for load balancing.
For a general introduction to the technology behind WMI, please see Monit oring via WMI 1959
section.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on. In the parent device's 276 Credent ials for Windows Sy st ems settings,
please prefer using Windows domain credentials.
Note: If you use local credentials, please make sure the same Windows user accounts (with
same username and password) exist on both the system running the PRTG probe and the
target computer. If you fail to do so, a connection via Performance Counters will not be
possible. However, WMI connections may still work.
In order for this sensor to work with Windows Performance Counters, please make sure a
Windows version 2008 or later is installed on the computer running the PRTG probe: This is
either on the local system (on every node, if on a cluster probe), or on the system running a
remote probe 2050 . Note: The target system may well run on Windows 2003 or later.
590 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
42 Hyper-V Host Server Sensor
In order for this sensor to work with Windows Performance Counters, please make sure the
Remote Registry Windows service is running on the target computer. If you fail to do so, a
connection via Performance Counters will not be possible. However, WMI connections may still
work.
To enable the service, please log in to the respective computer and open the services
manager (e.g. via services.msc). In the list, find the respective service and set its Start Type to
Automatic.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Sensor Result Define what will be done with the result of the sensor. Choose
between:
12.05.2014 591
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
42 Hyper-V Host Server Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
592 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
42 Hyper-V Host Server Sensor
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
12.05.2014 593
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
42 Hyper-V Host Server Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
594 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
42 Hyper-V Host Server Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
12.05.2014 595
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
43 Hyper-V Virtual Machine Sensor
The Hyper-V Virtual Machine sensor monitors a virtual machine running on a Microsoft Hyper-V
host server, via Windows Performance Counters or Windows Management Instrumentation
(WMI), as configured in the "Windows Compatibility Options" of the parent device. It shows CPU
usage in percent of guests, hypervisor, and total, as well as disk read and write values, per
second. Note: The parent device for this sensor must be a Hyper-V server.
Note: In order to monitor a virtual machine with this sensor, disable User Account Control
(UAC) in the control panel of the Windows operating system which is running on this virtual
machine. Otherwise, the sensor might switch into a down status with the error message "The
virtual is not running or is powered off".
Note: We recommend using System Center Virtual Machine Manager (SCVMM) as parent device,
because this way PRTG will continue to monitor your virtual machines also when they change
the physical host using Live Migration.
Note: By default, this sensor type uses a hybrid approach, first trying to query data via
Windows Performance Counters (which needs less system resources), and using Windows
Management Instrumentation (WMI) as a fallback in case Performance Counters are not
available. When running in fallback mode, the sensor will re-try to connect via Performance
Counters after 24 hours. The default behavior can be changed in the Windows Compat ibilit y
Opt ions of the parent device's settings 280 this sensor is created on.
Sensors using the Windows Management Instrumentation (WMI) protocol have high impact on
the system performance! Try to stay below 200 WMI sensors per probe 77 . Above this number,
please consider using multiple Remot e Probes 2050 for load balancing.
For a general introduction to the technology behind WMI, please see Monit oring via WMI 1959
section.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on. In the parent device's 276 Credent ials for Windows Sy st ems settings,
please prefer using Windows domain credentials.
Note: If you use local credentials, please make sure the same Windows user accounts (with
same username and password) exist on both the system running the PRTG probe and the
target computer. If you fail to do so, a connection via Performance Counters will not be
possible. However, WMI connections may still work.
In order for this sensor to work with Windows Performance Counters, please make sure a
Windows version 2008 or later is installed on the computer running the PRTG probe: This is
either on the local system (on every node, if on a cluster probe), or on the system running a
remote probe 2050 . Note: The target system may well run on Windows 2003 or later.
596 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
43 Hyper-V Virtual Machine Sensor
In order for this sensor to work with Windows Performance Counters, please make sure the
Remote Registry Windows service is running on the target computer. If you fail to do so, a
connection via Performance Counters will not be possible. However, WMI connections may still
work.
To enable the service, please log in to the respective computer and open the services
manager (e.g. via services.msc). In the list, find the respective service and set its Start Type to
Automatic.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor virtual machines, PRTG will create one sensor for each machine. The
settings you make in this dialog are valid for all of the sensors that are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Virtual Machine Select the virtual machines (VMs) you want to add a sensor for,
including the ones that are not running. A list of all available items
is shown with their name. Select the desired items by adding check
marks in front of the respective lines. One sensor will be created
for each selection. You can also select and deselect all items by
using the check box in the table head. Note: Please make sure the
name of your VMs do not contain unsupported characters,
especially avoid the hash ('#') sign. We recommend to not rename
virtual machines once you've set up monitoring. For detailed
information, please see More 602 section below.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
28.05.2014 597
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
43 Hyper-V Virtual Machine Sensor
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
GUID Shows the Globally Unique Identifier (GUID) of the virtual machine
monitored by this sensor. Once a sensor is created this value
cannot be changed. It is shown for reference purposes only. If you
need to change this, please add the sensor anew.
Name Shows the name of the virtual machine monitored by this sensor.
Once a sensor is created this value cannot be changed. It is shown
for reference purposes only. If you need to change this, please add
the sensor anew.
Name Shows the name of the host server. Once a sensor is created this
value cannot be changed. It is shown for reference purposes only.
If you need to change this, please add the sensor anew.
Powered Off VMs Choose how the sensor will react to a virtual machine that is
powered off. Please choose between:
· Alarm when powered off (default ): The sensor will change to a
Down 121 status if the virtual machine is powered off. Note: While
in Down status, a sensor does not record any data in all of its
channels.
· Ignore powered off st at e: The sensor will not change to a
Down status if the virtual machine is powered off; it will report
zero values instead.
Sensor Result Define what will be done with the result of the sensor. Choose
between:
§ Discard sensor result : Do not store the sensor result.
598 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
43 Hyper-V Virtual Machine Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
28.05.2014 599
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
43 Hyper-V Virtual Machine Sensor
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
600 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
43 Hyper-V Virtual Machine Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
28.05.2014 601
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
43 Hyper-V Virtual Machine Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
More
Knowledge Base: Why don't my Hyper-V Virtual Machine / Network Adapter Sensor work after
changing names?
§ http://kb.paessler.com/en/topic/15533
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
602 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
43 Hyper-V Virtual Machine Sensor
Others
For more general information about settings, please see Object Set t ings 142 section.
28.05.2014 603
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
44 Hyper-V Virtual Network Adapter Sensor
The Hyper-V Network Adapter sensor monitors virtual network adapters running on a
Microsoft Hyper-V host server, via Windows Performance Counters or Windows Management
Instrumentation (WMI), as configured in the "Windows Compatibility Options" of the parent
device. It shows sent and received bytes, packets, broadcast packets, directed packets, and
multicast packets, per second. Note: The parent device for this sensor must be a Hyper-V
server.
Note: We recommend using System Center Virtual Machine Manager (SCVMM) as parent device,
because this way PRTG will continue to monitor your virtual machines also when they change
the physical host using Live Migration.
Note: By default, this sensor type uses a hybrid approach, first trying to query data via
Windows Performance Counters (which needs less system resources), and using Windows
Management Instrumentation (WMI) as a fallback in case Performance Counters are not
available. When running in fallback mode, the sensor will re-try to connect via Performance
Counters after 24 hours. The default behavior can be changed in the Windows Compat ibilit y
Opt ions of the parent device's settings 280 this sensor is created on.
Sensors using the Windows Management Instrumentation (WMI) protocol have high impact on
the system performance! Try to stay below 200 WMI sensors per probe 77 . Above this number,
please consider using multiple Remot e Probes 2050 for load balancing.
For a general introduction to the technology behind WMI, please see Monit oring via WMI 1959
section.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on. In the parent device's 276 Credent ials for Windows Sy st ems settings,
please prefer using Windows domain credentials.
Note: If you use local credentials, please make sure the same Windows user accounts (with
same username and password) exist on both the system running the PRTG probe and the
target computer. If you fail to do so, a connection via Performance Counters will not be
possible. However, WMI connections may still work.
In order for this sensor to work with Windows Performance Counters, please make sure a
Windows version 2008 or later is installed on the computer running the PRTG probe: This is
either on the local system (on every node, if on a cluster probe), or on the system running a
remote probe 2050 . Note: The target system may well run on Windows 2003 or later.
604 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
44 Hyper-V Virtual Network Adapter Sensor
In order for this sensor to work with Windows Performance Counters, please make sure the
Remote Registry Windows service is running on the target computer. If you fail to do so, a
connection via Performance Counters will not be possible. However, WMI connections may still
work.
To enable the service, please log in to the respective computer and open the services
manager (e.g. via services.msc). In the list, find the respective service and set its Start Type to
Automatic.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor network adapters, PRTG will create one sensor for each adapter. The
settings you make in this dialog are valid for all of the sensors that are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Hyper-V Virtual Select the virtual network adapters you want to add a sensor for. A
Network Adapter list of all available items is shown with their name. Select the
desired items by adding check marks in front of the respective
lines. One sensor will be created for each selection. You can also
select and deselect all items by using the check box in the table
head. Note: We recommend to not rename virtual machines once
you have set up monitoring. Renaming them will also change the
internal virtual network adapter names, causing the monitoring to
be interrupted. For detailed information about virtual machine
naming, please see More 602 section below.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
28.05.2014 605
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
44 Hyper-V Virtual Network Adapter Sensor
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Virtual Network Shows the name of the virtual network adapter monitored by this
Adapter sensor. Once a sensor is created this value cannot be changed. It
is shown for reference purposes only. If you need to change this,
please add the sensor anew.
Sensor Result Define what will be done with the results the sensor receives.
Choose between:
§ Discard sensor result : Do not store the results.
§ Writ e sensor result t o disk (Filename: "Result of Sensor
[ID].t xt "): Store the last result received to the "Logs (Sensors)"
directory (on the Master node, if in a cluster). This is for
debugging purposes. The file will be overridden with each
scanning interval. For information on how to find the folder used
for storage, please see Dat a St orage 2074 section.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
606 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
44 Hyper-V Virtual Network Adapter Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
28.05.2014 607
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
44 Hyper-V Virtual Network Adapter Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
608 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
44 Hyper-V Virtual Network Adapter Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
More
Knowledge Base: Why don't my Hyper-V Virtual Machine / Network Adapter Sensor work after
changing names?
§ http://kb.paessler.com/en/topic/15533
28.05.2014 609
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
44 Hyper-V Virtual Network Adapter Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
610 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
45 Hyper-V Virtual Storage Device Sensor
The Hyper-V Virtual Storage sensor monitors a virtual storage device running on a Microsoft
Hyper-V host server, via Windows Performance Counters or Windows Management
Instrumentation (WMI), as configured in the "Windows Compatibility Options" of the parent
device. It shows read and write values in second, and the number of errors. Note: The parent
device for this sensor must be a Hyper-V server.
Note: We recommend using System Center Virtual Machine Manager (SCVMM) as parent device,
because this way PRTG will continue to monitor your virtual machines also when they change
the physical host using Live Migration.
Note: By default, this sensor type uses a hybrid approach, first trying to query data via
Windows Performance Counters (which needs less system resources), and using Windows
Management Instrumentation (WMI) as a fallback in case Performance Counters are not
available. When running in fallback mode, the sensor will re-try to connect via Performance
Counters after 24 hours. The default behavior can be changed in the Windows Compat ibilit y
Opt ions of the parent device's settings 280 this sensor is created on.
Sensors using the Windows Management Instrumentation (WMI) protocol have high impact on
the system performance! Try to stay below 200 WMI sensors per probe 77 . Above this number,
please consider using multiple Remot e Probes 2050 for load balancing.
For a general introduction to the technology behind WMI, please see Monit oring via WMI 1959
section.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on. In the parent device's 276 Credent ials for Windows Sy st ems settings,
please prefer using Windows domain credentials.
Note: If you use local credentials, please make sure the same Windows user accounts (with
same username and password) exist on both the system running the PRTG probe and the
target computer. If you fail to do so, a connection via Performance Counters will not be
possible. However, WMI connections may still work.
In order for this sensor to work with Windows Performance Counters, please make sure a
Windows version 2008 or later is installed on the computer running the PRTG probe: This is
either on the local system (on every node, if on a cluster probe), or on the system running a
remote probe 2050 . Note: The target system may well run on Windows 2003 or later.
03.04.2014 611
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
45 Hyper-V Virtual Storage Device Sensor
In order for this sensor to work with Windows Performance Counters, please make sure the
Remote Registry Windows service is running on the target computer. If you fail to do so, a
connection via Performance Counters will not be possible. However, WMI connections may still
work.
To enable the service, please log in to the respective computer and open the services
manager (e.g. via services.msc). In the list, find the respective service and set its Start Type to
Automatic.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor storage devices, PRTG will create one sensor for each device. The settings
you make in this dialog are valid for all of the sensors that are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Hyper-V Virtual Storage Select the virtual storage devices you want to add a sensor for. A
Device list of all available items is shown with their name. Select the
desired items by adding check marks in front of the respective
lines. One sensor will be created for each selection. You can also
select and deselect all items by using the check box in the table
head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
612 03.04.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
45 Hyper-V Virtual Storage Device Sensor
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Virtual Storage Device Shows the unique name of the device monitored by this sensor.
Once a sensor is created this value cannot be changed. It is shown
for reference purposes only. If you need to change this, please add
the sensor anew.
Sensor Result Define what will be done with the result of the sensor. Choose
between:
§ Discard sensor result : Do not store the sensor result.
§ Writ e sensor result t o disk (Filename: "Result of Sensor
[ID].t xt "): Store the last result received from the sensor to the
"Logs (Sensor)" directory (on the Master node, if in a cluster). File
name: Result of Sensor [ID].txt. This is for debugging purposes.
The file will be overridden with each scanning interval. For
information on how to find the folder used for storage, please
see Dat a St orage 2074 section.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
03.04.2014 613
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
45 Hyper-V Virtual Storage Device Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
614 03.04.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
45 Hyper-V Virtual Storage Device Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
03.04.2014 615
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
45 Hyper-V Virtual Storage Device Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
616 03.04.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
45 Hyper-V Virtual Storage Device Sensor
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
03.04.2014 617
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
46 IMAP Sensor
6.8.46 IM AP Sensor
The IMAP sensor monitors a mail server using Internet Message Access Protocol (IMAP) and
shows the server's response time as well as the number of emails in the defined mailbox. It can
also check the content of emails for certain key words. This way, you can use this sensor to
monitor backup solutions via emails that are sent out by these solutions. For more
information, see section More 627 .
Note: If you use content checks, we recommend using a dedicated IMAP account that is only
checked by PRTG. Editing existing mails in the mailbox of the monitored IMAP account can lead
to false alarms or malfunctions of this sensor type.
Note: This sensor type might not work properly when monitoring sub-folders of mailboxes. If it
has to check subsequent emails with identical subjects, later on incoming emails might not be
recognized.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
618 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
46 IMAP Sensor
IMAP Specific
Timeout (sec.) Enter a timeout in seconds for the SMTP connect. If the reply takes
longer than this value the request is aborted and an error message
is triggered.
Port Enter the number of the port that will be used to connect via IMAP.
For non-secure connections usually port 143 is used; usually port
993 for SSL connections. The actual setting depends on the server
you are connecting to. Please enter an integer value. We
recommend using the default value. If you do not get a connection,
please try another port number.
Authentication Type Select the kind of authentication for the IMAP connection. Choose
between:
· Username/Password: Authenticate at the IMAP server via
username and password.
· Simple Aut hent icat ion and Securit y Lay er (SASL): Use a
secure connection for the authentication at the IMAP server.
28.05.2014 619
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
46 IMAP Sensor
SSL-Method This field is only visible if security is enabled above. Select the SSL
method that will be used when connecting to the server. We
recommend using the default value. Only if you experience
connection problems, try another setting. Choose between:
§ SSL V2
§ SSL V2 or V3
§ SSL V3
§ TLS V1
Process Email Content This sensor can additionally check the content of all incoming
emails. Choose between:
§ Do not check email cont ent : Only check availability of the IMAP
server and check if a login is successful (if defined). Do not
process any mails in the IMAP mail account.
§ Process emails in t his mailbox: Login in to the IMAP mail
account and check the mails contained there. Define further
options below.
Mailbox Name This field is only visible if email content processing is enabled
above. Enter the name of the mailbox (e.g. the name of the IMAP
folder) that will be checked. Default value is Inbox. Unless you set
a last message date check below, the sensor will always look at all
emails contained in the mailbox. Note: Please make sure that you
do not manually edit mails in this mailbox with another mail client,
as this can lead to malfunctions of this sensor's email identification.
Identify by "From" Field This option is only visible if email content processing is enabled
above. Define if you want to check the "From" field of the emails.
Choose between:
§ Don't check: Do not check this field in emails.
§ Check using st ring search: Check this field in emails using
simple string search.
§ Check using regular expression: Check this field in emails using
a regular expression. For more information about syntax, please
see Regular Expressions 2048 section.
When using a search, the sensor will scan all emails from the
newest to the oldest. Note: The scan will be finished with the first
match! That means: After a match is found in one email, there will be
no further checks performed in older emails.
Search For This field is only visible if a check is enabled above. Enter a search
string using the method defined above.
620 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
46 IMAP Sensor
Identify by "Subject" This option is only visible if email content processing is enabled
Field above. Define if you want to check the "Subject" field of the emails.
Choose between:
§ Don't check: Do not check this field in emails.
§ Check using st ring search: Check this field in emails using
simple string search.
§ Check using regular expression: Check this field in emails using
a regular expression. For more information about syntax, please
see Regular Expressions 2048 section.
When using a search, the sensor will scan all emails from the
newest to the oldest. Note: The scan will be finished with the first
match! That means: After a match is found in one email, there will be
no further checks performed in older emails.
Search For This field is only visible if a check is enabled above. Enter a search
string using the method defined above.
Identify by Mail Body This option is only visible if email content processing is enabled
above. Define if you want to check the mail body of the emails.
Choose between:
§ Don't check: Do not check the mail body.
§ Check using st ring search: Check the mail body using simple
string search.
§ Check using regular expression: Check the mail body using a
regular expression. For more information about syntax, please
see Regular Expressions 2048 section.
When using a search, the sensor will scan all emails from the
newest to the oldest. Note: The scan will be finished with the first
match! That means: After a match is found in one email, there will be
no further checks performed in older emails.
Search For This field is only visible if a check is enabled above. Enter a search
string using the method defined above.
Check Last Message This option is only visible if email content processing is enabled
Date above. Define if you want to check all emails in the mailbox, or only
mails that were received within the last x hours. Choose between:
§ Don't check message age: Always check all emails contained in
the mailbox.
§ Check for new messages received wit hin t he last x hours:
Only regard emails that were received in the last hours. Define
below.
28.05.2014 621
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
46 IMAP Sensor
Error Threshold (Hours) Enter the maximum age in hours. Only emails that are younger will
be processed. If there is no matching email in the defined time
span, the sensor will show a Down status.
Warning Threshold Enter the maximum age in hours. Only emails that are younger will
(Hours) be processed. If there is no matching email in the defined time
span, the sensor will show a Warning status.
Sensor Behavior
Set to Alarm This setting is only visible if email content check is enabled above.
Define in which cases the sensor will show a Down status. Choose
between:
§ If subject cont ains
§ If subject does not cont ain
§ If mail body cont ains
§ If mail body does not cont ain
§ Alway s: Always set this sensor to a Down status in case any
emails could be identified.
§ Never: Never set this sensor to a Down status based on email
content.
Search Text This setting is only visible if an if-condition is selected above. Enter
a search string using the method defined above.
Error Message This setting is only visible if an alarm condition is selected above.
Define the message that will be shown in case the sensor shows a
Down status.
622 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
46 IMAP Sensor
Sensor Behavior
Set to Warning This setting is only visible if email content check is enabled above.
Define in which cases the sensor will show a Warning status.
Choose between:
§ If subject cont ains
§ If subject does not cont ain
§ If mail body cont ains
§ If mail body does not cont ain
§ Alway s: Always set this sensor to a Warning status in case any
emails could be identified.
§ Never: Never set this sensor to a Warning status based on email
content.
Search Text This setting is only visible if an if-condition is selected above. Enter
a search string using the method defined above.
Warning Message This setting is only visible if a warning condition is selected above.
Define the message that will be shown in case the sensor shows a
Warning status.
No Matching Mail This setting is only visible if email content check is enabled above.
Behavior Define how the sensor will react if no matching emails are found in
the mailbox that is being scanned. Choose between:
§ Set sensor t o "Down" st at us
§ Set sensor t o "Warning" st at us
§ None: Don't do anything in this case.
28.05.2014 623
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
46 IMAP Sensor
Sensor Behavior
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
624 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
46 IMAP Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
28.05.2014 625
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
46 IMAP Sensor
§ Mast er object for parent : Make this sensor the master object
for its parent device. The sensor will influence the behavior of
the device it is created on: If the sensor is in a Down status, the
device will be paused. For example, it is a good idea to make a
Ping sensor the master object for its parent device to pause
monitoring for all other sensors on the device in case the device
cannot even be pinged. Additionally, the sensor will be paused if
the parent group of its parent device is in a Down status, or if it
is paused by another dependency.
Note: Testing your dependencies is easy! Simply choose Simulat e
Error St at us from the context menu of an object that other
objects depend on. A few seconds later all dependent objects
should be paused.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
626 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
46 IMAP Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
More
Knowledge Base: How can I monitor my backup software to be sure backup succeeded last
night?
§ http://kb.paessler.com/en/topic/47023
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
28.05.2014 627
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
46 IMAP Sensor
Others
For more general information about settings, please see Object Set t ings 142 section.
628 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
47 INI File Content Check Sensor
The INI File Content Check sensor reads an *.ini file. It indicates if the file exists and if a
specified section and field are found. The sensor returns the field's integer value (or -1 if the
field does not contain an integer). It will show a Warning status if a section or field is not
found, and a Down status if the file could not be opened.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on.
Note: This sensor type can have a high impact on the performance of your monitoring system.
Please use it with care! We recommend using not more than 50 sensors, on each probe, of this
type of sensor.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
04.06.2014 629
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
47 INI File Content Check Sensor
INI File Name Enter the full path to the file this sensor will monitor. For example,
enter C:\Windows\win.ini. If the file is located on a network device
use the Uniform Naming Convention (UNC) path without the server
part (you would only enter share\folder\file.ini). The server part (\
\server\) is taken from this sensor's parent device's settings. Please
enter a valid path and file name. Note: In order to provide any
shares, the LanmanServer "Server" Windows service must be
running on the target computer.
INI Section Define the section inside the INI file you would like to check. A
section within the INI file is denoted in square brackets [ ]. Enter
the section name without the brackets here, for example, enter
Mail. This value is not case sensitive. If the section is not found, the
sensor will show a Warning status.
INI Field Define the field inside the section you would like to check. In the
INI file, a field name is written before an equal sign =, followed by its
value. Enter the field name here, for example, enter MAPI. This value
is not case sensitive. The sensor will return the value of this field,
i.e. the value on the right side of the equal sign. If the field is not
found, the sensor will show a Warning status.
If Value Changes Define what will be done in case the value of this sensor changes.
You can choose between:
· Ignore changes: No action will be taken on change.
· Trigger 'change' not ificat ion: The sensor will send an internal
message indicating that its value has changed. In combination
with a Change Trigger, you can use this mechanism to trigger a
notification 1716 whenever the sensor value changes.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
630 04.06.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
47 INI File Content Check Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
04.06.2014 631
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
47 INI File Content Check Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
632 04.06.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
47 INI File Content Check Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
04.06.2014 633
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
47 INI File Content Check Sensor
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
634 04.06.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
48 IP on DNS Blacklist Sensor
The IP on DNS Blacklist sensor checks if the IP address of its parent device is listed on specific
blacklist servers and returns the number of hits found. If a DNS name is used as the parent
device's hostname, PRTG will resolve it to an IP address first.
During normal operation, there should be 0 hits and the sensor should show a green Up
status. If the IP address is found on at least one of the blacklist servers, the sensor changes to
a yellow Warning status by default. Note: You can set additional thresholds in the sensor's
Sensor Channels Set t ings 1709 , if you like.
Note: This sensor type can have a high impact on the performance of your monitoring system.
Please use it with care! We recommend using not more than 50 sensors, on each probe, of this
type of sensor.
This sensor type requires the Microsoft .NET Framework to be installed on the computer
running the PRTG probe: Either on the local system (on every node, if on a cluster probe), or
on the system running the remote probe 2050 . If the framework is missing, you cannot create
this sensor. Note: You need to install the exact version required (a higher version will usually
not work; an exception applies to .NET 3.5 which comprises .NET 2.0 and .NET 3.0). Generally, it
is possible to run several .NET Framework versions on the same machine side-by-side. Please
install the latest update available for the required version.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
28.05.2014 635
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
48 IP on DNS Blacklist Sensor
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Blacklist Servers Define the blacklist servers that will be used for the check. You can
enter a comma separated list. Default is bl.spamcop.net. For a list
of servers, please see More 639 section below. Note: With each
scanning interval, PRTG will query all servers in the list! We
recommend you do not enter more than 10 servers to make sure
the check can be completed within the scanning interval of this
sensor. If you use too many blacklist servers, the sensor will show
a "Timeout (code: PE018)" error message.
Timeout (sec.) Define a timeout in seconds for the check. If the reply takes longer
than this value the request is aborted and an error message is
triggered.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
636 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
48 IP on DNS Blacklist Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
28.05.2014 637
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
48 IP on DNS Blacklist Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
638 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
48 IP on DNS Blacklist Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
More
Knowledge Base: Is there a list of anti spam black list servers?
§ http://kb.paessler.com/en/topic/37633
28.05.2014 639
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
48 IP on DNS Blacklist Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
640 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
49 IPFIX Sensor
The IPFIX sensor receives traffic data from an IPFIX (Internet Protocol Flow Information Export)
compatible device and shows traffic by type. There are several filter options available to divide
traffic into different channels. Please make sure your device supports IPFIX when using this
sensor.
Note: In order for this sensor to work, you have to enable IPFIX export on the device. The
device must send the flow data stream to the IP address of the PRTG probe system on which
the sensor is set up (either a local or remote probe). This sensor type cannot be used in
cluster mode. You can set it up on a local probe or remote probe only, not on a cluster probe.
For a general introduction to the technology behind flow monitoring, please see Monit oring
Bandwidt h via Flows 1966 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
28.05.2014 641
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
49 IPFIX Sensor
Receive IPFIX Packets Enter the UDP port number on which the flow packets are received.
on UDP Port It must match the one you have configured in the IPFIX export
options of your hardware router device. Please enter an integer
value.
Sender IP Enter the IP address of the sending device you want to receive the
IPFIX data from. Enter an IP address to receive data from a specific
device only, or leave the field empty to receive data from any
device on the specified port.
Receive IPFIX Packets Select the IP address(es) on which PRTG listens to IPFIX packets.
on IP The list of IP addresses shown here is specific to your setup. To
select an IP address, add a check mark in front of the respective
line or in the top level box to select all. The IP address selected
here must match the one configured in the IPFIX export options of
your hardware router device.
Active Flow Timeout Enter a time span in minutes after which new flow data must be
(Minutes) received. If the timeout is reached and no new data is received, the
sensor may switch to an Unknown status. Please enter an integer
value. We recommend setting this one minute longer than the
respective timeout configured in your hardware router device.
Note: If you set this value too low, flow information might get lost!
Sampling Mode Define if you want to use the sampling mode. This setting must
accord to the setting in the flow exporter. Choose between:
§ Off: The standard flow will be used.
§ On: Switch into sampling mode and specify the sampling rate
below.
Sampling Rate This field is only visible when sampling mode is enabled above.
Enter a number that matches the sampling rate in your exporter
device. If the number is different, monitoring results will be
incorrect. Please enter an integer value.
Log Stream Data to Define if the probe will write a log file of the stream and packet
Disk (for Debugging) data to the data folder (see Dat a St orage 2074 ). Choose between:
§ None (recommended): Do not write additional log files.
Recommended for normal use cases.
§ Only for t he 'Ot her' channel: Only write log files of data that is
not filtered otherwise and therefore accounted to the default
Ot her channel.
§ All st ream dat a: Write log files for all data received.
642 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
49 IPFIX Sensor
Note: Use with caution! When enabled, huge data files can be
created. Please use for a short time and for debugging purposes
only.
Channel Selection Define the categories the traffic will be accounted to. There are
different groups of traffic available. Choose between:
§ Web: Internet web traffic.
§ File Transfer: Traffic caused by FTP.
§ Mail: Internet mail traffic.
§ Chat : Traffic caused by chat and instant messaging.
§ Remot e Cont rol: Traffic caused by remote control applications,
such as RDP, SSH, Telnet, VNC.
§ Infrast ruct ure: Traffic caused by network services, such as
DHCP, DNS, Ident, ICMP, SNMP.
§ Net BIOS: Traffic caused by NetBIOS communication.
§ Ot her Prot ocols: Traffic caused by various other protocols via
UDP and TCP.
For each traffic group, you can select how many channels will be
used for each group, i.e. how detailed traffic will be divided. For
each group, choose between:
§ No: Do not account traffic of this group in an own channel. All
traffic of this group will be accounted to the default channel
named Ot her.
§ Yes: Count all traffic of this group and summarize it into one
channel.
§ Det ail: Count all traffic of this group and further divide it into
different channels. The traffic will appear in several channels as
shown in the Cont ent column. Note: Extensive use of this
option can cause load problems on your probe system. We
recommend setting specific, well-chosen filters for the data you
really want to analyze.
Note: You can change the default configuration for groups and
channels. For details, please see section More.
28.05.2014 643
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
49 IPFIX Sensor
Filt ering
Include Filter Define if you want to filter any traffic. If you leave this field empty,
all traffic will be included. To include specific traffic only, define
filters using a special syntax. For detailed information, please see
Filt er Rules for xFlow, IPFIX , and Packet Sniffer Sensors 2032
section.
Exclude Filter First, the filters defined in the Include Filt er field are considered.
From this subset, you can explicitly exclude traffic, using the same
syntax. For detailed information, please see Filt er Rules for xFlow,
IPFIX , and Packet Sniffer Sensors 2032 section.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Primary Toplist
Primary Toplist Define which will be your primary toplist. It will be shown in maps
when adding a toplist object. Choose from:
§ Top Talkers
§ Top Connect ions
§ Top Prot ocols
644 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
49 IPFIX Sensor
Primary Toplist
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
28.05.2014 645
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
49 IPFIX Sensor
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
646 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
49 IPFIX Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
28.05.2014 647
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
49 IPFIX Sensor
Toplists
For all flow and packet sniffer sensors there are Toplist s available on the Overview tab of a
sensor's detail page. Using toplists, you can review traffic data of small time periods in great
detail. For more information, please see Toplist s 1728 section.
More
Knowledge Base: How can I change the default groups and channels for xFlow and Packet
Sniffer sensors?
§ http://kb.paessler.com/en/topic/60203
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
Related Topics
§ Filt er Rules for xFlow, IPFIX , and Packet Sniffer Sensors 2032
§ Channel Defint ions for xFlow, IPFIX , and Packet Sniffer Sensors 2036
648 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
50 IPFIX (Custom) Sensor
The IPFIX (Custom) sensor receives traffic data from an IPFIX (Internet Protocol Flow Information
Export) compatible device and shows the traffic by type. In this custom sensor, you can define
your own channel definitions to divide traffic into different channels. Please make sure your
device supports IPFIX when using this sensor.
Note: In order for this sensor to work, you have to enable IPFIX export on the device. The
device must send the flow data stream to the IP address of the PRTG probe system on which
the sensor is set up (either a local or remote probe). This sensor type cannot be used in
cluster mode. You can set it up on a local probe or remote probe only, not on a cluster probe.
For a general introduction to the technology behind flow monitoring, please see Monit oring
Bandwidt h via Flows 1966 section.
PRTG does not support more than 50 sensor channels officially. Depending on the data used
with this sensor type, you might exceed the maximum number of supported sensor channels.
In this case, PRTG will try to display all sensor channels. However, please be aware that you will
experience limited usability and performance.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
24.10.2013 649
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
50 IPFIX (Custom) Sensor
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Receive IPFIX Packets Enter the UDP port number on which the flow packets are received.
on UDP Port It must match the one configured in the IPFIX export options of
your hardware router device. Please enter an integer value.
Sender IP Enter the IP address of the sending device you want to receive the
IPFIX data from. Enter an IP address to receive data from a specific
device only, or leave the field empty to receive data from any
device on the specified port.
Receive IPFIX Packets Select the IP address(es) on which PRTG listens to IPFIX packets.
on IP The list of IP addresses shown here is specific to your setup. To
select an IP address, add a check mark in front of the respective
line. The IP address selected here must match the one configured
in the IPFIX export options of your hardware router device.
Active Flow Timeout Enter a time span in minutes after which new flow data must be
(Minutes) received. If the timeout is reached and no new data is received, the
sensor may switch to an Unknown status. Please enter an integer
value. We recommend setting this one minute longer than the
respective timeout configured in your hardware router device.
Note: If you set this value too low, flow information might get lost!
Sampling Mode Define if you want to use the sampling mode. This setting must
accord to the setting in the flow exporter. Choose between:
§ Off: The standard flow will be used.
§ On: Switch into sampling mode and specify the sampling rate
below.
Sampling Rate This field is only visible when sampling mode is enabled above.
Enter a number that matches the sampling rate in your device. If the
number is different, monitoring results will be incorrect. Please
enter an integer value.
650 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
50 IPFIX (Custom) Sensor
Channel Definition Please enter a channel definition to divide the traffic into different
channels. Write each definition in one line. For detailed information,
please see Channel Definit ions for xFlow and Packet Sniffer
Sensors 2036 section. All traffic for which no channel is defined will
be accounted to the default channel named Ot her. Note: Extensive
use of many filters can cause load problems on your probe system.
We recommend defining specific, well-chosen filters for the data
you really want to analyze.
Log Stream Data to Define if the probe will write a log file of the stream and packet
Disk (for Debugging) data to the data folder (see Dat a St orage 2074 ). Choose between:
§ None (recommended): Do not write additional log files.
Recommended for normal use cases.
§ Only for t he 'Ot her' channel: Only write log files of data that is
not filtered otherwise and therefore accounted to the default
Ot her channel.
§ All st ream dat a: Write log files for all data received.
Note: Use with caution! When enabled, huge data files can be
created. Please use for a short time and for debugging purposes
only.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
24.10.2013 651
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
50 IPFIX (Custom) Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Filt ering
Include Filter Define if you want to filter any traffic. If you leave this field empty,
all traffic will be included. To include specific traffic only, define
filters using a special syntax. For detailed information, please see
Filt er Rules for xFlow, IPFIX , and Packet Sniffer Sensors 2032
section.
Exclude Filter First, the filters defined in the Include Filt er field are considered.
From this subset, you can explicitly exclude traffic, using the same
syntax. For detailed information, please see Filt er Rules for xFlow,
IPFIX , and Packet Sniffer Sensors 2032 section.
Primary Toplist
Primary Toplist Define which will be your primary toplist. It will be shown in maps
when adding a toplist object. Choose from:
§ Top Talkers
§ Top Connect ions
§ Top Prot ocols
§ [Any custom toplists you have added]
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
652 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
50 IPFIX (Custom) Sensor
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
24.10.2013 653
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
50 IPFIX (Custom) Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
654 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
50 IPFIX (Custom) Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
24.10.2013 655
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
50 IPFIX (Custom) Sensor
Toplists
For all flow and packet sniffer sensors there are Toplist s available on the Overview tab of a
sensor's detail page. Using toplists, you can review traffic data of small time periods in great
detail. For more information, please see Toplist s 1728 section.
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
Related Topics
§ Filt er Rules for xFlow, IPFIX , and Packet Sniffer Sensors 2032
§ Channel Defint ions for xFlow, IPFIX , and Packet Sniffer Sensors 2036
656 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
51 IPMI System Health Sensor
The IPMI System Health sensor monitors the status of a system via the Intelligent Platform
Management Interface (IPMI). It can show temperature, rotation per minute of fans, voltage, and
the status of a power supply.
Note: You have to explicitly specify the credentials of the IPMI in the sensor settings.
This sensor type uses lookups to determine the status values of some sensor channels. For
details, please see section Define Lookups 2039 .
This sensor type has predefined limits for several metrics. These limits can be changed
individually in the channel settings. For detailed information about channel limits please refer to
the section Sensor Channels Set t ings 1709 .
Important notice: Currently, this sensor type is in bet a status. The methods of operating can
change at any time, as well as the available settings. Do not expect that all functions will work
properly, or that this sensor works as expected at all. Be aware that this type of sensor can be
removed again from PRTG at any time.
This sensor type requires the Microsoft .NET Framework to be installed on the computer
running the PRTG probe: Either on the local system (on every node, if on a cluster probe), or
on the system running the remote probe 2050 . If the framework is missing, you cannot create
this sensor. Note: You need to install the exact version required (a higher version will usually
not work; an exception applies to .NET 3.5 which comprises .NET 2.0 and .NET 3.0). Generally, it
is possible to run several .NET Framework versions on the same machine side-by-side. Please
install the latest update available for the required version.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Before you can actually add this sensor, PRTG will ask you to provide your credentials for the
Intelligent Platform Management Interface (IPMI) in the add sensor dialog 220 . Enter the
Username and the Password in the respective fields.
In order to monitor the system health via IPMI, PRTG will create one sensor for each metric you
choose. The settings you make in this dialog are valid for all of the sensors that are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
28.05.2014 657
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
51 IPMI System Health Sensor
IPMI Specific
Group Select the measurements you want to add a sensor for. A list of all
available items is shown with their name. Select the desired items
by adding check marks in front of the respective lines. One sensor
will be created for each selection. You can also select and deselect
all items by using the check box in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
658 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
51 IPMI System Health Sensor
IPMI Specific
Group Shows the measurement that this sensor monitors. Once a sensor
is created this value cannot be changed. It is shown for reference
purposes only. If you need to change this, please add the sensor
anew.
Logfile Result Define what will be done with the result of the sensor. Choose
between:
§ Discard sensor result : Do not store the sensor result.
§ Writ e sensor result t o disk (Filename: "Result of Sensor
[ID].t xt "): Store the last result received from the sensor to the
"Logs (Sensor)" directory (on the Master node, if in a cluster). File
name: Result of Sensor [ID].txt. This is for debugging purposes.
The file will be overridden with each scanning interval. For
information on how to find the folder used for storage, please
see Dat a St orage 2074 section.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
28.05.2014 659
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
51 IPMI System Health Sensor
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
660 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
51 IPMI System Health Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
28.05.2014 661
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
51 IPMI System Health Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
662 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
51 IPMI System Health Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
28.05.2014 663
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
52 jFlow V5 Sensor
The jFlow V5 sensor receives traffic data from a jFlow V5 compatible device and shows the
traffic by type. On your hardware device, please make sure it matches jFlow V5 and disable any
sampling option! There are several filter options available to divide traffic into different
channels.
Note: In order for the sensor to work, jFlow export of the respective version must be enabled
on the device. The device must send the flow data stream to the IP address of the PRTG probe
system on which the sensor is set up (either a local or remote probe). The sensor does not
support sampling, so please disable sampling in your jFlow device! This sensor type cannot be
used in cluster mode. You can set it up on a local probe or remote probe only, not on a cluster
probe.
For a general introduction to the technology behind flow monitoring, please see Monit oring
Bandwidt h via Flows 1966 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
664 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
52 jFlow V5 Sensor
Receive jFlow Packets Enter the UDP port number on which the flow packets are received.
on UDP Port It must match the one you have configured in the jFlow export
options of your hardware router device. Please enter an integer
value. Note: When configuring export, please make sure you select
the appropriate jFlow version for this sensor.
Sender IP Enter the IP address of the sending device you want to receive the
jFlow from. Enter an IP address to receive data from a specific
device only, or leave the field empty to receive data from any
device on the specified port.
Receive jFlow Packets Select the IP address(es) on which PRTG listens to jFlow packets.
on IP The list of IP addresses shown here is specific to your setup. To
select an IP address, add a check mark in front of the respective
line. The IP address selected here must match the one configured
in the jFlow export options of your hardware router device. Note:
When configuring export, please make sure you select the
appropriate jFlow version for this sensor.
Active Flow Timeout Enter a time span in minutes after which new flow data must be
(Minutes) received. If the timeout is reached and no new data is received, the
sensor may switch to an Unknown status. Please enter an integer
value. We recommend setting this one minute longer than the
respective timeout configured in your hardware router device.
Note: If you set this value too low, flow information might get lost!
Sampling Mode Define if you want to use the sampling mode. This setting must
accord to the setting in the flow exporter. Choose between:
§ Off: The standard flow will be used.
§ On: Switch into sampling mode and specify the sampling rate
below.
Sampling Rate This field is only visible when sampling mode is enabled above.
Enter a number that matches the sampling rate in your exporter
device. If the number is different, monitoring results will be
incorrect. Please enter an integer value.
Log Stream Data to Define if the probe will write a log file of the stream and packet
Disk (for Debugging) data to the data folder (see Dat a St orage 2074 ). Choose between:
§ None (recommended): Do not write additional log files.
Recommended for normal use cases.
§ Only for t he 'Ot her' channel: Only write log files of data that is
not filtered otherwise and therefore accounted to the default
Ot her channel.
§ All st ream dat a: Write log files for all data received.
24.10.2013 665
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
52 jFlow V5 Sensor
Note: Use with caution! When enabled, huge data files can be
created. Please use for a short time and for debugging purposes
only.
Channel Selection Define the categories the traffic will be accounted to. There are
different groups of traffic available. Choose between:
§ Web: Internet web traffic.
§ File Transfer: Traffic caused by FTP.
§ Mail: Internet mail traffic.
§ Chat : Traffic caused by chat and instant messaging.
§ Remot e Cont rol: Traffic caused by remote control applications,
such as RDP, SSH, Telnet, VNC.
§ Infrast ruct ure: Traffic caused by network services, such as
DHCP, DNS, Ident, ICMP, SNMP.
§ Net BIOS: Traffic caused by NetBIOS communication.
§ Ot her Prot ocols: Traffic caused by various other protocols via
UDP and TCP.
For each traffic group, you can select how many channels will be
used for each group, i.e. how detailed traffic will be divided. For
each group, choose between:
§ No: Do not account traffic of this group in an own channel. All
traffic of this group will be accounted to the default channel
named Ot her.
§ Yes: Count all traffic of this group and summarize it into one
channel.
§ Det ail: Count all traffic of this group and further divide it into
different channels. The traffic will appear in several channels as
shown in the Cont ent column. Note: Extensive use of this
option can cause load problems on your probe system. We
recommend setting specific, well-chosen filters for the data you
really want to analyze.
Note: You can change the default configuration for groups and
channels. For details, please see section More.
666 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
52 jFlow V5 Sensor
Filt ering
Include Filter Define if you want to filter any traffic. If you leave this field empty,
all traffic will be included. To include specific traffic only, define
filters using a special syntax. For detailed information, please see
Filt er Rules for xFlow, IPFIX , and Packet Sniffer Sensors 2032
section.
Exclude Filter First, the filters defined in the Include Filt er field are considered.
From this subset, you can explicitly exclude traffic, using the same
syntax. For detailed information, please see Filt er Rules for xFlow,
IPFIX , and Packet Sniffer Sensors 2032 section.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Primary Toplist
Primary Toplist Define which will be your primary toplist. It will be shown in maps
when adding a toplist object. Choose from:
§ Top Talkers
§ Top Connect ions
§ Top Prot ocols
24.10.2013 667
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
52 jFlow V5 Sensor
Primary Toplist
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
668 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
52 jFlow V5 Sensor
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
24.10.2013 669
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
52 jFlow V5 Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
670 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
52 jFlow V5 Sensor
Toplists
For all flow and packet sniffer sensors there are Toplist s available on the Overview tab of a
sensor's detail page. Using toplists, you can review traffic data of small time periods in great
detail. For more information, please see Toplist s 1728 section.
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
Related Topics
§ Filt er Rules for xFlow, IPFIX , and Packet Sniffer Sensors 2032
§ Channel Defint ions for xFlow, IPFIX , and Packet Sniffer Sensors 2036
24.10.2013 671
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
53 jFlow V5 (Custom) Sensor
The jFlow V5 (Custom) sensor receives traffic data from a jFlow V5 compatible device and
shows the traffic by type. On your hardware device, please make sure it matches jFlow V5 and
disable any sampling option! In this custom sensor, you can define your own channel
definitions to divide traffic into different channels.
Note: In order for the sensor to work, jFlow export of the respective version must be enabled
on the device. The device must send the flow data stream to the IP address of the PRTG probe
system on which the sensor is set up (either a local or remote probe). The sensor does not
support sampling, so please disable sampling in your jFlow device! This sensor type cannot be
used in cluster mode. You can set it up on a local probe or remote probe only, not on a cluster
probe.
For a general introduction to the technology behind flow monitoring, please see Monit oring
Bandwidt h via Flows 1966 section.
PRTG does not support more than 50 sensor channels officially. Depending on the data used
with this sensor type, you might exceed the maximum number of supported sensor channels.
In this case, PRTG will try to display all sensor channels. However, please be aware that you will
experience limited usability and performance.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
672 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
53 jFlow V5 (Custom) Sensor
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Receive jFlow Packets Enter the UDP port number on which the flow packets are received.
on UDP Port It must match the one configured in the jFlow export options of
your hardware router device. Please enter an integer value. Note:
When configuring export, please make sure you select the
appropriate jFlow version for this sensor.
Sender IP Enter the IP address of the sending device you want to receive the
jFlow from. Enter an IP address to receive data from a specific
device only, or leave the field empty to receive data from any
device on the specified port.
Receive jFlow Packets Select the IP address(es) on which PRTG listens to jFlow packets.
on IP The list of IP addresses shown here is specific to your setup. To
select an IP address, add a check mark in front of the respective
line. The IP address selected here must match the one configured
in the jFlow export options of your hardware router device. Note:
When configuring export, please make sure you select the
appropriate jFlow version for this sensor.
Active Flow Timeout Enter a time span in minutes after which new flow data must be
(Minutes) received. If the timeout is reached and no new data is received, the
sensor may switch to an Unknown status. Please enter an integer
value. We recommend setting this one minute longer than the
respective timeout configured in your hardware router device.
Note: If you set this value too low, flow information might get lost!
Sampling Mode Define if you want to use the sampling mode. This setting must
accord to the setting in the flow exporter. Choose between:
§ Off: The standard flow will be used.
§ On: Switch into sampling mode and specify the sampling rate
below.
24.10.2013 673
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
53 jFlow V5 (Custom) Sensor
Sampling Rate This field is only visible when sampling mode is enabled above.
Enter a number that matches the sampling rate in your exporter
device. If the number is different, monitoring results will be
incorrect. Please enter an integer value.
Channel Definition Please enter a channel definition to divide the traffic into different
channels. Write each definition in one line. For detailed information,
please see Channel Defint ions for xFlow and Packet Sniffer
Sensors 2036 section. All traffic for which no channel is defined will
be accounted to the default channel named Ot her. Note: Extensive
use of many filters can cause load problems on your probe system.
We recommend defining specific, well-chosen filters for the data
you really want to analyse.
Log Stream Data to Define if the probe will write a log file of the stream and packet
Disk (for Debugging) data to the data folder (see Dat a St orage 2074 ). Choose between:
§ None (recommended): Do not write additional log files.
Recommended for normal use cases.
§ Only for t he 'Ot her' channel: Only write log files of data that is
not filtered otherwise and therefore accounted to the default
Ot her channel.
§ All st ream dat a: Write log files for all data received.
Note: Use with caution! When enabled, huge data files can be
created. Please use for a short time and for debugging purposes
only.
Filt ering
Include Filter Define if you want to filter any traffic. If you leave this field empty,
all traffic will be included. To include specific traffic only, define
filters using a special syntax. For detailed information, please see
Filt er Rules for xFlow, IPFIX , and Packet Sniffer Sensors 2032
section.
Exclude Filter First, the filters defined in the Include Filt er field are considered.
From this subset, you can explicitly exclude traffic, using the same
syntax. For detailed information, please see Filt er Rules for xFlow,
IPFIX , and Packet Sniffer Sensors 2032 section.
674 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
53 jFlow V5 (Custom) Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Primary Toplist
Primary Toplist Define which will be your primary toplist. It will be shown in maps
when adding a toplist object. Choose from:
§ Top Talkers
§ Top Connect ions
§ Top Prot ocols
§ [Any custom toplists you have added]
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
24.10.2013 675
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
53 jFlow V5 (Custom) Sensor
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
676 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
53 jFlow V5 (Custom) Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
24.10.2013 677
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
53 jFlow V5 (Custom) Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
678 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
53 jFlow V5 (Custom) Sensor
Toplists
For all flow and packet sniffer sensors there are Toplist s available on the Overview tab of a
sensor's detail page. Using toplists, you can review traffic data of small time periods in great
detail. For more information, please see Toplist s 1728 section.
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
Related Topics
§ Filt er Rules for xFlow, IPFIX , and Packet Sniffer Sensors 2032
§ Channel Defint ions for xFlow, IPFIX , and Packet Sniffer Sensors 2036
24.10.2013 679
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
54 LDAP Sensor
The LDAP sensor monitors directory services using Lightweight Directory Access Protocol
(LDAP), connecting to the server trying a "bind". It shows the response time. If the server does
not respond or authentication fails, an error message will be triggered.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
LDAP Specific
Port Enter the LDAP port number, usually port 389 for unencrypted
connections. Please enter an integer value.
Distinguished Name Enter the Distinguished Name (DN) you want to authenticate to the
LDAP server. Usually, this is the information for the user you want
to authenticate with. For example, use the format
cn=Manager,dc=my -domain,dc=com for a DN on an OpenLDAP
server.
680 13.06.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
54 LDAP Sensor
LDAP Specific
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
13.06.2013 681
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
54 LDAP Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
682 13.06.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
54 LDAP Sensor
§ Mast er object for parent : Make this sensor the master object
for its parent device. The sensor will influence the behavior of
the device it is created on: If the sensor is in a Down status, the
device will be paused. For example, it is a good idea to make a
Ping sensor the master object for its parent device to pause
monitoring for all other sensors on the device in case the device
cannot even be pinged. Additionally, the sensor will be paused if
the parent group of its parent device is in a Down status, or if it
is paused by another dependency.
Note: Testing your dependencies is easy! Simply choose Simulat e
Error St at us from the context menu of an object that other
objects depend on. A few seconds later all dependent objects
should be paused.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
13.06.2013 683
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
54 LDAP Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
684 13.06.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
55 Microsoft SQL Sensor
The Microsoft SQL sensor monitors a Microsoft Structured Query Language (SQL) server. It
shows the response time, the number of records, and the value. The sensor can monitor if the
database server accepts connections, processes requests, and returns an expected result
when executing a custom SQL command.
The following SQL servers are supported: SQL Server 2008, SQL Server 2005 (including SQL
Server Express / Server Compact Editions), SQL Server 2000, SQL Server 7 and MSDE (requires
OLE DB installed on the machine running the PRTG probe that accesses the server)
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Timeout (sec.) Enter a timeout in seconds for the request. If the reply takes longer
than this value the request is aborted and an error message is
triggered.
24.10.2013 685
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
55 Microsoft SQL Sensor
Instance Enter the SQL server instance's name if you want to connect to a
"named instance". For example, such an instance's name could be
SQLEXPRESS. Note: Sometimes you will see connection strings like
SQLSERVER\SQLINSTANCE in database clients. The first part is the
server name configured under the general server settings. The
second part refers to the instance name mentioned above. Never
enter this complete string in this PRTG form, merely provide the
second part (without the backslash). Please enter a string or leave
the field empty.
Port Define the port for the SQL connection. Choose between:
§ Aut omat ic: Automatically choose the right port.
§ Manual: Use a specific port. Define below. Standard value is
1433.
Port This field is only visible if manual port selection is enabled above.
Define the port number for the SQL connection. Please enter an
integer value.
Dat abase
Database Enter the name of the SQL database the sensor will connect to. For
example, such a database's name could be Northwind
Authentication Define the kind of authentication used for the connection to the
database. Choose between:
§ SQL Server: Use credentials specific to the SQL server. Please
enter them below.
§ Windows Aut hent icat ion: Use the Windows credentials defined
for the parent device this sensor is created on. Note: For
successful authentication, the defined Windows credentials must
be known to the SQL server, and SQL server and the computer
the PRTG probe is running on must be in the same domain.
686 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
55 Microsoft SQL Sensor
Dat a
SQL Expression Enter a valid SQL statement to execute on the server. In your
SELECT statement, please specify the field name explicitly. Do not
use SELECT *! For example, a correct expression could be: SELECT
ProductName FROM Northwind.dbo.Products. When a cursor is
returned (i.e. with a SELECT statement), only the first row of data
will be processed.
Note: Executing stored procedures is currently not supported.
Record Count If you want to know how many records in your database were
affected by your SQL expression as defined above, you can count
the number of concerned records. Choose between:
§ Do not count number of records: Affected records will not be
counted.
§ Count number of records: The number of affected records will
be counted. Note: Enabling this option might increase the
execution time of this sensor.
Post-Processing If the SQL expression returns a result set, please define if you want
to further process it. Choose between:
§ Ignore result set : Do not do anything with the data returned.
§ Process numerical result : Regard the result set returned as
integer or float. You can set the sensor to Warning or Down
status for specific thresholds. Define below.
§ Process st ring result : Regard the result set returned as a string.
You can set the sensor to error for certain sub-strings contained
or missing. Define below.
§ Monit or for changes: Monitor if the result set has changed
since last check. The sensor will send an internal message
indicating that its value has changed. In combination with a
Change Trigger, you can use this mechanism to trigger a
notification 1716 whenever a sensor value changes.
Condition "Warning" This field is only visible if numeric results is enabled above. Define a
condition of the returned numeric SQL result set that will set the
sensor to a Warning status. Choose between:
§ none: Do not set the sensor to Warning status for any
condition.
§ equals: Result set must be the same as the value provided
below.
§ is above: Result set must be above the value provided below.
§ lower t han: Result set must be below the value provided below.
24.10.2013 687
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
55 Microsoft SQL Sensor
Value This field is only visible if numeric results is enabled above. Enter a
value of the returned numeric SQL result set that will set the
sensor into a Warning status. Please enter an integer or float
value.
Condition "Down" This field is only visible if numeric results is enabled above. Define a
condition of the returned numeric SQL result set that will set the
sensor to a Down status. Choose between:
§ none: Do not set the sensor to Down status for any condition.
§ equals: Result set must be the same as the value provided
below.
§ is above: Result set must be above the value provided below.
§ lower t han: Result set must be below the value provided below.
§ does not equal: Result set must be unequal to the value
provided below.
Note: This threshold check the SQL result set only. You can set
additional thresholds in the sensor's channel settings 1709 .
Value This field is only visible if numeric results is enabled above. Enter a
value of the returned numeric SQL result set that will set the
sensor to a Down status. Please enter an integer value.
Response Must Include This field is only visible if string results is enabled above. Enter a
string that must be part of the returned SQL string. If it is not, the
sensor will be set to an error state. Please enter a string or leave
the field empty.
Response Must Not This field is only visible if string results is enabled above. Enter a
include string that must not be part of the returned SQL string. If it is, the
sensor will be set to an error state. Please enter a string or leave
the field empty.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
688 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
55 Microsoft SQL Sensor
Sensor Display
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
24.10.2013 689
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
55 Microsoft SQL Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
690 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
55 Microsoft SQL Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
24.10.2013 691
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
55 Microsoft SQL Sensor
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
692 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
56 MySQL Sensor
The MySQL sensor monitors a MySQL server. It connects to the server and shows the
response time. Additionally, it can read the number of records and a value.
The following SQL servers are supported: MySQL server 5.1, 5.0, 4.1, 4.0, and 3.23
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Port Define the port for the SQL connection. Choose between:
§ Aut omat ic: Automatically choose the right port.
§ Manual: Use a specific port. Define below. Standard value is
3306.
27.11.2012 693
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
56 MySQL Sensor
Timeout (sec.) Enter a timeout in seconds for the request. If the reply takes longer
than this value the request is aborted and an error message is
triggered.
DB/SQL Dat a
Database Enter the name of the SQL database the sensor will connect to. For
example, such a database's name could be MyDatabase. This is a
logical entity on the database server where database objects like
tables or stored procedures exist. In case of the mySQL server it
also reflects a physical directory structure where your database
objects are stored. Enter the appropriate string which is the same
as you would supply when invoking the mysql.exe admin tool (with
the command line switch -p) or after the login with mysql.exe with
the command use.
User Enter the user name that will be used for the database connection.
Password Enter the password that will be used for the database connection.
Dat a
SQL Expression Enter a valid SQL statement to execute on the server. In your
SELECT statement, please specify the field name explicitly. Do not
use SELECT *! For example, a correct expression could be: SELECT
AVG(UnitPrice) FROM Products. When a cursor is returned (i.e. with
a SELECT statement), only the first row of data will be processed.
Record Count If you want to know how many records in your database were
affected by your SQL expression as defined above, you can count
the number of concerned records. Choose between:
§ Do not count number of records: Affected records will not be
counted.
§ Count number of records: The number of affected records will
be counted. Note: Enabling this option might increase the
execution time of this sensor.
Post-Processing If the SQL expression returns a result set, please define if you want
to further process it. Choose between:
§ Ignore result set : Do not do anything with the data returned.
694 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
56 MySQL Sensor
Condition "Warning" This field is only visible if numeric results is enabled above. Define a
condition of the returned numeric SQL result set that will set the
sensor to a Warning status. Choose between:
§ none: Do not set the sensor to Warning status for any
condition.
§ equals: Result set must be the same as the value provided
below.
§ is above: Result set must be above the value provided below.
§ lower t han: Result set must be below the value provided below.
§ does not equal: Result set must be unequal to the value
provided below.
Note: This threshold check the SQL result set only. You can set
additional thresholds in the sensor's channel settings 1709 .
Value This field is only visible if numeric results is enabled above. Enter a
value of the returned numeric SQL result set that will set the
sensor into a Warning status. Please enter an integer or float
value.
Condition "Down" This field is only visible if numeric results is enabled above. Define a
condition of the returned numeric SQL result set that will set the
sensor to a Down status. Choose between:
§ none: Do not set the sensor to Down status for any condition.
§ equals: Result set must be the same as the value provided
below.
§ is above: Result set must be above the value provided below.
§ lower t han: Result set must be below the value provided below.
§ does not equal: Result set must be unequal to the value
provided below.
Note: This threshold check the SQL result set only. You can set
additional thresholds in the sensor's channel settings 1709 .
27.11.2012 695
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
56 MySQL Sensor
Value This field is only visible if numeric results is enabled above. Enter a
value of the returned numeric SQL result set that will set the
sensor to a Down status. Please enter an integer value.
Response Must Include This field is only visible if string results is enabled above. Enter a
string that must be part of the returned SQL string. If it is not, the
sensor will be set to an error state. Please enter a string or leave
the field empty.
Response Must Not This field is only visible if string results is enabled above. Enter a
include string that must not be part of the returned SQL string. If it is, the
sensor will be set to an error state. Please enter a string or leave
the field empty.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
696 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
56 MySQL Sensor
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
27.11.2012 697
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
56 MySQL Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
698 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
56 MySQL Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
27.11.2012 699
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
57 NetFlow V5 Sensor
The NetFlow V5 sensor receives traffic data from a NetFlow V5 compatible device and shows
the traffic by type. Please make sure the sensor matches the NetFlow version your device is
exporting! There are several filter options available to divide traffic into different channels.
Note: In order for the sensor to work, NetFlow export of the respective version must be
enabled on the device. The device must send the flow data stream to the IP address of the
PRTG probe system on which the sensor is set up (either a local or remote probe). This sensor
type cannot be used in cluster mode. You can set it up on a local probe or remote probe only,
not on a cluster probe.
For a general introduction to the technology behind flow monitoring, please see Monit oring
Bandwidt h via Flows 1966 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
700 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
57 NetFlow V5 Sensor
Receive NetFlow Enter the UDP port number on which the flow packets are received.
Packets on UDP Port It must match the one you have configured in the NetFlow export
options of your hardware router device. Please enter an integer
value. Note: When configuring export, please make sure you select
the appropriate NetFlow version for this sensor.
Sender IP Enter the IP address of the sending device you want to receive the
NetFlow from. Enter an IP address to receive data from a specific
device only, or leave the field empty to receive data from any
device on the specified port.
Active Flow Timeout Enter a time span in minutes after which new flow data must be
(Minutes) received. If the timeout is reached and no new data is received, the
sensor may switch to an Unknown status. Please enter an integer
value. We recommend setting this one minute longer than the
respective timeout configured in your hardware router device.
Note: If you set this value too low, flow information might get lost!
Sampling Mode Define if you want to use the sampling mode. This setting must
accord to the setting in the flow exporter. Choose between:
§ Off: The standard flow will be used.
§ On: Switch into sampling mode and specify the sampling rate
below.
Sampling Rate This field is only visible when sampling mode is enabled above.
Enter a number that matches the sampling rate in your exporter
device. If the number is different, monitoring results will be
incorrect. Please enter an integer value.
Log Stream Data to Define if the probe will write a log file of the stream and packet
Disk (for Debugging) data to the data folder (see Dat a St orage 2074 ). Choose between:
§ None (recommended): Do not write additional log files.
Recommended for normal use cases.
§ Only for t he 'Ot her' channel: Only write log files of data that is
not filtered otherwise and therefore accounted to the default
Ot her channel.
§ All st ream dat a: Write log files for all data received.
27.11.2012 701
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
57 NetFlow V5 Sensor
Note: Use with caution! When enabled, huge data files can be
created. Please use for a short time and for debugging purposes
only.
Channel Selection Define the categories the traffic will be accounted to. There are
different groups of traffic available. Choose between:
§ Web: Internet web traffic.
§ File Transfer: Traffic caused by FTP.
§ Mail: Internet mail traffic.
§ Chat : Traffic caused by chat and instant messaging.
§ Remot e Cont rol: Traffic caused by remote control applications,
such as RDP, SSH, Telnet, VNC.
§ Infrast ruct ure: Traffic caused by network services, such as
DHCP, DNS, Ident, ICMP, SNMP.
§ Net BIOS: Traffic caused by NetBIOS communication.
§ Ot her Prot ocols: Traffic caused by various other protocols via
UDP and TCP.
For each traffic group, you can select how many channels will be
used for each group, i.e. how detailed traffic will be divided. For
each group, choose between:
§ No: Do not account traffic of this group in an own channel. All
traffic of this group will be accounted to the default channel
named Ot her.
§ Yes: Count all traffic of this group and summarize it into one
channel.
§ Det ail: Count all traffic of this group and further divide it into
different channels. The traffic will appear in several channels as
shown in the Cont ent column. Note: Extensive use of this
option can cause load problems on your probe system. We
recommend setting specific, well-chosen filters for the data you
really want to analyze.
Note: You can change the default configuration for groups and
channels. For details, please see section More.
702 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
57 NetFlow V5 Sensor
Filt ering
Include Filter Define if you want to filter any traffic. If you leave this field empty,
all traffic will be included. To include specific traffic only, define
filters using a special syntax. For detailed information, please see
Filt er Rules for xFlow, IPFIX , and Packet Sniffer Sensors 2032
section.
Exclude Filter First, the filters defined in the Include Filt er field are considered.
From this subset, you can explicitly exclude traffic, using the same
syntax. For detailed information, please see Filt er Rules for xFlow,
IPFIX , and Packet Sniffer Sensors 2032 section.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Primary Toplist
Primary Toplist Define which will be your primary toplist. It will be shown in maps
when adding a toplist object. Choose from:
§ Top Talkers
§ Top Connect ions
§ Top Prot ocols
27.11.2012 703
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
57 NetFlow V5 Sensor
Primary Toplist
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
704 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
57 NetFlow V5 Sensor
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
27.11.2012 705
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
57 NetFlow V5 Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
706 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
57 NetFlow V5 Sensor
Toplists
For all flow and packet sniffer sensors there are Toplist s available on the Overview tab of a
sensor's detail page. Using toplists, you can review traffic data of small time periods in great
detail. For more information, please see Toplist s 1728 section.
More
Knowledge Base: How can I change the default groups and channels for xFlow and Packet
Sniffer sensors?
§ http://kb.paessler.com/en/topic/60203
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
Related Topics
§ Filt er Rules for xFlow, IPFIX , and Packet Sniffer Sensors 2032
§ Channel Defint ions for xFlow, IPFIX , and Packet Sniffer Sensors 2036
27.11.2012 707
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
58 NetFlow V5 (Custom) Sensor
The NetFlow V5 (Custom) sensor receives traffic data from a NetFlow V5 compatible device and
shows the traffic by type. Please make sure the sensor matches the NetFlow version your
device is exporting! In this custom sensor, you can define your own channel definitions to
divide traffic into different channels.
Note: In order for the sensor to work, NetFlow export of the respective version must be
enabled on the device. The device must send the flow data stream to the IP address of the
PRTG probe system on which the sensor is set up (either a local or remote probe). This sensor
type cannot be used in cluster mode. You can set it up on a local probe or remote probe only,
not on a cluster probe.
For a general introduction to the technology behind flow monitoring, please see Monit oring
Bandwidt h via Flows 1966 section.
PRTG does not support more than 50 sensor channels officially. Depending on the data used
with this sensor type, you might exceed the maximum number of supported sensor channels.
In this case, PRTG will try to display all sensor channels. However, please be aware that you will
experience limited usability and performance.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
708 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
58 NetFlow V5 (Custom) Sensor
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Receive NetFlow Enter the UDP port number on which the flow packets are received.
Packets on UDP Port It must match the one configured in the NetFlow export options of
your hardware router device. Please enter an integer value. Note:
When configuring export, please make sure you select the
appropriate NetFlow version for this sensor.
Sender IP Enter the IP address of the sending device you want to receive the
NetFlow from. Enter an IP address to receive data from a specific
device only, or leave the field empty to receive data from any
device on the specified port.
Active Flow Timeout Enter a time span in minutes after which new flow data must be
(Minutes) received. If the timeout is reached and no new data is received, the
sensor may switch to an Unknown status. Please enter an integer
value. We recommend setting this one minute longer than the
respective timeout configured in your hardware router device.
Note: If you set this value too low, flow information might get lost!
Sampling Mode Define if you want to use the sampling mode. This setting must
accord to the setting in the flow exporter. Choose between:
§ Off: The standard flow will be used.
§ On: Switch into sampling mode and specify the sampling rate
below.
Sampling Rate This field is only visible when sampling mode is enabled above.
Enter a number that matches the sampling rate in your device. If the
number is different, monitoring results will be incorrect. Please
enter an integer value.
07.02.2013 709
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
58 NetFlow V5 (Custom) Sensor
Channel Definition Please enter a channel definition to divide the traffic into different
channels. Write each definition in one line. For detailed information,
please see Channel Definit ions for xFlow, IPFIX , and Packet
Sniffer Sensors 2036 section. All traffic for which no channel is
defined will be accounted to the default channel named Ot her.
Note: Extensive use of many filters can cause load problems on
your probe system. We recommend defining specific, well-chosen
filters for the data you really want to analyze.
Log Stream Data to Define if the probe will write a log file of the stream and packet
Disk (for Debugging) data to the data folder (see Dat a St orage 2074 ). Choose between:
§ None (recommended): Do not write additional log files.
Recommended for normal use cases.
§ Only for t he 'Ot her' channel: Only write log files of data that is
not filtered otherwise and therefore accounted to the default
Ot her channel.
§ All st ream dat a: Write log files for all data received.
Note: Use with caution! When enabled, huge data files can be
created. Please use for a short time and for debugging purposes
only.
Filt ering
Include Filter Define if you want to filter any traffic. If you leave this field empty,
all traffic will be included. To include specific traffic only, define
filters using a special syntax. For detailed information, please see
Filt er Rules for xFlow, IPFIX , and Packet Sniffer Sensors 2032
section.
Exclude Filter First, the filters defined in the Include Filt er field are considered.
From this subset, you can explicitly exclude traffic, using the same
syntax. For detailed information, please see Filt er Rules for xFlow,
IPFIX , and Packet Sniffer Sensors 2032 section.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
710 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
58 NetFlow V5 (Custom) Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Primary Toplist
Primary Toplist Define which will be your primary toplist. It will be shown in maps
when adding a toplist object. Choose from:
§ Top Talkers
§ Top Connect ions
§ Top Prot ocols
§ [Any custom toplists you have added]
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
07.02.2013 711
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
58 NetFlow V5 (Custom) Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
712 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
58 NetFlow V5 (Custom) Sensor
§ Mast er object for parent : Make this sensor the master object
for its parent device. The sensor will influence the behavior of
the device it is created on: If the sensor is in a Down status, the
device will be paused. For example, it is a good idea to make a
Ping sensor the master object for its parent device to pause
monitoring for all other sensors on the device in case the device
cannot even be pinged. Additionally, the sensor will be paused if
the parent group of its parent device is in a Down status, or if it
is paused by another dependency.
Note: Testing your dependencies is easy! Simply choose Simulat e
Error St at us from the context menu of an object that other
objects depend on. A few seconds later all dependent objects
should be paused.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
07.02.2013 713
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
58 NetFlow V5 (Custom) Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
714 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
58 NetFlow V5 (Custom) Sensor
Toplists
For all flow and packet sniffer sensors there are Toplist s available on the Overview tab of a
sensor's detail page. Using toplists, you can review traffic data of small time periods in great
detail. For more information, please see Toplist s 1728 section.
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
Related Topics
§ Filt er Rules for xFlow, IPFIX , and Packet Sniffer Sensors 2032
§ Channel Defint ions for xFlow, IPFIX , and Packet Sniffer Sensors 2036
07.02.2013 715
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
59 NetFlow V9 Sensor
The NetFlow V9 sensor receives traffic data from a NetFlow V9 compatible device and shows
the traffic by type. Please make sure the sensor matches the NetFlow version your device is
exporting! There are several filter options available to divide traffic into different channels.
Note: In order for the sensor to work, NetFlow export of the respective version must be
enabled on the device. The device must send the flow data stream to the IP address of the
PRTG probe system on which the sensor is set up (either a local or remote probe). This sensor
type cannot be used in cluster mode. You can set it up on a local probe or remote probe only,
not on a cluster probe.
For a general introduction to the technology behind flow monitoring, please see Monit oring
Bandwidt h via Flows 1966 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
716 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
59 NetFlow V9 Sensor
Receive NetFlow Enter the UDP port number on which the flow packets are received.
Packets on UDP Port It must match the one you have configured in the NetFlow export
options of your hardware router device. Please enter an integer
value. Note: When configuring export, please make sure you select
the appropriate NetFlow version for this sensor.
Sender IP Enter the IP address of the sending device you want to receive the
NetFlow from. Enter an IP address to receive data from a specific
device only, or leave the field empty to receive data from any
device on the specified port.
Active Flow Timeout Enter a time span in minutes after which new flow data must be
(Minutes) received. If the timeout is reached and no new data is received, the
sensor may switch to an Unknown status. Please enter an integer
value. We recommend setting this one minute longer than the
respective timeout configured in your hardware router device.
Note: If you set this value too low, flow information might get lost!
Sampling Mode Define if you want to use the sampling mode. This setting must
accord to the setting in the flow exporter. Choose between:
§ Off: The standard flow will be used.
§ On: Switch into sampling mode and specify the sampling rate
below.
Sampling Rate This field is only visible when sampling mode is enabled above.
Enter a number that matches the sampling rate in your exporter
device. If the number is different, monitoring results will be
incorrect. Please enter an integer value.
Log Stream Data to Define if the probe will write a log file of the stream and packet
Disk (for Debugging) data to the data folder (see Dat a St orage 2074 ). Choose between:
§ None (recommended): Do not write additional log files.
Recommended for normal use cases.
§ Only for t he 'Ot her' channel: Only write log files of data that is
not filtered otherwise and therefore accounted to the default
Ot her channel.
§ All st ream dat a: Write log files for all data received.
27.11.2012 717
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
59 NetFlow V9 Sensor
Note: Use with caution! When enabled, huge data files can be
created. Please use for a short time and for debugging purposes
only.
Channel Selection Define the categories the traffic will be accounted to. There are
different groups of traffic available. Choose between:
§ Web: Internet web traffic.
§ File Transfer: Traffic caused by FTP.
§ Mail: Internet mail traffic.
§ Chat : Traffic caused by chat and instant messaging.
§ Remot e Cont rol: Traffic caused by remote control applications,
such as RDP, SSH, Telnet, VNC.
§ Infrast ruct ure: Traffic caused by network services, such as
DHCP, DNS, Ident, ICMP, SNMP.
§ Net BIOS: Traffic caused by NetBIOS communication.
§ Ot her Prot ocols: Traffic caused by various other protocols via
UDP and TCP.
For each traffic group, you can select how many channels will be
used for each group, i.e. how detailed traffic will be divided. For
each group, choose between:
§ No: Do not account traffic of this group in an own channel. All
traffic of this group will be accounted to the default channel
named Ot her.
§ Yes: Count all traffic of this group and summarize it into one
channel.
§ Det ail: Count all traffic of this group and further divide it into
different channels. The traffic will appear in several channels as
shown in the Cont ent column. Note: Extensive use of this
option can cause load problems on your probe system. We
recommend setting specific, well-chosen filters for the data you
really want to analyze.
Note: You can change the default configuration for groups and
channels. For details, please see section More.
718 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
59 NetFlow V9 Sensor
Filt ering
Include Filter Define if you want to filter any traffic. If you leave this field empty,
all traffic will be included. To include specific traffic only, define
filters using a special syntax. For detailed information, please see
Filt er Rules for xFlow, IPFIX , and Packet Sniffer Sensors 2032
section.
Exclude Filter First, the filters defined in the Include Filt er field are considered.
From this subset, you can explicitly exclude traffic, using the same
syntax. For detailed information, please see Filt er Rules for xFlow,
IPFIX , and Packet Sniffer Sensors 2032 section.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Primary Toplist
Primary Toplist Define which will be your primary toplist. It will be shown in maps
when adding a toplist object. Choose from:
§ Top Talkers
§ Top Connect ions
§ Top Prot ocols
27.11.2012 719
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
59 NetFlow V9 Sensor
Primary Toplist
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
720 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
59 NetFlow V9 Sensor
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
27.11.2012 721
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
59 NetFlow V9 Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
722 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
59 NetFlow V9 Sensor
Toplists
For all flow and packet sniffer sensors there are Toplist s available on the Overview tab of a
sensor's detail page. Using toplists, you can review traffic data of small time periods in great
detail. For more information, please see Toplist s 1728 section.
More
Knowledge Base: How can I change the default groups and channels for xFlow and Packet
Sniffer sensors?
§ http://kb.paessler.com/en/topic/60203
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
Related Topics
§ Filt er Rules for xFlow, IPFIX , and Packet Sniffer Sensors 2032
§ Channel Defint ions for xFlow, IPFIX , and Packet Sniffer Sensors 2036
27.11.2012 723
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
60 NetFlow V9 (Custom) Sensor
The NetFlow V9 (Custom) sensor receives traffic data from a NetFlow V9 compatible device and
shows the traffic by type. Please make sure the sensor matches the NetFlow version your
device is exporting! In this custom sensor, you can define your own channel definitions to
divide traffic into different channels.
Note: In order for the sensor to work, NetFlow export of the respective version must be
enabled on the device. The device must send the flow data stream to the IP address of the
PRTG probe system on which the sensor is set up (either a local or remote probe). This sensor
type cannot be used in cluster mode. You can set it up on a local probe or remote probe only,
not on a cluster probe.
For a general introduction to the technology behind flow monitoring, please see Monit oring
Bandwidt h via Flows 1966 section.
PRTG does not support more than 50 sensor channels officially. Depending on the data used
with this sensor type, you might exceed the maximum number of supported sensor channels.
In this case, PRTG will try to display all sensor channels. However, please be aware that you will
experience limited usability and performance.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
724 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
60 NetFlow V9 (Custom) Sensor
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Receive NetFlow Enter the UDP port number on which the flow packets are received.
Packets on UDP Port It must match the one configured in the NetFlow export options of
your hardware router device. Please enter an integer value. Note:
When configuring export, please make sure you select the
appropriate NetFlow version for this sensor.
Sender IP Enter the IP address of the sending device you want to receive the
NetFlow from. Enter an IP address to receive data from a specific
device only, or leave the field empty to receive data from any
device on the specified port.
Active Flow Timeout Enter a time span in minutes after which new flow data must be
(Minutes) received. If the timeout is reached and no new data is received, the
sensor may switch to an Unknown status. Please enter an integer
value. We recommend setting this one minute longer than the
respective timeout configured in your hardware router device.
Note: If you set this value too low, flow information might get lost!
Sampling Mode Define if you want to use the sampling mode. This setting must
accord to the setting in the flow exporter. Choose between:
§ Off: The standard flow will be used.
§ On: Switch into sampling mode and specify the sampling rate
below.
Sampling Rate This field is only visible when sampling mode is enabled above.
Enter a number that matches the sampling rate in your device. If the
number is different, monitoring results will be incorrect. Please
enter an integer value.
07.02.2013 725
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
60 NetFlow V9 (Custom) Sensor
Channel Definition Please enter a channel definition to divide the traffic into different
channels. Write each definition in one line. For detailed information,
please see Channel Definit ions for xFlow, IPFIX , and Packet
Sniffer Sensors 2036 section. All traffic for which no channel is
defined will be accounted to the default channel named Ot her.
Note: Extensive use of many filters can cause load problems on
your probe system. We recommend defining specific, well-chosen
filters for the data you really want to analyze.
Log Stream Data to Define if the probe will write a log file of the stream and packet
Disk (for Debugging) data to the data folder (see Dat a St orage 2074 ). Choose between:
§ None (recommended): Do not write additional log files.
Recommended for normal use cases.
§ Only for t he 'Ot her' channel: Only write log files of data that is
not filtered otherwise and therefore accounted to the default
Ot her channel.
§ All st ream dat a: Write log files for all data received.
Note: Use with caution! When enabled, huge data files can be
created. Please use for a short time and for debugging purposes
only.
Filt ering
Include Filter Define if you want to filter any traffic. If you leave this field empty,
all traffic will be included. To include specific traffic only, define
filters using a special syntax. For detailed information, please see
Filt er Rules for xFlow, IPFIX , and Packet Sniffer Sensors 2032
section.
Exclude Filter First, the filters defined in the Include Filt er field are considered.
From this subset, you can explicitly exclude traffic, using the same
syntax. For detailed information, please see Filt er Rules for xFlow,
IPFIX , and Packet Sniffer Sensors 2032 section.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
726 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
60 NetFlow V9 (Custom) Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Primary Toplist
Primary Toplist Define which will be your primary toplist. It will be shown in maps
when adding a toplist object. Choose from:
§ Top Talkers
§ Top Connect ions
§ Top Prot ocols
§ [Any custom toplists you have added]
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
07.02.2013 727
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
60 NetFlow V9 (Custom) Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
728 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
60 NetFlow V9 (Custom) Sensor
§ Mast er object for parent : Make this sensor the master object
for its parent device. The sensor will influence the behavior of
the device it is created on: If the sensor is in a Down status, the
device will be paused. For example, it is a good idea to make a
Ping sensor the master object for its parent device to pause
monitoring for all other sensors on the device in case the device
cannot even be pinged. Additionally, the sensor will be paused if
the parent group of its parent device is in a Down status, or if it
is paused by another dependency.
Note: Testing your dependencies is easy! Simply choose Simulat e
Error St at us from the context menu of an object that other
objects depend on. A few seconds later all dependent objects
should be paused.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
07.02.2013 729
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
60 NetFlow V9 (Custom) Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
730 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
60 NetFlow V9 (Custom) Sensor
Toplists
For all flow and packet sniffer sensors there are Toplist s available on the Overview tab of a
sensor's detail page. Using toplists, you can review traffic data of small time periods in great
detail. For more information, please see Toplist s 1728 section.
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
Related Topics
§ Filt er Rules for xFlow, IPFIX , and Packet Sniffer Sensors 2032
§ Channel Defint ions for xFlow, IPFIX , and Packet Sniffer Sensors 2036
07.02.2013 731
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
61 Oracle SQL Sensor
The Oracle SQL sensor monitors an Oracle SQL server. It connects to the server and shows
the response time (measured from the time when the connection is opened to the time when
the return values of the SQL query—if configured—have been received). Additionally, it can
read the number of records and a value.
The following SQL servers are supported: Supports Oracle servers 11g, 10g, 9i, 8i, 8.0, and 7.3,
including Oracle 10g Express, and Oracle 8i Personal and Lite editions (requires default TCP port
setting 1521).
Note: On the client computer running the PRTG probe where this sensor is created on, Oracle
Net is used for direct TCP/IP communication; OCI is not supported any more. You do not need
to install an Oracle client or define a TNSNAMES.ORA on the client computer.
Note: With Oracle version 11.2.0.4, Oracle's TCP/IP authentication method has changed. You
will encounter connection problems with credential errors when using the direct connection
mode as of this Oracle version. In this case, please install the 32-bit Oracle client on the
machine which is running the PRTG probe and choose Use Oracle client as connection mode
in the sensor settings.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
732 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
61 Oracle SQL Sensor
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Timeout (Sec.) Enter a timeout in seconds for the request. If the reply takes longer
than this value the request is aborted and an error message is
triggered.
Port Enter the port number that will be used for the connection. Default
value is 1521. Please enter an integer value.
Connection Mode Select which mode you want to use to connect to the Oracle
server. Choose between:
§ Use direct mode (TCP/IP): Use Oracle Net for direct TCP/IP
communication.
Note: As of Oracle version 11.2.0.4, please use the Oracle client
(see sensor description above).
§ Use Oracle client : Use the Oracle client for communication. It
needs to be installed the machine which is running the PRTG
probe.
DB/SQL Dat a
Service Name / Alias Enter the name of the SQL database the sensor will connect to. For
example, such a database's name could be orcl
User Enter the user name that will be used for the database connection.
Password Enter the password that will be used for the database connection.
Dat a
SQL Expression Enter a valid SQL statement to execute on the server. In your
SELECT statement, please specify the field name explicitly. Do not
use SELECT *! For example, a correct expression could be: SELECT
sum(salary) FROM hr.employees. When a cursor is returned (i.e.
with a SELECT statement), only the first row of data will be
processed.
28.05.2014 733
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
61 Oracle SQL Sensor
Record Count If you want to know how many records in your database were
affected by your SQL expression as defined above, you can count
the number of concerned records. Choose between:
§ Do not count number of records: Affected records will not be
counted.
§ Count number of records: The number of affected records will
be counted. Note: Enabling this option might increase the
execution time of this sensor.
Post-Processing If the SQL expression returns a result set, please define if you want
to further process it. Choose between:
§ Ignore result set : Do not do anything with the data returned.
§ Process numerical result : Regard the result set returned as
integer or float. You can set the sensor to Warning or Down
status for specific thresholds. Define below.
§ Process st ring result : Regard the result set returned as a string.
You can set the sensor to error for certain sub-strings contained
or missing. Define below.
§ Monit or for changes: Monitor if the result set has changed
since last check. The sensor will send an internal message
indicating that its value has changed. In combination with a
Change Trigger, you can use this mechanism to trigger a
notification 1716 whenever a sensor value changes.
Condition "Warning" This field is only visible if numeric results is enabled above. Define a
condition of the returned numeric SQL result set that will set the
sensor to a Warning status. Choose between:
§ none: Do not set the sensor to Warning status for any
condition.
§ equals: Result set must be the same as the value provided
below.
§ is above: Result set must be above the value provided below.
§ lower t han: Result set must be below the value provided below.
§ does not equal: Result set must be unequal to the value
provided below.
Note: This threshold check the SQL result set only. You can set
additional thresholds in the sensor's channel settings 1709 .
Value This field is only visible if numeric results is enabled above. Enter a
value of the returned numeric SQL result set that will set the
sensor into a Warning status. Please enter an integer or float
value.
734 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
61 Oracle SQL Sensor
Condition "Down" This field is only visible if numeric results is enabled above. Define a
condition of the returned numeric SQL result set that will set the
sensor to a Down status. Choose between:
§ none: Do not set the sensor to Down status for any condition.
§ equals: Result set must be the same as the value provided
below.
§ is above: Result set must be above the value provided below.
§ lower t han: Result set must be below the value provided below.
§ does not equal: Result set must be unequal to the value
provided below.
Note: This threshold check the SQL result set only. You can set
additional thresholds in the sensor's channel settings 1709 .
Value This field is only visible if numeric results is enabled above. Enter a
value of the returned numeric SQL result set that will set the
sensor to a Down status. Please enter an integer value.
Response Must Include This field is only visible if string results is enabled above. Enter a
string that must be part of the returned SQL string. If it is not, the
sensor will be set to an error state. Please enter a string or leave
the field empty.
Response Must Not This field is only visible if string results is enabled above. Enter a
include string that must not be part of the returned SQL string. If it is, the
sensor will be set to an error state. Please enter a string or leave
the field empty.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
28.05.2014 735
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
61 Oracle SQL Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
736 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
61 Oracle SQL Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
28.05.2014 737
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
61 Oracle SQL Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
More
§ http://kb.paessler.com/en/topic/52803
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
738 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
61 Oracle SQL Sensor
Others
For more general information about settings, please see Object Set t ings 142 section.
28.05.2014 739
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
62 Packet Sniffer Sensor
Monitors the headers of data packets passing a local network card using built-in packet sniffer.
You can choose from predefined channels. Only header traffic will be analyzed.
Note: This sensor can be set up on a Probe Device only! By default, you can only monitor traffic
passing the PRTG probe system on which's Probe Device the sensor is set up (either a local or
remote probe). To monitor other traffic in your network, you can configure a monitoring port
(if available) to which the switch sends a copy of all traffic. You can then physically connect this
port to a network card of the computer the PRTG probe (either local or remote probe) is
running on. This way, PRTG will be able to analyze the complete traffic that passes through the
switch. This feature of your hardware may be called Switched Port Analyzer (SPAN), port
mirroring, or port monitoring.
For a general introduction to the technology behind packet sniffing, please see Monit oring
Bandwidt h via Packet Sniffing 1964 section.
Note: This sensor type can have a high impact on the performance of your monitoring system.
Please use it with care! We recommend using not more than 50 sensors, on each probe, of this
type of sensor.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
740 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
62 Packet Sniffer Sensor
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Sniffer Specific
Include Filter Define if you want to filter any traffic. If you leave this field empty,
all traffic will be included. To include specific traffic only, define
filters using a special syntax. For detailed information, please see
Filt er Rules for xFlow, IPFIX , and Packet Sniffer Sensors 2032
section.
Exclude Filter First, the filters defined in the Include Filt er field are considered.
From this subset, you can explicitly exclude traffic, using the same
syntax. For detailed information, please see Filt er Rules for xFlow,
IPFIX , and Packet Sniffer Sensors 2032 section.
Network Adapters Define the network adapters that will be monitored by the sensor.
You see a list of names with all adapters available on the probe
system. To select an adapter, set a check mark symbol in front of
the respective name.
Log Stream Data to Define if the probe will write a log file of the stream and packet
Disk (for Debugging) data to the data folder (see Dat a St orage 2074 ). Choose between:
§ None (recommended): Do not write additional log files.
Recommended for normal use cases.
§ Only for t he 'Ot her' channel: Only write log files of data that is
not filtered otherwise and therefore accounted to the default
Ot her channel.
§ All st ream dat a: Write log files for all data received.
Note: Use with caution! When enabled, huge data files can be
created. Please use for a short time and for debugging purposes
only.
Channel Selection Define the categories the traffic will be accounted to. There are
different groups of traffic available. Choose between:
§ Web: Internet web traffic.
§ File Transfer: Traffic caused by FTP.
28.05.2014 741
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
62 Packet Sniffer Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
742 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
62 Packet Sniffer Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Primary Toplist
Primary Toplist Define which will be your primary toplist. It will be shown in maps
when adding a toplist object. Choose from:
§ Top Talkers
§ Top Connect ions
§ Top Prot ocols
§ [Any custom toplists you have added]
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
28.05.2014 743
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
62 Packet Sniffer Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
744 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
62 Packet Sniffer Sensor
§ Mast er object for parent : Make this sensor the master object
for its parent device. The sensor will influence the behavior of
the device it is created on: If the sensor is in a Down status, the
device will be paused. For example, it is a good idea to make a
Ping sensor the master object for its parent device to pause
monitoring for all other sensors on the device in case the device
cannot even be pinged. Additionally, the sensor will be paused if
the parent group of its parent device is in a Down status, or if it
is paused by another dependency.
Note: Testing your dependencies is easy! Simply choose Simulat e
Error St at us from the context menu of an object that other
objects depend on. A few seconds later all dependent objects
should be paused.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
28.05.2014 745
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
62 Packet Sniffer Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
746 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
62 Packet Sniffer Sensor
Toplists
For all flow and packet sniffer sensors there are Toplist s available on the Overview tab of a
sensor's detail page. Using toplists, you can review traffic data of small time periods in great
detail. For more information, please see Toplist s 1728 section.
More
Knowledge Base: How can I change the default groups and channels for xFlow and Packet
Sniffer sensors?
§ http://kb.paessler.com/en/topic/60203
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
Related Topics
§ Filt er Rules for xFlow, IPFIX , and Packet Sniffer Sensors 2032
§ Channel Defint ions for xFlow, IPFIX , and Packet Sniffer Sensors 2036
28.05.2014 747
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
63 Packet Sniffer (Custom) Sensor
Monitors the headers of data packets passing a local network card using built-in packet sniffer.
You can define your own channels. There are no predefined channels for this sensor type.
Only header traffic will be analyzed.
Note: This sensor can be set up on a Probe Device only! By default, you can only monitor traffic
passing the PRTG probe system on which's Probe Device the sensor is set up (either a local or
remote probe).To monitor other traffic in your network, you can configure a monitoring port (if
available) to which the switch sends a copy of all traffic. You can then physically connect this
port to a network card of the computer the PRTG probe (either local or remote probe) is
running on. This way, PRTG will be able to analyze the complete traffic that passes through the
switch. This feature of your hardware may be called Switched Port Analyzer (SPAN), port
mirroring, or port monitoring.
For a general introduction to the technology behind packet sniffing, please see Monit oring
Bandwidt h via Packet Sniffing 1964 section.
Note: This sensor type can have a high impact on the performance of your monitoring system.
Please use it with care! We recommend using not more than 50 sensors, on each probe, of this
type of sensor.
PRTG does not support more than 50 sensor channels officially. Depending on the data used
with this sensor type, you might exceed the maximum number of supported sensor channels.
In this case, PRTG will try to display all sensor channels. However, please be aware that you will
experience limited usability and performance.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
748 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
63 Packet Sniffer (Custom) Sensor
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Sniffer specific
Include Filter Define if you want to filter any traffic. If you leave this field empty,
all traffic will be included. To include specific traffic only, define
filters using a special syntax. For detailed information, please see
Filt er Rules for xFlow and Packet Sniffer Sensors 2032 section.
Exclude Filter First, the filters defined in the Include Filt er field are considered.
From this subset, you can explicitly exclude traffic, using the same
syntax. For detailed information, please see Filt er Rules for xFlow
and Packet Sniffer Sensors 2032 section.
Channel Definition Please enter a channel definition to divide the traffic into different
channels. Write each definition in one line. For detailed information,
please see Channel Defint ions for xFlow and Packet Sniffer
Sensors 2036 section. All traffic for which no channel is defined will
be accounted to the default channel named Ot her. Note: Extensive
use of many filters can cause load problems on your probe system.
We recommend defining specific, well-chosen filters for the data
you really want to analyse. We recommend to not use more than
20 channels in graphs and tables, and not more than 100 channels
in total. For performance reasons, it is better to add several
sensors with less channels each.
Network Adapters Define the network adapters that will be monitored by the sensor.
You see a list of names with all adapters available on the probe
system. To select an adapter, set a check mark symbol in front of
the respective name.
Log Stream Data to Define if the probe will write a log file of the stream and packet
Disk (for Debugging) data to the data folder (see Dat a St orage 2074 ). Choose between:
§ None (recommended): Do not write additional log files.
Recommended for normal use cases.
24.10.2013 749
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
63 Packet Sniffer (Custom) Sensor
Sniffer specific
§ Only for t he 'Ot her' channel: Only write log files of data that is
not filtered otherwise and therefore accounted to the default
Ot her channel.
§ All st ream dat a: Write log files for all data received.
Note: Use with caution! When enabled, huge data files can be
created. Please use for a short time and for debugging purposes
only.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Primary Toplist
Primary Toplist Define which will be your primary toplist. It will be shown in maps
when adding a toplist object. Choose from:
§ Top Talkers
§ Top Connect ions
§ Top Prot ocols
§ [Any custom toplists you have added]
750 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
63 Packet Sniffer (Custom) Sensor
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
24.10.2013 751
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
63 Packet Sniffer (Custom) Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
752 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
63 Packet Sniffer (Custom) Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
24.10.2013 753
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
63 Packet Sniffer (Custom) Sensor
Toplists
For all flow and packet sniffer sensors there are Toplist s available on the Overview tab of a
sensor's detail page. Using toplists, you can review traffic data of small time periods in great
detail. For more information, please see Toplist s 1728 section.
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
Related Topics
§ Filt er Rules for xFlow, IPFIX , and Packet Sniffer Sensors 2032
§ Channel Defint ions for xFlow, IPFIX , and Packet Sniffer Sensors 2036
754 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
64 Passive Application Performance Sensor
The Passive Application Performance sensor monitors Transport Control Protocol (TCP)
connection timings using packet sniffer. It can measure the performance of many different web
applications without actually having direct access to neither the client nor the server. In order
to obtain valuable data, these applications must work TCP-based and initiate a new session
with each request.
The sensor shows the total number of packets per second on the selected network card, the
number of dropped packets per second by PRTG because of system overload (more processor
power is required if this value is above zero to cope with the traffic), as well as the number of
currently active connections on all monitored applications.
For defined applications, the sensor can show (together with the corresponding application
name):
§ Request time in msec: average time between the initial (SYN) packet from the client and the
first request package from the client
§ Response time in msec: average time between the initial (SYN) packet from the client and
first packet of the result from the server
§ ACK (acknowledge) time in msec: average time between the initial (SYN) packet of a
connection from the client until the server sends an ACK (acknowledge) packet. This means
that a TCP connection was successfully established (in LANs this value is zero in most cases
and only increases for extreme loads).
§ Count: total number of observed connections to the service in the last monitoring interval.
This is the number of measurements the average is based on. The higher the value the more
reliable/averaged the data is. If this value is zero, PRTG did not see any packets for this
service.
Important notice: This sensor is an experimental sensor. Currently, it is in bet a status. The
methods of operating can change at any time, as well as the available settings. Do not expect
that all functions will work properly, or that this sensor works as expected at all. Be aware that
this type of sensor can be removed again from PRTG at any time.
For a general introduction to the technology behind packet sniffing, please see Monit oring
Bandwidt h via Packet Sniffing 1964 section.
Note: This sensor type can have a high impact on the performance of your monitoring system.
Please use it with care! We recommend using not more than 50 sensors, on each probe, of this
type of sensor.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
24.10.2013 755
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
64 Passive Application Performance Sensor
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Applicat ions
Applications Define the applications you want to monitor. For each application,
use one dedicated line. Use the following syntax to define an
application to be monitored: ip:port=application. Provide the IP
address and port number of the application. Behind the equals sign,
enter a name for the application which will be displayed in the
channels. Please enter a string. This sensor will create four sensor
channels with the application name, e.g., "Application (ACK)".
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
756 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
64 Passive Application Performance Sensor
Sensor Display
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
24.10.2013 757
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
64 Passive Application Performance Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
758 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
64 Passive Application Performance Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
24.10.2013 759
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
64 Passive Application Performance Sensor
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
760 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
65 PerfCounter Custom Sensor
The PerfCounter Custom sensor monitors a configured set of Windows Performance Counters.
You can define your own channels. There are no predefined channels available for this sensor
type. To find out which performance counters are available on the target system and what
their names are, please see section More 766 .
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on. In the parent device's 276 Credent ials for Windows Sy st ems settings,
please prefer using Windows domain credentials.
Note: If you use local credentials, please make sure the same Windows user accounts (with
same username and password) exist on both the system running the PRTG probe and the
target computer. If you fail to do so, a connection via Performance Counters will not be
possible.
Note: The user account has to be a member of the Performance Monitor Users user group on
the target system.
In order for this sensor to work with Windows Performance Counters, please make sure the
RemoteRegistry "Remote Registry" Windows service is running on the target computer. If you
fail to do so, a connection via Performance Counters will not be possible.
To enable the service, please log in to the respective computer and open the services
manager (e.g. via services.msc). In the list, find the respective service and set its Start Type to
Automatic.
In order for this sensor to work with Windows Performance Counters, please make sure a
Windows version 2008 or later is installed on the computer running the PRTG probe: This is
either on the local system (on every node, if on a cluster probe), or on the system running a
remote probe 2050 . Note: The target system may well run on Windows 2003 or later.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
28.05.2014 761
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
65 PerfCounter Custom Sensor
List of Counters Enter a list of performance counters which will be queried. Define
one counter per row. PRTG will create one channel for each
counter. Use the following syntax: the name of the counter,
followed by two colons (::) and the unit. Example: \Processor
(_Total)\% Processor Time::%
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
762 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
65 PerfCounter Custom Sensor
List of Counters The list of counters monitored by this sensor. Once a sensor is
created this value cannot be changed. It is shown for reference
purposes only. If you need to change this, please add the sensor
anew.
Mode The mode in which the returning values are displayed. Once a
sensor is created this value cannot be changed. It is shown for
reference purposes only. If you need to change this, please add
the sensor anew.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
28.05.2014 763
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
65 PerfCounter Custom Sensor
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
764 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
65 PerfCounter Custom Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
28.05.2014 765
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
65 PerfCounter Custom Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
More
Knowledge Base: How can I find out the names of available Performance Counters?
766 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
65 PerfCounter Custom Sensor
§ http://kb.paessler.com/en/topic/50673
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
28.05.2014 767
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
66 PerfCounter IIS Application Pool Sensor
The PerfCounter IIS Application Pool sensor monitors a Microsoft Internet Information Services
(IIS) application pool using Windows Performance Counters. This sensor can show the overall
state of an application pool, the number of worker processes, the number of failures in worker
processes, as well as the number of ping failures, shutdown failures, and startup failures in
worker processes.
In order to monitor Microsoft Internet Information Services (IIS) application pools, this sensor
needs IIS version 7.5 or later to be installed on the target system.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on. In the parent device's 276 Credent ials for Windows Sy st ems settings,
please prefer using Windows domain credentials.
Note: If you use local credentials, please make sure the same Windows user accounts (with
same username and password) exist on both the system running the PRTG probe and the
target computer. If you fail to do so, a connection via Performance Counters will not be
possible.
Note: The user account has to be a member of the Performance Monitor Users user group on
the target system.
In order for this sensor to work with Windows Performance Counters, please make sure the
RemoteRegistry "Remote Registry" Windows service is running on the target computer. If you
fail to do so, a connection via Performance Counters will not be possible.
To enable the service, please log in to the respective computer and open the services
manager (e.g. via services.msc). In the list, find the respective service and set its Start Type to
Automatic.
In order for this sensor to work with Windows Performance Counters, please make sure a
Windows version 2008 or later is installed on the computer running the PRTG probe: This is
either on the local system (on every node, if on a cluster probe), or on the system running a
remote probe 2050 . Note: The target system may well run on Windows 2003 or later.
768 03.05.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
66 PerfCounter IIS Application Pool Sensor
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor Microsoft Internet Information Services (IIS) application pools, PRTG will
create one sensor for each pool. The settings you make in this dialog are valid for all of the
sensors that are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Application Pool A list of all available items is shown with their name. Select the
desired items by adding check marks in front of the respective
lines. One sensor will be created for each selection. You can also
select and deselect all items by using the check box in the table
head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
03.05.2013 769
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
66 PerfCounter IIS Application Pool Sensor
Application Pool The name of the application pool that is monitored by this sensor.
Once a sensor is created this value cannot be changed. It is shown
for reference purposes only. If you need to change this, please add
the sensor anew.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
770 03.05.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
66 PerfCounter IIS Application Pool Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
03.05.2013 771
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
66 PerfCounter IIS Application Pool Sensor
§ Mast er object for parent : Make this sensor the master object
for its parent device. The sensor will influence the behavior of
the device it is created on: If the sensor is in a Down status, the
device will be paused. For example, it is a good idea to make a
Ping sensor the master object for its parent device to pause
monitoring for all other sensors on the device in case the device
cannot even be pinged. Additionally, the sensor will be paused if
the parent group of its parent device is in a Down status, or if it
is paused by another dependency.
Note: Testing your dependencies is easy! Simply choose Simulat e
Error St at us from the context menu of an object that other
objects depend on. A few seconds later all dependent objects
should be paused.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
772 03.05.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
66 PerfCounter IIS Application Pool Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
03.05.2013 773
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
66 PerfCounter IIS Application Pool Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
774 03.05.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
67 Ping Sensor
The Ping sensor sends an Internet Control Message Protocol (ICMP) echo request ("Ping") from
the computer running the probe to the device it is created on, in order to monitor the
availability of a device. When using more than one Ping per interval, it also measures minimum
and maximum Ping time as well as packet loss in percent.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Timeout (Sec.) Enter a timeout in seconds for the Ping. If the reply takes longer
than this value the request is aborted and an error message is
triggered.
Packet Size (Bytes) Enter the packet size in bytes for the Ping. You can choose any
value between 1 and 10000. We recommend using the default
value.
28.05.2014 775
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
67 Ping Sensor
Ping Method Define the kind of Ping check that will be performed. Choose
between:
§ Send one single Ping: With each scanning interval, send a single
Ping only. A sensor in this setting will show the Ping time only.
This setting is good for simply availability monitoring.
§ Send mult iple Ping request : With each scanning interval, send
multiple Pings in a row. A sensor in this setting will also show
minimum and maximum Ping time as well as packet loss (in
percent). This setting is good if you want to create reports about
average Ping times out of a series of ping requests. Note: When
using multiple request, all of them have to get lost in order for
the sensor to switch to a Down status. For example, if there is
only one Ping request answered in a series of five, the sensor will
still show a green Up status.
Ping Count This field is only visible if sending multiple Pings is enabled above.
Enter the number of Pings that are sent in a row for one interval.
Please enter an integer value.
Ping Delay (in ms) This field is only visible if sending multiple Pings is enabled above.
Enter the time in milliseconds PRTG has to wait between two Ping
requests. Please enter an integer value. Note: Increase the value if
the target device drops Ping packets due to denial-of-service (DOS)
suspicion.
Auto Acknowledge You can define that a Down status of this sensor will be
acknowledged 145 automatically.
§ Show "Down" st at us on error (default ): Do not automatically
acknowledge an alarm if this sensor changes to a Down status.
§ Show "Down (Acknowledged)" st at us on error: Automatically
acknowledge an alarm. If this sensor changes to a Down status,
it will automatically change to Down (Acknowledged). Note: The
sensor will also go through a Down status, so any sensor state
triggers 1716 using this will still provoke notifications, as
configured.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
776 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
67 Ping Sensor
Sensor Display
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
28.05.2014 777
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
67 Ping Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
778 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
67 Ping Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
More
Knowledge Base: How to create/customize statistical PING sensor?
§ http://kb.paessler.com/en/topic/1873
28.05.2014 779
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
67 Ping Sensor
§ http://kb.paessler.com/en/topic/10203
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
780 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
68 Ping Jitter Sensor
The Ping Jitter sensor sends a series of Internet Control Message Protocol (ICMP) echo
requests ("Pings") to the given URI to determine the statistical jitter. The Real Time Jitter value is
updated every time a packet is received using the formula described in RFC 1889:
The Statistical Jitter value is calculated on the first x packets received using the statistical
variance formula:
Note: This sensor type can have a high impact on the performance of your monitoring system.
Please use it with care! We recommend using not more than 50 sensors, on each probe, of this
type of sensor.
This sensor type requires the Microsoft .NET Framework to be installed on the computer
running the PRTG probe: Either on the local system (on every node, if on a cluster probe), or
on the system running the remote probe 2050 . If the framework is missing, you cannot create
this sensor. Note: You need to install the exact version required (a higher version will usually
not work; an exception applies to .NET 3.5 which comprises .NET 2.0 and .NET 3.0). Generally, it
is possible to run several .NET Framework versions on the same machine side-by-side. Please
install the latest update available for the required version.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
07.02.2013 781
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
68 Ping Jitter Sensor
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Ping Count Define the number of pings that will be sent. Please enter an
integer value.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
782 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
68 Ping Jitter Sensor
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
07.02.2013 783
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
68 Ping Jitter Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
784 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
68 Ping Jitter Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
07.02.2013 785
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
69 Pingdom Sensor
The Pingdom sensor queries an account at Pingdom.com and retrieves values for one "check"
configured in the respective Pingdom account. With every scanning interval, the sensor will
always catch the last value available in the "detailed check log" of your Pingdom account.
Note: This sensor type can have a high impact on the performance of your monitoring system.
Please use it with care! We recommend using not more than 50 sensors, on each probe, of this
type of sensor.
This sensor type requires the Microsoft .NET Framework to be installed on the computer
running the PRTG probe: Either on the local system (on every node, if on a cluster probe), or
on the system running the remote probe 2050 . If the framework is missing, you cannot create
this sensor. Note: You need to install the exact version required (a higher version will usually
not work; an exception applies to .NET 3.5 which comprises .NET 2.0 and .NET 3.0). Generally, it
is possible to run several .NET Framework versions on the same machine side-by-side. Please
install the latest update available for the required version.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
786 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
69 Pingdom Sensor
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Pingdom Check Name Enter the name of the "check" you want to retrieve data for. Enter it
exactly the way configured in your Pingdom account. This setting is
case sensitive! Please enter a string.
Username Please enter the username of the Pingdom account you want to
query. Please enter a string.
Password Please enter the password of the Pingdom account you want to
query. Please enter a string.
If Value Changes Define what shall be done in case the value of this sensor changes.
You can choose between:
· Ignore changes (default ): No action will be taken on change.
· Trigger 'change' not ificat ion: The sensor will send an internal
message indicating that its value has changed. In combination
with a Change Trigger, you can use this mechanism to trigger a
notification 1716 whenever the sensor value changes.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
07.02.2013 787
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
69 Pingdom Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1831 . Note: Please make sure you select
the same scanning interval you configured for the "check" in your
Pingdom account. Only if the intervals match PRTG can catch every
measurement from your "check".
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
788 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
69 Pingdom Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
07.02.2013 789
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
69 Pingdom Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
790 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
69 Pingdom Sensor
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
07.02.2013 791
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
70 POP3 Sensor
The POP3 sensor monitors a mail server using Post Office Protocol version 3 (POP3). It shows
the response time of the server.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
792 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
70 POP3 Sensor
Pop3 Specific
Timeout Enter a timeout in seconds for the request. If the reply takes longer
than this value the request is aborted and an error message is
triggered.
Port Specify the port that will be used for the POP3 connection. For
non-secure connections usually port 110 is used; usually port 995
for SSL connections. The actual setting depends on the server you
are connecting to. Please enter an integer value. We recommend
using the default value. If you do not get a connection, please try
another port number.
SSL-Method This field is only visible if security is enabled above. Select the SSL
method that will be used when connecting to the server. We
recommend using the default value. Only if you experience
connection problems, try another setting. Choose between:
§ SSL V2
§ SSL V2 or V3
§ SSL V3
§ TLS V1
27.11.2012 793
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
70 POP3 Sensor
POP3 Authentication Select the kind of authentication for the POP3 connection. Choose
Type between:
· Wit hout Login: Monitor the connection to the POP3 server only.
· Username and Password: Log into the POP3 server with user
name and password (simple login, non-secure).
Username This field is only visible if an option with login is selected above.
Enter a username for POP3 authentication. Please enter a string.
Password This field is only visible if an option with login is selected above.
Enter a password for POP3 authentication. Please enter a string.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
794 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
70 POP3 Sensor
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
27.11.2012 795
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
70 POP3 Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
796 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
70 POP3 Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
27.11.2012 797
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
71 POP3 Email Count Sensor
The POP3 Email Count sensor connects to a POP3 email account and returns the number of
emails stored in it. Additionally, you can filter by to or from address, or by subject, to only
count mails matching the search pattern.
Note: This sensor type can have a high impact on the performance of your monitoring system.
Please use it with care! We recommend using not more than 50 sensors, on each probe, of this
type of sensor.
This sensor type requires the Microsoft .NET Framework to be installed on the computer
running the PRTG probe: Either on the local system (on every node, if on a cluster probe), or
on the system running the remote probe 2050 . If the framework is missing, you cannot create
this sensor. Note: You need to install the exact version required (a higher version will usually
not work; an exception applies to .NET 3.5 which comprises .NET 2.0 and .NET 3.0). Generally, it
is possible to run several .NET Framework versions on the same machine side-by-side. Please
install the latest update available for the required version.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
798 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
71 POP3 Email Count Sensor
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Username Define the username of the POP3 account you want to log into.
Note: As POP3 server, this sensor will use the parent device's IP
Address/DNS Name value.
Password Define the passwort for the POP3 account. Note: As POP3 server,
this sensor will use the parent device's IP Address/DNS Name
value.
Mailserver POP3 Port Define the port number the POP3 server is running at. Please enter
an integer value. Note: As POP3 server, this sensor will use the
parent device's IP Address/DNS Name value.
Use SSL Define whether to use SSL for the connection to the POP3 server.
Choose between:
§ No
§ Yes
Note: As POP3 server, this sensor will use the parent device's
hostname.
Filter To Address Optionally define a To address. Only mails containing this will be
counted by the sensor. Please enter a string or leave the field
empty.
Filter From Address Optionally define a From address. Only mails containing this will be
counted by the sensor. Please enter a string or leave the field
empty.
Filter Subject Content Optionally define an email Subject. Only mails containing this will be
counted by the sensor. Please enter a string or leave the field
empty.
07.02.2013 799
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
71 POP3 Email Count Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
800 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
71 POP3 Email Count Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
07.02.2013 801
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
71 POP3 Email Count Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
802 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
71 POP3 Email Count Sensor
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
07.02.2013 803
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
72 Port Sensor
The Port sensor monitors a network service by connecting to its port. It tries to connect to
the specified TCP/IP port number of a device and waits for the request to be accepted.
Depending on your settings, it can alert you either when the monitored port is open, or when
it is closed.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Port Specific
Timeout (sec.) Enter a timeout in seconds for the port connect. If the reply takes
longer than this value the request is aborted and an error message
is triggered.
Port Enter the number of the port the sensor will try to connect to.
Please enter an integer value.
804 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
72 Port Sensor
Port Specific
SSL (Secure Sockets Specify if an encryption will be used for the connection. Choose
Layer) between:
§ Don't use SSL (recommended)
§ Use SSL
SSL-Method This field is only visible if security is enabled above. Select the SSL
method that will be used when connecting to the server. We
recommend using the default value. Only if you experience
connection problems, try another setting. Choose between:
§ SSL V2
§ SSL V2 or V3
§ SSL V3
§ TLS V1
Goal Define how the sensor will report on the port defined above.
Choose between:
§ Open: The sensor will return a green OK status if the port is
open, and show a red Down status if the port is closed.
§ Closed: The sensor will return a green OK status if the port is
closed, and show a red Down status if the port is open.
Command Define whether a command will be sent after the port is opened.
Choose between:
§ Don't send command: Only check if a connection to the port is
possible.
§ Send command: Open a Telnet session to the respective port
and send the command. Note: You cannot use this option if the
target machine is a webserver.
24.10.2013 805
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
72 Port Sensor
Allowed Code This field is only visible if response code check is enabled above.
Enter a code that must be returned. If it does not match the sensor
will be set to a Down status. Please enter an integer value.
Check For Existing This setting is only visible if text processing is activated above.
Keywords (Positive) Check if a certain keyword is part of the received value. If there is
no match, the sensor will show a "Down" status.
§ Disable: Do not check for positive keywords.
§ Enable key word check (posit ive): Check if a certain keyword
exists in the received value. Define below.
Text Must Include This setting is only visible if keyword check is activated above.
Enter a search string that must be contained in the returned value.
For Keyword Search Define the method you want to provide the search string with.
Use Choose between:
§ Plain Text : Search for a simple string.
§ Regular Expression: Search using a regular expression. For
more details, see Regular Expressions 2048 section.
Check For Existing This setting is only visible if text processing is activated above.
Keywords (Negative) Check if a certain keyword is not part of the received value. If
there is a match, the sensor will show a "Down" status.
Text Must Not Include This setting is only visible if keyword check is activated above.
Enter a search string that must not be contained in the returned
value.
For Keyword Search Define the method you want to provide the search string with.
Use Choose between:
§ Plain Text : Search for a simple string.
§ Regular Expression: Search using a regular expression. For
more details, see Regular Expressions 2048 section.
806 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
72 Port Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
24.10.2013 807
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
72 Port Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
808 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
72 Port Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
24.10.2013 809
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
72 Port Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
810 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
73 Port Range Sensor
The Port Range sensor monitors a network service by connecting to various TCP/IP ports. It
tries to connect to the specified TCP/IP port numbers of a device in succession and waits for
each request to be accepted. It returns the number of closed ports and open ports in two
different channels. Optionally, you can set limits in the sensor's channel settings. This way you
can get alerted about open/closed ports.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Timeout (sec.) Enter a timeout in seconds for the port connect. If the reply takes
longer than this value the request is aborted and an error message
is triggered.
Port-by-Port-Delay (ms) Specify in milliseconds how long the sensor will wait to go to the
next port while running through all given ports.
29.11.2012 811
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
73 Port Range Sensor
Port Range Selection Define whether you want to monitor all ports within a range or if
Method you want to monitor several individual ports. Choose between:
§ Port Range wit h st art /end: Monitor ports within a range.
§ List of Port s: Provide a list of several individual ports to monitor.
Range Start This field is only visible if the port range method is enabled above.
Enter the port number where the scan will start. Please enter an
integer value.
Range End This field is only visible if the port range method is enabled above.
Enter the port number where the scan will end. Please enter an
integer value.
Port List This field is only visible if the list of ports method is enabled above.
Enter the numbers of the ports the sensor will try to connect to.
Please enter one or more individual integer values.
If Value Changes Define what will be done in case the value of a sensor channel
changes. Choose between:
§ Ignore changes: No action will be taken on change.
§ Trigger 'change' not ificat ion: The sensor will send an internal
message indicating that its value has changed. In combination
with a Change Trigger, you can use this mechanism to trigger a
notification 1716 whenever the sensor value changes.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
812 29.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
73 Port Range Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
29.11.2012 813
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
73 Port Range Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
814 29.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
73 Port Range Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
29.11.2012 815
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
74 Probe Health Sensor
The Probe Health sensor monitors internal PRTG parameters. It shows the state of the PRTG
probe (either for the local probe, a remote probe 2050 , or a cluster 81 probe). This sensor type is
created automatically by PRTG and cannot be deleted. It checks various parameters of your
PRTG system which can affect the quality of the monitoring results:
§ Healt h: This index value sums up the probe state into a value between 100% (healthy) and
0% (failing). Frequent or repeated health values below 100% should be investigated.
§ CPU Load: This channel shows the current percentage CPU load. Extensive CPU load can lead
to false, incomplete, and incorrect monitoring results. This value usually should stay below
50%.
§ Handles: This is a counter for the data structures of the operating system. It is responsible
for internal resource management. Repeated obviously increasing values should be
investigated.
§ Int erval Delay non-WMI&SNMP: This channel shows the percentage interval delay for all
sensor types which are not from the type SNMP or WMI.
§ Int erval Delay SNMP: This channel shows the percentage interval delay for SNMP sensors. If
this value is above 0% there are probably very slow SNMP V3 sensors. In this case, try to
increase the monitoring intervals or distribute the sensors over several probes.
§ Int erval Delay WMI: This channel shows the percentage interval delay for WMI sensors. If
this value is above 0% WMI sensors could not be checked according to their interval. 100%
means that WMI sensors on the average are checked with twice their interval. For values
above 0% try to increase the monitoring intervals or distribute the sensors over several
probes to keep the number of WMI sensors per probe below 120 (with 60 seconds interval)
or 600 (with 300 seconds interval).
§ Lost Flow Packet s: This channel shows the percentage of lost flow packets.
§ Memory Usage: This channel shows the amount of memory being used by the PRTG probe
service as reported by the memory manager. Repeated obviously increasing values should
be investigated. If the value is constantly above 2 GB this indicates that PRTG runs at its
limits. In this case you should distribute some sensors to Remote Probe 2050 .
§ Message Queue: This channel shows the number of monitoring results from the probe
which have not been processed yet by the core. This value usually should stay below 1/10
of the sensor count.
§ Open Request s: This channel shows the number of currently active monitoring requests.
This value should stay below the maximum of 500 open requests.
§ Threads: This channel shows the number of program parts which are running simultaneously
currently. This value can increase with heavy load. The number should not exceed 100 in
normal operation.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
816 03.05.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
74 Probe Health Sensor
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
03.05.2013 817
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
74 Probe Health Sensor
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
818 03.05.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
74 Probe Health Sensor
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
03.05.2013 819
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
75 QoS (Quality of Service) One Way Sensor
The QoS (Quality of Service) One Way sensor monitors parameters regarding the quality of a
network connection between two probes, which is important, for example, when using Voice
over IP (VoIP) over this connection. The sensor sends a series of UDP packets from the parent
probe to another probe and measures packet loss, jitter, Packet Delay Variation (PDV), etc.
Note: In order for this sensor to work, there has to be at least one remote probe 2049
configured in your setup. The sensor can be created on the Probe Device of either a local or
remote probe.
Note: This sensor type cannot be cloned using the Clone Object 1734 function.
For a general introduction to the technology behind Quality of Service monitoring, please see
Monit oring Qualit y of Service 1971 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
820 03.06.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
75 QoS (Quality of Service) One Way Sensor
Timeout (Sec.) Enter a timeout in seconds for the request. If the reply takes longer
than this value the request is aborted and an error message is
triggered. The maximum timeout is 900 seconds (15 minutes).
Target Probe Define the target probe that will receive the UDP packets. In the
drop down menu, all local and remote probes of your setup are
shown. When running the sensor on the local probe, select a
remote probe as Target Probe; if no remote probe is available,
please install and connect a remote probe 2049 first. When running
the sensor on a remote probe, select either another remote probe
or the local probe as target. The sensor will measure values for the
network track between the probe the sensor is created on and the
target probe. Note: You must ensure that firewalls, NAT rules, etc.
will allow the UDP packets to reach the target probe. The Windows
firewall on the target system will be automatically opened by the
probe.
Target Host/IP Define the IP address of the target probe to which the probe the
sensor is created on will connect. When you're not using NAT rules,
this is usually the address shown above next to the target probe's
name.
Port Define the source and t arget port for the UDP packets. This port
will be used on both the source and target probe. Please use a
different port for each QoS sensor to make sure packets can be
assigned correctly. Enter an integer value between 1024 and
65536. Note: This port must be available on both the source and
target system.
Number of Packets Define how many packets are sent for each scanning interval. We
recommend using 1000. Please enter an integer value.
Size of Packets (Bytes) Define the size in bytes of the packets sent. We recommend using
172. Please enter an integer value.
Time between Packets Define the size in milliseconds that will be waited between two
(ms) packets. We recommend using 20. Please enter an integer value.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
03.06.2014 821
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
75 QoS (Quality of Service) One Way Sensor
Sensor Display
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
822 03.06.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
75 QoS (Quality of Service) One Way Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
03.06.2014 823
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
75 QoS (Quality of Service) One Way Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
824 03.06.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
75 QoS (Quality of Service) One Way Sensor
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
03.06.2014 825
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
76 QoS (Quality of Service) Round Trip Sensor
The QoS (Quality of Service) Round Trip sensor monitors parameters regarding the quality of a
network connection between two probes. This is important, for example, when using Voice
over IP (VoIP) over this connection. The sensor sends a series of UDP packets from the parent
probe to another probe. Then, the traffic is sent back to the original probe. The sensor
measures packet loss, jitter, Packet Delay Variation (PDV), the round trip time (RTT), etc.
Note: In order for this sensor to work, there has to be at least one remote probe 2049
configured in your setup. The sensor can be created on the Probe Device of either a local or
remote probe.
Note: This sensor type cannot be cloned using the Clone Object 1734 function.
For a general introduction to the technology behind Quality of Service monitoring, please see
Monit oring Qualit y of Service 1971 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
826 03.06.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
76 QoS (Quality of Service) Round Trip Sensor
Timeout (Sec.) Enter a timeout in seconds for the request. If the reply takes longer
than this value the request is aborted and an error message is
triggered. The maximum timeout is 900 seconds (15 minutes).
Target Probe Define the target probe that will receive the UDP packets. In the
drop down menu, all local and remote probes of your setup are
shown. When running the sensor on the local probe, select a
remote probe as Target Probe; if no remote probe is available,
please install and connect a remote probe 2049 first. When running
the sensor on a remote probe, select either another remote probe
or the local probe as target. The sensor will measure values for the
network track between the probe the sensor is created on and the
target probe. Note: You must ensure that firewalls, NAT rules, etc.
will allow the UDP packets to reach the target probe. The Windows
firewall on the target system will be automatically opened by the
probe.
Target Host/IP Define the IP address of the target probe to which the probe the
sensor is created on will connect. When you're not using NAT rules,
this is usually the address shown above next to the target probe's
name.
Port Define the source and t arget port for the UDP packets. This port
will be used on both the source and target probe. Please use a
different port for each QoS sensor to make sure packets can be
assigned correctly. Enter an integer value between 1024 and
65536. Note: This port must be available on both the source and
target system.
Number of Packets Define how many packets are sent for each scanning interval. We
recommend using 1000. Please enter an integer value.
Size of Packets (Bytes) Define the size in bytes of the packets sent. We recommend using
172. Please enter an integer value.
Time between Packets Define the size in milliseconds that will be waited between two
(ms) packets. We recommend using 20. Please enter an integer value.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
03.06.2014 827
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
76 QoS (Quality of Service) Round Trip Sensor
Sensor Display
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
828 03.06.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
76 QoS (Quality of Service) Round Trip Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
03.06.2014 829
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
76 QoS (Quality of Service) Round Trip Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
830 03.06.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
76 QoS (Quality of Service) Round Trip Sensor
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
03.06.2014 831
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
77 RADIUS Sensor
The RADIUS sensor monitors a Remote Authentication Dial-In User Service (RADIUS) server.
The sensor tries to authenticate at the server and shows the response time. If authentication
fails, it will show an error.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
832 03.04.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
77 RADIUS Sensor
Radius specific
Timeout (sec) Enter a timeout in seconds for the request. If the reply takes longer
than this value, the request is aborted and an error message is
triggered.
User Define the user name used for authentication at the server. Please
enter a string.
Password Define the password used for authentication between the client
and the RADIUS server. Please enter a string. Note: The password
must not be longer than 6 characters.
Secret Define the shared secret used for authentication between the
authenticator (here the PRTG Probe) and the server. Please enter a
string.
Port Enter the port number used for connection to the server. Default
value is 1812. Please enter an integer value.
NAS IP Address Define a valid NAS IP address or leave the field empty.
NAS-Identifier Enter a NAS identifier. Please enter a string or leave the field empty.
Use Chap Add a check mark if you want to use the Challenge Handshake
Authentication Protocol.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
03.04.2014 833
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
77 RADIUS Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
834 03.04.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
77 RADIUS Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
03.04.2014 835
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
77 RADIUS Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
836 03.04.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
78 RDP (Remote Desktop) Sensor
The RDP (Remote Desktop) Sensor monitors remote desktop services (RDP, Terminal Services
Client).
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Sensor Specific
Timeout (sec) Enter a timeout in seconds for the request. If the reply takes longer
than this value the request is aborted and an error message is
triggered.
Port Enter the number of the port the sensor will try to connect to.
Please enter an integer value. Default value is 3389. We recommend
using the default value.
27.11.2012 837
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
78 RDP (Remote Desktop) Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
838 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
78 RDP (Remote Desktop) Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
27.11.2012 839
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
78 RDP (Remote Desktop) Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
840 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
78 RDP (Remote Desktop) Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
27.11.2012 841
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
79 SCVMM Host Sensor
The SCVMM Host sensor monitors a host that is managed by a Microsoft System Center Virtual
Machine Manager (SCVMM). This can be, for example, a Hyper-V host, a VMware host, or a
XenServer host. It can show the CPU usage, free memory (in bytes and percentage), the overall
status, the communication status, the status of the cluster node, the status of the virtual
server, the computer status, and the VM count.
Note: This sensor type can have a high impact on the performance of your monitoring system.
Please use it with care! We recommend using not more than 50 sensors, on each probe, of this
type of sensor.
This sensor type requires the Microsoft .NET Framework to be installed on the computer
running the PRTG probe: Either on the local system (on every node, if on a cluster probe), or
on the system running the remote probe 2050 . If the framework is missing, you cannot create
this sensor. Note: You need to install the exact version required (a higher version will usually
not work; an exception applies to .NET 3.5 which comprises .NET 2.0 and .NET 3.0). Generally, it
is possible to run several .NET Framework versions on the same machine side-by-side. Please
install the latest update available for the required version.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on. In the parent device's 276 Credent ials for Windows Sy st ems settings,
please prefer using Windows domain credentials.
Note: If you use local credentials, please make sure the same Windows user accounts (with
same username and password) exist on both the system running the PRTG probe and the
target computer. Otherwise the sensor cannot connect correctly.
Note: Your Windows credentials may not contain any double quotation marks ("). If they do,
this sensor will not work!
This sensor type uses PowerShell commands. In order to monitor devices with this sensor,
Remot e PowerShell 2.0 has to be enabled. For detailed information, please see More 847
section below. Note: PowerShell 1.0 is not supported.
This sensor type needs the VMM PowerShell Plugin to be installed on the target machine.
Under Windows 2008 and 2012 it is part of the VMM 2008 Administrator Console, or the VMM
2012 Management Console, respectively.
842 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
79 SCVMM Host Sensor
Note: To provide good performance, the System Center Virtual Manager (SCVMM) only reads
the performance data from time to time and caches them. Because of this, updates can take up
to several minutes. If your monitoring returns the same values again and again, please increase
the scanning interval.
In order to make this sensor type compatible for Windows Server 2012 systems, the following
requirements have to be met:
§ The SCVMM PowerShell module has to be in the directory C:\Program Files\Microsoft System
Center 2012\Virtual Machine Manager\bin\psModules\virtualmachinemanager
\virtualmachinemanager.
§ You have to set the execution policy in PowerShell to allow the execution of Import-Module
C:\Program Files\Microsoft System Center 2012\Virtual Machine Manager\bin\psModules
\virtualmachinemanager\virtualmachinemanager. Use the command Set -Execut ionPolicy . We
recommend the execution policy Remot eSigned; AllSigned and Unrest rict ed are also
possible.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor hosts, PRTG will create one sensor for each host. The settings you make in
this dialog are valid for all of the sensors that are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Host Select the hosts you want to add a sensor for. A list of all available
items is shown with their name. Select the desired items by adding
check marks in front of the respective lines. One sensor will be
created for each selection. You can also select and deselect all
items by using the check box in the table head. Note: Please make
sure the name of your hosts do not contain unsupported
characters, especially avoid the hash ('#') sign. We recommend to
not rename hosts once you've set up monitoring. For detailed
information, please see More 602 section below.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
28.05.2014 843
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
79 SCVMM Host Sensor
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Sensor Result Define what will be done with the results the sensor receives.
Choose between:
§ Discard sensor result : Do not store the results.
§ Writ e sensor result t o disk (Filename: "Result of Sensor
[ID].t xt "): Store the last result received to the "Logs (Sensors)"
directory (on the Master node, if in a cluster). This is for
debugging purposes. The file will be overridden with each
scanning interval. For information on how to find the folder used
for storage, please see Dat a St orage 2074 section.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
844 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
79 SCVMM Host Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
28.05.2014 845
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
79 SCVMM Host Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
846 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
79 SCVMM Host Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
More
Knowledge Base: Why don't my Hyper-V sensors work after changing names?
§ http://kb.paessler.com/en/topic/15533
Knowledge Base: How do I enable and use remote commands in Windows PowerShell?
§ http://kb.paessler.com/en/topic/44453
28.05.2014 847
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
79 SCVMM Host Sensor
Knowledge Base: My Powershell sensor returns an error message. What can I do?
§ http://kb.paessler.com/en/topic/59473
Knowledge Base: "No Logon Servers Available" when Using PowerShell Sensors
§ http://kb.paessler.com/en/topic/59745
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
848 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
80 SCVMM Virtual Machine Sensor
The SCVMM Virtual Machine sensor monitors a virtual machine (VM) that is managed by a
Microsoft System Center Virtual Machine Manager (SCVMM). This can be, for example, a Hyper-
V virtual machine, a VMware virtual machine, or a XenServer virtual machine. It can show the
CPU usage, the status of a VM, and disk read and write speed.
Note: This sensor type can have a high impact on the performance of your monitoring system.
Please use it with care! We recommend using not more than 50 sensors, on each probe, of this
type of sensor.
This sensor type requires the Microsoft .NET Framework to be installed on the computer
running the PRTG probe: Either on the local system (on every node, if on a cluster probe), or
on the system running the remote probe 2050 . If the framework is missing, you cannot create
this sensor. Note: You need to install the exact version required (a higher version will usually
not work; an exception applies to .NET 3.5 which comprises .NET 2.0 and .NET 3.0). Generally, it
is possible to run several .NET Framework versions on the same machine side-by-side. Please
install the latest update available for the required version.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on. In the parent device's 276 Credent ials for Windows Sy st ems settings,
please prefer using Windows domain credentials.
Note: If you use local credentials, please make sure the same Windows user accounts (with
same username and password) exist on both the system running the PRTG probe and the
target computer. Otherwise the sensor cannot connect correctly.
Note: Your Windows credentials may not contain any double quotation marks ("). If they do,
this sensor will not work!
This sensor type uses PowerShell commands. In order to monitor devices with this sensor,
Remot e PowerShell 2.0 has to be enabled. For detailed information, please see More 854
section below. Note: PowerShell 1.0 is not supported.
This sensor type needs the VMM PowerShell Plugin to be installed on the target machine.
Under Windows 2008 and 2012 it is part of the VMM 2008 Administrator Console, or the VMM
2012 Management Console, respectively.
28.05.2014 849
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
80 SCVMM Virtual Machine Sensor
Note: To provide good performance, the System Center Virtual Manager (SCVMM) only reads
the performance data from time to time and caches them. Because of this, updates can take up
to several minutes. If your monitoring returns the same values again and again, please increase
the scanning interval.
In order to make this sensor type compatible for Windows Server 2012 systems, the following
requirements have to be met:
§ The SCVMM PowerShell module has to be in the directory C:\Program Files\Microsoft System
Center 2012\Virtual Machine Manager\bin\psModules\virtualmachinemanager
\virtualmachinemanager.
§ You have to set the execution policy in PowerShell to allow the execution of Import-Module
C:\Program Files\Microsoft System Center 2012\Virtual Machine Manager\bin\psModules
\virtualmachinemanager\virtualmachinemanager. Use the command Set -Execut ionPolicy . We
recommend the execution policy Remot eSigned; AllSigned and Unrest rict ed are also
possible.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor VMs, PRTG will create one sensor for each VM. The settings you make in
this dialog are valid for all of the sensors that are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Virtual Machine Select the Virtual Machines (VMs) you want to add a sensor for. A
list of all available items is shown with their name. Select the
desired items by adding check marks in front of the respective
lines. One sensor will be created for each selection. You can also
select and deselect all items by using the check box in the table
head. Note: Please make sure the name of your VMs do not
contain unsupported characters, especially avoid the hash ('#') sign.
We recommend to not rename VMs once you've set up monitoring.
For detailed information, please see More 602 section below.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
850 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
80 SCVMM Virtual Machine Sensor
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Sensor Result Define what will be done with the results the sensor receives.
Choose between:
§ Discard sensor result : Do not store the results.
§ Writ e sensor result t o disk (Filename: "Result of Sensor
[ID].t xt "): Store the last result received to the "Logs (Sensors)"
directory (on the Master node, if in a cluster). This is for
debugging purposes. The file will be overridden with each
scanning interval. For information on how to find the folder used
for storage, please see Dat a St orage 2074 section.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
28.05.2014 851
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
80 SCVMM Virtual Machine Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
852 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
80 SCVMM Virtual Machine Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
28.05.2014 853
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
80 SCVMM Virtual Machine Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
More
Knowledge Base: Why don't my Hyper-V sensors work after changing names?
§ http://kb.paessler.com/en/topic/15533
Knowledge Base: How do I enable and use remote commands in Windows PowerShell?
§ http://kb.paessler.com/en/topic/44453
854 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
80 SCVMM Virtual Machine Sensor
Knowledge Base: My Powershell sensor returns an error message. What can I do?
§ http://kb.paessler.com/en/topic/59473
Knowledge Base: "No Logon Servers Available" when Using PowerShell Sensors
§ http://kb.paessler.com/en/topic/59745
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
28.05.2014 855
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
81 Sensor Factory Sensor
The Sensor Factory sensor is a powerful tool that allows you to create your own sensor with
channels based on data from other sensors. You can define one or more channels using
formulas that combine monitoring results from other sensors.
Note: A sensor factory sensor does not show a "Downtime" channel. Downtime cannot be
calculated for this sensor type.
Note: The Sensor Factory sensor might not work with flow sensors 1966 . Sensor types using
active flow timeout, this is, NetFlow and jFlow sensors 291 , are not supported by the Sensor
Factory sensor.
Note: This sensor type can have a high impact on the performance of your monitoring system.
Please use it with care! We recommend using not more than 50 sensors, on each probe, of this
type of sensor.
PRTG does not support more than 50 sensor channels officially. Depending on the data used
with this sensor type, you might exceed the maximum number of supported sensor channels.
In this case, PRTG will try to display all sensor channels. However, please be aware that you will
experience limited usability and performance.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
856 04.06.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
81 Sensor Factory Sensor
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
04.06.2014 857
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
81 Sensor Factory Sensor
Channel Definition Enter a channel definition for the sensor. Using a specific syntax,
you can refer to data from channels of other sensors here. You can
also calculate values. Enter one channel definition for each new
channel you want to add to this sensor. Please see section Define
Sensor Channels 861 below.
Error Handling Define the sensor's behavior if one of the sensors defined above is
in an error status. In this case, you can set the sensor factory
sensor either to error or to warning status. Choose between:
· Fact ory sensor shows error st at us when one or more source
sensors are in error st at us: If at least one sensor used in a
channel definition is in a Down status, the factory sensor will
show a Down status as well until all referred sensors leave this
status. While the factory sensor is Down it will still show data of
all available sensor channels.
· Fact ory sensor shows warning st at us when one or more
source sensors are in error st at us: If at least one sensor used
in a channel definition is in a Down status, the factory sensor will
show a Warning status until all referred sensors leave the Down
status.
· Use cust om formula: Define the status of the factory sensor by
adding a status definition in the field below.
Status Definition This field is only visible if custom formula is enabled above. Define
when the sensor will switch to a Down status. You can use the
status() function in combination with Boolean operations. For
advanced users it is also possible to calculate a status value. Please
see section Define Sensor St at us 868 below.
If a Sensor Has No Choose how this Sensor Factory sensor will react in case a sensor
Data referred to in the channel definition does not provide any data (for
example, because it is paused or does not exist). Choose
between:
§ Do not calculat e fact ory channels t hat use t he sensor: For
channels that are defined using one or more sensor(s) that
deliver no data, no data will be shown. Additionally, the sensor
will show a Warning state.
§ Calculat e t he fact ory channels and use zero as source value:
If a sensor used in a channel definition does not deliver any data,
zero values will be filled in instead. The channel will be calculated
and shown using these values.
858 04.06.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
81 Sensor Factory Sensor
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
04.06.2014 859
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
81 Sensor Factory Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
860 04.06.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
81 Sensor Factory Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
The channels of a Sensor Factory sensor are controlled by the Channel Definit ion text field.
Using a special syntax you can refer to other sensor channels, calculate values, and add
horizontal lines. You can define factory sensor channels using data from any other sensor's
channels on your PRTG core server.
04.06.2014 861
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
81 Sensor Factory Sensor
Example
You see a definition of two factory sensor channels, both using the channel() function which
simply collects data from the channels of other sensors in your monitoring and displays
them:
#1:Local Probe Health
channel(1001,0)
#2:Local Traffic Out[kbit]
channel(1004,1)
The first channel of the factory sensor (#1) collects data from the Healt h channel (ID 0) of
the Core/Probe Healt h sensor (ID 1001) running on the Local Probe device. The second
channel (#2) collects data from the Traffic out channel (ID 1) of a traffic sensor (ID 1004)
measuring the system's local network card. Both channels will be shown together in the
factory sensor's data tables and graphs.
The basic syntax for a sensor factory channel definition looks like this:
#<id>:<name>[<unit>]
<formula>
For each channel one section is used. A section begins with the # sign. Function names in
formulas are not case sensitive.
§ <id> is the ID of the factory sensor's channel and must be a unique number > 0.
§ <name> is the name of the factory sensor's channel (displayed in graphs and tables).
§ [<unit >] is an optional unit description for the factory sensor's channel (e.g. bytes). If it is
not provided a fitting unit string is selected automatically (recommended).
§ <formula> contains the formula to calculate the factory sensor's channel. For the formula,
you can use the following functions: channel() 863 , min() 864 , max() 864 , avg() 864 , or percent ()
865 .
Within a formula the following elements are allowed to perform calculations with the values
that are returned by one or more functions:
862 04.06.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
81 Sensor Factory Sensor
§ Compare: = (equal), <> (not equal), > (greater), < (less), >= (greater or equal), <= (less or
equal)
If the compare is true the value is 10,000; if false the value is 0. For delta sensors the speed
is compared.
Example
This full channel definition will result in a factory sensor showing a calculation with values
from two channels (channel IDs -1 and 1) of two traffic sensors (sensor IDs 2001 and 1004).
The returned values will be subtracted and then multiplied by two.
Channels can be gauge values (e.g. Ping ms) or delta values (e.g. traffic kbit/s). Not all
combinations are allowed in a formula. Note: When performing percentage calculation, please
use the percent () Funct ion 865 to make sure you obtain the expected values!
· You cannot add/subtract a delta from a gauge channel (and vice versa).
· You cannot multiply two delta channels.
· You cannot compare a delta with a gauge channel.
· You cannot use a channel of (another) Sensor Factory sensor channel in the formula.
The channel() function allows to read the data from a channel of a different sensor. The syntax
is:
channel(<sensorId>,<channelId>)
§ <sensorId> is the ID of the sensor. It is displayed on the sensor details page, in the
Overview tab behind the sensor name.
§ <channelId> is the ID of the sensor channel. It is displayed on the sensor details page, in
the Channels tab for each channel behind the channel name.
04.06.2014 863
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
81 Sensor Factory Sensor
Example
channel(2001,2)
This function reads the data from channel ID 2 of the sensor with the ID 2001.
#1:Sample
channel(2001,2)
This full channel definition reads the data from channel ID 2 of the sensor with the ID 2001
and displays it in the first factory sensor channel (#1), without any additional calculations.
The min() and max() functions return the minimum or maximum of the two values. The syntax
is:
min(<a>,<b>)
max(<a>,<b>)
Values for <a> and <b> are either numbers or channel() 863 functions.
Examples
min(10,5)
This function in the first line returns 5, as this is the smaller value out of 10 and 5.
min( channel(2001,1),channel(2002,1) )
This function returns the minimum of channel 1 of the sensor with ID 2001 and channel 1 of
the sensor with ID 2002.
The avg() function returns the average of the two values. This equals: (a+b) / 2. The syntax is:
avg(<a>,<b>)
Values for <a> and <b> are either numbers or channel() 863 functions.
864 04.06.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
81 Sensor Factory Sensor
Examples
avg(20,10)
avg( channel(2001,1),channel(2002,1) )
This function returns the average of channel 1 of the sensor with ID 2001 and channel 1 of
the sensor with ID 2002.
The percent () function calculates the percent value of two given values, for example, a channel
and a fixed value. The syntax is:
percent(<source>,<maximum>[,<unit>])
§ <source> is the value the percent is calculated for. This is usually a channel() 863 function.
§ <maximum> is the limit value used for the percent calculation.
§ [<unit >] is an optional unit the maximum is provided in. You can use constants with this
function (see Const ant s 867 section below for a list). This can be used for gauge (e.g. Ping
sensors) or delta (e.g. traffic sensors). If no unit is provided 1 will be used. Note: As unit
string % will be added automatically.
04.06.2014 865
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
81 Sensor Factory Sensor
Examples
#1:Usage Traffic In
percent(channel(2001,0),100,kilobit)
#2:Usage Traffic Out
percent(channel(2001,1),100,kilobit)
This full channel definition will result in a factory sensor showing two channels of a traffic
sensor (sensor ID 2001): Traffic in (channel ID 0) and traffic out (channel ID 1). The values will
be displayed as % of maximum bandwidth (100 kilobit/second).
#1:Ping %
percent(channel(2002,0),200)
This full channel definition will result in a factory sensor showing the Ping Time channel
(channel ID 0) of a Ping sensor (sensor ID 2002). The values will be displayed as a percentage
of 200 ms.
You can add lines to the graph using a formula without channel() function. Use a fixed value
instead. The syntax is:
#<id>:<name>[<unit>]
<value>
§ <id> is the ID of the factory sensor's channel and must be a unique number > 1. Although a
horizontal line will not be shown as a channel, the ID has to be unique.
§ <name> is the name of the factory sensor's channel. When used here it will not be displayed
in graphs and tables, but can be used as a comment to describe the nature of the line.
§ [<unit >] is an optional unit description (e.g. kbit/s). If it is not provided the line is applied
automatically to the scale of the first factory sensor channel. If your factory sensor uses
different units you should provide a unit to make sure the line is added for the right scale.
Please enter the unit exactly as shown in your graphs' legend. If you enter a unit that does
not yet exist in your graph, a new scale will be added automatically.
§ <value> contains a number defining where the line will be shown in the graph.
866 04.06.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
81 Sensor Factory Sensor
Examples
This channel definition will result in graph showing a horizontal line at the value of 100 on
the ms scale.
This channel definition will result in graph showing a horizontal line at the value of 2000 on
the kbit /s scale.
#1:Ping Time
channel(2002,0)
#2:Line at 120ms [ms]
120
This full channel definition will result in a factory sensor showing the Ping Time channel
(channel ID 0) of a Ping sensor (sensor ID 2002). Additionally, the sensor's graphs will show a
horizontal line at 120 ms.
§ one = 1
§ kilo = 1000
§ mega = 1000 * kilo
§ giga = 1000 * mega
§ t era = 1000 * giga
§ by t e = 1
§ kiloby t e = 1024
§ megaby t e = 1024 * kilobyte
§ gigaby t e = 1024 * megabyte
§ t eraby t e = 1024 * gigabyte
§ bit = 1/8
§ kilobit = kilo / 8
04.06.2014 867
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
81 Sensor Factory Sensor
§ megabit = mega / 8
§ gigabit = giga / 8
§ t erabit = tera / 8
The status of a Sensor Factory sensor can be controlled by the St at us Definit ion text field, if
the custom formula option is enabled in the Sensor Set t ings 856 . Using a special syntax you
can define when the factory sensor will change to a Down status. In all other cases the sensor
will be in an Up status. The syntax is:
status(sensorID) <boolean> status(sensorID)
§ <sensorId> is the ID of the sensor you want to check the status of. The ID is displayed on
the sensor details page, in the Overview tab behind the sensor name.
§ <boolean> is one of the Boolean operators AND, OR, or NOT. If the resulting expression is
true, the factory sensor will change to a Down status.
868 04.06.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
81 Sensor Factory Sensor
Examples
This will change the factory sensor to a Down status if both sensors, with IDs 2031 and
2044, are Down. Otherwise the factory sensor will show an Up status.
status(2031) OR status(2044)
This will change the factory sensor to a Down status if at least one of the sensors with ID
2031 or ID 2044 is Down. Otherwise the factory sensor will show an Up status.
This will change the factory sensor to a Down status if the sensor with ID 2031 is Down, but
the sensor with ID 2044 is not in a Down status. Otherwise the factory sensor will show an
Up status.
§ Note: A status() function with NOT has to be connected with AND or OR if it is combined
with other status() functions:
status(sensorID) AND NOT status(sensorID)
status(sensorID) OR NOT status(sensorID)
This will change the factory sensor to a Down status if both the sensor with ID 2031 and the
sensor with ID 2044 is Down, or if the sensor with ID 2051 is Down. Otherwise the factory
sensor will show an Up status.
Additionally, the following elements are allowed to perform calculations and comparisons with
the values that are returned by the status functions:
Internally, the status() function returns the downtime channel of the sensor in hundreds of
percent (10,000 = 100%).
04.06.2014 869
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
81 Sensor Factory Sensor
Example
This will change the factory sensor to a Down status if at least any two of the sensors with
IDs 1031, 1032, 1033, or 1034 are Down. Otherwise the factory sensor will show an Up
status.
Note: The status() function may also be used in channel definitions 861 . Using this functionality,
it is for example possible to display the numeric status value of sensors in a factory sensor
channel.
If you're running PRTG in Clustering 81 mode, please note these additional facts:
§ If you add a Sensor Factory sensor underneath the Clust er Probe, and in the Sensor Factory
formula, you refer to a channel of a sensor running on the Clust er Probe as well, the Sensor
Factory sensor will show the data of all cluster nodes for this sensor channel.
§ If you add a Sensor Factory sensor underneath the Local Probe, and in the Sensor Factory
formula, you refer to a channel of a sensor running on the Clust er Probe, the Sensor
Factory sensor will only show data of the primary master node for this sensor channel.
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
870 04.06.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
82 sFlow Sensor
The sFlow sensor receives traffic data from a sFlow V5 compatible device and shows the traffic
by type. Only header traffic will be analyzed. Please make sure the device matches the sFlow
version V5! There are several filter options available to divide traffic into different channels.
Note: In order for the sensor to work, sFlow V5 export must be enabled on the device. The
device must send the flow data stream to the IP address of the PRTG probe system on which
the sensor is set up (either a local or remote probe).
The sensor accepts RAW data only. The stream must be sent via IPv4. This sensor type cannot
be used in cluster mode. You can set it up on a local probe or remote probe only, not on a
cluster probe.
For a general introduction to the technology behind flow monitoring, please see Monit oring
Bandwidt h via Flows 1966 section.
We recommend using sFlow tester for debugging (see More section below).
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
28.05.2014 871
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
82 sFlow Sensor
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Receive sFlow Packets Enter the UDP port number on which the flow packets are received.
on UDP Port It must match the one you have configured in the sFlow export
options of your hardware router device. Default value is 6343.
Please enter an integer value. Note: When configuring export,
please make sure you select the appropriate sFlow version 5.
Sender IP Enter the IP address of the sending device you want to receive the
sFlow from. Enter an IP address to receive data from a specific
device only, or leave the field empty to receive data from any
device on the specified port.
Receive sFlow Packets Select the IP address(es) on which PRTG listens to sFlow packets.
on IP The list of IP addresses shown here is specific to your setup. To
select an IP address, add a check mark in front of the respective
line. The IP address selected here must match the one configured
in the sFlow export options of your hardware router device. Note:
When configuring export, please make sure you select the
appropriate sFlow version 5.
Channel Selection Define the categories the traffic will be accounted to. There are
different groups of traffic available. Choose between:
§ Web: Internet web traffic.
872 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
82 sFlow Sensor
Filt ering
Include Filter Define if you want to filter any traffic. If you leave this field empty,
all traffic will be included. To include specific traffic only, define
filters using a special syntax. For detailed information, please see
Filt er Rules for xFlow, IPFIX , and Packet Sniffer Sensors 2032
section.
Exclude Filter First, the filters defined in the Include Filt er field are considered.
From this subset, you can explicitly exclude traffic, using the same
syntax. For detailed information, please see Filt er Rules for xFlow,
IPFIX , and Packet Sniffer Sensors 2032 section.
28.05.2014 873
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
82 sFlow Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Primary Toplist
Primary Toplist Define which will be your primary toplist. It will be shown in maps
when adding a toplist object. Choose from:
§ Top Talkers
§ Top Connect ions
§ Top Prot ocols
§ [Any custom toplists you have added]
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
874 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
82 sFlow Sensor
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
28.05.2014 875
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
82 sFlow Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
876 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
82 sFlow Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
28.05.2014 877
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
82 sFlow Sensor
Toplists
For all flow and packet sniffer sensors there are Toplist s available on the Overview tab of a
sensor's detail page. Using toplists, you can review traffic data of small time periods in great
detail. For more information, please see Toplist s 1728 section.
More
Knowledge Base: How can I change the default groups and channels for xFlow and Packet
Sniffer sensors?
§ http://kb.paessler.com/en/topic/60203
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
Related Topics
§ Filt er Rules for xFlow, IPFIX , and Packet Sniffer Sensors 2032
§ Channel Defint ions for xFlow, IPFIX , and Packet Sniffer Sensors 2036
878 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
83 sFlow (Custom) Sensor
The sFlow (Custom) sensor receives traffic data from a sFlow V5 compatible device and shows
the traffic by type. Please make sure the device matches the sFlow version V5! There are
several filter options available to divide traffic into different channels.
Note: In order for the sensor to work, sFlow V5 export must be enabled on the device. The
device must send the flow data stream to the IP address of the PRTG probe system on which
the sensor is set up (either a local or remote probe). The sensor accepts RAW data. This
sensor type cannot be used in cluster mode. You can set it up on a local probe or remote
probe only, not on a cluster probe.
For a general introduction to the technology behind flow monitoring, please see Monit oring
Bandwidt h via Flows 1966 section.
We recommend using sFlow tester for debugging (see More section below).
PRTG does not support more than 50 sensor channels officially. Depending on the data used
with this sensor type, you might exceed the maximum number of supported sensor channels.
In this case, PRTG will try to display all sensor channels. However, please be aware that you will
experience limited usability and performance.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
24.10.2013 879
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
83 sFlow (Custom) Sensor
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Receive sFlow Packets Enter the UDP port number on which the flow packets are received.
on UDP Port It must match the one you have configured in the sFlow export
options of your hardware router device. Default value is 6343.
Please enter an integer value. Note: When configuring export,
please make sure you select the appropriate sFlow version 5.
Sender IP Enter the IP address of the sending device you want to receive the
sFlow from. Enter an IP address to receive data from a specific
device only, or leave the field empty to receive data from any
device on the specified port.
Receive sFlow Packets Select the IP address(es) on which PRTG listens to sFlow packets.
on IP The list of IP addresses shown here is specific to your setup. To
select an IP address, add a check mark in front of the respective
line. The IP address selected here must match the one configured
in the sFlow export options of your hardware router device. Note:
When configuring export, please make sure you select the
appropriate sFlow version 5.
880 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
83 sFlow (Custom) Sensor
Channel Definition Please enter a channel definition to divide the traffic into different
channels. Write each definition in one line. For detailed information,
please see Channel Defint ions for xFlow and Packet Sniffer
Sensors 2036 section. All traffic for which no channel is defined will
be accounted to the default channel named Ot her. Note: Extensive
use of many filters can cause load problems on your probe system.
We recommend defining specific, well-chosen filters for the data
you really want to analyse.
Filt ering
Include Filter Define if you want to filter any traffic. If you leave this field empty,
all traffic will be included. To include specific traffic only, define
filters using a special syntax. For detailed information, please see
Filt er Rules for xFlow, IPFIX , and Packet Sniffer Sensors 2032
section.
Exclude Filter First, the filters defined in the Include Filt er field are considered.
From this subset, you can explicitly exclude traffic, using the same
syntax. For detailed information, please see Filt er Rules for xFlow,
IPFIX , and Packet Sniffer Sensors 2032 section.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
24.10.2013 881
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
83 sFlow (Custom) Sensor
Primary Toplist
Primary Toplist Define which will be your primary toplist. It will be shown in maps
when adding a toplist object. Choose from:
§ Top Talkers
§ Top Connect ions
§ Top Prot ocols
§ [Any custom toplists you have added]
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
882 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
83 sFlow (Custom) Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
24.10.2013 883
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
83 sFlow (Custom) Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
884 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
83 sFlow (Custom) Sensor
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
Toplists
For all flow and packet sniffer sensors there are Toplist s available on the Overview tab of a
sensor's detail page. Using toplists, you can review traffic data of small time periods in great
detail. For more information, please see Toplist s 1728 section.
More
Paessler Website: Paessler sFlow Tester
§ http://www.paessler.com/tools/sflowtester
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
24.10.2013 885
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
83 sFlow (Custom) Sensor
Related Topics
§ Filt er Rules for xFlow, IPFIX , and Packet Sniffer Sensors 2032
§ Channel Defint ions for xFlow, IPFIX , and Packet Sniffer Sensors 2036
886 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
84 SFTP Secure File Transfer Protocol Sensor
The sFTP Secure File Transfer Protocol sensor monitors FTP servers of a Linux/Unix system
using SSH File Transfer Protocol (FTP over SSH). It tries to connect to a server and shows the
response time.
For this sensor type credentials for Linux/Solaris/Mac OS (SSH/WBEM) systems must be
defined for the device you want to use the sensor on.
Note: Not all Linux/Unix and Mac OS distributions can be supported by this sensor type.
For a general introduction to SSH monitoring, please see Monit oring via SSH 1962 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
24.10.2013 887
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
84 SFTP Secure File Transfer Protocol Sensor
SSH Specific
Connection Timeout Define a timeout for the connection. This is the the time the sensor
(sec.) waits to establish a connection to the host. You should keep this
value as low as possible.
Shell Timeout (sec.) Define a timeout for the shell response. This is the time in seconds
the sensor waits for the shell to return a response after it has sent
its specific command (e.g. cat /proc/loadavg).
SSH Port Define which port this sensor will use for the SSH connection.
Choose between:
§ Inherit port number from parent device (default ): Use the
port number as defined in the Credentials for Linux/Solaris/Mac
OS (SSH/WBEM) Systems section of the device this sensor is
created on.
§ Ent er cust om port number: Do not use the port number from
the parent device's settings, but define a different port number
below.
Use Port Number This field is only visible if the custom port number setting is enabled
above. Enter the port number this sensor will use for the SSH
connection. Please enter an integer value.
Result Handling Define what will be done with the result data received by the
sensor. Choose between:
· Discard result : Do not store the result data.
· Writ e result t o disk (Filename: "Result of Sensor [ID].t xt ):
Store the last result received from the query to the "Logs
(Sensors)" directory (on the Master node, if in a cluster). File
name: Result of Sensor [ID].txt. This is for debugging purposes.
The file will be overridden with each scanning interval. For
information on how to find the folder used for storage, please
see Dat a St orage 2074 section.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
888 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
84 SFTP Secure File Transfer Protocol Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
24.10.2013 889
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
84 SFTP Secure File Transfer Protocol Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
890 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
84 SFTP Secure File Transfer Protocol Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
24.10.2013 891
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
84 SFTP Secure File Transfer Protocol Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
892 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
85 Share Disk Free Sensor
The Share Disk Free sensor monitors free disk space of a share (Windows/Samba) using Server
Message Block (SMB). It shows the free space in percent and total.
Note: This sensor only works if no quotas are enabled on the target share. If there are quotas
enabled for the user account this sensor uses to connect to the share, the absolute value will
be okay, but the percentage variable will show wrong values.
In order to monitor shares on Windows machines, please make sure the LanmanServer "Server"
Windows service is running on the target computer.
To enable the service, please log in to the respective computer and open the services
manager (e.g. via services.msc). In the list, find the respective service and set its Start Type to
Automatic.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
28.05.2014 893
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
85 Share Disk Free Sensor
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Share Enter the name of the share this sensor will monitor. Only a share
name is allowed here (for example, enter C$). Please do not enter a
complete UNC name here. The server name (\\server\) is taken
from the parent device of this sensor. Note: In order to provide any
shares under Windows, the LanmanServer "Server" Windows service
must be running on the target computer.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
894 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
85 Share Disk Free Sensor
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
28.05.2014 895
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
85 Share Disk Free Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
896 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
85 Share Disk Free Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
More
Knowledge Base: What can I do if PRTG doesn't succeed with monitoring a share? PE029 PE032
§ http://kb.paessler.com/en/topic/513
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
28.05.2014 897
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
85 Share Disk Free Sensor
Others
For more general information about settings, please see Object Set t ings 142 section.
898 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
86 SIP Options Ping Sensor
The SIP Options Ping sensor monitors the connectivity for a Session Initiation Protocol (SIP)
server using SIP options "Ping". It can be used to monitor voice-over-IP (VoIP) services. The
sensor sends "auth" and "options" requests to the SIP server and shows the response time. It
can alert in case of an error.
Note: A SIP server might return a 480 Service temporarily unavailable error until at least one
reachable SIP client is connected to the server.
Note: This sensor type can have a high impact on the performance of your monitoring system.
Please use it with care! We recommend using not more than 50 sensors, on each probe, of this
type of sensor.
This sensor type requires the Microsoft .NET Framework to be installed on the computer
running the PRTG probe: Either on the local system (on every node, if on a cluster probe), or
on the system running the remote probe 2050 . If the framework is missing, you cannot create
this sensor. Note: You need to install the exact version required (a higher version will usually
not work; an exception applies to .NET 3.5 which comprises .NET 2.0 and .NET 3.0). Generally, it
is possible to run several .NET Framework versions on the same machine side-by-side. Please
install the latest update available for the required version.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
07.02.2013 899
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
86 SIP Options Ping Sensor
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
SIP Specific
Port Define the UDP port this sensor will connect to. Please enter an
integer value.
Username Enter the username of the SIP account this sensor will log into after
a connection to the SIP server has been established. Please enter a
string.
Password Enter the password of the SIP account this sensor will log into after
a connection to the SIP server has been established. Please enter a
string.
Timeout (Seconds) Enter the timeout for the connection to the SIP server. Please enter
an integer value.
Retry Count In case the connection to the SIP server fails, the sensor can re-try
to connect. Enter the maximum number of retries. After reaching
the maximum count the sensor will show a red Down status.
Please enter an integer value.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
900 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
86 SIP Options Ping Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
07.02.2013 901
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
86 SIP Options Ping Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
902 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
86 SIP Options Ping Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
07.02.2013 903
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
86 SIP Options Ping Sensor
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
904 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
87 SMTP Sensor
6.8.87 SM TP Sensor
The SMTP sensor monitors a mail server using Simple Mail Transfer Protocol (SMTP) and shows
the server's response time. It can optionally send a test email with every check.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
SMTP specific
Timeout (sec) Enter a timeout in seconds for the SMTP connect. If the reply takes
longer than this value the request is aborted and an error message
is triggered.
14.01.2014 905
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
87 SMTP Sensor
SMTP specific
Port Enter the number of the port that will be used to send an email via
SMTP. For non-secure connections usually port 25 is used; usually
port 465 or 587 for SSL connections. The actual setting depends
on the server you are connecting to. Please enter an integer value.
We recommend using the default value. If you do not get a
connection, please try another port number.
TLS (Transport-Level Select if the SMTP connection will be secured via SSL. Choose
Security) between:
· Don't use: Do not use encryption for the SMTP connection.
· Use: Connect to the SMTP server using the SSL method selected
below.
SSL-Method This field is only visible if security is enabled above. Select the SSL
method that will be used when connecting to the server. We
recommend using the default value. Only if you experience
connection problems, try another setting. Choose between:
§ SSL V2
§ SSL V2 or V3
§ SSL V3
§ TLS V1
906 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
87 SMTP Sensor
Monit oring
Send Mail Define if an email will be sent when connecting to the SMTP server.
Choose between:
· None: Do not send an email, just connect to the SMTP server.
· Send Mail: Send an email through the SMTP server. If there is an
error when sending mail, an error message will be triggered and
the sensor will change to a Down status.
Helo Ident Enter a server name for the helo part of the mail protocol. For
some mail servers the helo ident must be the valid principal host
domain name for the client host.
From Specify which address the sent emails will contain in the from field.
Please enter a valid email address.
To Specify to which address the emails will be sent to. Please enter a
valid email address.
Topic Specify which subject will be used in the sent emails. Please enter a
string or leave the field empty.
Content Specify which body will be used in the sent emails. Please enter a
string or leave the field empty.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
14.01.2014 907
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
87 SMTP Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
908 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
87 SMTP Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
14.01.2014 909
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
87 SMTP Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
910 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
88 SMTP&IMAP Round Trip Sensor
The SMTP&IMAP Round Trip sensor monitors the time it takes for an email to reach an Internet
Message Access Protocol (IMAP) mailbox after being sent using Simple Mail Transfer Protocol
(SMTP). It sends an email to the parent device via SMTP and then scans a dedicated IMAP
mailbox until this email comes in. The sensor shows the response time of SMTP and IMAP
server, and the sum of both.
The SMTP&IMAP Round Trip sensor will delete these emails automatically from the mailbox as
soon as PRTG retrieves them. Emails will only remain in the mailbox particularly if a timeout or a
restart of the PRTG server occurred during sensor run-time.
Note: Please use dedicated email accounts with this sensor type. If you use more sensors of
this type, please make sure that each sensor uses its own email accounts.
For a general introduction to the technology behind round trip monitoring, please see
Monit oring Email Round Trip 1975 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
We recommend adding this sensor on an SMTP server device only, because this sensor type's
settings are optimized for this scenario.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
14.01.2014 911
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
88 SMTP&IMAP Round Trip Sensor
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Sensor Result Define what will be done with the result of the sensor. Choose
between:
§ Discard sensor result : Do not store the sensor result.
§ Writ e sensor result t o disk (Filename: "Result of Sensor
[ID].t xt "): Store the last result received from the sensor to the
"Logs (Sensor)" directory (on the Master node, if in a cluster). File
name: Result of Sensor [ID].txt. This is for debugging purposes.
The file will be overridden with each scanning interval. For
information on how to find the folder used for storage, please
see Dat a St orage 2074 section.
From Specify which address the sent emails will contain in the from field.
Please enter a valid email address.
To Specify to which address the emails will be sent to. Please enter a
valid email address.
Helo Ident Enter a server name for the helo part of the mail protocol. For
some mail servers the helo ident must be the valid principal host
domain name for the client host.
912 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
88 SMTP&IMAP Round Trip Sensor
In this step, you configure how emails will be sent. As SMTP server, the sensor uses the IP-
Address/DNS Name property's value of the device it is added on.
Port Enter the number of the port that will be used to send an email via
SMTP. Please enter an integer value. For non-secure connections
usually port 25 is used; usually port 465 or 587 for SSL
connections. The actual setting depends on the server you are
connecting to. Please enter an integer value. We recommend using
the default value. If you do not get a connection, please try
another port number.
Timeout for SMTP Enter a timeout in seconds for the SMTP connect. If the reply takes
Connection (Sec.) longer than this value the request is aborted and an error message
is triggered.
TLS (Transport-Level Select if the SMTP connection will be secured via SSL. Choose
Security) between:
· Don't use: Do not use encryption for the SMTP connection.
· Use: Connect to the SMTP server using the SSL method selected
below.
SSL-Method This field is only visible if security is enabled above. Select the SSL
method that will be used when connecting to the server. We
recommend using the default value. Only if you experience
connection problems, try another setting. Choose between:
§ SSL V2
§ SSL V2 or V3
§ SSL V3
§ TLS V1
SMTP Authentication Define if you want to use an authentication for the SMTP
Type connection. Choose between:
· None: Do not use any authentication method.
· Username/Password: Authenticate at the SMTP server via
username and password.
Additional Text for The subject part of the round trip email is created automatically by
Email Subject PRTG. It consists of the string "PRTG Roundtrip Mail:" followed by a
unique GUID to correctly identify the email in the IMAP mailbox (e.g.
14.01.2014 PRTG Roundtrip Mail: {5E858D9C-AC70-466A-9B2A- 913
55630165D276}). Use this field to place your custom text before
the automatically created text.
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
88 SMTP&IMAP Round Trip Sensor
In this step, you configure how the sent emails will be received.
IP-Address/DNS Name Specify the IMAP server. Enter a valid IP address or DNS name.
Mailbox Specify the IMAP Mailbox (resp. "IMAP folder") you want to check.
Please enter the IMAP mailbox/folder name.
Port Specify the port that will be used for the IMAP connection. For non-
secure connections usually port 143 is used; usually port 993 for
SSL connections. The actual setting depends on the server you are
connecting to. Please enter an integer value. We recommend using
the default value. If you do not get a connection, please try
another port number.
TLS (Transport-Level Select if the IMAP connection will be secured via SSL. Choose
Security) between:
· Don't use: Do not use encryption for the SMTP connection.
· Use: Connect to the SMTP server using the SSL method selected
below.
SSL-Method This field is only visible when TLS is enabled above. Select the SSL
method that will be used when connecting to the IMAP server. We
recommend using the default value. If you experience connection
problems, try another setting.
Connection Interval Enter the number of seconds the sensor will wait between two
(Sec.) connections to the IMAP server. PRTG will repeatedly check the
mailbox in this interval until the email arrives. Please enter an
integer value.
Maximum Trip Time Enter the number of seconds an email may take to arrive in the
(Sec.) IMAP mailbox. PRTG will repeatedly check the mailbox in the interval
specified above until the email arrives. If it does not arrive within
the maximum trip time, an error message will be triggered for the
sensor. Please enter an integer value.
IMAP Authentication Select the kind of authentication for the IMAP connection. Choose
Type between:
· Username and Password (simple)
· Simple Aut hent icat ion and Securit y Lay er (SASL)
914 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
88 SMTP&IMAP Round Trip Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
14.01.2014 915
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
88 SMTP&IMAP Round Trip Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
916 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
88 SMTP&IMAP Round Trip Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
14.01.2014 917
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
88 SMTP&IMAP Round Trip Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
918 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
89 SMTP&POP3 Round Trip Sensor
The SMTP&POP3 Round Trip sensor monitors the time it takes for an email to reach an Post
Office Protocol version 3 (POP3) mailbox after being sent using Simple Mail Transfer Protocol
(SMTP). It sends an email to the parent device via SMTP and then scans a dedicated POP3
mailbox until the email comes in. The sensor shows the response time of SMTP and POP3
server, and the sum of both.
The SMTP&POP3 Round Trip sensor will delete these emails automatically from the mailbox as
soon as PRTG retrieves them. Emails will only remain in the mailbox particularly if a timeout or a
restart of the PRTG server occurred during sensor run-time.
Note: Please use dedicated email accounts with this sensor type. If you use more sensors of
this type, please make sure that each sensor uses its own email accounts.
For a general introduction to the technology behind round trip monitoring, please see
Monit oring Email Round Trip 1975 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
We recommend adding this sensor on an SMTP server device only, as the sensor's settings are
optimized for this scenario.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
14.01.2014 919
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
89 SMTP&POP3 Round Trip Sensor
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Sensor Result Define what will be done with the result of the sensor. Choose
between:
§ Discard sensor result : Do not store the sensor result.
§ Writ e sensor result t o disk (Filename: "Result of Sensor
[ID].t xt "): Store the last result received from the sensor to the
"Logs (Sensor)" directory (on the Master node, if in a cluster). File
name: Result of Sensor [ID].txt. This is for debugging purposes.
The file will be overridden with each scanning interval. For
information on how to find the folder used for storage, please
see Dat a St orage 2074 section.
From Specify which address the sent emails will contain in the from field.
Please enter a valid email address.
To Specify to which address the emails will be sent to. Please enter a
valid email address.
Helo Ident Enter a server name for the helo part of the mail protocol. For
some mail servers the helo ident must be the valid principal host
domain name for the client host.
920 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
89 SMTP&POP3 Round Trip Sensor
In this step, you configure how emails will be sent. As SMTP server, the sensor uses the IP-
Address/DNS Name property's value of the device it is added on.
Port Enter the number of the port that will be used to send an email via
SMTP. Please enter an integer value. For non-secure connections
usually port 25 is used; usually port 465 or 587 for SSL
connections. The actual setting depends on the server you are
connecting to. Please enter an integer value. We recommend using
the default value. If you do not get a connection, please try
another port number.
Timeout for SMTP Enter a timeout in seconds for the SMTP connect. If the reply takes
Connection (Sec.) longer than this value the request is aborted and an error message
is triggered.
TLS (Transport-Level Select if the SMTP connection will be secured via SSL. Choose
Security) between:
· Don't use: Do not use encryption for the SMTP connection.
· Use: Connect to the SMTP server using the SSL method selected
below.
SSL-Method This field is only visible if security is enabled above. Select the SSL
method that will be used when connecting to the server. We
recommend using the default value. Only if you experience
connection problems, try another setting. Choose between:
§ SSL V2
§ SSL V2 or V3
§ SSL V3
§ TLS V1
SMTP Authentication Define if you want to use an authentication for the SMTP
Type connection. Choose between:
· None: Do not use any authentication method.
· Username/Password: Authenticate at the SMTP server via
username and password.
14.01.2014 921
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
89 SMTP&POP3 Round Trip Sensor
Additional Text for The subject part of the round trip email is created automatically by
Email Subject PRTG. It consists of the string "PRTG Roundtrip Mail:" followed by a
unique GUID to correctly identify the email in the POP3 mailbox
(e.g. PRTG Roundtrip Mail: {5E858D9C-AC70-466A-9B2A-
55630165D276}). Use this field to place your custom text before
the automatically created text.
922 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
89 SMTP&POP3 Round Trip Sensor
In this step, you configure how the sent emails will be received.
IP-Address/DNS Name Specify the POP3 server. Enter a valid IP address or DNS name.
Port Specify the port that will be used for the POP3 connection. For
non-secure connections usually port 110 is used; usually port 995
for SSL connections. The actual setting depends on the server you
are connecting to. Please enter an integer value. We recommend
using the default value. If you do not get a connection, please try
another port number.
TLS (Transport-Level Select if the POP3 connection will be secured via SSL. Choose
Security) between:
· Don't use: Do not use encryption for the SMTP connection.
· Use: Connect to the SMTP server using the SSL method selected
below.
SSL-Method This field is only visible when TLS is enabled above. Select the SSL
method that will be used when connecting to the IMAP server. We
recommend using the default value. If you experience connection
problems, try another setting.
Connection Interval Enter the number of seconds the sensor will wait between two
(Sec.) connections to the IMAP server. PRTG will repeatedly check the
mailbox in this interval until the email arrives. Please enter an
integer value.
Maximum Trip Time Enter the number of seconds an email may take to arrive in the
(Sec.) IMAP mailbox. PRTG will repeatedly check the mailbox in the interval
specified above until the email arrives. If it does not arrive within
the maximum trip time, an error message will be triggered for the
sensor. Please enter an integer value.
POP3 Authentication Select the kind of authentication for the POP3 connection. Choose
Type between:
· Wit hout Login: Monitor the connection to the POP3 server only.
· Username and Password: Log into the POP3 server with user
name and password (simple login, non-secure).
· 128-bit MD5 hash value (APOP): Send the password in an
encrypted form using APOP. This option must be supported by
the POP3 server you're connecting to.
Username This field is only visible if an option with login is selected above.
Enter a username for POP3 authentication. Please enter a string.
Password This field is only visible if an option with login is selected above.
Enter a username for POP3 authentication. Please enter a string.
14.01.2014 923
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
89 SMTP&POP3 Round Trip Sensor
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
924 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
89 SMTP&POP3 Round Trip Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
14.01.2014 925
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
89 SMTP&POP3 Round Trip Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
926 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
90 SNMP APC Hardware Sensor
The SNMP APC Hardware sensor monitors performance counters on an APC UPS device using
Simple Network Management Protocol (SNMP). It can show actual voltage of a battery, its
capacity and temperature, and its remaining runtime, the input and output frequency, input and
output voltage, and output load. For additional counters, please see section More 932 .
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
For devices with multiple performance counters multiple sensors are created at once in the
Add Sensor dialog. The settings you make in this dialog are valid for all of the sensors that are
created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Library OIDs Select the performance counters you want to add a sensor for. A
list of all available items is shown with their name. Select the
desired items by adding check marks in front of the respective
lines. One sensor will be created for each selection. You can also
select and deselect all items by using the check box in the table
head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
28.05.2014 927
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
90 SNMP APC Hardware Sensor
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Selected Interface Shows the name of the interface (performance counter) monitored
by this sensor. Once a sensor is created this value cannot be
changed. It is shown for reference purposes only. If you need to
change this, please add the sensor anew.
Unit String Define the unit of the numerical data that will be received at the
given OID. Please enter a string.
Multiplication If you want to multiply the received data with a certain value, enter
the quotient here. Please enter an integer or float value.
Division If you want to divide the received data by a certain value, enter the
divisor here. Please enter an integer or float value.
If Value Changes Define what shall be done in case the value of this sensor changes.
You can choose between:
· Ignore changes: No action will be taken on change.
· Trigger 'change' not ificat ion: The sensor will send an internal
message indicating that its value has changed. In combination
with a Change Trigger, you can use this mechanism to trigger a
notification 1716 whenever the sensor value changes.
928 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
90 SNMP APC Hardware Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
28.05.2014 929
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
90 SNMP APC Hardware Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
930 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
90 SNMP APC Hardware Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
28.05.2014 931
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
90 SNMP APC Hardware Sensor
More
Knowledge Base: How can I monitor additional counters with the SNMP APC Hardware sensor?
§ http://kb.paessler.com/en/topic/60367
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
932 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
91 SNMP Cisco ADSL Sensor
The SNMP Cisco ADSL sensor monitors Asymmetric Digital Subscriber Line (ADSL) statistics of a
Cisco router using Simple Network Management Protocol (SNMP). It shows the speed of
downlink and uplink, remote and local attenuation, remote and local SNR (signal-to-noise ratio),
and remote and local power output.
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
For devices with multiple performance counters, multiple sensors are created at once in the
Add Sensor dialog. The settings you make in this dialog are valid for all of the sensors that are
created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Line Index Select the performance counters you want to add a sensor for. A
list of all available items is shown with their name. Select the
desired items by adding check marks in front of the respective
lines. One sensor will be created for each selection. You can also
select and deselect all items by using the check box in the table
head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
14.01.2014 933
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
91 SNMP Cisco ADSL Sensor
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
934 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
91 SNMP Cisco ADSL Sensor
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
14.01.2014 935
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
91 SNMP Cisco ADSL Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
936 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
91 SNMP Cisco ADSL Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
14.01.2014 937
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
92 SNMP Cisco ASA VPN Connections Sensor
The SNMP Cisco ASA VPN Connections sensor monitors the Virtual Private Network (VPN)
connections on a Cisco Adaptive Security Appliance using Simple Network Management
Protocol (SNMP). It shows the active sessions of the connection types email, IPsec, L2L, LB,
SVC, WebVPN, as well as the total number of sessions, active users, and groups with active
users.
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
938 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
92 SNMP Cisco ASA VPN Connections Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
14.01.2014 939
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
92 SNMP Cisco ASA VPN Connections Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
940 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
92 SNMP Cisco ASA VPN Connections Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
14.01.2014 941
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
92 SNMP Cisco ASA VPN Connections Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
942 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
93 SNMP Cisco ASA VPN Traffic Sensor
The SNMP Cisco ASA VPN Traffic sensor monitors the traffic of an Internet Protocol Security
(IPsec) Virtual Private Network (VPN) connection on a Cisco Adaptive Security Appliance using
Simple Network Management Protocol (SNMP). It shows incoming and outgoing traffic, as well
as total traffic.
This sensor type is indented to monitor permanent connections. It will show an error if a
connection is interrupted. It can monitor IPsec connections only!
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
If you select more than one connections, multiple sensors are created at once in the Add
Sensor dialog. The settings you make in this dialog are valid for all of the sensors that are
created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Connections Select the IPsec VPN connections you want to add a sensor for.
You see a list of all active IPsec VPN connections available on the
target ASA, listed with remote IP, user name, and the kind of
connection. Select the desired items by adding check marks in
front of the respective lines. One sensor will be created for each
selection. You can also select and deselect all items by using the
check box in the table head. Note: This sensor type can only
monitor VPN connections based on IPsec. This means, for example,
that connections using "Cisco AnyConnect" will not be listed here.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
12.05.2014 943
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
93 SNMP Cisco ASA VPN Traffic Sensor
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
944 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
93 SNMP Cisco ASA VPN Traffic Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
12.05.2014 945
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
93 SNMP Cisco ASA VPN Traffic Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
946 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
93 SNMP Cisco ASA VPN Traffic Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
12.05.2014 947
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
94 SNMP Cisco ASA VPN Users Sensor
The SNMP Cisco ASA VPN Users sensor monitors account connections to a Virtual Private
Network (VPN) on a Cisco Adaptive Security Appliance via Simple Network Management
Protocol (SNMP). It can show the number of currently connected accounts and if a user
account is currently offline or online.
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
948 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
94 SNMP Cisco ASA VPN Users Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
14.01.2014 949
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
94 SNMP Cisco ASA VPN Users Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
950 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
94 SNMP Cisco ASA VPN Users Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
14.01.2014 951
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
94 SNMP Cisco ASA VPN Users Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
952 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
95 SNMP Cisco CBQoS Sensor
The SNMP Cisco CBQoS sensor monitors network parameters using Cisco's Class Based Quality
of Service (CBQoS) via Simple Network Management Protocol (SNMP). It supports the classes
Class Map, Match Statement, and Queueing. The sensor shows current and maximum queue
depth, pre policy packets, pre and post policy size, drop packets and size, drop packets
without buffer, as well as fragment packets and size, depending on the particular class type.
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
For a general introduction to the technology behind Quality of Service monitoring, please see
Monit oring Qualit y of Service 1971 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor quality-of-service via compatible devices, PRTG will create one sensor for
each CBQoS entry you choose. The settings you make in this dialog are valid for all of the
sensors that are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
CBQoS Entries Select the measurements you want to add a sensor for. A list of all
available items is shown with their name. Select the desired items
by adding check marks in front of the respective lines. One sensor
will be created for each selection. You can also select and deselect
all items by using the check box in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
03.04.2014 953
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
95 SNMP Cisco CBQoS Sensor
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Bitmask
ObjectID
ConfigID
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
954 03.04.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
95 SNMP Cisco CBQoS Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
03.04.2014 955
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
95 SNMP Cisco CBQoS Sensor
§ Mast er object for parent : Make this sensor the master object
for its parent device. The sensor will influence the behavior of
the device it is created on: If the sensor is in a Down status, the
device will be paused. For example, it is a good idea to make a
Ping sensor the master object for its parent device to pause
monitoring for all other sensors on the device in case the device
cannot even be pinged. Additionally, the sensor will be paused if
the parent group of its parent device is in a Down status, or if it
is paused by another dependency.
Note: Testing your dependencies is easy! Simply choose Simulat e
Error St at us from the context menu of an object that other
objects depend on. A few seconds later all dependent objects
should be paused.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
956 03.04.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
95 SNMP Cisco CBQoS Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
03.04.2014 957
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
96 SNMP Cisco System Health Sensor
The SNMP Cisco System Health sensor monitors the system health of a Cisco device via Simple
Network Management Protocol (SNMP). It can show the percentage CPU load, available memory
in absolute and percentage values, the status of power supplies, temperatures (in Celsius), the
current temperature states, and many more, depending on the available components of your
device.
This sensor type has predefined limits for several metrics. These limits can be changed
individually in the channel settings. For detailed information about channel limits please refer to
the section Sensor Channels Set t ings 1709 .
This sensor type uses lookups to determine the status values of some sensor channels. For
details, please see section Define Lookups 2039 .
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor the system health of a Cisco device, PRTG will create one sensor for each
measurement you choose. The settings you make in this dialog are valid for all of the sensors
that are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Measurement Select the measurements you want to add a sensor for. A list of all
available items is shown with their name. Select the desired items
by adding check marks in front of the respective lines. One sensor
will be created for each selection. You can also select and deselect
all items by using the check box in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
958 19.07.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
96 SNMP Cisco System Health Sensor
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
19.07.2013 959
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
96 SNMP Cisco System Health Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
960 19.07.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
96 SNMP Cisco System Health Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
19.07.2013 961
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
96 SNMP Cisco System Health Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
962 19.07.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
96 SNMP Cisco System Health Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
19.07.2013 963
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
97 SNMP Cisco UCS Chassis Sensor
The SNMP Cisco UCS Chassis sensor monitors the health status of the chassis of a Cisco
Unified Computing and Server (UCS) device via Simple Network Management Protocol (SNMP). It
can show the states of configuration, license, oper, the operability, power status, thermal
status, as well as the serial electronic erasable programmable read-only memory (SEEPROM)
status. The creation of these channels depends on the available measurement components on
the UCS chassis.
This sensor type uses lookups to determine the status values of some sensor channels. For
details, please see section Define Lookups 2039 .
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor the health status of a Cisco UCS chassis, PRTG will create one sensor for
each chassis you choose. The settings you make in this dialog are valid for all of the sensors
that are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Chassis Select the chassis you want to add a sensor for. A list of all
available items is shown with their name. Select the desired items
by adding check marks in front of the respective lines. One sensor
will be created for each selection. You can also select and deselect
all items by using the check box in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
964 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
97 SNMP Cisco UCS Chassis Sensor
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
14.01.2014 965
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
97 SNMP Cisco UCS Chassis Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
966 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
97 SNMP Cisco UCS Chassis Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
14.01.2014 967
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
97 SNMP Cisco UCS Chassis Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
968 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
97 SNMP Cisco UCS Chassis Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
14.01.2014 969
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
98 SNMP Cisco UCS Physical Disk Sensor
The SNMP Cisco UCS Physical Disk sensor monitors a physical disk of a Cisco Unified
Computing and Server (UCS) device via Simple Network Management Protocol (SNMP). It can
show the operability status of the disk, as well as if the monitored disk is still connected.
Important notice: Currently, this sensor type is in bet a status. The methods of operating can
change at any time, as well as the available settings. Do not expect that all functions will work
properly, or that this sensor works as expected at all. Be aware that this type of sensor can be
removed again from PRTG at any time.
This sensor type uses lookups to determine the status values of some sensor channels. For
details, please see section Define Lookups 2039 .
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor physical disks in a UCS device, PRTG will create one sensor for each disk
you choose. The settings you make in this dialog are valid for all of the sensors that are
created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Disks Select the disks you want to add a sensor for. A list of all available
items is shown with their name. Select the desired items by adding
check marks in front of the respective lines. One sensor will be
created for each selection. You can also select and deselect all
items by using the check box in the table head.
Note: Only working disks (with the current status Up or Warning)
will be shown here.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
970 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
98 SNMP Cisco UCS Physical Disk Sensor
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Disk Shows the disk which this sensor monitors. Once a sensor is
created this value cannot be changed. It is shown for reference
purposes only. If you need to change this, please add the sensor
anew.
Display Name Shows the display name of the physical disk which this sensor
monitors. Once a sensor is created this value cannot be changed. It
is shown for reference purposes only. If you need to change this,
please add the sensor anew.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
12.05.2014 971
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
98 SNMP Cisco UCS Physical Disk Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
972 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
98 SNMP Cisco UCS Physical Disk Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
12.05.2014 973
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
98 SNMP Cisco UCS Physical Disk Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
974 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
98 SNMP Cisco UCS Physical Disk Sensor
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
12.05.2014 975
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
99 SNMP Cisco UCS System Health Sensor
The SNMP Cisco UCS System Health sensor monitors the system health of a Cisco Unified
Computing and Server (UCS) device via Simple Network Management Protocol (SNMP). It can
show the following: the number of operable resp. inoperable fans, the status of fan
performance, fan thermal and fan voltage, and if a fan failure is predicted; the number of
operable resp. inoperable fan modules, the status of fan module performance, fan module
thermal and fan module voltage, and if a fan module failure is predicted; the number of operable
resp. inoperable power supplies, the status of power supply performance, power supply
thermal and power supply voltage, and if a power supply failure is predicted.
The creation of these channels depends on the available measurement components in the UCS
device.
This sensor type uses lookups to determine the status values of some sensor channels. For
details, please see section Define Lookups 2039 .
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
976 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
99 SNMP Cisco UCS System Health Sensor
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
12.05.2014 977
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
99 SNMP Cisco UCS System Health Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
978 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
99 SNMP Cisco UCS System Health Sensor
§ Mast er object for parent : Make this sensor the master object
for its parent device. The sensor will influence the behavior of
the device it is created on: If the sensor is in a Down status, the
device will be paused. For example, it is a good idea to make a
Ping sensor the master object for its parent device to pause
monitoring for all other sensors on the device in case the device
cannot even be pinged. Additionally, the sensor will be paused if
the parent group of its parent device is in a Down status, or if it
is paused by another dependency.
Note: Testing your dependencies is easy! Simply choose Simulat e
Error St at us from the context menu of an object that other
objects depend on. A few seconds later all dependent objects
should be paused.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
12.05.2014 979
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
99 SNMP Cisco UCS System Health Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
980 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
99 SNMP Cisco UCS System Health Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
12.05.2014 981
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
100 SNMP CPU Load Sensor
The SNMP CPU Load sensor monitors the system load using Simple Network Management
Protocol (SNMP). It can show the load of several CPUs in percent.
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
982 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
100 SNMP CPU Load Sensor
Sensor Display
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
07.02.2013 983
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
100 SNMP CPU Load Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
984 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
100 SNMP CPU Load Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
07.02.2013 985
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
100 SNMP CPU Load Sensor
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
986 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
101 SNMP Custom Sensor
The SNMP Custom sensor monitors a numerical value returned by a specific OID using Simple
Network Management Protocol (SNMP).
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
OID values
Channel Name Enter a name for the channel the results at the given OID will be will
shown in. You can change this value later in the sensor's channel
settings 1709 .
Value Type Select how the results at the given OID will be handled. Choose
between:
§ Gauge (unsigned Int eger): For integer values, such as 10 or
120.
§ Gauge (signed int eger): For integer values, such as -12 or 120.
§ Gauge (float ): For float values, such as -5.80 or 8.23.
§ Delt a (Count er): For counter values. PRTG will calculate the
difference between the last and the current value.
Once a sensor is created this value cannot be changed. It is shown
for reference purposes only. If you need to change this, please add
the sensor anew.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
28.05.2014 987
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
101 SNMP Custom Sensor
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
988 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
101 SNMP Custom Sensor
OID values
OID value Enter the OID of the SNMP object you want to receive numerical
data from. Note: Most OIDs begin with 1.3.6.1. However, entering
OIDs starting with 1.0, or 1.1, or 1.2 is also allowed. If you want to
disable the validation of your entry entirely, add the string
norfccheck: at the beginning of your OID, for example,
norfccheck:2.0.0.0.1.
Unit String Define the unit of the numerical data that will be received at the
given OID. Please enter a string.
Value Type Shows the value type of the numerical data that will be received at
the given OID.Once a sensor is created this value cannot be
changed. It is shown for reference purposes only. If you need to
change this, please add the sensor anew.
Multiplication If you want to multiply the received data with a certain value, enter
the quotient here. Please enter an integer or float value.
Division If you want to divide the received data by a certain value, enter the
divisor here. Please enter an integer or float value.
If value changes Define what shall be done in case the value of this sensor changes.
You can choose between:
· Ignore changes (default ): No action will be taken on change.
· Trigger 'On Change' not ificat ion: The sensor will send an
internal message indicating that its value has changed. In
combination with a Change Trigger, you can use this mechanism
to trigger a notification 1716 whenever the sensor value changes.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
28.05.2014 989
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
101 SNMP Custom Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
990 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
101 SNMP Custom Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
28.05.2014 991
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
101 SNMP Custom Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
992 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
101 SNMP Custom Sensor
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
More
Knowledge Base: How do I find out what OID I need to use for a custom sensor?
§ http://kb.paessler.com/en/topic/903
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
28.05.2014 993
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
102 SNMP Custom String Sensor
The SNMP Custom String sensor monitors a string returned by a specific OID using Simple
Network Management Protocol (SNMP). It can check for keywords. If you want to use limits for
the sensor channel value, you can also extract a numeric value contained in the string.
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
994 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
102 SNMP Custom String Sensor
OID Values
OID Value Enter the OID of the SNMP object you want to receive a string
from. Note: Most OIDs begin with 1.3.6.1. However, entering OIDs
starting with 1.0, or 1.1, or 1.2 is also allowed. If you want to
disable the validation of your entry entirely, add the string
norfccheck: at the beginning of your OID, for example,
norfccheck:2.0.0.0.1.
Maximum Length of Define the maximum length of the string that will be received from
String the SNMP object at the given OID. If the string is longer than this
value, the sensor will be set to an error status. Please enter an
integer value or leave the field empty.
If Value Changes Define what shall be done in case the value of this sensor changes.
You can choose between:
· Ignore changes (default ): No action will be taken on change.
· Trigger 'On Change' not ificat ion: The sensor will send an
internal message indicating that its value has changed. In
combination with a Change Trigger, you can use this mechanism
to trigger a notification 1716 whenever the sensor value changes.
28.05.2014 995
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
102 SNMP Custom String Sensor
Response Must Include Define which string must be part of the data that is received from
(Error State) the SNMP object at the given OID. You can either enter plain text or
a Regular Expression 2048 . If the data does not include the search
pattern, the sensor will be set to an error state. Please enter a
string or leave the field empty.
For Keyword Search Define in which format you have entered the search expression in
Use the field above.
§ Plain Text : Search for the string as plain text. The characters *
and ? work here as placeholder, whereas * stands for no or any
number of characters and ? stands for exactly one character (as
known from Windows search). This behavior cannot be disabled,
so the literal search for these characters is not possible with
plain text search.
§ Regular Expression: Treat the search pattern as a Regular
Expression 2048 .
Response Must Not Define which string must not be part of the data that is received
Include (Error State) form the SNMP object at the given OID. You can either enter plain
text or a Regular Expression 2048 . If the data does include the
search pattern, the sensor will be set to an error state. Please
enter a string or leave the field empty.
For Keyword Search Define in which format you have entered the search expression in
Use the field above.
§ Plain Text : Search for the string as plain text. The characters *
and ? work here as placeholder, whereas * stands for no or any
number of characters and ? stands for exactly one character (as
known from Windows search). This behavior cannot be disabled,
so the literal search for these characters is not possible with
plain text search.
§ Regular Expression: Treat the search pattern as a Regular
Expression 2048 .
Response Must Include Define which string must be part of the data that is received from
(Warning State) the SNMP object at the given OID. You can either enter plain text or
a Regular Expression 2048 . If the data does not include the search
pattern, the sensor will be set to a warning state. Please enter a
string or leave the field empty.
For Keyword Search Define in which format you have entered the search expression in
Use the field above.
§ Plain Text : Search for the string as plain text. The characters *
and ? work here as placeholder, whereas * stands for no or any
number of characters and ? stands for exactly one character (as
known from Windows search). This behavior cannot be disabled,
so the literal search for these characters is not possible with
plain text search.
996 § Regular Expression: Treat the search pattern as a Regular
28.05.2014
Expression 2048 .
Response Must Not Define which string must not be part of the data that is received
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
102 SNMP Custom String Sensor
Extract Number Using Define if you want to filter out a numeric value from the string
Regular Expression received from the SNMP object at the given OID. You can convert
this into a float value in order to use it with channel limits (see
Sensor Channels Set t ings 1709 ).
§ No ext ract ion: Do not extract a float value. Use the result as a
string value.
§ Ext ract a numeric value using a regular expression: Use a
regular expression to identify a numeric value in the string and
convert it to a float value. Define below. See also the example 1000
below.
Regular Expression This setting is only visible if number extraction is enabled above.
Enter a Regular Expression 2048 to identify the numeric value you
want to extract from the string returned by the SNMP object at the
given OID. You can use capturing groups here. Make sure the
expression returns numbers only (including decimal and thousands
separators). The result will be further refined by the settings below.
Index of Capturing This setting is only visible if number extraction is enabled above. If
Group your regular expression uses capturing groups, please specify
which one will be used to capture the number. Please enter an
integer value or leave the field empty.
Decimal Separator This setting is only visible if number extraction is enabled above.
Define which character is used as decimal separator for the number
extracted above. Please enter a string or leave the field empty.
Thousands Separator This setting is only visible if number extraction is enabled above.
Define which character is used as thousands separator for the
number extracted above. Please enter a string or leave the field
empty.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
28.05.2014 997
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
102 SNMP Custom String Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
998 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
102 SNMP Custom String Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
28.05.2014 999
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
102 SNMP Custom String Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
If you want to extract a number in the response string using a regular expression, please note
that the index for captures in this sensor is based on 1 (not on 0). Furthermore, capturing
groups are not created automatically. The example below will illustrate this issue.
1000 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
102 SNMP Custom String Sensor
Assuming you would like to filter for the number 3.555, i.e., the percentage in the second
parentheses. Then enter the following regex in the Regular Expression field:
(\d+\.\d+).*(\d+\.\d+).*(\d+\.\d+)
As Index of Capt uring Group enter 3. This will extract the desired number 3.555.
The index has to be 3 in this case because the capturing groups here are the following:
Please keep in mind this note about index and capturing groups when using number
extraction.
More
Knowledge Base: How do I find out what OID I need to use for a custom sensor?
§ http://kb.paessler.com/en/topic/903
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
28.05.2014 1001
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
103 SNMP Dell Hardware Sensor
The SNMP Dell Hardware sensor monitors performance counters on a Dell hardware device
using Simple Network Management Protocol (SNMP).
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
For devices with multiple performance counters multiple sensors are created at once in the
Add Sensor dialog. The settings you make in this dialog are valid for all of the sensors that are
created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Library OIDs Select the performance counters you want to add a sensor for. A
list of all available items is shown with their name. Select the
desired items by adding check marks in front of the respective
lines. One sensor will be created for each selection. You can also
select and deselect all items by using the check box in the table
head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
1002 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
103 SNMP Dell Hardware Sensor
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Selected Interface Shows the name of the interface (performance counter) monitored
by this sensor. Once a sensor is created this value cannot be
changed. It is shown for reference purposes only. If you need to
change this, please add the sensor anew.
Unit String Define the unit of the numerical data that will be received at the
given OID. Please enter a string.
Multiplication If you want to multiply the received data with a certain value, enter
the quotient here. Please enter an integer or float value.
Division If you want to divide the received data by a certain value, enter the
divisor here. Please enter an integer or float value.
If Value Changes Define what shall be done in case the value of this sensor changes.
You can choose between:
· Ignore changes: No action will be taken on change.
· Trigger 'change' not ificat ion: The sensor will send an internal
message indicating that its value has changed. In combination
with a Change Trigger, you can use this mechanism to trigger a
notification 1716 whenever the sensor value changes.
07.02.2013 1003
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
103 SNMP Dell Hardware Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
1004 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
103 SNMP Dell Hardware Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
07.02.2013 1005
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
103 SNMP Dell Hardware Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
1006 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
103 SNMP Dell Hardware Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
07.02.2013 1007
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
104 SNMP Dell PowerEdge Physical Disk Sensor
The SNMP Dell PowerEdge Physical Disk sensor monitors a physical disk in a Dell PowerEdge
server using Simple Network Management Protocol (SNMP). It can show the disk status, the roll
up status, the component status, as well as if there is currently a warning regarding the Self-
Monitoring, Analysis and Reporting Technology (S.M.A.R.T.) status.
This sensor type uses lookups to determine the status values of some sensor channels. For
details, please see section Define Lookups 2039 .
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
This sensor needs the Dell OpenManage Server Administrator tool to be installed on the
device in order to monitor PowerEdge servers. Please make sure that you enable SNMP in the
OpenManage Server Administrator. For details, please see section More below. Note: You can
also monitor Dell PowerEdge servers with this sensor type via Integrated Dell Remote Access
Controller (iDRAC) 7.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor physical disks in a Dell PowerEdge server, PRTG will create one sensor for
each disk. The settings you make in this dialog are valid for all of the sensors that are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Disk Select the disks you want to add a sensor for. A list of all available
items is shown with their name. Select the desired items by adding
check marks in front of the respective lines. One sensor will be
created for each selection. You can also select and deselect all
items by using the check box in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
1008 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
104 SNMP Dell PowerEdge Physical Disk Sensor
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Disk Shows the name of the disk that this sensor is monitoring. Once a
sensor is created this value cannot be changed. It is shown for
reference purposes only. If you need to change this, please add
the sensor anew.
Data Source Shows the interface which is used to get monitoring data. This is
either Dell OpenManage Server Administrator (OMSA) or Integrated
Dell Remote Access Controller (iDRAC).
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
12.05.2014 1009
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
104 SNMP Dell PowerEdge Physical Disk Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
1010 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
104 SNMP Dell PowerEdge Physical Disk Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
12.05.2014 1011
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
104 SNMP Dell PowerEdge Physical Disk Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
More
1012 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
104 SNMP Dell PowerEdge Physical Disk Sensor
§ http://kb.paessler.com/en/topic/45333
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
12.05.2014 1013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
105 SNMP Dell PowerEdge System Health Sensor
The SNMP Dell PowerEdge System Health sensor monitors the system health of a Dell
PowerEdge server using Simple Network Management Protocol (SNMP). It can show the global
system status, the power supply status, the temperature status, the cooling device status, the
memory device status, the voltage status, and many more, depending on the available
components of your device.
This sensor type has predefined limits for several metrics. These limits can be changed
individually in the channel settings. For detailed information about channel limits please refer to
the section Sensor Channels Set t ings 1709 .
This sensor type uses lookups to determine the status values of some sensor channels. For
details, please see section Define Lookups 2039 .
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
This sensor needs the Dell OpenManage Server Administrator tool to be installed on the
device in order to monitor PowerEdge servers. Please make sure that you enable SNMP in the
OpenManage Server Administrator. For details, please see section More below. Note: You can
also monitor Dell PowerEdge servers with this sensor type via Integrated Dell Remote Access
Controller (iDRAC) 7.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor the health status of a Dell PowerEdge server, PRTG will create one sensor
for each chassis you choose. The settings you make in this dialog are valid for all of the
sensors that are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Chassis Select the chassis you want to add a sensor for. A list of all
available items is shown with their name. Select the desired items
by adding check marks in front of the respective lines. One sensor
will be created for each selection. You can also select and deselect
all items by using the check box in the table head.
1014 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
105 SNMP Dell PowerEdge System Health Sensor
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Chassis Shows the chassis this sensor monitors. Once a sensor is created
this value cannot be changed. It is shown for reference purposes
only. If you need to change this, please add the sensor anew.
Channel Mask Shows the channel mask that describes which sensors are
available. Once a sensor is created this value cannot be changed. It
is shown for reference purposes only. If you need to change this,
please add the sensor anew.
Data Source Shows the interface which is used to get monitoring data. This is
either Dell OpenManage Server Administrator (OMSA) or Integrated
Dell Remote Access Controller (iDRAC).
12.05.2014 1015
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
105 SNMP Dell PowerEdge System Health Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
1016 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
105 SNMP Dell PowerEdge System Health Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
12.05.2014 1017
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
105 SNMP Dell PowerEdge System Health Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
1018 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
105 SNMP Dell PowerEdge System Health Sensor
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
More
§ http://kb.paessler.com/en/topic/45333
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
12.05.2014 1019
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
106 SNMP Disk Free Sensor
The SNMP Disk Free sensor monitors the free disk space on a logical disk via Simple Network
Management Protocol (SNMP). It can show free space in percent and in total, as well as the
total space. Note: This sensor uses more generic Object Identifier (OID) values compared to
the SNMP Linux Disk Free Sensor 1122 .
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor memory usage, PRTG will create one sensor for each memory type you
choose. The settings you make in this dialog are valid for all of the sensors that are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Disk Select one or more disks you want to add a sensor for. A list of all
available items is shown with their name. Select the desired items
by adding check marks in front of the respective lines. One sensor
will be created for each selection. You can also select and deselect
all items by using the check box in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
1020 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
106 SNMP Disk Free Sensor
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Disk Shows the name of the disk that this sensor is monitoring. Once a
sensor is created this value cannot be changed. It is shown for
reference purposes only. If you need to change this, please add
the sensor anew.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
07.02.2013 1021
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
106 SNMP Disk Free Sensor
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
1022 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
106 SNMP Disk Free Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
07.02.2013 1023
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
106 SNMP Disk Free Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
1024 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
106 SNMP Disk Free Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
07.02.2013 1025
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
107 SNMP GSA System Health Sensor
The SNMP GSA System Health sensor monitors the system health of a Google Search Appliance
(GSA) via Simple Network Management Protocol (SNMP). It can show the number of queries per
minute, the number of processed documents, the number of indexed documents, the number
of processed bytes, the activity status of crawling, the crawling rate per second, as well as the
health status of disk, temperature, and machine.
Note: The location you provide in the GSA's SNMP configuration section will be shown in
PRTG's GeoMaps 1744 . In order to use SNMP v3 for monitoring, you need to add an SNMP v3
user in the GSA's SNMP configuration.
This sensor type uses lookups to determine the status values of some sensor channels. For
details, please see section Define Lookups 2039 .
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
1026 13.06.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
107 SNMP GSA System Health Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
13.06.2013 1027
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
107 SNMP GSA System Health Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
1028 13.06.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
107 SNMP GSA System Health Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
13.06.2013 1029
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
107 SNMP GSA System Health Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1030 13.06.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
108 SNMP Hardware Status Sensor
The SNMP Hardware Status sensor monitors the status of a hardware component of a server
via Simple Network Management Protocol (SNMP). It shows the current status of the
component, as well as the number of errors per time period.
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor hardware components of a server, PRTG will create one sensor for each
component you choose. The settings you make in this dialog are valid for all of the sensors
that are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Hardware Specific
Hardware Component Select the hardware components you want to add a sensor for. A
list of all available items is shown with their name. Select the
desired items by adding check marks in front of the respective
lines. One sensor will be created for each selection. You can also
select and deselect all items by using the check box in the table
head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
13.06.2013 1031
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
108 SNMP Hardware Status Sensor
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Hardware Specific
Hardware Component
Product ID
Shows further information about the hardware component. Once a
sensor is created this value cannot be changed. It is shown for
Description reference purposes only. If you need to change this, please add
the sensor anew.
Type
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
1032 13.06.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
108 SNMP Hardware Status Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
13.06.2013 1033
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
108 SNMP Hardware Status Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
1034 13.06.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
108 SNMP Hardware Status Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
13.06.2013 1035
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
109 SNMP HP LaserJet Hardware Sensor
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
For devices with multiple performance counters multiple sensors are created at once in the
Add Sensor dialog. The settings you make in this dialog are valid for all of the sensors that are
created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Library OIDs Select the performance counters you want to add a sensor for. A
list of available counters for your device is shown with category
and name:
§ Toner/St at us
§ Paper/St at us
§ Jam/St at us
A list of all available items is shown with their name. Select the
desired items by adding check marks in front of the respective
lines. One sensor will be created for each selection. You can also
select and deselect all items by using the check box in the table
head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
1036 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
109 SNMP HP LaserJet Hardware Sensor
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
HP LaserJet Specific
Selected Interface Shows the name of the interface (performance counter) monitored
by this sensor. Once a sensor is created this value cannot be
changed. It is shown for reference purposes only. If you need to
change this, please add the sensor anew.
If Value Changes Define what shall be done in case the value of this sensor changes.
You can choose between:
· Ignore changes: No action will be taken on change.
· Trigger 'change' not ificat ion: The sensor will send an internal
message indicating that its value has changed. In combination
with a Change Trigger, you can use this mechanism to trigger a
notification 1716 whenever the sensor value changes.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
14.01.2014 1037
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
109 SNMP HP LaserJet Hardware Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
1038 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
109 SNMP HP LaserJet Hardware Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
14.01.2014 1039
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
109 SNMP HP LaserJet Hardware Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
1040 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
109 SNMP HP LaserJet Hardware Sensor
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
14.01.2014 1041
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
110 SNMP HP ProLiant Logical Disk Sensor
The SNMP HP ProLiant Logical Disk sensor monitors a logical disk in an HP server via Simple
Network Management Protocol (SNMP). It can show disk status and completion. Completion is
only important when the disk status is "Reconstructing" or "Expanding" and illustrates the
progress of this task.
This sensor type uses lookups to determine the status values of some sensor channels. For
details, please see section Define Lookups 2039 .
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
This sensor needs a specific HP system management tool to be installed on the target device,
so it reports data via SNMP: HP Insight Management Agents for Windows Server 2003/2008. In
order to receive SNMP data from RAID controllers you will additionally need HP Insight
Management WBEM Providers. For more details and download links please refer to the
subsection More below.
Note: Some of the HP Object Identifiers (OIDs) which this sensor type uses are only accessible
via the HP Integrated Lights-Out (iLO) interface. If this sensor throws an error that it cannot
find "such device types", please create a device in PRTG which points to the address of the HP
iLO interface (if available) and add the sensor to this device. We recommend using the
Agentless Management feature with configured SNMP. You can set this up in the iLO
configuration interface under Administ rat ion | Management | SNMP Set t ings.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor logical disks in a HP server, PRTG will create one sensor for each disk you
choose. The settings you make in this dialog are valid for all of the sensors that are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Disk Select the disks you want to add a sensor for. A list of all available
items is shown with their name. Select the desired items by adding
check marks in front of the respective lines. One sensor will be
created for each selection. You can also select and deselect all
items by using the check box in the table head.
1042 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
110 SNMP HP ProLiant Logical Disk Sensor
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Disk Shows the name of the disk that this sensor is monitoring. Once a
sensor is created this value cannot be changed. It is shown for
reference purposes only. If you need to change this, please add
the sensor anew.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
12.05.2014 1043
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
110 SNMP HP ProLiant Logical Disk Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
1044 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
110 SNMP HP ProLiant Logical Disk Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
12.05.2014 1045
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
110 SNMP HP ProLiant Logical Disk Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
1046 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
110 SNMP HP ProLiant Logical Disk Sensor
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
More
Knowledge Base: Monitor HP ProLiant via SNMP
§ http://kb.paessler.com/en/topic/33133
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
12.05.2014 1047
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
111 SNMP HP ProLiant Memory Controller Sensor
The SNMP HP ProLiant Memory Controller sensor monitors a memory controller in an HP server
via Simple Network Management Protocol (SNMP). It shows the error status of the controller,
the condition of the controller, and states and conditions of available modules. Note: If
modules are inserted at a later point, the sensor has to be added again.
This sensor type uses lookups to determine the status values of some sensor channels. For
details, please see section Define Lookups 2039 .
For supported lookup values of this specific sensor, please see subsection More 1053 below.
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
This sensor needs a specific HP system management tool to be installed on the target device,
so it reports data via SNMP: HP Insight Management Agents for Windows Server 2003/2008. In
order to receive SNMP data from RAID controllers you will additionally need HP Insight
Management WBEM Providers. For more details and download links please refer to the
subsection More below.
Note: Some of the HP Object Identifiers (OIDs) which this sensor type uses are only accessible
via the HP Integrated Lights-Out (iLO) interface. If this sensor throws an error that it cannot
find "such device types", please create a device in PRTG which points to the address of the HP
iLO interface (if available) and add the sensor to this device. We recommend using the
Agentless Management feature with configured SNMP. You can set this up in the iLO
configuration interface under Administ rat ion | Management | SNMP Set t ings.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor memory controllers in a HP server, PRTG will create one sensor for each
controller you choose. The settings you make in this dialog are valid for all of the sensors that
are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
1048 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
111 SNMP HP ProLiant Memory Controller Sensor
Controller Select the controllers you want to add a sensor for. A list of all
available items is shown with their name. Select the desired items
by adding check marks in front of the respective lines. One sensor
will be created for each selection. You can also select and deselect
all items by using the check box in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Controller Shows the name of the controller that this sensor is monitoring.
Once a sensor is created this value cannot be changed. It is shown
for reference purposes only. If you need to change this, please add
the sensor anew.
28.05.2014 1049
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
111 SNMP HP ProLiant Memory Controller Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
1050 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
111 SNMP HP ProLiant Memory Controller Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
28.05.2014 1051
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
111 SNMP HP ProLiant Memory Controller Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
1052 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
111 SNMP HP ProLiant Memory Controller Sensor
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
More
Knowledge Base: Monitor HP ProLiant via SNMP
§ http://kb.paessler.com/en/topic/33133
Knowledge Base: Which lookup values are supported by the SNMP HP ProLiant Memory
Controller Sensor?
§ http://kb.paessler.com/en/topic/44803
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
28.05.2014 1053
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
112 SNMP HP ProLiant Network Interface Sensor
The SNMP HP ProLiant Network Interface sensor monitors a network interface in an HP server
via Simple Network Management Protocol (SNMP). It can show traffic in and out, the number of
transmitted and received good frames, the number of transmitted and received bad frames,
alignment and FCS (Frame Check Sequence) errors, late and excessive collisions, carrier sense
errors, and when the frames are too long.
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
This sensor needs a specific HP system management tool to be installed on the target device,
so it reports data via SNMP: HP Insight Management Agents for Windows Server 2003/2008. In
order to receive SNMP data from RAID controllers you will additionally need HP Insight
Management WBEM Providers. For more details and download links please refer to the
subsection More below.
Note: Some of the HP Object Identifiers (OIDs) which this sensor type uses are only accessible
via the HP Integrated Lights-Out (iLO) interface. If this sensor throws an error that it cannot
find "such device types", please create a device in PRTG which points to the address of the HP
iLO interface (if available) and add the sensor to this device. We recommend using the
Agentless Management feature with configured SNMP. You can set this up in the iLO
configuration interface under Administ rat ion | Management | SNMP Set t ings.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor network interfaces in a HP server, PRTG will create one sensor for each
interface. The settings you make in this dialog are valid for all of the sensors that are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Network Interface Select the interfaces you want to add a sensor for. A list of all
available items is shown with their name. Select the desired items
by adding check marks in front of the respective lines. One sensor
will be created for each selection. You can also select and deselect
all items by using the check box in the table head.
1054 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
112 SNMP HP ProLiant Network Interface Sensor
Note: In the HP ProLiant Net work Int erface Set t ings section, the St at us of each available
network interface is shown. If this status is Link Failure, it is still possible to add a sensor for
the respective interface. Though, most likely the sensor for this interface will not work
correctly. The error message in this case will be No Such Name (SNMP error # 2).
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Network Interface Shows the name of the interface that this sensor is monitoring.
Once a sensor is created this value cannot be changed. It is shown
for reference purposes only. If you need to change this, please add
the sensor anew.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
12.05.2014 1055
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
112 SNMP HP ProLiant Network Interface Sensor
Sensor Display
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
§ Show in and out t raffic as posit ive and negat ive area chart :
Show channels for incoming and outgoing traffic as positive and
negative area chart. This will visualize your traffic in a clear way.
Note: This option cannot be used in combination with manual
Vertical Axis Scaling (available in the Sensor Channels Set t ings
1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
1056 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
112 SNMP HP ProLiant Network Interface Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
12.05.2014 1057
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
112 SNMP HP ProLiant Network Interface Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
1058 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
112 SNMP HP ProLiant Network Interface Sensor
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
More
Knowledge Base: Monitor HP ProLiant via SNMP
§ http://kb.paessler.com/en/topic/33133
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
12.05.2014 1059
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
113 SNMP HP ProLiant Physical Disk Sensor
The SNMP HP ProLiant Physical Disk sensor monitors a physical disk in an HP server via Simple
Network Management Protocol (SNMP). It can show read and written sectors, hard and
corrected read errors, hard and corrected write errors, the disk status, the drive condition, the
Self-Monitoring, Analysis and Reporting Technology (S.M.A.R.T.) status, and if the threshold is
passed.
This sensor type uses lookups to determine the status values of some sensor channels. For
details, please see section Define Lookups 2039 .
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
This sensor needs a specific HP system management tool to be installed on the target device,
so it reports data via SNMP: HP Insight Management Agents for Windows Server 2003/2008. In
order to receive SNMP data from RAID controllers you will additionally need HP Insight
Management WBEM Providers. For more details and download links please refer to the
subsection More below.
Note: Some of the HP Object Identifiers (OIDs) which this sensor type uses are only accessible
via the HP Integrated Lights-Out (iLO) interface. If this sensor throws an error that it cannot
find "such device types", please create a device in PRTG which points to the address of the HP
iLO interface (if available) and add the sensor to this device. We recommend using the
Agentless Management feature with configured SNMP. You can set this up in the iLO
configuration interface under Administ rat ion | Management | SNMP Set t ings.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor physical disks in a HP server, PRTG will create one sensor for each disk.
The settings you make in this dialog are valid for all of the sensors that are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Disk Select the disks you want to add a sensor for. A list of all available
items is shown with their name. Select the desired items by adding
check marks in front of the respective lines. One sensor will be
created for each selection. You can also select and deselect all
items by using the check box in the table head.
1060 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
113 SNMP HP ProLiant Physical Disk Sensor
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Disk Shows the name of the disk that this sensor is monitoring. Once a
sensor is created this value cannot be changed. It is shown for
reference purposes only. If you need to change this, please add
the sensor anew.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
12.05.2014 1061
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
113 SNMP HP ProLiant Physical Disk Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
1062 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
113 SNMP HP ProLiant Physical Disk Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
12.05.2014 1063
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
113 SNMP HP ProLiant Physical Disk Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
1064 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
113 SNMP HP ProLiant Physical Disk Sensor
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
More
Knowledge Base: Monitor HP ProLiant via SNMP
§ http://kb.paessler.com/en/topic/33133
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
12.05.2014 1065
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
114 SNMP HP ProLiant System Health Sensor
The SNMP HP ProLiant System Health sensor monitors the system health of an HP ProLiant
server via Simple Network Management Protocol (SNMP). It can show the overall status, the
thermal status, the system fan status, the CPU fan status, the number of broken and running
fans, as well as the number of broken and running fans that are fault tolerant, and status and
condition of the power supply.
The SNMP HP ProLiant System Health sensor has predefined limits for temperatures and broken
frames. These limits can be changed individually in the channel settings. For detailed
information about channel limits please refer to the subsection Channels 1071 below.
This sensor type uses lookups to determine the status values of some sensor channels. For
details, please see section Define Lookups 2039 .
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
This sensor needs a specific HP system management tool to be installed on the target device,
so it reports data via SNMP: HP Insight Management Agents for Windows Server 2003/2008. In
order to receive SNMP data from RAID controllers you will additionally need HP Insight
Management WBEM Providers. For more details and download links please refer to the
subsection More below.
Note: Some of the HP Object Identifiers (OIDs) which this sensor type uses are only accessible
via the HP Integrated Lights-Out (iLO) interface. If this sensor throws an error that it cannot
find "such device types", please create a device in PRTG which points to the address of the HP
iLO interface (if available) and add the sensor to this device. We recommend using the
Agentless Management feature with configured SNMP. You can set this up in the iLO
configuration interface under Administ rat ion | Management | SNMP Set t ings.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
1066 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
114 SNMP HP ProLiant System Health Sensor
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
§ Show in and out t raffic as posit ive and negat ive area chart :
Show channels for incoming and outgoing traffic as positive and
negative area chart. This will visualize your traffic in a clear way.
Note: This option cannot be used in combination with manual
Vertical Axis Scaling (available in the Sensor Channels Set t ings
1709 settings).
12.05.2014 1067
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
114 SNMP HP ProLiant System Health Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
1068 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
114 SNMP HP ProLiant System Health Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
12.05.2014 1069
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
114 SNMP HP ProLiant System Health Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
More
Knowledge Base: Monitor HP ProLiant via SNMP
1070 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
114 SNMP HP ProLiant System Health Sensor
§ http://kb.paessler.com/en/topic/33133
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
12.05.2014 1071
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
115 SNMP IBM System X Logical Disk Sensor
The SNMP IBM System X Logical Disk sensor monitors a logical disk in an IBM server via Simple
Network Management Protocol (SNMP). It shows the status of a logical disk.
This sensor type uses lookups to determine the status values of some sensor channels. For
details, please see section Define Lookups 2039 .
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
This sensor type needs the IBM Systems Director Platform Agent to be installed on the target
IBM device in order to monitor it through SNMP. For more information, please see section
More below.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor the logical disks of an IBM device, PRTG will create one sensor for each
disk you choose. The settings you make in this dialog are valid for all of the sensors that are
created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Disk Select the logical disks you want to add a sensor for. A list of all
available items is shown with their name. Select the desired items
by adding check marks in front of the respective lines. One sensor
will be created for each selection. You can also select and deselect
all items by using the check box in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
1072 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
115 SNMP IBM System X Logical Disk Sensor
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Disk Shows the ID of the logical disk. Once a sensor is created this
value cannot be changed. It is shown for reference purposes only.
If you need to change this, please add the sensor anew.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
24.10.2013 1073
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
115 SNMP IBM System X Logical Disk Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
1074 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
115 SNMP IBM System X Logical Disk Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
24.10.2013 1075
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
115 SNMP IBM System X Logical Disk Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
More
Knowledge Base: What are the requirements to monitor IBM System x?
1076 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
115 SNMP IBM System X Logical Disk Sensor
§ http://kb.paessler.com/en/topic/59393
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
24.10.2013 1077
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
116 SNMP IBM System X Physical Disk Sensor
The SNMP IBM System X Physical Disk sensor monitors a physical disk in an IBM server via
Simple Network Management Protocol (SNMP). It shows the status of a physical disk.
This sensor type uses lookups to determine the status values of some sensor channels. For
details, please see section Define Lookups 2039 .
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
This sensor type needs the IBM Systems Director Platform Agent to be installed on the target
IBM device in order to monitor it through SNMP. For more information, please see section
More below.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor the physical disks of an IBM device, PRTG will create one sensor for each
disk you choose. The settings you make in this dialog are valid for all of the sensors that are
created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Disk Select the physical disks you want to add a sensor for. A list of all
available items is shown with their name. Select the desired items
by adding check marks in front of the respective lines. One sensor
will be created for each selection. You can also select and deselect
all items by using the check box in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
1078 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
116 SNMP IBM System X Physical Disk Sensor
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Disk Shows the ID of the physical disk. Once a sensor is created this
value cannot be changed. It is shown for reference purposes only.
If you need to change this, please add the sensor anew.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
24.10.2013 1079
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
116 SNMP IBM System X Physical Disk Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
1080 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
116 SNMP IBM System X Physical Disk Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
24.10.2013 1081
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
116 SNMP IBM System X Physical Disk Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
More
Knowledge Base: What are the requirements to monitor IBM System x?
1082 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
116 SNMP IBM System X Physical Disk Sensor
§ http://kb.paessler.com/en/topic/59393
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
24.10.2013 1083
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
117 SNMP IBM System X Physical Memory Sensor
The SNMP IBM System X Physical Memory sensor monitors the memory modules in an IBM
server via Simple Network Management Protocol (SNMP). It shows the condition of a memory
module, as well as its power status.
This sensor type uses lookups to determine the status values of some sensor channels. For
details, please see section Define Lookups 2039 .
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
This sensor type needs the IBM Systems Director Platform Agent to be installed on the target
IBM device in order to monitor it through SNMP. For more information, please see section
More below.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor the memory modules of an IBM device, PRTG will create one sensor for
each module you choose. The settings you make in this dialog are valid for all of the sensors
that are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Module Select the memory modules you want to add a sensor for. A list of
all available items is shown with their name. Select the desired
items by adding check marks in front of the respective lines. One
sensor will be created for each selection. You can also select and
deselect all items by using the check box in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
1084 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
117 SNMP IBM System X Physical Memory Sensor
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Name
Caption
Shows further information about the module. Once a sensor is
created this value cannot be changed. It is shown for reference
Serial Number purposes only. If you need to change this, please add the sensor
anew.
Size
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
24.10.2013 1085
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
117 SNMP IBM System X Physical Memory Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
1086 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
117 SNMP IBM System X Physical Memory Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
24.10.2013 1087
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
117 SNMP IBM System X Physical Memory Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
More
Knowledge Base: What are the requirements to monitor IBM System x?
1088 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
117 SNMP IBM System X Physical Memory Sensor
§ http://kb.paessler.com/en/topic/59393
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
24.10.2013 1089
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
118 SNMP IBM System X System Health Sensor
The SNMP IBM System X System Health sensor monitors the system health of an IBM device via
Simple Network Management Protocol (SNMP). It can show revolutions per minute of fans (or
the current percentage of the possible maximum), temperatures of ambient and CPUs, voltage,
status of power supplies, and many more, depending on the available measurement
components.
Note: If the IBM device returns a string in an unexpected format for the percentage of fan
revolutions (for example, "offline"), this sensor will show -1% in the corresponding channel. You
can define a Down status for this via channel limits 1710 .
This sensor type has predefined limits for several metrics. These limits can be changed
individually in the channel settings. For detailed information about channel limits please refer to
the section Sensor Channels Set t ings 1709 .
This sensor type uses lookups to determine the status values of some sensor channels. For
details, please see section Define Lookups 2039 .
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
This sensor type needs the IBM Systems Director Platform Agent to be installed on the target
IBM device in order to monitor it through SNMP. For more information, please see section
More below.
Note: The SNMP IBM System X System Health sensor can also run directly on an Integrated
Management Module (IMM) network port and can show the overall health on IMMs.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor the system health of an IBM device, PRTG will create one sensor for each
measurement you choose. The settings you make in this dialog are valid for all of the sensors
that are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
1090 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
118 SNMP IBM System X System Health Sensor
Measurement Select the measurements you want to add a sensor for. A list of all
available items is shown with their name. Select the desired items
by adding check marks in front of the respective lines. One sensor
will be created for each selection. You can also select and deselect
all items by using the check box in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
12.05.2014 1091
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
118 SNMP IBM System X System Health Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
1092 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
118 SNMP IBM System X System Health Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
12.05.2014 1093
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
118 SNMP IBM System X System Health Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
1094 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
118 SNMP IBM System X System Health Sensor
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
More
Knowledge Base: What are the requirements to monitor IBM System x?
§ http://kb.paessler.com/en/topic/59393
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
12.05.2014 1095
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
119 SNMP interSeptor Pro Environment Sensor
The SNMP interSeptor Pro Environment sensor queries data from a Jacarta interSeptor Pro
environmental monitoring system via Simple Network Management Protocol (SNMP). It can
monitor temperature and humidity as measured by the Jacarta interSeptor Pro device.
Note: In order to monitor an interSeptor Pro device's data with this sensor, you have to add
the IP address of your PRTG installation to Access Cont rol in the interSeptor Pro control
panel. Open the interSeptor Pro web interface, select Int erSept or Pro Menu | Sy st em
Configurat ion | Access Cont rol for this purpose, and allow access for PRTG's IP address.
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor the environment via an interSeptor Pro device, PRTG will create one sensor
for each measuring point you choose. The settings you make in this dialog are valid for all of
the sensors that are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Measuring Point Select the measuring points you want to add a sensor for. A list of
all available items is shown with their name. Select the desired
items by adding check marks in front of the respective lines. One
sensor will be created for each selection. You can also select and
deselect all items by using the check box in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
1096 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
119 SNMP interSeptor Pro Environment Sensor
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Measuring Point Shows the measuring point which this sensor monitors. Once a
sensor is created this value cannot be changed. It is shown for
reference purposes only. If you need to change this, please add
the sensor anew.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
12.05.2014 1097
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
119 SNMP interSeptor Pro Environment Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
1098 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
119 SNMP interSeptor Pro Environment Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
12.05.2014 1099
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
119 SNMP interSeptor Pro Environment Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
1100 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
119 SNMP interSeptor Pro Environment Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
12.05.2014 1101
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
120 SNMP LenovoEMC Physical Disk Sensor
The SNMP Lenovo Physical Disk sensor monitors a physical disk in a LenovoEMC Network
Attached Storage (NAS) via Simple Network Management Protocol (SNMP). It shows the overall
disk status. States of the disk can be Normal (sensor status Up), Unknown and Foreign (both
with sensor status Warning), as well as Faulted and Missing (both with sensor status Down).
This sensor type uses lookups to determine the status values of some sensor channels. For
details, please see section Define Lookups 2039 .
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor physical disks in a LenovoEMC NAS, PRTG will create one sensor for each
disk you select. The settings you make in this dialog are valid for all of the sensors that are
created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Disk Select the disks you want to add a sensor for. A list of all available
items is shown with their name. Select the desired items by adding
check marks in front of the respective lines. One sensor will be
created for each selection. You can also select and deselect all
items by using the check box in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
1102 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
120 SNMP LenovoEMC Physical Disk Sensor
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Disk Shows the disk monitored by this sensor. Once a sensor is created
this value cannot be changed. It is shown for reference purposes
only. If you need to change this, please add the sensor anew.
Name Shows the name of the disk monitored by this sensor. Once a
sensor is created this value cannot be changed. It is shown for
reference purposes only. If you need to change this, please add
the sensor anew.
Size Shows the size of the disk monitored by this sensor. Once a
sensor is created this value cannot be changed. It is shown for
reference purposes only. If you need to change this, please add
the sensor anew.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
14.01.2014 1103
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
120 SNMP LenovoEMC Physical Disk Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
1104 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
120 SNMP LenovoEMC Physical Disk Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
14.01.2014 1105
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
120 SNMP LenovoEMC Physical Disk Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
1106 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
120 SNMP LenovoEMC Physical Disk Sensor
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
14.01.2014 1107
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
121 SNMP LenovoEMC System Health Sensor
The SNMP LenovoEMC System Health sensor monitors the system health of a LenovoEMC
Network Attached Storage (NAS) via Simple Network Management Protocol (SNMP). It shows
the overall status of the RAID. States can be Normal (sensor status Up), Unknown, Rebuilding,
Degraded, and RebuildFS (all with sensor status Warning), as well as Faulted (sensor status
Down).
Furthermore, this sensor can show, for example, states of several fans, voltages, and
temperatures. These channels are created at run-time depending on the available measurement
components in the LenovoEMC NAS.
This sensor type uses lookups to determine the status values of some sensor channels. For
details, please see section Define Lookups 2039 .
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
1108 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
121 SNMP LenovoEMC System Health Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
14.01.2014 1109
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
121 SNMP LenovoEMC System Health Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
1110 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
121 SNMP LenovoEMC System Health Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
14.01.2014 1111
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
121 SNMP LenovoEMC System Health Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1112 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
122 SNMP Library Sensor
The SNMP Library sensor monitors a device using Simple Network Management Protocol
(SNMP) in combination with a compiled Management Information Base (MIB) library file. This
provides extended monitoring beyond the standard SNMP sensors of PRTG.
In order to monitor any SNMP capable device, you can download the manufacturer's MIB files
for these devices, convert them to the Paessler oidlib format, and import them into PRTG. To
make your monitoring setup as convenient as possible, PRTG is delivered with pre-compiled
oidlib library files that already contain the Object Identifier (OID) of SNMP counters for the most
common devices in a network.
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
Manually add 220 a new sensor to an SNMP device and from the Add Sensor dialog, select
SNMP Library sensor. PRTG will show a list of oidlib files available on the system. This contains
all library files stored at the \snmplibs sub-directory of your PRTG installation directory—both
the ones delivered with PRTG and your own files. For details about directory paths, please see
section Dat a St orage 2074 .
28.05.2014 1113
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
122 SNMP Library Sensor
The file names in the list indicate the potential purpose. Select a name that appears appropriate
for your device and confirm with the OK button. Often, Paessler common oid library .oidlib is
a good start. If the file does not fit to your device, this will result in an error message saying
that the scan for available monitoring items has failed on this device: No such object (SNMP
error # 222). If you see this message, please hit the Cancel button and try adding the sensor
with another file. If counters were found for your device, you will see the sensor's settings.
The following files are delivered with PRTG and allow to extend your SNMP monitoring for many
devices. Please be aware that not all devices and/or parameters may be supported by the
libraries.
§ APC UPS.oidlib
Can be used to monitor uninterruptible power supplies (UPS) from APC American Power
Conversion Corp.
§ APCSensorst at ionlib.oidlib
Can be used to monitor alarm status, communication status, humidity, and temperature as
shown by an APC sensor station.
§ cisco-int erfaces.oidlib
Can be used to monitor Cisco specific parameters, for example, the number of present
network interfaces on a system, several states of an interface (admin, oper, speed, type,
errors, discards, etc.), and more.
§ cisco-queue.oidlib
Can be used to monitor queues on a Cisco interface, for example, queue depth and its
maximum, discarded messages from the queue, the number of the queue within the queue
set, etc.
1114 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
122 SNMP Library Sensor
§ Linux SNMP (IP Net SNMP Not i OSPF RMON SMUX ).oidlib
Can be used to monitor different aspects of Linux systems. Note: This file can find a very
large number of possible interfaces. It may take a few seconds until the selection table is
shown.
Additionally you can create your own oidlib files by importing your device manufacturers' MIB
files, using a the free Paessler MIB Import er. Simply convert your mib files and save the
resulting oidlib files to the \snmplibs sub-folder of your PRTG program directory. For details
about directory paths, please see Dat a St orage 2074 . For more information and download of
MIB Import er, please see the link in the More 1120 section below.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Library This shows the path to the oidlib file selected before. Once a
sensor is created this value cannot be changed. It is shown for
reference purposes only. If you need to change this, please add
the sensor anew.
Library-OIDs Select the aspects of the device you want to monitor. A list specific
to your setup is shown. It contains all counters found in the
chosen library that match your device. Select one or more items by
adding a check mark in front of the respective line. For each
selection one sensor will be created when you click the Cont inue
button.
28.05.2014 1115
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
122 SNMP Library Sensor
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
1116 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
122 SNMP Library Sensor
Selected Interface Shows the interface monitored by this sensor. Once a sensor is
created this value cannot be changed. It is shown for reference
purposes only. If you need to change this, please add the sensor
anew.
Unit String Enter a string describing the unit of the returned values. This is for
display purposes only. Please enter a string.
Multiplication If you want to multiply the received data with a certain value, enter
the quotient here. Please enter an integer or float value, or leave
the field empty.
Division If you want to divide the received data by a certain value, enter the
divisor here. Please enter an integer or float value, or leave the field
empty.
If Value Changes Define what will be done in case the value of this sensor changes.
You can choose between:
§ Ignore changes (default ): No action will be taken on change.
§ Trigger 'change' not ificat ion: The sensor will send an internal
message indicating that its value has changed. In combination
with a Change Trigger, you can use this mechanism to trigger a
notification 1716 whenever the sensor value changes.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
28.05.2014 1117
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
122 SNMP Library Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
1118 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
122 SNMP Library Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
28.05.2014 1119
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
122 SNMP Library Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
More
Knowledge Base: How can I import my MIB files into PRTG?
§ http://kb.paessler.com/en/topic/733
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
1120 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
122 SNMP Library Sensor
Others
For more general information about settings, please see Object Set t ings 142 section.
28.05.2014 1121
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
123 SNMP Linux Disk Free Sensor
The SNMP Linux Disk Free sensor monitors free space on disks of a Linux/Unix system using
Simple Network Management Protocol (SNMP). It shows the total free disk space (sum), and the
free disk space in percent for every mounted partition (volume).
Note: The free space returned by this sensor type shows the disk space that is not yet used.
Not all of this space may be available for use, as a part of this space can be reserved by the
system, e.g. for redundancy purposes. For details, please see the article linked in the More 1129
section below.
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
1122 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
123 SNMP Linux Disk Free Sensor
In this section you can set limits that are valid for all channels and all drives. By entering
limits, you can define when the sensor will enter a Warning or Down status; depending on
the data provided by all drives that this sensor monitors. If you want to define limits for
separate channels individually please use the limit settings in the sensor's Channels settings.
Note: All limits defined here are valid additionally to the limits defined in the particular
Channels settings!
Percentage Limit Check Enable or disable a limit check for the free space in percentage
channels of all drives. By default percentage limits are enabled with
lower warning and lower error limit. Choose between:
· Disable Percent age Limit s: Do not use the drives' data to
control the sensor's status.
· Enable Percent age Limit s: Define limits. Additional fields appear
below. The sensor will enter a warning or down state when free
space limits are undercut or overrun.
Upper Error Limit This field is only visible if percentage limit check is enabled above.
Specify an upper limit in percent for a Down status. If the free disk
space of one of your drives overruns this percent value, the sensor
will be set to Down. Please enter an integer value or leave the field
empty. Note: The limits set here are valid for all channels of this
sensor. You can additionally set individual limits for each sensor
channel in the Sensor Channels Set t ings 1709 . The limits set here
and in the channel settings are valid simultaneously!
Upper Warning Limit This field is only visible if percentage limit check is enabled above.
Specify an upper limit in percent for a Warning status. If the free
disk space of one of your drives overruns this percent value, the
sensor will be set to Warning. Please enter an integer value or
leave the field empty. Note: The limits set here are valid for all
channels of this sensor. You can additionally set individual limits for
each sensor channel in the Sensor Channels Set t ings 1709 . The
limits set here and in the channel settings are valid simultaneously!
Lower Warning Limit This field is only visible if percentage limit check is enabled above.
Specify a lower limit in percent for a warning state. If the free disk
space of one of your drives undercuts this percent value, the
sensor will be set to warning. Please enter an integer value or
leave the field empty. Note: The limits set here are valid for all
channels of this sensor. You can additionally set individual limits for
each sensor channel in the Sensor Channels Set t ings 1709 . The
limits set here and in the channel settings are valid simultaneously!
28.05.2014 1123
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
123 SNMP Linux Disk Free Sensor
Lower Error Limit This field is only visible if percentage limit check is enabled above.
Specify a lower limit in percent for entering a Down status. If the
free disk space of one of your drives undercuts this percent value,
the sensor will be set to Down. Please enter an integer value or
leave the field empty. Note: The limits set here are valid for all
channels of this sensor. You can additionally set individual limits for
each sensor channel in the Sensor Channels Set t ings 1709 . The
limits set here and in the channel settings are valid simultaneously!
Byte Limit Check Enable or disable a limit check for the free bytes channels of all
drives. Choose between:
· Disable By t e Limit s: Do not use the drives' data to control the
sensor's status.
· Enable By t e Limit s: Define limits. Additional fields appear below.
The sensor will enter a warning or down state when free space
limits are undercut or overrun.
Upper Error Limit This field is only visible if byte limit check is enabled above. Specify
an upper limit. Use the same unit as shown by the free bytes
channels of this sensor (by default this is MByte). If the free disk
space of one of your drives overruns this bytes value, the sensor
will be set to Down. Please enter an integer value or leave the field
empty. Note: The limits set here are valid for all channels of this
sensor. You can additionally set individual limits for each sensor
channel in the Sensor Channels Set t ings 1709 . The limits set here
and in the channel settings are valid simultaneously!
Upper Warning Limit This field is only visible if byte limit check is enabled above. Specify
an upper limit. Use the same unit as shown by the free bytes
channels of this sensor (by default this is MByte). If the free disk
space of one of your drives overruns this bytes value, the sensor
will be set to Warning. Please enter an integer value or leave the
field empty. Note: The limits set here are valid for all channels of
this sensor. You can additionally set individual limits for each
sensor channel in the Sensor Channels Set t ings 1709 . The limits set
here and in the channel settings are valid simultaneously!
Lower Warning Limit This field is only visible if byte limit check is enabled above. Specify
a lower limit. Use the same unit as shown by the free bytes
channels of this sensor (by default this is MByte). If the free disk
space of one of your drives undercuts this bytes value, the sensor
will be set to Warning. Please enter an integer value or leave the
field empty. Note: The limits set here are valid for all channels of
this sensor. You can additionally set individual limits for each
sensor channel in the Sensor Channels Set t ings 1709 . The limits set
here and in the channel settings are valid simultaneously!
1124 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
123 SNMP Linux Disk Free Sensor
Lower Error Limit This field is only visible if byte limit check is enabled above. Specify
a lower limit. Use the same unit as shown by the free bytes
channels of this sensor (by default this is MByte). If the free disk
space of one of your drives undercuts this bytes value, the sensor
will be set to Down. Please enter an integer value or leave the field
empty. Note: The limits set here are valid for all channels of this
sensor. You can additionally set individual limits for each sensor
channel in the Sensor Channels Set t ings 1709 . The limits set here
and in the channel settings are valid simultaneously!
Alarm on Missing/ If a monitored disk is removed or not found, values are set to zero.
Removed Disk Select the alarming approach in this case. Choose between:
§ Deact ivat e alarm (default ): Select this option if you do not
want an alarm for a removed disk.
§ Act ivat e Alarm: Select this option if you want to be alerted if a
monitored disk is removed.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
28.05.2014 1125
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
123 SNMP Linux Disk Free Sensor
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
1126 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
123 SNMP Linux Disk Free Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
28.05.2014 1127
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
123 SNMP Linux Disk Free Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
1128 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
123 SNMP Linux Disk Free Sensor
More
Knowledge Base: Why do SSH Disk Free and SNMP Linux Disk Free show different values for
my target Linux system?
§ http://kb.paessler.com/en/topic/43183
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
28.05.2014 1129
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
124 SNMP Linux Load Average Sensor
The SNMP Load Average sensor monitors the system load average of a Linux/Unix system
using Simple Network Management Protocol (SNMP). It shows the average system load within a
one, five, and 15 minutes interval (each in one channel).
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
1130 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
124 SNMP Linux Load Average Sensor
Sensor Display
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
27.11.2012 1131
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
124 SNMP Linux Load Average Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
1132 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
124 SNMP Linux Load Average Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
27.11.2012 1133
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
124 SNMP Linux Load Average Sensor
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1134 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
125 SNMP Linux Meminfo Sensor
The SNMP Linux Meminfo sensor monitors the memory usage of a Linux/Unix system using
Simple Network Management Protocol (SNMP). It shows the available memory in total and in
percent.
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
08.10.2013 1135
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
125 SNMP Linux Meminfo Sensor
Sensor Display
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
1136 08.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
125 SNMP Linux Meminfo Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
08.10.2013 1137
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
125 SNMP Linux Meminfo Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
1138 08.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
125 SNMP Linux Meminfo Sensor
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
08.10.2013 1139
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
126 SNMP Linux Physical Disk Sensor
The SNMP Linux Physical Disk sensor monitors input/output (I/O) on disks of a Linux/Unix
system using Simple Network Management Protocol (SNMP). It shows read and written bytes
per second, read and write accesses per second, as well as load average within a specific time
span (1, 5, and 15 minutes), depending on the counters available on the disk.
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor I/O on disks of a Linux/Unix system, PRTG will create one sensor for each
disk you choose. The settings you make in this dialog are valid for all of the sensors that are
created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Disk Select one or more disks you want to add a sensor for. A list of all
available items is shown with their name. Select the desired items
by adding check marks in front of the respective lines. One sensor
will be created for each selection. You can also select and deselect
all items by using the check box in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
1140 19.07.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
126 SNMP Linux Physical Disk Sensor
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Disk Shows further information about the disk that this sensor is
monitoring. Once a sensor is created this value cannot be changed.
It is shown for reference purposes only. If you need to change this,
Bitmask please add the sensor anew.
In this section you can set limits that are valid for all channels and all drives. By entering
limits, you can define when the sensor will enter a Warning or Down status; depending on
the data provided by all drives that this sensor monitors. If you want to define limits for
separate channels individually please use the limit settings in the sensor's Channels settings.
Note: All limits defined here are valid additionally to the limits defined in the particular
Channels settings!
Percentage Limit Check Enable or disable a limit check for load average in percentage
channels of all drives. By default percentage limits are enabled with
lower warning and lower error limit. Choose between:
· Disable Percent age Limit s: Do not use the drives' data to
control the sensor's status.
· Enable Percent age Limit s: Define limits. Additional fields appear
below. The sensor will enter a warning or down state when load
average limits are undercut or overrun.
19.07.2013 1141
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
126 SNMP Linux Physical Disk Sensor
Upper Error Limit This field is only visible if percentage limit check is enabled above.
Specify an upper limit in percent for a Down status. If load average
of one of your drives overruns this percent value, the sensor will
be set to Down. Please enter an integer value or leave the field
empty. Note: The limits set here are valid for all channels of this
sensor. You can additionally set individual limits for each sensor
channel in the Sensor Channels Set t ings 1709 . The limits set here
and in the channel settings are valid simultaneously!
Upper Warning Limit This field is only visible if percentage limit check is enabled above.
Specify an upper limit in percent for a Warning status. If load
average of one of your drives overruns this percent value, the
sensor will be set to Warning. Please enter an integer value or
leave the field empty. Note: The limits set here are valid for all
channels of this sensor. You can additionally set individual limits for
each sensor channel in the Sensor Channels Set t ings 1709 . The
limits set here and in the channel settings are valid simultaneously!
Lower Warning Limit This field is only visible if percentage limit check is enabled above.
Specify a lower limit in percent for a warning state. If load average
of one of your drives undercuts this percent value, the sensor will
be set to warning. Please enter an integer value or leave the field
empty. Note: The limits set here are valid for all channels of this
sensor. You can additionally set individual limits for each sensor
channel in the Sensor Channels Set t ings 1709 . The limits set here
and in the channel settings are valid simultaneously!
Lower Error Limit This field is only visible if percentage limit check is enabled above.
Specify a lower limit in percent for entering a Down status. If load
average of one of your drives undercuts this percent value, the
sensor will be set to Down. Please enter an integer value or leave
the field empty. Note: The limits set here are valid for all channels of
this sensor. You can additionally set individual limits for each
sensor channel in the Sensor Channels Set t ings 1709 . The limits set
here and in the channel settings are valid simultaneously!
Byte Limit Check Enable or disable a limit check for read and written bytes channels
of all drives. Choose between:
· Disable By t e Limit s: Do not use the drives' data to control the
sensor's status.
· Enable By t e Limit s: Define limits. Additional fields appear below.
The sensor will enter a warning or down state when read and
written bytes limits are undercut or overrun.
1142 19.07.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
126 SNMP Linux Physical Disk Sensor
Upper Error Limit This field is only visible if byte limit check is enabled above. Specify
an upper limit. Use the same unit as shown by the bytes channels
of this sensor (by default this is MByte). If the read and/or written
bytes of one of your drives overruns this bytes value, the sensor
will be set to Down. Please enter an integer value or leave the field
empty. Note: The limits set here are valid for all channels of this
sensor. You can additionally set individual limits for each sensor
channel in the Sensor Channels Set t ings 1709 . The limits set here
and in the channel settings are valid simultaneously!
Upper Warning Limit This field is only visible if byte limit check is enabled above. Specify
an upper limit. Use the same unit as shown by the bytes channels
of this sensor (by default this is MByte). If the read and/or written
bytes of one of your drives overruns this bytes value, the sensor
will be set to Warning. Please enter an integer value or leave the
field empty. Note: The limits set here are valid for all channels of
this sensor. You can additionally set individual limits for each
sensor channel in the Sensor Channels Set t ings 1709 . The limits set
here and in the channel settings are valid simultaneously!
Lower Warning Limit This field is only visible if byte limit check is enabled above. Specify
a lower limit. Use the same unit as shown by the bytes channels of
this sensor (by default this is MByte). If the read and/or written
bytes of one of your drives undercuts this bytes value, the sensor
will be set to Warning. Please enter an integer value or leave the
field empty. Note: The limits set here are valid for all channels of
this sensor. You can additionally set individual limits for each
sensor channel in the Sensor Channels Set t ings 1709 . The limits set
here and in the channel settings are valid simultaneously!
Lower Error Limit This field is only visible if byte limit check is enabled above. Specify
a lower limit. Use the same unit as shown by the bytes channels of
this sensor (by default this is MByte). If the read and/or written
bytes of one of your drives undercuts this bytes value, the sensor
will be set to Down. Please enter an integer value or leave the field
empty. Note: The limits set here are valid for all channels of this
sensor. You can additionally set individual limits for each sensor
channel in the Sensor Channels Set t ings 1709 . The limits set here
and in the channel settings are valid simultaneously!
Alarm on Missing/ If a monitored disk is removed or not found, values are set to zero.
Removed Disk Select the alarming approach in this case. Choose between:
§ Deact ivat e alarm (default ): Select this option if you do not
want an alarm for a removed disk.
§ Act ivat e Alarm: Select this option if you want to be alerted if a
monitored disk is removed.
19.07.2013 1143
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
126 SNMP Linux Physical Disk Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
1144 19.07.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
126 SNMP Linux Physical Disk Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
19.07.2013 1145
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
126 SNMP Linux Physical Disk Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
1146 19.07.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
126 SNMP Linux Physical Disk Sensor
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
19.07.2013 1147
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
127 SNMP Memory Sensor
The SNMP Memory sensor monitors the memory usage of a system via Simple Network
Management Protocol (SNMP). It can show the available memory in total and in percent, as well
as the total memory. Note: This sensor uses more generic Object Identifier (OID) values
compared to the SNMP Linux Meminfo Sensor 1135 .
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor memory usage, PRTG will create one sensor for each memory type you
choose. The settings you make in this dialog are valid for all of the sensors that are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Memory Select one or more memory types you want to add a sensor for. A
list of all available items is shown with their name. Select the
desired items by adding check marks in front of the respective
lines. One sensor will be created for each selection. You can also
select and deselect all items by using the check box in the table
head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
1148 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
127 SNMP Memory Sensor
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Memory Shows the type of the memory that this sensor is monitoring. Once
a sensor is created this value cannot be changed. It is shown for
reference purposes only. If you need to change this, please add
the sensor anew.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
07.02.2013 1149
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
127 SNMP Memory Sensor
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
1150 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
127 SNMP Memory Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
07.02.2013 1151
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
127 SNMP Memory Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
1152 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
127 SNMP Memory Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
07.02.2013 1153
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
128 SNMP NetApp Disk Free Sensor
The SNMP NetApp Disk Free sensor monitors free space on disks of a NetApp storage system
via Simple Network Management Protocol (SNMP). It can show deduplication saved space and
shared space, in total and in percent; disk free (total and percent), as well as percentage values
for files free and inodes free.
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor disk space on a NetApp, PRTG will create one sensor for each disk. The
settings you make in this dialog are valid for all of the sensors that are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
File System Select the disks you want to add a sensor for. A list of all available
items is shown with their name. Select the desired items by adding
check marks in front of the respective lines. One sensor will be
created for each selection. You can also select and deselect all
items by using the check box in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
1154 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
128 SNMP NetApp Disk Free Sensor
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
File System Shows the name of the disk that this sensor is monitoring. Once a
sensor is created this value cannot be changed. It is shown for
reference purposes only. If you need to change this, please add
the sensor anew.
Virtual Disk Shows the name of the virtual disk that this sensor is monitoring (if
applicable). Once a sensor is created this value cannot be changed.
It is shown for reference purposes only. If you need to change this,
please add the sensor anew.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
07.02.2013 1155
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
128 SNMP NetApp Disk Free Sensor
Sensor Display
§ Show in and out t raffic as posit ive and negat ive area chart :
Show channels for incoming and outgoing traffic as positive and
negative area chart. This will visualize your traffic in a clear way.
Note: This option cannot be used in combination with manual
Vertical Axis Scaling (available in the Sensor Channels Set t ings
1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
1156 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
128 SNMP NetApp Disk Free Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
07.02.2013 1157
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
128 SNMP NetApp Disk Free Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
1158 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
128 SNMP NetApp Disk Free Sensor
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
07.02.2013 1159
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
129 SNMP NetApp Enclosure Sensor
The SNMP NetApp Enclosure sensor monitors the power supply and cooling of an enclosure
that is part of a NetApp storage system via SNMP. It can measure temperatures, fans, voltages,
and currents.
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor power supply and cooling of an enclosure on a NetApp, PRTG will create
one sensor for each enclosure/measurement combination. The settings you make in this
dialog are valid for all of the sensors that are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Enclosure Select the enclosures with the desired measurement you want to
add a sensor for. A list of all available items is shown with their
name. Select the desired items by adding check marks in front of
the respective lines. One sensor will be created for each selection.
You can also select and deselect all items by using the check box
in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
1160 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
129 SNMP NetApp Enclosure Sensor
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
07.02.2013 1161
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
129 SNMP NetApp Enclosure Sensor
Sensor Display
§ Show in and out t raffic as posit ive and negat ive area chart :
Show channels for incoming and outgoing traffic as positive and
negative area chart. This will visualize your traffic in a clear way.
Note: This option cannot be used in combination with manual
Vertical Axis Scaling (available in the Sensor Channels Set t ings
1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
1162 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
129 SNMP NetApp Enclosure Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
07.02.2013 1163
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
129 SNMP NetApp Enclosure Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
1164 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
129 SNMP NetApp Enclosure Sensor
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
07.02.2013 1165
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
130 SNMP NetApp I/O Sensor
The SNMP NetApp I/O sensor monitors input/output operations (IOPS) on a NetApp storage
system via Simple Network Management Protocol (SNMP). It can show FCP Read, CIFS Ops, Disk
Read, Disk Write, FCP Ops, FCP Write, HTTP Ops, ISCSI Ops, ISCSI Read, ISCSI Write, Network
Received, Network Sent, NFS Ops, Tape Read, and Tape Write.
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
1166 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
130 SNMP NetApp I/O Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
§ Show in and out t raffic as posit ive and negat ive area chart :
Show channels for incoming and outgoing traffic as positive and
negative area chart. This will visualize your traffic in a clear way.
Note: This option cannot be used in combination with manual
Vertical Axis Scaling (available in the Sensor Channels Set t ings
1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
27.11.2012 1167
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
130 SNMP NetApp I/O Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
1168 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
130 SNMP NetApp I/O Sensor
§ Mast er object for parent : Make this sensor the master object
for its parent device. The sensor will influence the behavior of
the device it is created on: If the sensor is in a Down status, the
device will be paused. For example, it is a good idea to make a
Ping sensor the master object for its parent device to pause
monitoring for all other sensors on the device in case the device
cannot even be pinged. Additionally, the sensor will be paused if
the parent group of its parent device is in a Down status, or if it
is paused by another dependency.
Note: Testing your dependencies is easy! Simply choose Simulat e
Error St at us from the context menu of an object that other
objects depend on. A few seconds later all dependent objects
should be paused.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
27.11.2012 1169
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
130 SNMP NetApp I/O Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
1170 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
130 SNMP NetApp I/O Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
27.11.2012 1171
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
131 SNMP NetApp License Sensor
The SNMP NetApp License sensor monitors the licenses for the services of a NetApp storage
system via Simple Network Management Protocol (SNMP). It indicates how much time is left
until the license for a service expires. This can help you to detect when a timely limited NetApp
license is going to expire.
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor licenses on a NetApp, PRTG will create one sensor for each license. The
settings you make in this dialog are valid for all of the sensors that are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
License for Service Select the licenses you want to add a sensor for. A list of all
available items is shown with their name. Select the desired items
by adding check marks in front of the respective lines. One sensor
will be created for each selection. You can also select and deselect
all items by using the check box in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
1172 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
131 SNMP NetApp License Sensor
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
License for Service Shows the name of the license that this sensor is monitoring. Once
a sensor is created this value cannot be changed. It is shown for
reference purposes only. If you need to change this, please add
the sensor anew.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
07.02.2013 1173
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
131 SNMP NetApp License Sensor
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
1174 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
131 SNMP NetApp License Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
07.02.2013 1175
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
131 SNMP NetApp License Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
1176 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
131 SNMP NetApp License Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
07.02.2013 1177
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
132 SNMP NetApp Logical Unit Sensor
The SNMP NetApp Logical Unit sensor monitors the input/output operations (IOPS) on a logical
unit of a NetApp storage system via Simple Network Management Protocol (SNMP). It can show
the total number of operations, the amount of read and written data, the number of errors, the
number of read, write, and other operations, as well as the overall status of the logical unit.
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor logical units on a NetApp, PRTG will create one sensor for each unit. The
settings you make in this dialog are valid for all of the sensors that are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Logical Unit Select the logical units you want to add a sensor for. A list of all
available items is shown with their name. Select the desired items
by adding check marks in front of the respective lines. One sensor
will be created for each selection. You can also select and deselect
all items by using the check box in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
1178 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
132 SNMP NetApp Logical Unit Sensor
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Logical Unit Shows the name of the logical unit that this sensor is monitoring.
Once a sensor is created this value cannot be changed. It is shown
for reference purposes only. If you need to change this, please add
the sensor anew.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
14.01.2014 1179
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
132 SNMP NetApp Logical Unit Sensor
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
1180 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
132 SNMP NetApp Logical Unit Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
14.01.2014 1181
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
132 SNMP NetApp Logical Unit Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
1182 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
132 SNMP NetApp Logical Unit Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
14.01.2014 1183
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
133 SNMP NetApp Network Interface Sensor
The SNMP NetApp Network Interface sensor monitors a network card of a NetApp storage
system via Simple Network Management Protocol (SNMP). It can show traffic in and out, as well
as the number of errors per second (in and out).
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor network interfaces on a NetApp, PRTG will create one sensor for each
interface. The settings you make in this dialog are valid for all of the sensors that are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Network Interface Select the interfaces you want to add a sensor for. A list of all
available items is shown with their name. Select the desired items
by adding check marks in front of the respective lines. One sensor
will be created for each selection. You can also select and deselect
all items by using the check box in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
1184 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
133 SNMP NetApp Network Interface Sensor
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Network Interface Shows the name of the interface that this sensor is monitoring.
Once a sensor is created this value cannot be changed. It is shown
for reference purposes only. If you need to change this, please add
the sensor anew.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
§ Show in and out t raffic as posit ive and negat ive area chart :
Show channels for incoming and outgoing traffic as positive and
negative area chart. This will visualize your traffic in a clear way.
Note: This option cannot be used in combination with manual
Vertical Axis Scaling (available in the Sensor Channels Set t ings
1709 settings).
07.02.2013 1185
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
133 SNMP NetApp Network Interface Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
1186 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
133 SNMP NetApp Network Interface Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
07.02.2013 1187
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
133 SNMP NetApp Network Interface Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
1188 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
133 SNMP NetApp Network Interface Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
07.02.2013 1189
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
134 SNMP NetApp System Health Sensor
The SNMP NetApp System Health sensor monitors the status of a NetApp storage system via
Simple Network Management Protocol (SNMP). It can show the CPU load in percent, active
restore, current CIFS users; the number of disks active, being added, being scrubbed, failed,
failing soon, being out of date, reconstructing (parity), spare, verifying parity, and total; the
number of fans and power supplies failed; the max used disk space and max used inodes, in
percent. This depends on the available measurement components on the NetApp.
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
1190 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
134 SNMP NetApp System Health Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
§ Show in and out t raffic as posit ive and negat ive area chart :
Show channels for incoming and outgoing traffic as positive and
negative area chart. This will visualize your traffic in a clear way.
Note: This option cannot be used in combination with manual
Vertical Axis Scaling (available in the Sensor Channels Set t ings
1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
28.05.2014 1191
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
134 SNMP NetApp System Health Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
1192 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
134 SNMP NetApp System Health Sensor
§ Mast er object for parent : Make this sensor the master object
for its parent device. The sensor will influence the behavior of
the device it is created on: If the sensor is in a Down status, the
device will be paused. For example, it is a good idea to make a
Ping sensor the master object for its parent device to pause
monitoring for all other sensors on the device in case the device
cannot even be pinged. Additionally, the sensor will be paused if
the parent group of its parent device is in a Down status, or if it
is paused by another dependency.
Note: Testing your dependencies is easy! Simply choose Simulat e
Error St at us from the context menu of an object that other
objects depend on. A few seconds later all dependent objects
should be paused.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
28.05.2014 1193
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
134 SNMP NetApp System Health Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
1194 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
134 SNMP NetApp System Health Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
28.05.2014 1195
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
135 SNMP Poseidon Environment Sensor
The SNMP Poseidon Environment sensor monitors performance counters for environmental
measurements on Poseidon hardware via Simple Network Management Protocol (SNMP). It can
show, for example, humidity and temperature in the environment, depending on available
measurement components on the hardware device.
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Measuring Point Select the measurements you want to add a sensor for. A list of all
available items is shown with their name. Select the desired items
by adding check marks in front of the respective lines. One sensor
will be created for each selection. You can also select and deselect
all items by using the check box in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
1196 13.06.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
135 SNMP Poseidon Environment Sensor
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Name
Shows further information about the measurement. Once a sensor
Unit is created this value cannot be changed. It is shown for reference
purposes only. If you need to change this, please add the sensor
Measuring Point anew.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
13.06.2013 1197
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
135 SNMP Poseidon Environment Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
1198 13.06.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
135 SNMP Poseidon Environment Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
13.06.2013 1199
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
135 SNMP Poseidon Environment Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1200 13.06.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
136 SNMP Printer Sensor
The SNMP Printer sensor is a generic sensor which monitors various types of printers via
Simple Network Management Protocol (SNMP). It can show the total number of printed pages,
the fill level of cartridges and toners, and the status of the printer cover. Additionally, the
sensor shows the printer status as sensor message.
This sensor type uses lookups to determine the status values of some sensor channels. For
details, please see section Define Lookups 2039 .
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Important notice: Currently, this sensor type is in bet a status. The methods of operating can
change at any time, as well as the available settings. Do not expect that all functions will work
properly, or that this sensor works as expected at all. Be aware that this type of sensor can be
removed again from PRTG at any time.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
28.05.2014 1201
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
136 SNMP Printer Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
1202 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
136 SNMP Printer Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
28.05.2014 1203
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
136 SNMP Printer Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
1204 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
136 SNMP Printer Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
28.05.2014 1205
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
137 SNMP QNAP Logical Disk Sensor
The SNMP QNAP Logical Disk sensor monitors a logical disk in a QNAP Network Attached
Storage (NAS) via Simple Network Management Protocol (SNMP). It can show free space and
free bytes, as well as the status of a volume.
This sensor type uses lookups to determine the status values of some sensor channels. For
details, please see section Define Lookups 2039 .
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor the logical disks in a QNAP NAS, PRTG will create one sensor for each disk
you choose. The settings you make in this dialog are valid for all of the sensors that are
created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Disk Select the logical disks you want to add a sensor for. A list of all
available items is shown with their name. Select the desired items
by adding check marks in front of the respective lines. One sensor
will be created for each selection. You can also select and deselect
all items by using the check box in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
1206 13.06.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
137 SNMP QNAP Logical Disk Sensor
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Disk
Shows further information about the disk. Once a sensor is created
Description this value cannot be changed. It is shown for reference purposes
only. If you need to change this, please add the sensor anew.
File System
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
13.06.2013 1207
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
137 SNMP QNAP Logical Disk Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
1208 13.06.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
137 SNMP QNAP Logical Disk Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
13.06.2013 1209
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
137 SNMP QNAP Logical Disk Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1210 13.06.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
138 SNMP QNAP Physical Disk Sensor
The SNMP QNAP Physical Disk sensor monitors a physical disk in a QNAP Network Attached
Storage (NAS) via Simple Network Management Protocol (SNMP). It can show the temperature,
the HD status, and the Self-Monitoring, Analysis and Reporting Technology (S.M.A.R.T.) status
of the disk.
This sensor type uses lookups to determine the status values of some sensor channels. For
details, please see section Define Lookups 2039 .
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor the physical disks in a QNAP NAS, PRTG will create one sensor for each disk
you choose. You can also define the unit of the temperature measurement. The settings you
make in this dialog are valid for all of the sensors that are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Disk Select the physical disks you want to add a sensor for. A list of all
available items is shown with their name. Select the desired items
by adding check marks in front of the respective lines. One sensor
will be created for each selection. You can also select and deselect
all items by using the check box in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
13.06.2013 1211
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
138 SNMP QNAP Physical Disk Sensor
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Disk
Description
Model Shows further information about the disk. Once a sensor is created
this value cannot be changed. It is shown for reference purposes
Capacity only. If you need to change this, please add the sensor anew.
Unit
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
1212 13.06.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
138 SNMP QNAP Physical Disk Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
13.06.2013 1213
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
138 SNMP QNAP Physical Disk Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
1214 13.06.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
138 SNMP QNAP Physical Disk Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
13.06.2013 1215
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
138 SNMP QNAP Physical Disk Sensor
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1216 13.06.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
139 SNMP QNAP System Health Sensor
The SNMP QNAP System Health sensor monitors the system health of a QNAP Network
Attached Storage (NAS) via Simple Network Management Protocol (SNMP). It can show the
usage of the CPU, available memory in absolute numbers and percent, the temperature of CPU
and system, as well as various other values, for example, revolutions of fans per minute,
depending on the available measurement components.
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor the system health of a QNAP NAS, please specify the unit of the
temperature measurement.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
13.06.2013 1217
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
139 SNMP QNAP System Health Sensor
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
1218 13.06.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
139 SNMP QNAP System Health Sensor
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
13.06.2013 1219
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
139 SNMP QNAP System Health Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
1220 13.06.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
139 SNMP QNAP System Health Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
13.06.2013 1221
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
140 SNMP RMON Sensor
The SNMP RMON sensor monitors traffic on a device using the Remote Monitoring (RMON)
standard via Simple Network Management Protocol (SNMP). It can be created on an SNMP
compatible device which provides traffic data via RMON. Depending on the data returned by
your device, traffic data for each port can be displayed in different channels, allowing detailed
analysis.
For example, available channels for each traffic port may include Transmitted kbit/s, Packets (#/
s), Broadcast Packets (#/s), Multicast Packets (#/s), CRC Errors (#/s), Undersize Packets (#/s),
Oversize Packets (#/s), Fragments (#/s), Jabbers (#/s), Collisions (#/s), Packets <= 64 Byte (#/
s), Packets 65 - 127 Bytes (#/s), Packets 128 - 255 Bytes (#/s), Packets 256 - 511 Bytes (#/s),
Packets 512 - 1023 Bytes (#/s), Packets 1024 - 1518 Bytes (#/s), and Drop Events (#/s).
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
For SNMP devices with multiple interfaces multiple sensors are created at once in the Add
Sensor dialog. The settings you make in this dialog are valid for all of the sensors that are
created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
RMON Specific
Ports Select the ports you want to add a sensor for. A list of all available
items is shown with their name. Select the desired items by adding
check marks in front of the respective lines. One sensor will be
created for each selection. You can also select and deselect all
items by using the check box in the table head.
In the In Use column you will see a Yes if there was already traffic
detected on this interface in the past, and a No if there wasn't any
traffic yet on this interface (since last device restart, usually). The In
Use column does not show whether or not an interface is currently
connected!
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
1222 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
140 SNMP RMON Sensor
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
RMON Specific
Port Shows the number of the interface port in your physical device that
this sensor is monitoring. Once a sensor is created this value
cannot be changed. It is shown for reference purposes only. If you
need to change this, please add the sensor anew.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
14.01.2014 1223
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
140 SNMP RMON Sensor
Sensor Display
§ Show in and out t raffic as posit ive and negat ive area chart :
Show channels for incoming and outgoing traffic as positive and
negative area chart. This will visualize your traffic in a clear way.
Note: This option cannot be used in combination with manual
Vertical Axis Scaling (available in the Sensor Channels Set t ings
1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
1224 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
140 SNMP RMON Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
14.01.2014 1225
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
140 SNMP RMON Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
1226 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
140 SNMP RMON Sensor
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
14.01.2014 1227
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
141 SNMP SonicWALL System Health Sensor
The SNMP SonicWALL System Health sensor monitors health values of a Dell SonicWALL
Network Security Appliance (NSA) via Simple Network Management Protocol (SNMP). It shows
usage of CPU and memory, as well as usage of the connection cache.
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
1228 15.08.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
141 SNMP SonicWALL System Health Sensor
Sensor Display
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
15.08.2013 1229
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
141 SNMP SonicWALL System Health Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
1230 15.08.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
141 SNMP SonicWALL System Health Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
15.08.2013 1231
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
141 SNMP SonicWALL System Health Sensor
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1232 15.08.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
142 SNMP SonicWALL VPN Traffic Sensor
The SNMP SonicWALL VPN Traffic sensor monitors the traffic of an Internet Protocol Security
(IPsec) Virtual Private Network (VPN) on a Dell SonicWALL Network Security Appliance (NSA) via
Simple Network Management Protocol (SNMP). It can show the number of encrypted and
decrypted packets, the number of bytes of encrypted and decrypted transmissions, as well as
the number of in- and outgoing fragmented packets.
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor the traffic of a SonicWALL VPN, PRTG will create one sensor for each
connection you choose. The settings you make in this dialog are valid for all of the sensors
that are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Connections Select the connections you want to add a sensor for. A list of all
available items is shown with their name. Select the desired items
by adding check marks in front of the respective lines. One sensor
will be created for each selection. You can also select and deselect
all items by using the check box in the table head.
Identification Method Select the criteria PRTG will use to identify the connection. PRTG
will always use the first connection found that matches all criteria.
Choose between:
§ By Index: Every connection has a unique index. This is the safest
method to identify your connection. Though, if the connection is
lost and reconnected, a new index will be assigned.
§ By Remot e IP: If the target of the VPN has always the same IP,
you can use this IP to identify the connection.
§ By Securit y Policy Name: If you use a different Security Policy
for every VPN, you can use its name to identify the connection.
§ By Remot e IP and Securit y Policy Name: You can also combine
both identification methods.
Sensor Settings
08.10.2013 1233
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
142 SNMP SonicWALL VPN Traffic Sensor
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Security Policy Shows further information about the monitored connection. Once
a sensor is created this value cannot be changed. It is shown for
reference purposes only. If you need to change this, please add
Remote IP
the sensor anew.
Index
Identification Method
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
1234 08.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
142 SNMP SonicWALL VPN Traffic Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
08.10.2013 1235
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
142 SNMP SonicWALL VPN Traffic Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
1236 08.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
142 SNMP SonicWALL VPN Traffic Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
08.10.2013 1237
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
142 SNMP SonicWALL VPN Traffic Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1238 08.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
143 SNMP Synology Logical Disk Sensor
The SNMP Synology Logical Disk sensor monitors a logical disk in a Synology Network
Attached Storage (NAS) via Simple Network Management Protocol (SNMP). It can show the
status of a volume.
This sensor type uses lookups to determine the status values of some sensor channels. For
details, please see section Define Lookups 2039 .
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor the logical disks in a Synology NAS, PRTG will create one sensor for each
disk you choose. The settings you make in this dialog are valid for all of the sensors that are
created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Disk Select the logical disks you want to add a sensor for. A list of all
available items is shown with their name. Select the desired items
by adding check marks in front of the respective lines. One sensor
will be created for each selection. You can also select and deselect
all items by using the check box in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
13.06.2013 1239
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
143 SNMP Synology Logical Disk Sensor
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Disk
Shows further information about the disk. Once a sensor is created
Name this value cannot be changed. It is shown for reference purposes
only. If you need to change this, please add the sensor anew.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
1240 13.06.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
143 SNMP Synology Logical Disk Sensor
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
13.06.2013 1241
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
143 SNMP Synology Logical Disk Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
1242 13.06.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
143 SNMP Synology Logical Disk Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
13.06.2013 1243
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
144 SNMP Synology Physical Disk Sensor
The SNMP Physical Disk sensor monitors a physical disk in a Synology Network Attached
Storage (NAS) via Simple Network Management Protocol (SNMP). It can show temperature and
disk status.
This sensor type uses lookups to determine the status values of some sensor channels. For
details, please see section Define Lookups 2039 .
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor the physical disks in a Synology NAS, PRTG will create one sensor for each
disk you choose. The settings you make in this dialog are valid for all of the sensors that are
created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Disk Select the physical disks you want to add a sensor for. A list of all
available items is shown with their name. Select the desired items
by adding check marks in front of the respective lines. One sensor
will be created for each selection. You can also select and deselect
all items by using the check box in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
1244 13.06.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
144 SNMP Synology Physical Disk Sensor
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Disk
Name
Shows further information about the disk. Once a sensor is created
this value cannot be changed. It is shown for reference purposes
Model only. If you need to change this, please add the sensor anew.
Type
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
13.06.2013 1245
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
144 SNMP Synology Physical Disk Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
1246 13.06.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
144 SNMP Synology Physical Disk Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
13.06.2013 1247
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
144 SNMP Synology Physical Disk Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1248 13.06.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
145 SNMP Synology System Health Sensor
The SNMP Synology System Health sensor monitors the system health of a Synology Network
Attached Storage (NAS) via Simple Network Management Protocol (SNMP). It can show
temperature, system status, power status, fan status, as well as several other values,
depending on the available measurement components.
This sensor type uses lookups to determine the status values of some sensor channels. For
details, please see section Define Lookups 2039 .
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor the system health of a Synology NAS, please specify the unit of the
temperature measurement.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
13.06.2013 1249
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
145 SNMP Synology System Health Sensor
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
1250 13.06.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
145 SNMP Synology System Health Sensor
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
13.06.2013 1251
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
145 SNMP Synology System Health Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
1252 13.06.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
145 SNMP Synology System Health Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
13.06.2013 1253
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
146 SNMP System Uptime Sensor
The SNMP System Uptime sensor monitors the time a device is running via Simple Network
Management Protocol (SNMP). It reads the device's value for system uptime and shows it.
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
1254 03.04.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
146 SNMP System Uptime Sensor
Sensor Display
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
03.04.2014 1255
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
146 SNMP System Uptime Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
1256 03.04.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
146 SNMP System Uptime Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
03.04.2014 1257
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
146 SNMP System Uptime Sensor
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1258 03.04.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
147 SNMP Traffic Sensor
The SNMP Traffic sensor monitors traffic on a device using Simple Network Management
Protocol (SNMP). It can be created on a device which provides traffic data. For each individual
port one traffic sensor is created. It can show traffic in, traffic out, and traffic total. Additional
channels can be added.
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
For SNMP devices with multiple interfaces multiple sensors are created at once in the Add
Sensor dialog. The settings you make in this dialog are valid for all of the sensors that are
created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Traffic Specific
Interface Number Select the interfaces you want to add a sensor for. A list of SNMP
device interfaces is shown; containing all interfaces which your
device provides. Connected interfaces are printed in bold face; not
connected in non-bold face. One sensor will be created for each
interface. You can group-select and -unselect interfaces by using
the buttons Select all connect ed int erfaces, Select all
disconnect ed int erfaces, and Deselect all int erfaces. You can
also select and deselect all items by using the check box in the
table head.
Description IN For the standard channel "Traffic In" enter the description here. It
will be shown in graphs and tables. You can change this description
and the description of all other channels in the sensor's channel
settings 1709 later.
Description OUT For the standard channel "Traffic Out" enter the description here. It
will be shown in graphs and tables. You can change this description
and the description of all other channels in the sensor's channel
settings 1709 later.
Description SUM For the standard channel traffic "Sum" enter the description here. It
will be shown in graphs and tables. You can change this description
and the description of all other channels in the sensor's channel
settings 1709 later.
28.05.2014 1259
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
147 SNMP Traffic Sensor
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
1260 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
147 SNMP Traffic Sensor
Traffic Specific
Interface Number Shows the number and name of the interface in your physical
device that this sensor is monitoring. Once a sensor is created this
value cannot be changed. It is shown for reference purposes only.
If you need to change this, please add the sensor anew.
Additional Channels By default, the channels "Traffic In" and "Traffic out" are created for
each sensor. Choose additional channels for all selected interfaces.
Please click on the respective channel name(s); a check mark
symbol will appear in front of them. You can choose from the
following additional channels:
§ Errors In & Out
§ Discards In & Out
§ Unicast Packet s In & Out
§ Non Unicast Packet s In & Out (32-bit only )
§ Mult icast Packet s In & Out (64-bit only )
§ Broadcast Packet s In & Out (64-bit only )
§ Unknown Prot ocols
Channels that are once created cannot be deleted later. They can
be disabled only.
Connection Status Define how PRTG will react when an interface is operational. A
Handling interface which is not operational is, for example, an ethernet port
on a switch with no cable plugged in. This setting is valid for all
interfaces selected above. You can choose between:
§ Show alarm for all "disconnect ed" st at es: The sensor for the
interface will always turn into a red error status for a
disconnected interface. This applies if the ifOperStatus of the
interface is not "up".
§ Show alarm when disconnect ed, but ignore when
deact ivat ed: The sensor will go into an error status for a
disconnected interface only if it is not deliberately deactivated in
the configuration. This applies if the ifOperStatus of the interface
is not "up" and the ifAdminStatus is "up".
§ Ignore all "disconnect ed" st at es: No alarm will be shown in
PRTG; the sensor status remains green and monitoring will be
discontinued without notice.
28.05.2014 1261
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
147 SNMP Traffic Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
§ Show in and out t raffic as posit ive and negat ive area chart :
Show channels for incoming and outgoing traffic as positive and
negative area chart. This will visualize your traffic in a clear way.
Note: This option cannot be used in combination with manual
Vertical Axis Scaling (available in the Sensor Channels Set t ings
1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
1262 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
147 SNMP Traffic Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
28.05.2014 1263
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
147 SNMP Traffic Sensor
§ Mast er object for parent : Make this sensor the master object
for its parent device. The sensor will influence the behavior of
the device it is created on: If the sensor is in a Down status, the
device will be paused. For example, it is a good idea to make a
Ping sensor the master object for its parent device to pause
monitoring for all other sensors on the device in case the device
cannot even be pinged. Additionally, the sensor will be paused if
the parent group of its parent device is in a Down status, or if it
is paused by another dependency.
Note: Testing your dependencies is easy! Simply choose Simulat e
Error St at us from the context menu of an object that other
objects depend on. A few seconds later all dependent objects
should be paused.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
1264 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
147 SNMP Traffic Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
28.05.2014 1265
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
147 SNMP Traffic Sensor
More
Knowledge Base: How do PRTG's automatic port name and number updates work for SNMP
traffic sensors?
§ http://kb.paessler.com/en/topic/25893
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1266 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
148 SNMP Trap Receiver Sensor
The SNMP Trap Receiver sensor receives and analyzes Simple Network Management Protocol
(SNMP) traps. It shows the overall number of received traps per second, warning and error
traps per second, as well as the number of dropped packets per second.
With the available filter options, you can define individually which types of messages will be
considered for monitoring, and which messages will be recognized as warning or error
messages. Depending on the filters, received messages will be counted in the respective
channels.
You can add the sensor to the probe device on the one hand; then the sensor will receive all
messages of the system running the probe. Alternatively, you can add the sensor to a specific
device to gain all messages from this device directly; this will make this sensor type faster than
just using source filters.
Note: You can copy the Management Information Base (MIB) file for your traps into the \MIB
subfolder of your PRTG installation 2074 . PRTG will then be able to translate the OIDs for the
traps into readable messages. For example, instead of the Object Identifier (OID)
1.3.6.1.4.1.32446.1.1.2 you would see SNMPv2-SMI-v1::enterprises.32446.1.1.2 = 0 (example
from the PRTG MIB).
You can use trap specific placeholders in notification templates in order to see the messages
when you receive a notification. See the More 1274 section below for more information.
For a general introduction to the SNMP trap receiver's configuration, please see section
Monit oring Sy slogs and SNMP Traps 1989 .
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
28.05.2014 1267
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
148 SNMP Trap Receiver Sensor
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Listen on Port Enter the port the sensor will listen on for SNMP traps. Usually port
162 is used. Please enter an integer value. We recommend using
the default value.
Purge Messages After Define how long received trap messages will be stored for analysis.
Choose a period of time from the drop down list.
Filt er
Include Filter Define if you want to filter traps. If you leave this field empty or use
the keyword "any", all data will be processed. To include specific
types of traps only, define filters using a special syntax. For more
information, see section Filt er Rules 1273 .
Exclude Filter Define which types of traps will be discarded and not processed.
To exclude specific types of traps, define filters using a special
syntax. For more information, see section Filt er Rules 1273 .
Warning Filter Define which types of traps will count for the Warnings channel. To
categorize received traps as warning messages, define filters using
a special syntax. For more information, see section Filt er Rules 1273 .
1268 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
148 SNMP Trap Receiver Sensor
Filt er
Error Filter Define which types of traps will count for the Errors channel. To
categorize received traps as error messages, define filters using a
special syntax. For more information, see section Filt er Rules 1273 .
Note: Messages are collected until a scanning interval ends; as long
as the scanning interval is running, no status change will happen.
By default, the sensor will turn into a Down status after a scanning
interval has finished and there was at least one error message
during this interval. The status will remain Down at least until the
succeeding scanning interval has finished. If in this scanning interval
no warning or error message occurred, the status of the sensor
will turn Up again after the interval.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
28.05.2014 1269
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
148 SNMP Trap Receiver Sensor
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
1270 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
148 SNMP Trap Receiver Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
28.05.2014 1271
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
148 SNMP Trap Receiver Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
1272 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
148 SNMP Trap Receiver Sensor
Debugging
Log Data to Disk Define if the probe will write a log file of the received data to the
data folder (see Dat a St orage 2074 ) to the disk for debugging
purposes. Choose between:
§ Off (recommended): Do not write additional log files.
Recommended for normal use cases.
§ On: Write log files for all data received.
Note: Use with caution! When enabled, huge data files can be
created. Please use for a short time and for debugging purposes
only.
Filter rules are used for the include, exclude, warning, and error definition fields of the Trap
Receiver sensor. They are based on the following format:
field[filter]
You can use various filters suitable to your needs. Include and exclude filters define which
traps will be monitored; warning and error filters define how received traps will be categorized.
Provide these filters in the sensor settings as formulas. Formulas are fields which can be
combined with boolean operators (AND, OR, NOT) and brackets.
28.05.2014 1273
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
148 SNMP Trap Receiver Sensor
spect rap Enter a number which defines the specific trap spectrap[4], spectrap[0-3]
[number] code. Ranges are also possible.
version Enter a number (1 or 2) which specifies the SNMP version[1], version[2]
[number] version.
communit y Enter a community string for exact, case sensitive community[public],
[text] match. community[private]
Received traps are stored as common files in PRTG's data folder (see section Dat a St orage 2074
). In order to review and analyze all received messages, you can access the most recent data
directly in PRTG's web interface via the respective sensors on the Overview tab in a table list
156 . Note: Received traps are only shown after an (automatic) page refresh following to a
sensor scan in the table on the Overview tab (default for auto refresh 1812 is 30 seconds).
For more details and further filter options, click on the Messages tab of the SNMP Trap
Receiver sensor. You will see all received messages in a table list 156 . On the top, you have
display filter options to drill down into the data for specific events of your interest. The filters
are the same as available in the sensor settings, but you can define them without using
formulas. Provide the desired parameters and PRTG will load the filtered list automatically.
You can open advanced filter settings with a click on the gear icon in the Filt er row. The
Advanced Filt er will appear in a popup window. In the text field, you can define a filter using
the syntax as given in section Filt er Rules for Traps 1273 . If you have provided filter parameters
on the Messages tab, these will be already included in the advanced filter as a corresponding
formula with the correct syntax. You can adjust this filter to your needs. You can also copy the
automatically created and manually adjusted formula for usage in the filter fields of the sensor
settings.
More
Blog Article: Introducing the New High Performance Syslog and SNMP Trap Receiver Sensors
§ http://www.paessler.com/blog/2013/10/11/prtg/introducing-the-new-high-performance-
syslog-and-snmp-trap-receiver-sensors
1274 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
148 SNMP Trap Receiver Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
28.05.2014 1275
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
149 SNMP Windows Service Sensor
The SNMP Windows Service sensor monitors a Windows service via Simple Network
Management Protocol (SNMP). It shows the operating status of the monitored service.
Operating states can be Active (sensor status Up), or Continue-Pending, Pause-Pending, and
Paused (all with sensor status Down).
Note: This sensor type cannot distinguish the status "not installed" from "not running".
This sensor type uses lookups to determine the status values of some sensor channels. For
details, please see section Define Lookups 2039 .
For a general introduction to the technology behind SNMP, please see Monit oring via SNMP
1955 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor services on Windows, PRTG will create one sensor for each service you
select. The settings you make in this dialog are valid for all of the sensors that are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Service Select the services you want to add a sensor for. A list of all
available items is shown with their name. Select the desired items
by adding check marks in front of the respective lines. One sensor
will be created for each selection. You can also select and deselect
all items by using the check box in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
1276 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
149 SNMP Windows Service Sensor
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
14.01.2014 1277
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
149 SNMP Windows Service Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
1278 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
149 SNMP Windows Service Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
14.01.2014 1279
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
149 SNMP Windows Service Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1280 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
150 SNTP Sensor
The SNTP Sensor monitors a Simple Network Time Protocol (SNTP) server. It returns the
response time and the time difference in comparison to the local system time.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Timeout (Sec.) Enter a timeout in seconds. If the reply takes longer than this value
the request is aborted and an error message is triggered. The
maximum timeout value is 900 seconds (equals 15 minutes).
03.04.2014 1281
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
150 SNTP Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
1282 03.04.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
150 SNTP Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
03.04.2014 1283
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
150 SNTP Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
1284 03.04.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
150 SNTP Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
03.04.2014 1285
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
151 SSH Disk Free Sensor
The SSH Disk Free sensor monitors free space on disks of a Linux/Unix system using Secure
Shell (SSH). It shows the total free disk space (sum), and the free disk space in percent for
every mounted partition (volume).
Note: The free space returned by this sensor type shows the available disk space of the
volume, minus a reserve defined for this volume (e.g. for redundancy purposes). So, this
sensor shows the disk space that is actually available for use. The size of the reserved disk
space can be defined with tune2fs. For details, please see the article linked in the More 1293
section below.
For this sensor type credentials for Linux/Solaris/Mac OS (SSH/WBEM) systems must be
defined for the device you want to use the sensor on.
Note: Not all Linux/Unix and Mac OS distributions can be supported by this sensor type.
For a general introduction to SSH monitoring, please see Monit oring via SSH 1962 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
1286 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
151 SSH Disk Free Sensor
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
SSH Specific
Connection Timeout Define a timeout for the connection. This is the the time the sensor
(Sec.) waits to establish a connection to the host. You should keep this
value as low as possible.
Shell Timeout (Sec.) Define a timeout for the shell response. This is the time in seconds
the sensor waits for the shell to return a response after it has sent
its specific command (e.g. cat /proc/loadavg).
SSH Port Define which port this sensor will use for the SSH connection.
Choose between:
§ Inherit port number from parent device (default ): Use the
port number as defined in the Credentials for Linux/Solaris/Mac
OS (SSH/WBEM) Systems section of the device this sensor is
created on.
§ Ent er cust om port number: Do not use the port number from
the parent device's settings, but define a different port number
below.
Use Port Number This field is only visible if the custom port number setting is enabled
above. Enter the port number this sensor will use for the SSH
connection. Please enter an integer value.
Result Handling Define what will be done with the result of the sensor. Choose
between:
§ Discard sensor result : Do not store the sensor result.
§ Writ e sensor result t o disk (Filename: "Result of Sensor
[ID].t xt "): Store the last result received from the sensor to the
"Logs (Sensor)" directory (on the Master node, if in a cluster). File
name: Result of Sensor [ID].txt. This is for debugging purposes.
The file will be overridden with each scanning interval. For
information on how to find the folder used for storage, please
see Dat a St orage 2074 section.
28.05.2014 1287
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
151 SSH Disk Free Sensor
In this section you can set limits that are valid for all channels and all drives. By entering
limits, you can define when the sensor will enter a Warning or Down status; depending on
the data provided by all drives that this sensor monitors. If you want to define limits for
separate channels individually please use the limit settings in the sensor's Channels settings.
Note: All limits defined here are valid additionally to the limits defined in the particular
Channels settings!
Percentage Limit Check Enable or disable a limit check for the free space in percentage
channels of all drives. By default percentage limits are enabled with
lower warning and lower error limit. Choose between:
· Disable Percent age Limit s: Do not use the drives' data to
control the sensor's status.
· Enable Percent age Limit s: Define limits. Additional fields appear
below. The sensor will enter a warning or down state when free
space limits are undercut or overrun.
Upper Error Limit This field is only visible if percentage limit check is enabled above.
Specify an upper limit in percent for a Down status. If the free disk
space of one of your drives overruns this percent value, the sensor
will be set to Down. Please enter an integer value or leave the field
empty. Note: The limits set here are valid for all channels of this
sensor. You can additionally set individual limits for each sensor
channel in the Sensor Channels Set t ings 1709 . The limits set here
and in the channel settings are valid simultaneously!
Upper Warning Limit This field is only visible if percentage limit check is enabled above.
Specify an upper limit in percent for a Warning status. If the free
disk space of one of your drives overruns this percent value, the
sensor will be set to Warning. Please enter an integer value or
leave the field empty. Note: The limits set here are valid for all
channels of this sensor. You can additionally set individual limits for
each sensor channel in the Sensor Channels Set t ings 1709 . The
limits set here and in the channel settings are valid simultaneously!
Lower Warning Limit This field is only visible if percentage limit check is enabled above.
Specify a lower limit in percent for a warning state. If the free disk
space of one of your drives undercuts this percent value, the
sensor will be set to warning. Please enter an integer value or
leave the field empty. Note: The limits set here are valid for all
channels of this sensor. You can additionally set individual limits for
each sensor channel in the Sensor Channels Set t ings 1709 . The
limits set here and in the channel settings are valid simultaneously!
1288 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
151 SSH Disk Free Sensor
Lower Error Limit This field is only visible if percentage limit check is enabled above.
Specify a lower limit in percent for entering a Down status. If the
free disk space of one of your drives undercuts this percent value,
the sensor will be set to Down. Please enter an integer value or
leave the field empty. Note: The limits set here are valid for all
channels of this sensor. You can additionally set individual limits for
each sensor channel in the Sensor Channels Set t ings 1709 . The
limits set here and in the channel settings are valid simultaneously!
Byte Limit Check Enable or disable a limit check for the free bytes channels of all
drives. Choose between:
· Disable By t e Limit s: Do not use the drives' data to control the
sensor's status.
· Enable By t e Limit s: Define limits. Additional fields appear below.
The sensor will enter a warning or down state when free space
limits are undercut or overrun.
Upper Error Limit This field is only visible if byte limit check is enabled above. Specify
an upper limit. Use the same unit as shown by the free bytes
channels of this sensor (by default this is MByte). If the free disk
space of one of your drives overruns this bytes value, the sensor
will be set to Down. Please enter an integer value or leave the field
empty. Note: The limits set here are valid for all channels of this
sensor. You can additionally set individual limits for each sensor
channel in the Sensor Channels Set t ings 1709 . The limits set here
and in the channel settings are valid simultaneously!
Upper Warning Limit This field is only visible if byte limit check is enabled above. Specify
an upper limit. Use the same unit as shown by the free bytes
channels of this sensor (by default this is MByte). If the free disk
space of one of your drives overruns this bytes value, the sensor
will be set to Warning. Please enter an integer value or leave the
field empty. Note: The limits set here are valid for all channels of
this sensor. You can additionally set individual limits for each
sensor channel in the Sensor Channels Set t ings 1709 . The limits set
here and in the channel settings are valid simultaneously!
Lower Warning Limit This field is only visible if byte limit check is enabled above. Specify
a lower limit. Use the same unit as shown by the free bytes
channels of this sensor (by default this is MByte). If the free disk
space of one of your drives undercuts this bytes value, the sensor
will be set to Warning. Please enter an integer value or leave the
field empty. Note: The limits set here are valid for all channels of
this sensor. You can additionally set individual limits for each
sensor channel in the Sensor Channels Set t ings 1709 . The limits set
here and in the channel settings are valid simultaneously!
28.05.2014 1289
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
151 SSH Disk Free Sensor
Lower Error Limit This field is only visible if byte limit check is enabled above. Specify
a lower limit. Use the same unit as shown by the free bytes
channels of this sensor (by default this is MByte). If the free disk
space of one of your drives undercuts this bytes value, the sensor
will be set to Down. Please enter an integer value or leave the field
empty. Note: The limits set here are valid for all channels of this
sensor. You can additionally set individual limits for each sensor
channel in the Sensor Channels Set t ings 1709 . The limits set here
and in the channel settings are valid simultaneously!
Alarm on Missing/ If a monitored disk is removed or not found, values are set to zero.
Removed Disk Select the alarming approach in this case. Choose between:
§ Deact ivat e alarm (default ): Select this option if you do not
want an alarm for a removed disk.
§ Act ivat e Alarm: Select this option if you want to be alerted if a
monitored disk is removed.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
1290 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
151 SSH Disk Free Sensor
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
28.05.2014 1291
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
151 SSH Disk Free Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
1292 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
151 SSH Disk Free Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
More
Knowledge Base: How and Where Does PRTG Store its Data?
28.05.2014 1293
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
151 SSH Disk Free Sensor
§ http://kb.paessler.com/en/topic/463
Knowledge Base: Why do SSH Disk Free and SNMP Linux Disk Free show different values for
my target Linux system?
§ http://kb.paessler.com/en/topic/43183
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1294 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
152 SSH INodes Free Sensor
The SSH INodes Free sensor monitors the free index nodes on disks of Linux/Unix and Mac OS
systems via Secure Shell (SSH). It shows the free index nodes in percent, for each mount in an
own sensor channel.
UNIX file systems only allow a limited number of index nodes. If the limit is exceeded, no more
data can be stored, although there might be still free space available. This sensor can help you
to notice early on if one of your drives is running out of INodes.
For this sensor type credentials for Linux/Solaris/Mac OS (SSH/WBEM) systems must be
defined for the device you want to use the sensor on.
Note: Not all Linux/Unix and Mac OS distributions can be supported by this sensor type.
For a general introduction to SSH monitoring, please see Monit oring via SSH 1962 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
03.04.2014 1295
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
152 SSH INodes Free Sensor
SSH Specific
Connection Timeout Define a timeout for the connection. This is the the time the sensor
(Sec.) waits to establish a connection to the host. You should keep this
value as low as possible.
Shell Timeout (Sec.) Define a timeout for the shell response. This is the time in seconds
the sensor waits for the shell to return a response after it has sent
its specific command (e.g. cat /proc/loadavg).
SSH Port Define which port this sensor will use for the SSH connection.
Choose between:
§ Inherit port number from parent device (default ): Use the
port number as defined in the Credentials for Linux/Solaris/Mac
OS (SSH/WBEM) Systems section of the device this sensor is
created on.
§ Ent er cust om port number: Do not use the port number from
the parent device's settings, but define a different port number
below.
Use Port Number This field is only visible if the custom port number setting is enabled
above. Enter the port number this sensor will use for the SSH
connection. Please enter an integer value.
Result Handling Define what will be done with the result of the sensor. Choose
between:
§ Discard sensor result : Do not store the sensor result.
§ Writ e sensor result t o disk (Filename: "Result of Sensor
[ID].t xt "): Store the last result received from the sensor to the
"Logs (Sensor)" directory (on the Master node, if in a cluster). File
name: Result of Sensor [ID].txt. This is for debugging purposes.
The file will be overridden with each scanning interval. For
information on how to find the folder used for storage, please
see Dat a St orage 2074 section.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
1296 03.04.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
152 SSH INodes Free Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
03.04.2014 1297
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
152 SSH INodes Free Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
1298 03.04.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
152 SSH INodes Free Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
03.04.2014 1299
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
152 SSH INodes Free Sensor
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
More
Knowledge Base: How and Where Does PRTG Store its Data?
§ http://kb.paessler.com/en/topic/463
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1300 03.04.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
153 SSH Load Average Sensor
The SSH Load Average sensor monitors the load average of a Linux/Unix system using Secure
Shell (SSH). It shows the average system load within a one, five, and 15 minutes interval (each
in one channel).
For this sensor type credentials for Linux/Solaris/Mac OS (SSH/WBEM) systems must be
defined for the device you want to use the sensor on.
Note: Not all Linux/Unix and Mac OS distributions can be supported by this sensor type.
For a general introduction to SSH monitoring, please see Monit oring via SSH 1962 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
27.11.2012 1301
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
153 SSH Load Average Sensor
SSH Specific
Connection Timeout Define a timeout for the connection. This is the the time the sensor
(Sec.) waits to establish a connection to the host. You should keep this
value as low as possible.
Shell Timeout (Sec.) Define a timeout for the shell response. This is the time in seconds
the sensor waits for the shell to return a response after it has sent
its specific command (e.g. cat /proc/loadavg).
SSH Port Define which port this sensor will use for the SSH connection.
Choose between:
§ Inherit port number from parent device (default ): Use the
port number as defined in the Credentials for Linux/Solaris/Mac
OS (SSH/WBEM) Systems section of the device this sensor is
created on.
§ Ent er cust om port number: Do not use the port number from
the parent device's settings, but define a different port number
below.
Use Port Number This field is only visible if the custom port number setting is enabled
above. Enter the port number this sensor will use for the SSH
connection. Please enter an integer value.
Result Handling Define what will be done with the result of the sensor. Choose
between:
§ Discard sensor result : Do not store the sensor result.
§ Writ e sensor result t o disk (Filename: "Result of Sensor
[ID].t xt "): Store the last result received from the sensor to the
"Logs (Sensor)" directory (on the Master node, if in a cluster). File
name: Result of Sensor [ID].txt. This is for debugging purposes.
The file will be overridden with each scanning interval. For
information on how to find the folder used for storage, please
see Dat a St orage 2074 section.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
1302 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
153 SSH Load Average Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
27.11.2012 1303
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
153 SSH Load Average Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
1304 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
153 SSH Load Average Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
27.11.2012 1305
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
153 SSH Load Average Sensor
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
More
Knowledge Base: How and Where Does PRTG Store its Data?
§ http://kb.paessler.com/en/topic/463
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1306 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
154 SSH Meminfo Sensor
The SSH Meminfo sensor monitors the memory usage of a Linux/Unix system using Secure
Shell (SSH). It shows the available memory in total and in percent. Note: This sensor type is not
compatible with Mac OS systems.
For this sensor type credentials for Linux/Solaris/Mac OS (SSH/WBEM) systems must be
defined for the device you want to use the sensor on.
Note: Not all Linux/Unix and Mac OS distributions can be supported by this sensor type.
For a general introduction to SSH monitoring, please see Monit oring via SSH 1962 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
27.11.2012 1307
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
154 SSH Meminfo Sensor
SSH Specific
Connection Timeout Define a timeout for the connection. This is the the time the sensor
(Sec.) waits to establish a connection to the host. You should keep this
value as low as possible.
Shell Timeout (Sec.) Define a timeout for the shell response. This is the time in seconds
the sensor waits for the shell to return a response after it has sent
its specific command (e.g. cat /proc/loadavg).
SSH Port Define which port this sensor will use for the SSH connection.
Choose between:
§ Inherit port number from parent device (default ): Use the
port number as defined in the Credentials for Linux/Solaris/Mac
OS (SSH/WBEM) Systems section of the device this sensor is
created on.
§ Ent er cust om port number: Do not use the port number from
the parent device's settings, but define a different port number
below.
Use Port Number This field is only visible if the custom port number setting is enabled
above. Enter the port number this sensor will use for the SSH
connection. Please enter an integer value.
Result Handling Define what will be done with the result of the sensor. Choose
between:
§ Discard sensor result : Do not store the sensor result.
§ Writ e sensor result t o disk (Filename: "Result of Sensor
[ID].t xt "): Store the last result received from the sensor to the
"Logs (Sensor)" directory (on the Master node, if in a cluster). File
name: Result of Sensor [ID].txt. This is for debugging purposes.
The file will be overridden with each scanning interval. For
information on how to find the folder used for storage, please
see Dat a St orage 2074 section.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
1308 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
154 SSH Meminfo Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
27.11.2012 1309
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
154 SSH Meminfo Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
1310 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
154 SSH Meminfo Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
27.11.2012 1311
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
154 SSH Meminfo Sensor
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
More
Knowledge Base: How and Where Does PRTG Store its Data?
§ http://kb.paessler.com/en/topic/463
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1312 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
155 SSH Remote Ping Sensor
The SSH Remote Ping sensor remotely monitors the connectivity between a system running
Linux/OS X and an other device, using Internet Control Message Protocol (ICMP) echo
requests ("Ping") and Secure Shell (SSH). It can show packet loss, as well as minimum, maximum,
and average response times; all measured from the remote device you connect to.
For this sensor type credentials for Linux/Solaris/Mac OS (SSH/WBEM) systems must be
defined for the device you want to use the sensor on.
Note: Not all Linux/Unix and Mac OS distributions can be supported by this sensor type.
For a general introduction to SSH monitoring, please see Monit oring via SSH 1962 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
27.11.2012 1313
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
155 SSH Remote Ping Sensor
Target Enter the DNS name or IP address of the target device the Ping is
sent to. The sensor will remotely connect to the parent device it is
created on via SSH, then perform a Ping request from this remote
device to the target device/server. Please enter a string.
Packet Size (Bytes) Enter the packet size in bytes for the Ping. You can choose any
value between 1 and 10000. Please enter an integer value. We
recommend using the default value.
Packet Count Enter the number of packets that is sent with each scanning
interval.
Custom Parameter Optionally enter additional parameters that will be added at the end
of the ping command. Please do not use parameters that change
the output format of the result to make sure it can still be parsed.
You cannot enter another command here. Please enter a string or
leave the field empty.
SSH Specific
Connection Timeout Define a timeout for the connection. This is the the time the sensor
(Sec.) waits to establish a connection to the host. You should keep this
value as low as possible.
Shell Timeout (Sec.) Define a timeout for the shell response. This is the time in seconds
the sensor waits for the shell to return a response after it has sent
its specific command (e.g. cat /proc/loadavg).
SSH Port Define which port this sensor will use for the SSH connection.
Choose between:
§ Inherit port number from parent device (default ): Use the
port number as defined in the Credentials for Linux/Solaris/Mac
OS (SSH/WBEM) Systems section of the device this sensor is
created on.
§ Ent er cust om port number: Do not use the port number from
the parent device's settings, but define a different port number
below.
Use Port Number This field is only visible if the custom port number setting is enabled
above. Enter the port number this sensor will use for the SSH
connection. Please enter an integer value.
Result Handling Define what will be done with the result of the sensor. Choose
between:
§ Discard sensor result : Do not store the sensor result.
1314 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
155 SSH Remote Ping Sensor
SSH Specific
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
27.11.2012 1315
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
155 SSH Remote Ping Sensor
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
1316 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
155 SSH Remote Ping Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
27.11.2012 1317
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
155 SSH Remote Ping Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
More
Knowledge Base: How and Where Does PRTG Store its Data?
§ http://kb.paessler.com/en/topic/463
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
1318 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
155 SSH Remote Ping Sensor
Others
For more general information about settings, please see Object Set t ings 142 section.
27.11.2012 1319
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
156 SSH SAN Logical Disk Sensor
The SSH SAN Logical Disk sensor monitors a logical disk on a Storage Area Network (SAN) via
Secure Shell (SSH). The SAN has to provide a command-line interface (CLI) for this purpose. The
sensor can show the health status of the disk.
Note: This sensor type does not support every SAN, even if it provides a CLI. The sensor only
works with specific devices, for example, with the HP P2000.
Note: Sometimes the devices which you monitor with this sensor return status values which
are not officially documented so that the shown sensor status in PRTG differs from the "real"
device status. For more information regarding this issue, please see section More below.
For this sensor type, corresponding credentials must be defined in section Credent ials for
Linux/Solaris/Mac OS (SSH/WBEM) Sy st em in the settings of the device 272 you want to use
the sensor on.
For a general introduction to SSH monitoring, please see Monit oring via SSH 1962 section.
This sensor type uses lookups to determine the status values of some sensor channels. For
details, please see section Define Lookups 2039 .
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor volumes on an SAN device, PRTG will create one sensor for each volume
you choose. The settings you make in this dialog are valid for all of the sensors that are
created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Volume Select the volumes you want to add a sensor for. A list of all
available items is shown with their name. Select the desired items
by adding check marks in front of the respective lines. One sensor
will be created for each selection. You can also select and deselect
all items by using the check box in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
1320 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
156 SSH SAN Logical Disk Sensor
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
SSH Specific
Connection Timeout Define a timeout for the connection. This is the the time the sensor
(Sec.) waits to establish a connection to the host. You should keep this
value as low as possible.
Shell Timeout (Sec.) Define a timeout for the shell response. This is the time in seconds
the sensor waits for the shell to return a response after it has sent
its specific command (e.g. cat /proc/loadavg).
SSH Port Define which port this sensor will use for the SSH connection.
Choose between:
§ Inherit port number from parent device (default ): Use the
port number as defined in the Credentials for Linux/Solaris/Mac
OS (SSH/WBEM) Systems section of the device this sensor is
created on.
§ Ent er cust om port number: Do not use the port number from
the parent device's settings, but define a different port number
below.
Use Port Number This field is only visible if the custom port number setting is enabled
above. Enter the port number this sensor will use for the SSH
connection. Please enter an integer value.
Result Handling Define what will be done with the result of the sensor. Choose
between:
12.05.2014 1321
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
156 SSH SAN Logical Disk Sensor
SSH Specific
Volume Shows the volume that this sensor monitors. Once a sensor is
created this value cannot be changed. It is shown for reference
purposes only. If you need to change this, please add the sensor
anew.
Size Shows the size of the volume that this sensor monitors. Once a
sensor is created this value cannot be changed. It is shown for
reference purposes only. If you need to change this, please add
the sensor anew.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
1322 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
156 SSH SAN Logical Disk Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
12.05.2014 1323
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
156 SSH SAN Logical Disk Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
1324 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
156 SSH SAN Logical Disk Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
More
Knowledge Base: Why does my SSH SAN sensor show a wrong status?
12.05.2014 1325
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
156 SSH SAN Logical Disk Sensor
§ http://kb.paessler.com/en/topic/60145
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1326 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
157 SSH SAN Physical Disk Sensor
The SSH SAN Physical Disk sensor monitors a physical disk on a Storage Area Network (SAN)
via Secure Shell (SSH). The SAN has to provide a command-line interface (CLI) for this purpose.
The sensor can show the health status of the disk, the total number of I/O operations, as well
as the amount of transferred data.
Note: This sensor type does not support every SAN, even if it provides a CLI. The sensor only
works with specific devices, for example, with the HP P2000.
Note: Sometimes the devices which you monitor with this sensor return status values which
are not officially documented so that the shown sensor status in PRTG differs from the "real"
device status. For more information regarding this issue, please see section More below.
For this sensor type, corresponding credentials must be defined in section Credent ials for
Linux/Solaris/Mac OS (SSH/WBEM) Sy st em in the settings of the device 272 you want to use
the sensor on.
For a general introduction to SSH monitoring, please see Monit oring via SSH 1962 section.
This sensor type uses lookups to determine the status values of some sensor channels. For
details, please see section Define Lookups 2039 .
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor disks on an SAN device, PRTG will create one sensor for each disk you
choose. The settings you make in this dialog are valid for all of the sensors that are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Disk Select the disks you want to add a sensor for. A list of all available
items is shown with their name. Select the desired items by adding
check marks in front of the respective lines. One sensor will be
created for each selection. You can also select and deselect all
items by using the check box in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
12.05.2014 1327
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
157 SSH SAN Physical Disk Sensor
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
SSH Specific
Connection Timeout Define a timeout for the connection. This is the the time the sensor
(Sec.) waits to establish a connection to the host. You should keep this
value as low as possible.
Shell Timeout (Sec.) Define a timeout for the shell response. This is the time in seconds
the sensor waits for the shell to return a response after it has sent
its specific command (e.g. cat /proc/loadavg).
SSH Port Define which port this sensor will use for the SSH connection.
Choose between:
§ Inherit port number from parent device (default ): Use the
port number as defined in the Credentials for Linux/Solaris/Mac
OS (SSH/WBEM) Systems section of the device this sensor is
created on.
§ Ent er cust om port number: Do not use the port number from
the parent device's settings, but define a different port number
below.
Use Port Number This field is only visible if the custom port number setting is enabled
above. Enter the port number this sensor will use for the SSH
connection. Please enter an integer value.
Result Handling Define what will be done with the result of the sensor. Choose
between:
1328 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
157 SSH SAN Physical Disk Sensor
SSH Specific
Disk Shows the disk that this sensor monitors. Once a sensor is created
this value cannot be changed. It is shown for reference purposes
only. If you need to change this, please add the sensor anew.
Disk Name Shows the label of disk that this sensor monitors. Once a sensor is
created this value cannot be changed. It is shown for reference
purposes only. If you need to change this, please add the sensor
anew.
Size Shows the size of the disk that this sensor monitors. Once a
sensor is created this value cannot be changed. It is shown for
reference purposes only. If you need to change this, please add
the sensor anew.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
12.05.2014 1329
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
157 SSH SAN Physical Disk Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
1330 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
157 SSH SAN Physical Disk Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
12.05.2014 1331
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
157 SSH SAN Physical Disk Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
More
Knowledge Base: Why does my SSH SAN sensor show a wrong status?
1332 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
157 SSH SAN Physical Disk Sensor
§ http://kb.paessler.com/en/topic/60145
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
12.05.2014 1333
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
158 SSH SAN System Health Sensor
The SSH SAN System Health sensor monitors the system health of a Storage Area Network
(SAN) via Secure Shell (SSH). The SAN has to provide a command-line interface (CLI) for this
purpose. The sensor can show several metrics of the SAN, such as temperatures, voltages, the
overall unit status, as well as capacitor charge. Which monitoring data this sensor type can
show depends on the available measurement components on the SAN.
Note: This sensor type does not support every SAN, even if it provides a CLI. The sensor only
works with specific devices, for example, with the HP P2000.
Note: Sometimes the devices which you monitor with this sensor return status values which
are not officially documented so that the shown sensor status in PRTG differs from the "real"
device status. For more information regarding this issue, please see section More below.
For this sensor type, corresponding credentials must be defined in section Credent ials for
Linux/Solaris/Mac OS (SSH/WBEM) Sy st em in the settings of the device 272 you want to use
the sensor on.
For a general introduction to SSH monitoring, please see Monit oring via SSH 1962 section.
This sensor type uses lookups to determine the status values of some sensor channels. For
details, please see section Define Lookups 2039 .
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor the system health of an SAN device, PRTG will create one sensor for each
metric you choose. The settings you make in this dialog are valid for all of the sensors that are
created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Metric Select the metrics you want to add a sensor for. A list of all
available items is shown with their name. Select the desired items
by adding check marks in front of the respective lines. One sensor
will be created for each selection. You can also select and deselect
all items by using the check box in the table head.
1334 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
158 SSH SAN System Health Sensor
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Metric Shows the metric this sensor monitors. Once a sensor is created
this value cannot be changed. It is shown for reference purposes
only. If you need to change this, please add the sensor anew.
SSH Specific
Connection Timeout Define a timeout for the connection. This is the the time the sensor
(Sec.) waits to establish a connection to the host. You should keep this
value as low as possible.
Shell Timeout (Sec.) Define a timeout for the shell response. This is the time in seconds
the sensor waits for the shell to return a response after it has sent
its specific command (e.g. cat /proc/loadavg).
SSH Port Define which port this sensor will use for the SSH connection.
Choose between:
12.05.2014 1335
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
158 SSH SAN System Health Sensor
SSH Specific
Use Port Number This field is only visible if the custom port number setting is enabled
above. Enter the port number this sensor will use for the SSH
connection. Please enter an integer value.
Result Handling Define what will be done with the result of the sensor. Choose
between:
§ Discard sensor result : Do not store the sensor result.
§ Writ e sensor result t o disk (Filename: "Result of Sensor
[ID].t xt "): Store the last result received from the sensor to the
"Logs (Sensor)" directory (on the Master node, if in a cluster). File
name: Result of Sensor [ID].txt. This is for debugging purposes.
The file will be overridden with each scanning interval. For
information on how to find the folder used for storage, please
see Dat a St orage 2074 section.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
1336 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
158 SSH SAN System Health Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
12.05.2014 1337
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
158 SSH SAN System Health Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
1338 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
158 SSH SAN System Health Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
More
Knowledge Base: Why does my SSH SAN sensor show a wrong status?
12.05.2014 1339
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
158 SSH SAN System Health Sensor
§ http://kb.paessler.com/en/topic/60145
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1340 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
159 SSH Script Sensor
The SSH Script sensor connects to a Linux/Unix system via Secure Shell (SSH) and executes a
script file located on the target system. The sensor shows the execution time, and can show
one value returned by the executable file or script (in one channel only). For details about the
return value format please see the Applicat ion Programming Int erface (API) Definit ion 2031 .
Note: For security reasons, the script file must be stored on the target system. Please make
sure the script has executable rights.
Note: This sensor type can have a high impact on the performance of your monitoring system.
Please use it with care! We recommend using not more than 50 sensors, on each probe, of this
type of sensor.
For this sensor type credentials for Linux/Solaris/Mac OS (SSH/WBEM) systems must be
defined for the device you want to use the sensor on.
Note: Not all Linux/Unix and Mac OS distributions can be supported by this sensor type.
For a general introduction to SSH monitoring, please see Monit oring via SSH 1962 section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
28.05.2014 1341
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
159 SSH Script Sensor
Script Select a script file from the list. The drop down menu will list all
script files available in the /var/prtg/scripts directory on the target
Linux/Unix system. In order for the files to appear in this list, please
store them into this directory. Please make sure the script has
executable rights. In order for the sensor to show the expected
values and sensor status, your files must use the right format for
the returned values (in this case, exitcode:value:message to
stdout). The exitcode will determine the sensor status. For detailed
information on the expected return format and on how to build
custom sensors, please see the API documentation (Applicat ion
Programming Int erface (API) Definit ion 2031 ). There, find detailed
information the the "Custom Sensors" tab. For an example script,
please see More 1348 section below.
Value Type Define what kind of values your script file gives back. Choose
between:
§ Int eger: An integer is expected as return value. If the script gives
back a float, PRTG will display the value 0.
§ Float : A float is expected as return value, with a dot (.) between
pre-decimal position and decimal places. In this setting, the
sensor will also display integer values unless they don't produce
a buffer overflow.
§ Count er: Your script returns an integer which increases. PRTG
will show the difference between the values of two sensor
scans. Note: A counter must return an integer; float is not
supported here!
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
1342 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
159 SSH Script Sensor
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Script Shows the script that is executed with each sensor scan, as
defined on sensor creation. Once a sensor is created this value
cannot be changed. It is shown for reference purposes only. If you
need to change this, please add the sensor anew.
Parameters If your script file catches command line parameters, you can define
them here. Placeholders can be used as well. For a full list of all
placeholders please see the API documentation (Applicat ion
Programming Int erface (API) Definit ion 2031 ). Note: Please make
sure you write the placeholders in quotes to ensure that they are
working properly if their values contain blanks. Use single
quotation marks ' ' with PowerShell scripts, and double quotes " "
with all others. Please enter a string or leave the field empty.
Mutex Name Define any desired mutex name for the process. All EXE/Script
sensors having the same mutex name will be executed serially (not
simultaneously). This is useful if you use a lot of sensors and want
to avoid high resource usage caused by processes running
simultaneously. For links to more information, please see the More
438 section below. Please enter a string or leave the field empty.
Value Type Shows the expected value type, chosen on sensor creation. Once
a sensor is created this value cannot be changed. It is shown for
reference purposes only. If you need to change this, please add
the sensor anew. Note: The sensor cannot handle string values.
If Value Changes Define what shall be done in case the value of this sensor changes.
You can choose between:
· Ignore changes (default ): No action will be taken on change.
28.05.2014 1343
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
159 SSH Script Sensor
· Trigger 'On Change' not ificat ion: The sensor will send an
internal message indicating that its value has changed. In
combination with a Change Trigger, you can use this mechanism
to trigger a notification 1716 whenever the sensor value changes.
SSH Specific
Connection Timeout Define a timeout for the connection. This is the the time the sensor
(Sec.) waits to establish a connection to the host. You should keep this
value as low as possible.
Shell Timeout (Sec.) Define a timeout for the shell response. This is the time in seconds
the sensor waits for the shell to return a response after it has sent
its specific command (e.g. cat /proc/loadavg).
SSH Port Define which port this sensor will use for the SSH connection.
Choose between:
§ Inherit port number from parent device (default ): Use the
port number as defined in the Credentials for Linux/Solaris/Mac
OS (SSH/WBEM) Systems section of the device this sensor is
created on.
§ Ent er cust om port number: Do not use the port number from
the parent device's settings, but define a different port number
below.
Use Port Number This field is only visible if the custom port number setting is enabled
above. Enter the port number this sensor will use for the SSH
connection. Please enter an integer value.
Result Handling Define what will be done with the result of the sensor. Choose
between:
§ Discard sensor result : Do not store the sensor result.
§ Writ e sensor result t o disk (Filename: "Result of Sensor
[ID].t xt "): Store the last result received from the sensor to the
"Logs (Sensor)" directory (on the Master node, if in a cluster). File
name: Result of Sensor [ID].txt. This is for debugging purposes.
The file will be overridden with each scanning interval. For
information on how to find the folder used for storage, please
see Dat a St orage 2074 section.
1344 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
159 SSH Script Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
28.05.2014 1345
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
159 SSH Script Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
1346 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
159 SSH Script Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
28.05.2014 1347
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
159 SSH Script Sensor
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
More
Knowledge Base: Is there a shell script example for PRTG's SSH Script Sensor?
§ http://kb.paessler.com/en/topic/39513
Knowledge Base: What is the Mutex Name in PRTG's EXE/Script Sensor's settings?
§ http://kb.paessler.com/en/topic/6673
Knowledge Base: How and Where Does PRTG Store its Data?
§ http://kb.paessler.com/en/topic/463
Knowledge Base: How can I test if parameters are correctly transmitted to my script when
using an EXE/Script sensor?
§ http://kb.paessler.com/en/topic/11283
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
1348 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
159 SSH Script Sensor
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
28.05.2014 1349
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
160 SSH Script Advanced Sensor
The SSH Script Advanced sensor connects to a Linux/Unix system via Secure Shell (SSH) and
executes a script file located on the target system. The sensor can show values returned by
the script in multiple channels. The return value of this sensor must be valid XML. For details
about the return value format please see the Applicat ion Programming Int erface (API)
Definit ion 2031 .
Note: For security reasons, the script file must be stored on the target system. Please make
sure the script has executable rights.
Note: This sensor type can have a high impact on the performance of your monitoring system.
Please use it with care! We recommend using not more than 50 sensors, on each probe, of this
type of sensor.
For this sensor type credentials for Linux/Solaris/Mac OS (SSH/WBEM) systems must be
defined for the device you want to use the sensor on.
Note: Not all Linux/Unix and Mac OS distributions can be supported by this sensor type.
For a general introduction to SSH monitoring, please see Monit oring via SSH 1962 section.
PRTG does not support more than 50 sensor channels officially. Depending on the data used
with this sensor type, you might exceed the maximum number of supported sensor channels.
In this case, PRTG will try to display all sensor channels. However, please be aware that you will
experience limited usability and performance.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
1350 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
160 SSH Script Advanced Sensor
Script Select a script file from the list. The drop down menu will list all
script files available in the /var/prtg/scriptsxml directory on the
target Linux/Unix system. In order for the files to appear in this list,
please store them into this directory. Please make sure the script
has executable rights. In order for the sensor to show the
expected values and sensor status, your files must return the
expected XML format to standard output. Values and message
must be embedded in the XML. For detailed information on the
expected return format and on how to build custom sensors,
please see the API documentation (Applicat ion Programming
Int erface (API) Definit ion 2031 ). There, find detailed information the
the "Custom Sensors" tab.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Script Shows the script that is executed with each sensor scan, as
defined on sensor creation. Once a sensor is created this value
cannot be changed. It is shown for reference purposes only. If you
need to change this, please add the sensor anew.
12.05.2014 1351
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
160 SSH Script Advanced Sensor
Parameters If your script file catches command line parameters, you can define
them here. Placeholders can be used as well. For a full list of all
placeholders please see the API documentation (Applicat ion
Programming Int erface (API) Definit ion 2031 ). Note: Please make
sure you write the placeholders in quotes to ensure that they are
working properly if their values contain blanks. Use single
quotation marks ' ' with PowerShell scripts, and double quotes " "
with all others. Please enter a string or leave the field empty.
Mutex Name Define any desired mutex name for the process. All EXE/Script
sensors having the same mutex name will be executed serially (not
simultaneously). This is useful if you use a lot of sensors and want
to avoid high resource usage caused by processes running
simultaneously. For links to more information, please see the More
438 section below. Please enter a string or leave the field empty.
EXE Result Define what will be done with the results the executable file gives
back. Choose between:
· Discard EX E result : Do not store the requested web page.
· Writ e EX E result t o disk (Filename: "Result of Sensor
[ID].t xt "): Store the last result received from the script to the
"Logs (Sensors)" directory (on the Master node, if in a cluster).
This is for debugging purposes. The file will be overridden with
each scanning interval. For information on how to find the folder
used for storage, please see Dat a St orage 2074 section.
SSH Specific
Connection Timeout Define a timeout for the connection. This is the the time the sensor
(Sec.) waits to establish a connection to the host. You should keep this
value as low as possible.
Shell Timeout (Sec.) Define a timeout for the shell response. This is the time in seconds
the sensor waits for the shell to return a response after it has sent
its specific command (e.g. cat /proc/loadavg).
SSH Port Define which port this sensor will use for the SSH connection.
Choose between:
§ Inherit port number from parent device (default ): Use the
port number as defined in the Credentials for Linux/Solaris/Mac
OS (SSH/WBEM) Systems section of the device this sensor is
created on.
§ Ent er cust om port number: Do not use the port number from
the parent device's settings, but define a different port number
below.
1352 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
160 SSH Script Advanced Sensor
SSH Specific
Use Port Number This field is only visible if the custom port number setting is enabled
above. Enter the port number this sensor will use for the SSH
connection. Please enter an integer value.
Result Handling Define what will be done with the result of the sensor. Choose
between:
§ Discard sensor result : Do not store the sensor result.
§ Writ e sensor result t o disk (Filename: "Result of Sensor
[ID].t xt "): Store the last result received from the sensor to the
"Logs (Sensor)" directory (on the Master node, if in a cluster). File
name: Result of Sensor [ID].txt. This is for debugging purposes.
The file will be overridden with each scanning interval. For
information on how to find the folder used for storage, please
see Dat a St orage 2074 section.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
12.05.2014 1353
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
160 SSH Script Advanced Sensor
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
1354 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
160 SSH Script Advanced Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
12.05.2014 1355
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
160 SSH Script Advanced Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
More
Information about custom scripts and executables
1356 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
160 SSH Script Advanced Sensor
Knowledge Base: What is the Mutex Name in PRTG's EXE/Script Sensor's settings?
§ http://kb.paessler.com/en/topic/6673
Knowledge Base: How and Where Does PRTG Store its Data?
§ http://kb.paessler.com/en/topic/463
Knowledge Base: How can I test if parameters are correctly transmitted to my script when
using an EXE/Script sensor?
§ http://kb.paessler.com/en/topic/11283
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
12.05.2014 1357
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
161 SSH VMWare ESX(i) Disk Sensor
The SSH VMWare ESX(i) Disk sensor monitors free space on disks of a VMware ESX(i) system
using Secure Shell (SSH). It shows the free disk space for different mounts and total, in total
and percent values.
For this sensor type credentials for Linux/Solaris/Mac OS (SSH/WBEM) systems must be
defined for the device you want to use the sensor on.
Note: Not all Linux/Unix and Mac OS distributions can be supported by this sensor type.
For a general introduction to SSH monitoring, please see Monit oring via SSH 1962 section.
In the parent device's Credent ials for Linux/Solaris/Mac OS (SSH/WBEM) Sy st ems settings,
please use the root user of your VMware host for authentication! See More 1363 section below.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
1358 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
161 SSH VMWare ESX(i) Disk Sensor
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
SSH Specific
Connection Timeout Define a timeout for the connection. This is the the time the sensor
(Sec.) waits to establish a connection to the host. You should keep this
value as low as possible.
Shell Timeout (Sec.) Define a timeout for the shell response. This is the time in seconds
the sensor waits for the shell to return a response after it has sent
its specific command (e.g. cat /proc/loadavg).
SSH Port Define which port this sensor will use for the SSH connection.
Choose between:
§ Inherit port number from parent device (default ): Use the
port number as defined in the Credentials for Linux/Solaris/Mac
OS (SSH/WBEM) Systems section of the device this sensor is
created on.
§ Ent er cust om port number: Do not use the port number from
the parent device's settings, but define a different port number
below.
Use Port Number This field is only visible if the custom port number setting is enabled
above. Enter the port number this sensor will use for the SSH
connection. Please enter an integer value.
Result Handling Define what will be done with the result of the sensor. Choose
between:
§ Discard sensor result : Do not store the sensor result.
§ Writ e sensor result t o disk (Filename: "Result of Sensor
[ID].t xt "): Store the last result received from the sensor to the
"Logs (Sensor)" directory (on the Master node, if in a cluster). File
name: Result of Sensor [ID].txt. This is for debugging purposes.
The file will be overridden with each scanning interval. For
information on how to find the folder used for storage, please
see Dat a St orage 2074 section.
28.05.2014 1359
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
161 SSH VMWare ESX(i) Disk Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
1360 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
161 SSH VMWare ESX(i) Disk Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
28.05.2014 1361
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
161 SSH VMWare ESX(i) Disk Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
1362 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
161 SSH VMWare ESX(i) Disk Sensor
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
More
Knowledge Base: How and Where Does PRTG Store its Data?
§ http://kb.paessler.com/en/topic/463
Knowledge Base: Settings on ESXi 5 host when monitoring via SSH VMware ESX(i) Disk Sensor
§ http://kb.paessler.com/en/topic/32603
Knowledge Base: Why do I need root credentials when monitoring VMware hosts via SSH?
§ http://kb.paessler.com/en/topic/33763
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
28.05.2014 1363
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
162 Syslog Receiver Sensor
The Syslog Receiver sensor receives and analyzes syslog messages. It shows the overall
number of received syslog messages per second, warning and error messages per second, as
well as the number of dropped packets per second.
With the available filter options, you can define individually which types of messages will be
considered for monitoring and thus stored, and which messages will be recognized as warning
or error messages. Depending on the filters, received messages will be counted in the
respective channels. The messages are stored in an internal database for later analysis. The
received data will be available on your respective probe system as common files, as well as via
the web interface.
You can add the sensor to the probe device on the one hand; then the sensor will receive all
messages of the system running the probe. Alternatively, you can add the sensor to a specific
device to gain all messages from this device directly; this will make this sensor type faster than
just using source filters.
Note: This sensor type cannot be used in cluster mode. You can set it up on a local probe or
remote probe only, not on a cluster probe.
You can use syslog specific placeholders in notification templates in order to see the
messages when you receive a notification. See the More 1372 section below for more
information.
For a general introduction to the syslog receiver's configuration, please see section
Monit oring Sy slogs and SNMP Traps 1989 .
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
1364 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
162 Syslog Receiver Sensor
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Sy slog Specific
Listen on Port Enter the port the sensor will listen on for Syslog messages.
Usually port 514 is used. Please enter an integer value. We
recommend using the default value.
Purge Messages After Define how long received syslog messages will be stored for
analysis. Choose a period of time from the drop down list.
Filt er
Include Filter Define if you want to filter syslog messages. If you leave this field
empty or use the keyword "any", all data will be processed. To
include specific types of messages only, define filters using a
special syntax. For more information, see section Filt er Rules 1370 .
Exclude Filter Define which types of syslog messages will be discarded and not
processed. To exclude specific types of messages, define filters
using a special syntax. For more information, see section Filt er
Rules 1370 .
Warning Filter Define which types of syslog messages will count for the Warnings
channel. To categorize received messages as warning messages,
define filters using a special syntax. For more information, see
section Filt er Rules 1370 .
28.05.2014 1365
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
162 Syslog Receiver Sensor
Filt er
Error Filter Define which types of syslog messages will count for the Errors
channel. To categorize received messages as error messages,
define filters using a special syntax. For more information, see
section Filt er Rules 1370 .
Note: Messages are collected until a scanning interval ends; as long
as the scanning interval is running, no status change will happen.
By default, the sensor will turn into a Down status after a scanning
interval has finished and there was at least one error message
during this interval. The status will remain Down at least until the
succeeding scanning interval has finished. If in this scanning interval
no warning or error message occurred, the status of the sensor
will turn Up again after the interval.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
1366 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
162 Syslog Receiver Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
28.05.2014 1367
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
162 Syslog Receiver Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
1368 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
162 Syslog Receiver Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
28.05.2014 1369
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
162 Syslog Receiver Sensor
Debugging
Log Data to Disk Define if the probe will write a log file of the received data to the
data folder (see Dat a St orage 2074 ) to the disk for debugging
purposes. Choose between:
§ Off (recommended): Do not write additional log files.
Recommended for normal use cases.
§ On: Write log files for all data received.
Note: Use with caution! When enabled, huge data files can be
created. Please use for a short time and for debugging purposes
only.
Filter rules are used for the include, exclude, warning, and error definition fields of the Syslog
Receiver sensor. They are based on the following format:
field[filter]
You can use various filters suitable to your needs. Include and exclude filters define which
messages will be monitored; warning and error filters define how received messages will be
categorized. Provide these filters in the sensor settings as formulas. Formulas are fields which
can be combined with boolean operators (AND, OR, NOT) and brackets.
1370 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
162 Syslog Receiver Sensor
Note: String parameters (except the substring in message) have to match exactly the particular
parts of the message; they are case sensitive!
Received syslog messages are stored as common files in PRTG's data folder (see section Dat a
St orage 2074 ). In order to review and analyze all received messages, you can access the most
recent data directly in PRTG's web interface via the Overview tab of the respective sensor in a
table list 156 . Note: Received syslogs are only shown after an (automatic) page refresh
following to a sensor scan in the table on the Overview tab (default for auto refresh 1812 is 30
seconds).
For more details and further filter options, click on the Messages tab of the Syslog Receiver
sensor. You will see all received messages in a table list 156 . On the top, you have display filter
options to drill down into the data for specific events of your interest. The filters are the same
as available in the sensor settings, but you can define them without using formulas. Provide
the desired parameters and PRTG will load the filtered list automatically.
28.05.2014 1371
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
162 Syslog Receiver Sensor
You can open advanced filter settings with a click on the gear icon in the Filt er row. The
Advanced Filt er will appear in a popup window. In the text field, you can define a filter using
the syntax as given in section Filt er Rules for Sy slog Messages 1370 . If you have provided filter
parameters on the Messages tab, these will be already included in the advanced filter as a
corresponding formula with the correct syntax. You can adjust this filter to your needs. You
can also copy the automatically created and manually adjusted formula for usage in the filter
fields of the sensor settings.
More
Blog Article: Introducing the New High Performance Syslog and SNMP Trap Receiver Sensors
§ http://www.paessler.com/blog/2013/10/11/prtg/introducing-the-new-high-performance-
syslog-and-snmp-trap-receiver-sensors
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1372 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
163 System Health Sensor
The System Health sensor monitors internal PRTG parameters. It shows the status of the
system. This sensor type is created automatically by PRTG and cannot be deleted. It checks
various parameters of your PRTG system which can affect the quality of the monitoring results:
§ Healt h: This index value sums up the probe state into a value between 100% (healthy) and
0% (failing). Frequent or repeated health values below 100% should be investigated.
§ Available Memory : This channel shows the amount of free memory available on the system.
This value should not fall below 500 MB. This way PRTG still can request resources during
report generation, auto-discoveries, and other issues.
§ Available Memory Percent : This channel shows the free memory available on the system in
percent.
§ CPU Load: This channel shows the current percentage CPU load. Extensive CPU load can lead
to false, incomplete, and incorrect monitoring results. This value usually should stay below
50%.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
03.05.2013 1373
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
163 System Health Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
1374 03.05.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
163 System Health Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
03.05.2013 1375
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
163 System Health Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1376 03.05.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
164 TFTP Sensor
The TFTP sensor monitors a Trivial File Transfer Protocol (TFTP) server and checks if a certain file
is available for download. It shows the availability.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Sensor Specific
Timeout (sec) Enter a timeout in seconds for the TFTP connect. If the reply takes
longer than this value the request is aborted and an error message
is triggered. Please enter an integer value.
Port Enter the number of the port the TFTP service is running on. The
sensor will try to connect to it. Please enter an integer value.
27.11.2012 1377
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
164 TFTP Sensor
Sensor Specific
Filename Enter the name of the file the sensor will check. If this filename is
not available on the server, the sensor's state will be set to down.
Please enter a string.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
1378 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
164 TFTP Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
27.11.2012 1379
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
164 TFTP Sensor
§ Mast er object for parent : Make this sensor the master object
for its parent device. The sensor will influence the behavior of
the device it is created on: If the sensor is in a Down status, the
device will be paused. For example, it is a good idea to make a
Ping sensor the master object for its parent device to pause
monitoring for all other sensors on the device in case the device
cannot even be pinged. Additionally, the sensor will be paused if
the parent group of its parent device is in a Down status, or if it
is paused by another dependency.
Note: Testing your dependencies is easy! Simply choose Simulat e
Error St at us from the context menu of an object that other
objects depend on. A few seconds later all dependent objects
should be paused.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
1380 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
164 TFTP Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
27.11.2012 1381
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
164 TFTP Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1382 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
165 Traceroute Hop Count Sensor
The Traceroute Hop Count sensor traces the number of hops needed from the probe system
the sensor is running on to the IP Address/DNS Name defined in the sensor's parent device.
It returns the number of hops. In case this number changes, you can additionally change the
sensor's status.
Note: This sensor type can have a high impact on the performance of your monitoring system.
Please use it with care! We recommend using not more than 50 sensors, on each probe, of this
type of sensor.
This sensor type requires the Microsoft .NET Framework to be installed on the computer
running the PRTG probe: Either on the local system (on every node, if on a cluster probe), or
on the system running the remote probe 2050 . If the framework is missing, you cannot create
this sensor. Note: You need to install the exact version required (a higher version will usually
not work; an exception applies to .NET 3.5 which comprises .NET 2.0 and .NET 3.0). Generally, it
is possible to run several .NET Framework versions on the same machine side-by-side. Please
install the latest update available for the required version.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
12.05.2014 1383
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
165 Traceroute Hop Count Sensor
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
If Route Changes Define what will be done in case the route has changed since the
last check. Choose between:
§ Ignore: Do not perform any action.
§ Set sensor t o "Warning": Set the sensor to warning status.
§ Set sensor t o "Error": Set the sensor to error status.
Sensor Result Define what will be done with the result of the sensor. Choose
between:
§ Discard sensor result : Do not store the sensor result.
§ Writ e sensor result t o disk (Filename: "Result of Sensor
[ID].t xt "): Store the last result received from the sensor to the
"Logs (Sensor)" directory (on the Master node, if in a cluster). File
name: Result of Sensor [ID].txt. This is for debugging purposes.
The file will be overridden with each scanning interval. For
information on how to find the folder used for storage, please
see Dat a St orage 2074 section.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
1384 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
165 Traceroute Hop Count Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
12.05.2014 1385
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
165 Traceroute Hop Count Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
1386 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
165 Traceroute Hop Count Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
12.05.2014 1387
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
165 Traceroute Hop Count Sensor
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1388 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
166 Virtuozzo Container Disk Sensor
server. This sensor must be created on a Windows server parent device running Virtuozzo.
For each container, it can show free disk space in percent, used disk space (kb-blocks),
allowed quota (kb-blocks), and hard limit (kb-blocks).
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Container Select all containers for which you want to create a sensor for disk
monitoring. A list of all available items is shown with their name.
Select the desired items by adding check marks in front of the
respective lines. One sensor will be created for each selection. You
can also select and deselect all items by using the check box in the
table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
28.05.2014 1389
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
166 Virtuozzo Container Disk Sensor
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Powered Off Define if the sensor will go into an error state if the container is
Containers powered off.
· Alarm when powered off: Set the sensor for a container to
error if the container is powered off.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
1390 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
166 Virtuozzo Container Disk Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
28.05.2014 1391
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
166 Virtuozzo Container Disk Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
1392 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
166 Virtuozzo Container Disk Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
28.05.2014 1393
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
166 Virtuozzo Container Disk Sensor
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1394 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
167 Virtuozzo Container Network Sensor
The Virtuozzo Container Network sensor monitors the network traffic of a container on a
device running Virtuozzo. For each container, it can show network usage as incoming and
outgoing bytes as well as its sum, and the number of incoming and outgoing packets.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Container Select all containers for which you want to create a sensor. A list
of all available items is shown with their name. Select the desired
items by adding check marks in front of the respective lines. One
sensor will be created for each selection. You can also select and
deselect all items by using the check box in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
28.05.2014 1395
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
167 Virtuozzo Container Network Sensor
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Powered Off Define if the sensor will go into an error state if the container is
Containers powered off.
· Alarm when powered off: Set the sensor for a container to
error if the container is powered off.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
1396 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
167 Virtuozzo Container Network Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
28.05.2014 1397
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
167 Virtuozzo Container Network Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
1398 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
167 Virtuozzo Container Network Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
28.05.2014 1399
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
167 Virtuozzo Container Network Sensor
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1400 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
168 VMware Host Hardware (WBEM) Sensor
The VMware Host Hardware sensor monitors hardware information of a ESX/ESXi server using
Web-Based Enterprise Management (WBEM). It shows the current reading and health state.
Note: The parent device must be a VMware ESX/ESXi server version 3.5, 4.0, 5.0, 5.1, or 5.5.
For this sensor type credentials for Linux/Solaris/Mac OS (SSH/WBEM) systems must be
defined for the device you want to use the sensor on.
Note: This sensor type can have a high impact on the performance of your monitoring system.
Please use it with care! We recommend using not more than 50 sensors, on each probe, of this
type of sensor.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
If you select more than one elements multiple sensors are created at once in the Add Sensor
dialog. The settings you make in this dialog are valid for all of the sensors that are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
ESX Element Select the hardware elements you want to add a sensor for. A list
of all available items is shown with their name. Select the desired
items by adding check marks in front of the respective lines. One
sensor will be created for each selection. You can also select and
deselect all items by using the check box in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
26.09.2013 1401
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
168 VMware Host Hardware (WBEM) Sensor
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Element Shows the ESX element monitored by this sensor. Once a sensor is
created this value cannot be changed. It is shown for reference
purposes only. If you need to change this, please add the sensor
anew.
Automatic Sensor Define if the sensor will change it's status dependent on the health
State state reading. Choose between:
§ Set sensor st at e aut omat ically t o 'Warning' or 'Down': Set
the sensor to a Warning or Down status when the server
returns respective values. The sensor will additionally change to
a Down status if the connection to the server fails.
§ Just report t he current reading, ignore Server Healt h Value:
Never change the sensor's status dependent on the values
returned by the server. The sensor will only change to a Down
status if the connection to the server fails.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
1402 26.09.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
168 VMware Host Hardware (WBEM) Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
26.09.2013 1403
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
168 VMware Host Hardware (WBEM) Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
1404 26.09.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
168 VMware Host Hardware (WBEM) Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
26.09.2013 1405
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
168 VMware Host Hardware (WBEM) Sensor
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1406 26.09.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
169 VMware Host Hardware Status (SOAP) Sensor
The VMware Host Hardware Status (SOAP) sensor monitors the hardware status of a VMware
host server using Simple Object Access Protocol (SOAP). It shows the total number of items in
"Normal", "Warning," and "Alert" states, just as shown in the vSphere client. This sensor is
intended to give you a general status overview for your host. Any states other than "Normal"
will be reported in the sensor message. Note: This sensor only shows items that report an
actual state; therefore you might see more "sensors" in your vSphere client than the number of
states available in the channels of this PRTG sensor.
Note: The parent device must be a VMware ESX/ESXi server version 3.5, 4.0, 5.0, 5.1, or 5.5.
We recommend to not use this sensor type on your vCenter. Reliable hardware information
can only be provided when this sensor is created on your physical host server as parent
device.
For this sensor type credentials for VMware servers must be defined for the device you want
to use the sensor on. Please make sure you enter a user with sufficient access rights to obtain
statistics (read-only should work).
Note: This sensor type can have a high impact on the performance of your monitoring system.
Please use it with care! We recommend using not more than 50 sensors, on each probe, of this
type of sensor.
This sensor type requires the Microsoft .NET Framework to be installed on the computer
running the PRTG probe: Either on the local system (on every node, if on a cluster probe), or
on the system running the remote probe 2050 . If the framework is missing, you cannot create
this sensor. Note: You need to install the exact version required (a higher version will usually
not work; an exception applies to .NET 3.5 which comprises .NET 2.0 and .NET 3.0). Generally, it
is possible to run several .NET Framework versions on the same machine side-by-side. Please
install the latest update available for the required version.
If you set up this sensor on different probes (for example, when using remote probes 2050 or
when running a cluster 81 setup), you might need to change the settings of your VMware
host, so it accepts more incoming connections. Otherwise you might get connection timeouts
when running plenty of VMware sensors with a short scanning interval.
For details about this setting, please see More section below.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
03.05.2013 1407
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
169 VMware Host Hardware Status (SOAP) Sensor
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Host Server Select the host server you want to add a sensor for. A list of all
available items is shown with their name. Select the desired items
by adding check marks in front of the respective lines. One sensor
will be created for each selection. You can also select and deselect
all items by using the check box in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
1408 03.05.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
169 VMware Host Hardware Status (SOAP) Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
03.05.2013 1409
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
169 VMware Host Hardware Status (SOAP) Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
1410 03.05.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
169 VMware Host Hardware Status (SOAP) Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
03.05.2013 1411
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
169 VMware Host Hardware Status (SOAP) Sensor
More
Knowledge Base: How can I increase the connection limit on VMware systems?
§ http://kb.paessler.com/en/topic/30643
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1412 03.05.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
170 VMware Host Performance (SOAP) Sensor
The VMware Host Performance (SOAP) sensor monitors a VMware host server using Simple
Object Access Protocol (SOAP). It shows CPU (percent) and memory (absolute) usage, disk read
and write speed, and network received and transmitted speed of a VMware host server.
Note: The parent device must be a VMware ESX/ESXi server version 3.5, 4.0, 5.0, 5.1, or 5.5.
For this sensor type credentials for VMware servers must be defined for the device you want
to use the sensor on. Please make sure you enter a user with sufficient access rights to obtain
statics (read-only should work).
Note: This sensor type can have a high impact on the performance of your monitoring system.
Please use it with care! We recommend using not more than 50 sensors, on each probe, of this
type of sensor.
This sensor type requires the Microsoft .NET Framework to be installed on the computer
running the PRTG probe: Either on the local system (on every node, if on a cluster probe), or
on the system running the remote probe 2050 . If the framework is missing, you cannot create
this sensor. Note: You need to install the exact version required (a higher version will usually
not work; an exception applies to .NET 3.5 which comprises .NET 2.0 and .NET 3.0). Generally, it
is possible to run several .NET Framework versions on the same machine side-by-side. Please
install the latest update available for the required version.
If you set up this sensor on different probes (for example, when using remote probes 2050 or
when running a cluster 81 setup), you might need to change the settings of your VMware
host, so it accepts more incoming connections. Otherwise you might get connection timeouts
when running plenty of VMware sensors with a short scanning interval.
For details about this setting, please see More section below.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
07.02.2013 1413
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
170 VMware Host Performance (SOAP) Sensor
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
1414 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
170 VMware Host Performance (SOAP) Sensor
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
07.02.2013 1415
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
170 VMware Host Performance (SOAP) Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
1416 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
170 VMware Host Performance (SOAP) Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
More
Knowledge Base: How can I increase the connection limit on VMware systems?
§ http://kb.paessler.com/en/topic/30643
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
07.02.2013 1417
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
170 VMware Host Performance (SOAP) Sensor
Others
For more general information about settings, please see Object Set t ings 142 section.
1418 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
171 VMware Virtual Machine (SOAP) Sensor
The VMware Virtual Machine (SOAP) sensor monitors a virtual machine on a VMware host
server using Simple Object Access Protocol (SOAP). It shows CPU (percent) and memory
(absolute) usage, disk read and write speed, read and write latency, and network usage (total,
received, and transmitted) of a single virtual machine.
Note: The parent device must be a VMware ESX/ESXi server version 3.5, 4.0, 5.0, 5.1, or 5.5; or
a respective Virtual Center server. We recommend using Virtual Center as parent device,
because this way PRTG will continue to monitor your virtual machines also when they change
the physical host using vMotion.
For this sensor type credentials for VMware servers must be defined for the device you want
to use the sensor on. Please make sure you enter a user with sufficient access rights to obtain
statics (read-only should work).
Note: This sensor type can have a high impact on the performance of your monitoring system.
Please use it with care! We recommend using not more than 50 sensors, on each probe, of this
type of sensor.
This sensor type requires the Microsoft .NET Framework to be installed on the computer
running the PRTG probe: Either on the local system (on every node, if on a cluster probe), or
on the system running the remote probe 2050 . If the framework is missing, you cannot create
this sensor. Note: You need to install the exact version required (a higher version will usually
not work; an exception applies to .NET 3.5 which comprises .NET 2.0 and .NET 3.0). Generally, it
is possible to run several .NET Framework versions on the same machine side-by-side. Please
install the latest update available for the required version.
If you set up this sensor on different probes (for example, when using remote probes 2050 or
when running a cluster 81 setup), you might need to change the settings of your VMware
host, so it accepts more incoming connections. Otherwise you might get connection timeouts
when running plenty of VMware sensors with a short scanning interval.
For details about this setting, please see More section below.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Note: PRTG requests a full list of all virtual machines configured on the device. Therefore, it may
take a few seconds before the dialog is loaded.
12.05.2014 1419
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
171 VMware Virtual Machine (SOAP) Sensor
If you select more than one virtual machine, multiple sensors are created at once in the Add
Sensor dialog. The settings you make in this dialog are valid for all of the sensors that are
created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Virtual Machine You see a list of all virtual machines (VMs) available on the host
server on this device, including the ones that are not running. All
VMs are listed with name and the OS it is running on. Select the
desired items by adding check marks in front of the respective
lines. One sensor will be created for each selection. You can also
select and deselect all items by using the check box in the table
head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
1420 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
171 VMware Virtual Machine (SOAP) Sensor
MoID Shows the Managed Object ID (MoID) of the virtual machine. Once a
sensor is created this value cannot be changed. It is shown for
reference purposes only. If you need to change this, please add
the sensor anew.
Handling of "Powered Choose how the sensor will react to a virtual machine that is
off" VM powered off. Please choose between:
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
12.05.2014 1421
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
171 VMware Virtual Machine (SOAP) Sensor
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
1422 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
171 VMware Virtual Machine (SOAP) Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
12.05.2014 1423
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
171 VMware Virtual Machine (SOAP) Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
More
Knowledge Base: How can I increase the connection limit on VMware systems?
§ http://kb.paessler.com/en/topic/30643
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
1424 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
171 VMware Virtual Machine (SOAP) Sensor
Others
For more general information about settings, please see Object Set t ings 142 section.
12.05.2014 1425
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
172 WBEM Custom Sensor
The WBEM Custom Sensor performs a custom query via Web-Based Enterprise Management
(WBEM). It can show the total and channels received.
For this sensor type credentials for Linux/Solaris/Mac OS (SSH/WBEM) systems must be
defined for the device you want to use the sensor on.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Namespace Enter the namespace for the query. Default value is root /cimv2.
WBEM Query (WQL) Enter the WBEM Query that will be performed with every scanning
interval. It has to be written in CQL/WQL.
1426 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
172 WBEM Custom Sensor
Numeric Format Define the expected type of the returned values. Choose between:
§ Int eger: The query returns integer values.
§ Float : The query returns float values.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
14.01.2014 1427
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
172 WBEM Custom Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
1428 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
172 WBEM Custom Sensor
§ Mast er object for parent : Make this sensor the master object
for its parent device. The sensor will influence the behavior of
the device it is created on: If the sensor is in a Down status, the
device will be paused. For example, it is a good idea to make a
Ping sensor the master object for its parent device to pause
monitoring for all other sensors on the device in case the device
cannot even be pinged. Additionally, the sensor will be paused if
the parent group of its parent device is in a Down status, or if it
is paused by another dependency.
Note: Testing your dependencies is easy! Simply choose Simulat e
Error St at us from the context menu of an object that other
objects depend on. A few seconds later all dependent objects
should be paused.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
14.01.2014 1429
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
172 WBEM Custom Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
1430 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
172 WBEM Custom Sensor
More
For more tips and tricks regarding WQL scripts, please see the Paessler Knowledge Base and
search for WQL.
· http://www.paessler.com/knowledgebase
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
14.01.2014 1431
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
173 Windows CPU Load Sensor
The Windows CPU Load sensor monitors the CPU load on a computer via Windows
Performance Counters or Windows Management Instrumentation (WMI), as configured in the
"Windows Compatibility Options" of the parent device. It shows the CPU usage in percent.
Note: By default, this sensor type uses a hybrid approach, first trying to query data via
Windows Performance Counters (which needs less system resources), and using Windows
Management Instrumentation (WMI) as a fallback in case Performance Counters are not
available. When running in fallback mode, the sensor will re-try to connect via Performance
Counters after 24 hours. The default behavior can be changed in the Windows Compat ibilit y
Opt ions of the parent device's settings 280 this sensor is created on.
Sensors using the Windows Management Instrumentation (WMI) protocol have high impact on
the system performance! Try to stay below 200 WMI sensors per probe 77 . Above this number,
please consider using multiple Remot e Probes 2050 for load balancing.
For a general introduction to the technology behind WMI, please see Monit oring via WMI 1959
section.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on. In the parent device's 276 Credent ials for Windows Sy st ems settings,
please prefer using Windows domain credentials.
Note: If you use local credentials, please make sure the same Windows user accounts (with
same username and password) exist on both the system running the PRTG probe and the
target computer. If you fail to do so, a connection via Performance Counters will not be
possible. However, WMI connections may still work.
In order for this sensor to work with Windows Performance Counters, please make sure a
Windows version 2008 or later is installed on the computer running the PRTG probe: This is
either on the local system (on every node, if on a cluster probe), or on the system running a
remote probe 2050 . Note: The target system may well run on Windows 2003 or later.
In order for this sensor to work with Windows Performance Counters, please make sure the
Remote Registry Windows service is running on the target computer. If you fail to do so, a
connection via Performance Counters will not be possible. However, WMI connections may still
work.
To enable the service, please log in to the respective computer and open the services
manager (e.g. via services.msc). In the list, find the respective service and set its Start Type to
Automatic.
1432 19.07.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
173 Windows CPU Load Sensor
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Errors and invalid data This is an extended help field only. PRTG's WMI sensors are
equipped with the most efficient and accurate WMI queries.
However, Microsoft has changed (and will continue to do that in
the future) some WMI classes over the various Windows/
ServicePack/patchlevel versions, resulting in errors like "class not
valid" or "invalid data". Wherever possible PRTG features an
alternative query that might work in your specific circumstances.
When you keep getting errors for this sensor please try enabling
the alternative query method below.
Alternative query Choose the method PRTG uses to query via WMI. For compatibility
reasons, an alternative query method can be enabled. We
recommend using the default value. You can choose between:
19.07.2013 1433
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
173 Windows CPU Load Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
1434 19.07.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
173 Windows CPU Load Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
19.07.2013 1435
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
173 Windows CPU Load Sensor
§ Mast er object for parent : Make this sensor the master object
for its parent device. The sensor will influence the behavior of
the device it is created on: If the sensor is in a Down status, the
device will be paused. For example, it is a good idea to make a
Ping sensor the master object for its parent device to pause
monitoring for all other sensors on the device in case the device
cannot even be pinged. Additionally, the sensor will be paused if
the parent group of its parent device is in a Down status, or if it
is paused by another dependency.
Note: Testing your dependencies is easy! Simply choose Simulat e
Error St at us from the context menu of an object that other
objects depend on. A few seconds later all dependent objects
should be paused.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
1436 19.07.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
173 Windows CPU Load Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
19.07.2013 1437
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
174 Windows IIS 6.0 SMTP Received Sensor
The Windows IIS 6.0 SMTP Receiver Sensor monitors Microsoft's Internet Information Services
regarding the number of received emails for an IIS 6.0 SMTP service (Exchange 2003) using
Windows Performance Counters or Windows Management Instrumentation (WMI), as configured
in the "Windows Compatibility Options" of the parent device. It shows the number of messages,
the bytes, and the number of retries, per second for received messages.
Note: This service is not used by Exchange Server 2007 and higher. Exchange Server 2007
uses its own SMTP stack implemented in the Microsoft Exchange Transport service.
Note: By default, this sensor type uses a hybrid approach, first trying to query data via
Windows Performance Counters (which needs less system resources), and using Windows
Management Instrumentation (WMI) as a fallback in case Performance Counters are not
available. When running in fallback mode, the sensor will re-try to connect via Performance
Counters after 24 hours. The default behavior can be changed in the Windows Compat ibilit y
Opt ions of the parent device's settings 280 this sensor is created on.
Sensors using the Windows Management Instrumentation (WMI) protocol have high impact on
the system performance! Try to stay below 200 WMI sensors per probe 77 . Above this number,
please consider using multiple Remot e Probes 2050 for load balancing.
For a general introduction to the technology behind WMI, please see Monit oring via WMI 1959
section.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on. In the parent device's 276 Credent ials for Windows Sy st ems settings,
please prefer using Windows domain credentials.
Note: If you use local credentials, please make sure the same Windows user accounts (with
same username and password) exist on both the system running the PRTG probe and the
target computer. If you fail to do so, a connection via Performance Counters will not be
possible. However, WMI connections may still work.
In order for this sensor to work with Windows Performance Counters, please make sure a
Windows version 2008 or later is installed on the computer running the PRTG probe: This is
either on the local system (on every node, if on a cluster probe), or on the system running a
remote probe 2050 . Note: The target system may well run on Windows 2003 or later.
In order for this sensor to work with Windows Performance Counters, please make sure the
Remote Registry Windows service is running on the target computer. If you fail to do so, a
connection via Performance Counters will not be possible. However, WMI connections may still
work.
1438 19.07.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
174 Windows IIS 6.0 SMTP Received Sensor
To enable the service, please log in to the respective computer and open the services
manager (e.g. via services.msc). In the list, find the respective service and set its Start Type to
Automatic.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
19.07.2013 1439
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
174 Windows IIS 6.0 SMTP Received Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
1440 19.07.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
174 Windows IIS 6.0 SMTP Received Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
19.07.2013 1441
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
174 Windows IIS 6.0 SMTP Received Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
1442 19.07.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
174 Windows IIS 6.0 SMTP Received Sensor
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
19.07.2013 1443
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
175 Windows IIS 6.0 SMTP Sent Sensor
The Windows IIS 6.0 SMTP Sent Sensor monitors Microsoft's Internet Information Services
regarding the number of sent emails for an IIS 6.0 SMTP service (Exchange 2003) using
Windows Performance Counters or Windows Management Instrumentation (WMI), as configured
in the "Windows Compatibility Options" of the parent device. It shows the number of messages,
the bytes, and the number of retries, per second for sent messages.
Note: This service is not used by Exchange Server 2007 and higher. Exchange Server 2007
uses its own SMTP stack implemented in the Microsoft Exchange Transport service.
Note: By default, this sensor type uses a hybrid approach, first trying to query data via
Windows Performance Counters (which needs less system resources), and using Windows
Management Instrumentation (WMI) as a fallback in case Performance Counters are not
available. When running in fallback mode, the sensor will re-try to connect via Performance
Counters after 24 hours. The default behavior can be changed in the Windows Compat ibilit y
Opt ions of the parent device's settings 280 this sensor is created on.
Sensors using the Windows Management Instrumentation (WMI) protocol have high impact on
the system performance! Try to stay below 200 WMI sensors per probe 77 . Above this number,
please consider using multiple Remot e Probes 2050 for load balancing.
For a general introduction to the technology behind WMI, please see Monit oring via WMI 1959
section.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on. In the parent device's 276 Credent ials for Windows Sy st ems settings,
please prefer using Windows domain credentials.
Note: If you use local credentials, please make sure the same Windows user accounts (with
same username and password) exist on both the system running the PRTG probe and the
target computer. If you fail to do so, a connection via Performance Counters will not be
possible. However, WMI connections may still work.
In order for this sensor to work with Windows Performance Counters, please make sure a
Windows version 2008 or later is installed on the computer running the PRTG probe: This is
either on the local system (on every node, if on a cluster probe), or on the system running a
remote probe 2050 . Note: The target system may well run on Windows 2003 or later.
In order for this sensor to work with Windows Performance Counters, please make sure the
Remote Registry Windows service is running on the target computer. If you fail to do so, a
connection via Performance Counters will not be possible. However, WMI connections may still
work.
1444 19.07.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
175 Windows IIS 6.0 SMTP Sent Sensor
To enable the service, please log in to the respective computer and open the services
manager (e.g. via services.msc). In the list, find the respective service and set its Start Type to
Automatic.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
19.07.2013 1445
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
175 Windows IIS 6.0 SMTP Sent Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
1446 19.07.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
175 Windows IIS 6.0 SMTP Sent Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
19.07.2013 1447
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
175 Windows IIS 6.0 SMTP Sent Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
1448 19.07.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
175 Windows IIS 6.0 SMTP Sent Sensor
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
19.07.2013 1449
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
176 Windows IIS Application Sensor
The Windows IIS Application sensor monitors a Microsoft Internet Information Services server
using Windows Performance Counters or Windows Management Instrumentation (WMI), as
configured in the "Windows Compatibility Options" of the parent device. It can also monitor
applications that use IIS, such as Microsoft SharePoint or Microsoft Reporting Services (SSRS).
The sensor shows bytes sent and received as well as post, get, and CGI requests, not found
errors, anonymous and known users, and received and sent files, in number/second.
Note: By default, this sensor type uses a hybrid approach, first trying to query data via
Windows Performance Counters (which needs less system resources), and using Windows
Management Instrumentation (WMI) as a fallback in case Performance Counters are not
available. When running in fallback mode, the sensor will re-try to connect via Performance
Counters after 24 hours. The default behavior can be changed in the Windows Compat ibilit y
Opt ions of the parent device's settings 280 this sensor is created on.
Sensors using the Windows Management Instrumentation (WMI) protocol have high impact on
the system performance! Try to stay below 200 WMI sensors per probe 77 . Above this number,
please consider using multiple Remot e Probes 2050 for load balancing.
For a general introduction to the technology behind WMI, please see Monit oring via WMI 1959
section.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on. In the parent device's 276 Credent ials for Windows Sy st ems settings,
please prefer using Windows domain credentials.
Note: If you use local credentials, please make sure the same Windows user accounts (with
same username and password) exist on both the system running the PRTG probe and the
target computer. If you fail to do so, a connection via Performance Counters will not be
possible. However, WMI connections may still work.
In order for this sensor to work with Windows Performance Counters, please make sure a
Windows version 2008 or later is installed on the computer running the PRTG probe: This is
either on the local system (on every node, if on a cluster probe), or on the system running a
remote probe 2050 . Note: The target system may well run on Windows 2003 or later.
In order for this sensor to work with Windows Performance Counters, please make sure the
Remote Registry Windows service is running on the target computer. If you fail to do so, a
connection via Performance Counters will not be possible. However, WMI connections may still
work.
1450 19.07.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
176 Windows IIS Application Sensor
To enable the service, please log in to the respective computer and open the services
manager (e.g. via services.msc). In the list, find the respective service and set its Start Type to
Automatic.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
If you select more than one web service instance, multiple sensors are created at once in the
Add Sensor dialog. The settings you make in this dialog are valid for all of the sensors that are
created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Specify Instance You see a list of all web service instances running on this device.
There is also a "_Total" instance available. Select the desired items
by adding check marks in front of the respective lines. One sensor
will be created for each selection. You can also select and deselect
all items by using the check box in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
19.07.2013 1451
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
176 Windows IIS Application Sensor
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Instance The name of the web services instance that is monitored by this
sensor. Once a sensor is created this value cannot be changed. It
is shown for reference purposes only. If you need to change this,
please add the sensor anew.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
1452 19.07.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
176 Windows IIS Application Sensor
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
19.07.2013 1453
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
176 Windows IIS Application Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
1454 19.07.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
176 Windows IIS Application Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
19.07.2013 1455
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
176 Windows IIS Application Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1456 19.07.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
177 Windows Last Update Sensor
The Windows Last Update sensor reads the number of days since last Windows update from its
parent device and returns the number of days. Use threshold triggers 1716 to get notified in case
this number breaches a certain value.
Note: This sensor type can have a high impact on the performance of your monitoring system.
Please use it with care! We recommend using not more than 50 sensors, on each probe, of this
type of sensor.
This sensor type requires the Microsoft .NET Framework to be installed on the computer
running the PRTG probe: Either on the local system (on every node, if on a cluster probe), or
on the system running the remote probe 2050 . If the framework is missing, you cannot create
this sensor. Note: You need to install the exact version required (a higher version will usually
not work; an exception applies to .NET 3.5 which comprises .NET 2.0 and .NET 3.0). Generally, it
is possible to run several .NET Framework versions on the same machine side-by-side. Please
install the latest update available for the required version.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on. In the parent device's 276 Credent ials for Windows Sy st ems settings,
please prefer using Windows domain credentials.
Note: If you use local credentials, please make sure the same Windows user accounts (with
same username and password) exist on both the system running the PRTG probe and the
target computer. Otherwise the sensor cannot connect correctly.
Note: Your Windows credentials may not contain any double quotation marks ("). If they do,
this sensor will not work!
In order for this sensor to work, you need to enable the RemoteRegistry "Remote Registry"
Windows service on the target machine. To do so, please log in to this machine and open the
services manager (e.g. start services.msc). In the list of services, find the Remot e Regist ry
service and set its Start Type to Automatic.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
28.05.2014 1457
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
177 Windows Last Update Sensor
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Timeout (sec.) Define the timeout for the internal process. It will be killed if it has
not returned a result after this time. Please enter an integer value.
If Value Changes Define what will be done in case the value of this sensor changes.
You can choose between:
· Ignore changes (default ): No action will be taken on change.
· Trigger 'change' not ificat ion: The sensor will send an internal
message indicating that its value has changed. In combination
with a Change Trigger, you can use this mechanism to trigger a
notification 1716 whenever the sensor value changes.
1458 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
177 Windows Last Update Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
28.05.2014 1459
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
177 Windows Last Update Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
1460 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
177 Windows Last Update Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
28.05.2014 1461
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
177 Windows Last Update Sensor
More
Knowledge Base: Fixing a Protocol Error Appearing With Windows Last Update Sensor
§ http://kb.paessler.com/en/topic/41113
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1462 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
178 Windows Logged In Users Sensor
The Windows Logged In Users sensor queries the number of users logged in to a Windows
installation on the parent device. It returns the total number. You can optionally filter for
certain user names.
Note: This sensor type can have a high impact on the performance of your monitoring system.
Please use it with care! We recommend using not more than 50 sensors, on each probe, of this
type of sensor.
This sensor type requires the Microsoft .NET Framework to be installed on the computer
running the PRTG probe: Either on the local system (on every node, if on a cluster probe), or
on the system running the remote probe 2050 . If the framework is missing, you cannot create
this sensor. Note: You need to install the exact version required (a higher version will usually
not work; an exception applies to .NET 3.5 which comprises .NET 2.0 and .NET 3.0). Generally, it
is possible to run several .NET Framework versions on the same machine side-by-side. Please
install the latest update available for the required version.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on. In the parent device's 276 Credent ials for Windows Sy st ems settings,
please prefer using Windows domain credentials.
Note: If you use local credentials, please make sure the same Windows user accounts (with
same username and password) exist on both the system running the PRTG probe and the
target computer. Otherwise the sensor cannot connect correctly.
Note: Your Windows credentials may not contain any double quotation marks ("). If they do,
this sensor will not work!
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
28.05.2014 1463
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
178 Windows Logged In Users Sensor
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
User Filter (optional) To filter the value returned by certain user names, define them
here. Enter a comma separated list of user names, or leave the field
empty.
Processing of Users in Define how the user names entered above will be used. Choose
"User Filter" between:
§ Do not count users list ed in "User Filt er": Exclude the users
entered above from counting and only count other uses.
§ Only count users list ed in "User Filt er": Ignore all other users
and only count user names from the list entered above.
If Value Changes Define what will be done in case the value of this sensor changes.
You can choose between:
§ Ignore changes (default ): No action will be taken on change.
§ Trigger 'change' not ificat ion: The sensor will send an internal
message indicating that its value has changed. In combination
with a Change Trigger, you can use this mechanism to trigger a
notification 1716 whenever the sensor value changes.
1464 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
178 Windows Logged In Users Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
28.05.2014 1465
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
178 Windows Logged In Users Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
1466 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
178 Windows Logged In Users Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
28.05.2014 1467
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
178 Windows Logged In Users Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1468 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
179 Windows MSMQ Queue Length Sensor
The Windows MSMQ Queue Length sensor reads the number of messages in a Microsoft
Message Queue of the parent device. It gives back the total number.
Note: This sensor type can have a high impact on the performance of your monitoring system.
Please use it with care! We recommend using not more than 50 sensors, on each probe, of this
type of sensor.
This sensor type requires the Microsoft .NET Framework to be installed on the computer
running the PRTG probe: Either on the local system (on every node, if on a cluster probe), or
on the system running the remote probe 2050 . If the framework is missing, you cannot create
this sensor. Note: You need to install the exact version required (a higher version will usually
not work; an exception applies to .NET 3.5 which comprises .NET 2.0 and .NET 3.0). Generally, it
is possible to run several .NET Framework versions on the same machine side-by-side. Please
install the latest update available for the required version.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on. In the parent device's 276 Credent ials for Windows Sy st ems settings,
please prefer using Windows domain credentials.
Note: If you use local credentials, please make sure the same Windows user accounts (with
same username and password) exist on both the system running the PRTG probe and the
target computer. Otherwise the sensor cannot connect correctly.
Note: Your Windows credentials may not contain any double quotation marks ("). If they do,
this sensor will not work!
In order for this sensor to work, the MSMQ "Message Queuing" service must be started both
on the target system and on the computer running the PRTG probe: Either on the local system
(on every node, if on a cluster probe), or on the system running the remote probe 2050 .
Additionally, the MSMQ "Message Queuing" service must also be started on the target
computer.
To enable the service, please log in to the respective computer and open the services
manager (e.g. via services.msc). In the list, find the respective service and set its Start Type to
Automatic.
Depending on your Windows version you may first need to install the Microsoft Message
Queue (MSMQ) Server.
28.05.2014 1469
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
179 Windows MSMQ Queue Length Sensor
Note: When installing Microsoft Message Queue (MSMQ) Server, make sure you install it
including the Directory Service. Depending on your Windows installation this might have
different names, such as
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Message Queue You see a list showing the names of all message queues found on
the target device. If there are no message queues available, you will
see a corresponding message. Select the desired items by adding
check marks in front of the respective lines. One sensor will be
created for each selection. You can also select and deselect all
items by using the check box in the table head. Note: Sub-queues
are not supported by this sensor.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
1470 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
179 Windows MSMQ Queue Length Sensor
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Message Queue Shows the name of the task monitored by this sensor. The
following settings for this sensor differ in the 'Add Sensor' dialog in
comparison to the sensor's settings page:
Min. Message Age Optionally define an age in minutes the message has to be old. If
set, messages younger than this will not be regarded. If you leave
this field blank, the sensor will not check for the message age.
Please enter an integer value or leave the field empty.
If Value Changes Define what will be done in case the value of this sensor changes.
You can choose between:
· Ignore changes: No action will be taken on change.
· Trigger 'change' not ificat ion: The sensor will send an internal
message indicating that its value has changed. In combination
with a Change Trigger, you can use this mechanism to trigger a
notification 1716 whenever the sensor value changes.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
28.05.2014 1471
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
179 Windows MSMQ Queue Length Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
1472 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
179 Windows MSMQ Queue Length Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
28.05.2014 1473
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
179 Windows MSMQ Queue Length Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
More
Knowledge Base: How do I activate Message Queuing in my Windows installation?
§ http://kb.paessler.com/en/topic/25963
1474 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
179 Windows MSMQ Queue Length Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
28.05.2014 1475
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
180 Windows Network Card Sensor
The Windows Network Card sensor monitors bandwidth usage and traffic of a network
interface using Windows Performance Counters or Windows Management Instrumentation
(WMI), as configured in the "Windows Compatibility Options" of the parent device.
Note: By default, this sensor type uses a hybrid approach, first trying to query data via
Windows Performance Counters (which needs less system resources), and using Windows
Management Instrumentation (WMI) as a fallback in case Performance Counters are not
available. When running in fallback mode, the sensor will re-try to connect via Performance
Counters after 24 hours. The default behavior can be changed in the Windows Compat ibilit y
Opt ions of the parent device's settings 280 this sensor is created on.
Sensors using the Windows Management Instrumentation (WMI) protocol have high impact on
the system performance! Try to stay below 200 WMI sensors per probe 77 . Above this number,
please consider using multiple Remot e Probes 2050 for load balancing.
For a general introduction to the technology behind WMI, please see Monit oring via WMI 1959
section.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on. In the parent device's 276 Credent ials for Windows Sy st ems settings,
please prefer using Windows domain credentials.
Note: If you use local credentials, please make sure the same Windows user accounts (with
same username and password) exist on both the system running the PRTG probe and the
target computer. If you fail to do so, a connection via Performance Counters will not be
possible. However, WMI connections may still work.
In order for this sensor to work with Windows Performance Counters, please make sure a
Windows version 2008 or later is installed on the computer running the PRTG probe: This is
either on the local system (on every node, if on a cluster probe), or on the system running a
remote probe 2050 . Note: The target system may well run on Windows 2003 or later.
In order for this sensor to work with Windows Performance Counters, please make sure the
Remote Registry Windows service is running on the target computer. If you fail to do so, a
connection via Performance Counters will not be possible. However, WMI connections may still
work.
To enable the service, please log in to the respective computer and open the services
manager (e.g. via services.msc). In the list, find the respective service and set its Start Type to
Automatic.
1476 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
180 Windows Network Card Sensor
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
For devices with multiple network cards multiple sensors are created at once in the Add
Sensor dialog. The settings you make in this dialog are valid for all of the sensors that are
created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Network Interface Select the network card(s) you want to add a sensor for. A list of
all available items is shown with their name. Select the desired
items by adding check marks in front of the respective lines. One
sensor will be created for each selection. You can also select and
deselect all items by using the check box in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
14.01.2014 1477
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
180 Windows Network Card Sensor
Selected Interface Shows the name of the network card that this sensor is
monitoring. Once a sensor is created this value cannot be changed.
It is shown for reference purposes only. If you need to change this,
please add the sensor anew.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
§ Show in and out t raffic as posit ive and negat ive area chart :
Show channels for incoming and outgoing traffic as positive and
negative area chart. This will visualize your traffic in a clear way.
Note: This option cannot be used in combination with manual
Vertical Axis Scaling (available in the Sensor Channels Set t ings
1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
1478 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
180 Windows Network Card Sensor
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
14.01.2014 1479
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
180 Windows Network Card Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
1480 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
180 Windows Network Card Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
14.01.2014 1481
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
180 Windows Network Card Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1482 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
181 Windows Pagefile Sensor
The Windows Pagefile sensor monitors the Windows pagefile usage via Windows Performance
Counters or Windows Management Instrumentation (WMI), as configured in the "Windows
Compatibility Options" of the parent device. It shows the usage in percent. Note: This sensor
does not work with Windows 2000, because the respective WMI class does not exist on this
operating system!
Note: By default, this sensor type uses a hybrid approach, first trying to query data via
Windows Performance Counters (which needs less system resources), and using Windows
Management Instrumentation (WMI) as a fallback in case Performance Counters are not
available. When running in fallback mode, the sensor will re-try to connect via Performance
Counters after 24 hours. The default behavior can be changed in the Windows Compat ibilit y
Opt ions of the parent device's settings 280 this sensor is created on.
Sensors using the Windows Management Instrumentation (WMI) protocol have high impact on
the system performance! Try to stay below 200 WMI sensors per probe 77 . Above this number,
please consider using multiple Remot e Probes 2050 for load balancing.
For a general introduction to the technology behind WMI, please see Monit oring via WMI 1959
section.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on. In the parent device's 276 Credent ials for Windows Sy st ems settings,
please prefer using Windows domain credentials.
Note: If you use local credentials, please make sure the same Windows user accounts (with
same username and password) exist on both the system running the PRTG probe and the
target computer. If you fail to do so, a connection via Performance Counters will not be
possible. However, WMI connections may still work.
In order for this sensor to work with Windows Performance Counters, please make sure a
Windows version 2008 or later is installed on the computer running the PRTG probe: This is
either on the local system (on every node, if on a cluster probe), or on the system running a
remote probe 2050 . Note: The target system may well run on Windows 2003 or later.
In order for this sensor to work with Windows Performance Counters, please make sure the
Remote Registry Windows service is running on the target computer. If you fail to do so, a
connection via Performance Counters will not be possible. However, WMI connections may still
work.
19.07.2013 1483
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
181 Windows Pagefile Sensor
To enable the service, please log in to the respective computer and open the services
manager (e.g. via services.msc). In the list, find the respective service and set its Start Type to
Automatic.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
1484 19.07.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
181 Windows Pagefile Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
19.07.2013 1485
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
181 Windows Pagefile Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
1486 19.07.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
181 Windows Pagefile Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
19.07.2013 1487
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
181 Windows Pagefile Sensor
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1488 19.07.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
182 Windows Physical Disk Sensor
The Windows Physical Disk sensor monitors parameters of a physical disk of a Windows device
using Windows Performance Counters or Windows Management Instrumentation (WMI), as
configured in the "Windows Compatibility Options" of the parent device. It shows accumulated
disk read/write time and bytes, queue, split IO, etc. on physical disks.
Note: By default, this sensor type uses a hybrid approach, first trying to query data via
Windows Performance Counters (which needs less system resources), and using Windows
Management Instrumentation (WMI) as a fallback in case Performance Counters are not
available. When running in fallback mode, the sensor will re-try to connect via Performance
Counters after 24 hours. The default behavior can be changed in the Windows Compat ibilit y
Opt ions of the parent device's settings 280 this sensor is created on.
Sensors using the Windows Management Instrumentation (WMI) protocol have high impact on
the system performance! Try to stay below 200 WMI sensors per probe 77 . Above this number,
please consider using multiple Remot e Probes 2050 for load balancing.
For a general introduction to the technology behind WMI, please see Monit oring via WMI 1959
section.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on. In the parent device's 276 Credent ials for Windows Sy st ems settings,
please prefer using Windows domain credentials.
Note: If you use local credentials, please make sure the same Windows user accounts (with
same username and password) exist on both the system running the PRTG probe and the
target computer. If you fail to do so, a connection via Performance Counters will not be
possible. However, WMI connections may still work.
In order for this sensor to work with Windows Performance Counters, please make sure a
Windows version 2008 or later is installed on the computer running the PRTG probe: This is
either on the local system (on every node, if on a cluster probe), or on the system running a
remote probe 2050 . Note: The target system may well run on Windows 2003 or later.
In order for this sensor to work with Windows Performance Counters, please make sure the
Remote Registry Windows service is running on the target computer. If you fail to do so, a
connection via Performance Counters will not be possible. However, WMI connections may still
work.
To enable the service, please log in to the respective computer and open the services
manager (e.g. via services.msc). In the list, find the respective service and set its Start Type to
Automatic.
12.05.2014 1489
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
182 Windows Physical Disk Sensor
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Physical Disks You see a list showing the Name of the counters you can monitor
as well as the Inst ance, i.e. the respective logical disk (or '_Total'). If
there are no logical disks available, you will see a corresponding
message. From the list, choose all Name/Inst ance combinations
you want to monitor by adding a check mark in front of the
respective line (for example, choose '% Disk Read Time for C:').
A list of all available items is shown with their name. Select the
desired items by adding check marks in front of the respective
lines. One sensor will be created for each selection. You can also
select and deselect all items by using the check box in the table
head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
1490 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
182 Windows Physical Disk Sensor
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Display Name These fields show the parameters that are used to query data for
this sensor from the target device.Once a sensor is created this
value cannot be changed. It is shown for reference purposes only.
Instance
If you need to change this, please add the sensor anew.
WMI Class
Counter
Time Stamp
Time Frequency
Counter Type
Sensor Result Define what will be done with the result of the sensor. Choose
between:
§ Discard sensor result : Do not store the results.
§ Writ e sensor result t o disk (Filename: "Result of Sensor
[ID].t xt "): Store the last result received to the "Logs (System)"
directory (on the Master node, if in a cluster). This is for
debugging purposes. The file will be overridden with each
scanning interval. For information on how to find the folder used
for storage, please see Dat a St orage 2074 section.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
12.05.2014 1491
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
182 Windows Physical Disk Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
1492 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
182 Windows Physical Disk Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
12.05.2014 1493
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
182 Windows Physical Disk Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
1494 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
182 Windows Physical Disk Sensor
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
12.05.2014 1495
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
183 Windows Print Queue Sensor
The Windows Print Queue sensor reads the print queue on its parent device and gives back
the number of jobs in the print queue. It can monitor queues for all printers that are installed
locally. For example, you can use this sensor to monitor all print queues on your Windows
print server. Additionally, this sensor can change to a Warning status if there is a printer
problem, such as out of paper, etc.
Note: This sensor type can have a high impact on the performance of your monitoring system.
Please use it with care! We recommend using not more than 50 sensors, on each probe, of this
type of sensor.
This sensor type requires the Microsoft .NET Framework to be installed on the computer
running the PRTG probe: Either on the local system (on every node, if on a cluster probe), or
on the system running the remote probe 2050 . If the framework is missing, you cannot create
this sensor. Note: You need to install the exact version required (a higher version will usually
not work; an exception applies to .NET 3.5 which comprises .NET 2.0 and .NET 3.0). Generally, it
is possible to run several .NET Framework versions on the same machine side-by-side. Please
install the latest update available for the required version.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on. In the parent device's 276 Credent ials for Windows Sy st ems settings,
please prefer using Windows domain credentials.
Note: If you use local credentials, please make sure the same Windows user accounts (with
same username and password) exist on both the system running the PRTG probe and the
target computer. Otherwise the sensor cannot connect correctly.
Note: Your Windows credentials may not contain any double quotation marks ("). If they do,
this sensor will not work!
In order for this sensor to work, the Spooler "Print Spooler" service must be started on the
target computer.
To enable the service, please log in to the respective computer and open the services
manager (e.g. via services.msc). In the list, find the respective service and set its Start Type to
Automatic.
1496 13.06.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
183 Windows Print Queue Sensor
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Print Queue You see a list showing the names of all print queues found on the
target device. If there are no print queues available, you will see a
corresponding message. Select the desired items by adding check
marks in front of the respective lines. One sensor will be created
for each selection. You can also select and deselect all items by
using the check box in the table head. Note: If a printer name
changes after you created a sensor for its queue, please add the
sensor anew.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
13.06.2013 1497
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
183 Windows Print Queue Sensor
Print Queue Name Shows the name of the task monitored by this sensor. The
following settings for this sensor differ in the 'Add Sensor' dialog in
comparison to the sensor's settings page:
Min. Print Job Age Optionally define the age in sedonds. If set, jobs younger than this
(sec.) will not be regarded. If you leave this field blank, the sensor will not
check for the print job age. Please enter an integer value or leave
the field empty.
Set to Warning on Define if the sensor will change to a Warning status in case a
Problem Reported printer reports a problem. Choose between:
§ No
§ Yes
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
1498 13.06.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
183 Windows Print Queue Sensor
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
13.06.2013 1499
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
183 Windows Print Queue Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
1500 13.06.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
183 Windows Print Queue Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
13.06.2013 1501
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
184 Windows Registry Sensor
The Windows Registry sensor reads a string value from the Windows registry and can process
the result using a keyword search. The value is shown in the sensor's last message field. Note:
Only REG_SZ values can be processed with this sensor.
In order for this sensor to work, please make sure the RemoteRegistry "Remote Registry"
Windows service is running on both the computer running the PRTG probe and the target
machine.
To enable the service, please log in to the respective computer and open the services
manager (e.g. via services.msc). In the list, find the respective service and set its Start Type to
Automatic.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on.
Please make sure that the Windows user account running the PRTGProbeService "PRTG Probe
Service" on the computer running the PRTG probe has access to the registry of the remote
computer (by default, this is the probe computer's local Windows "system" account).
Additionally, the computer running the PRTG probe and the target computer must be member
of the same Windows local domain.
Note: You cannot perform a remote registry call with a Windows user account for which no
password is defined.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
1502 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
184 Windows Registry Sensor
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Root Select the root key of the registry entry you want to monitor.
Choose between:
§ HKEY_CLASSES_ROOT
§ HKEY_CURRENT_USER
§ HKEY_LOCAL_MACHINE
§ HKEY_USERS
§ HKEY_PERFORMANCE_DATA
§ HKEY_CURRENT_CONFIG
§ HKEY_DYN_DATA
Key Name Enter the path of the key you want to monitor. Enter the full path
after the root, each subkey divided by a backslash. For example,
enter Software\Microsoft\Windows\CurrentVersion
Value Name Enter the name of the value you want to monitor. For example,
enter ProductId to read the product ID of the target computer's
Windows installation.
64-Bit Selection Define how the provided key name will be looked up. This is
relevant for some registry keys only, for example those containing
the Wow6432Node subkey. Choose between:
§ Use 32-bit regist ry view: The key provided above is copied
from the 32-bit registry editor.
28.05.2014 1503
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
184 Windows Registry Sensor
Check For Existing This setting is only visible if text processing is activated above.
Keywords (Positive) Check if a certain keyword is part of the received value. If there is
no match, the sensor will show a "Down" status.
§ Disable: Do not check for positive keywords.
§ Enable key word check (posit ive): Check if a certain keyword
exists in the received value. Define below.
Text Must Include This setting is only visible if keyword check is activated above.
Enter a search string that must be contained in the returned value.
For Keyword Search Define the method you want to provide the search string with.
Use Choose between:
§ Plain Text : Search for a simple string.
§ Regular Expression: Search using a regular expression. For
more details, see Regular Expressions 2048 section.
Check For Existing This setting is only visible if text processing is activated above.
Keywords (Negative) Check if a certain keyword is not part of the received value. If
there is a match, the sensor will show a "Down" status.
Text Must Not Include This setting is only visible if keyword check is activated above.
Enter a search string that must not be contained in the returned
value.
For Keyword Search Define the method you want to provide the search string with.
Use Choose between:
1504 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
184 Windows Registry Sensor
Check For Existing This setting is only visible if text processing is activated above.
Keywords (Positive) Check if a certain keyword is part of the received value. If there is
no match, the sensor will show a "Down" status.
§ Disable: Do not check for positive keywords.
§ Enable key word check (posit ive): Check if a certain keyword
exists in the received value. Define below.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
28.05.2014 1505
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
184 Windows Registry Sensor
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
1506 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
184 Windows Registry Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
28.05.2014 1507
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
184 Windows Registry Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
More
How do I discern 32-bit registry values vs. 64-bit registry values?
§ http://kb.paessler.com/en/topic/25513
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
1508 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
184 Windows Registry Sensor
Others
For more general information about settings, please see Object Set t ings 142 section.
28.05.2014 1509
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
185 Windows Scheduled Task Sensor
The Windows Scheduled Task sensor returns the number of minutes since the last run of the
specified task as well as the corresponding exit code. If a task was never run, the sensor
shows an error. You can define limits (in minutes) in the channel settings 1709 for Last Run in
order to set the sensor into a warning or error status if the last run of the task was too long
ago.
Note: This sensor type can have a high impact on the performance of your monitoring system.
Please use it with care! We recommend using not more than 50 sensors, on each probe, of this
type of sensor.
This sensor type requires the Microsoft .NET Framework to be installed on the computer
running the PRTG probe: Either on the local system (on every node, if on a cluster probe), or
on the system running the remote probe 2050 . If the framework is missing, you cannot create
this sensor. Note: You need to install the exact version required (a higher version will usually
not work; an exception applies to .NET 3.5 which comprises .NET 2.0 and .NET 3.0). Generally, it
is possible to run several .NET Framework versions on the same machine side-by-side. Please
install the latest update available for the required version.
In order for this sensor to work, please make sure the RemoteRegistry "Remote Registry"
Windows service is running on both the computer running the PRTG probe and the target
machine.
To enable the service, please log in to the respective computer and open the services
manager (e.g. via services.msc). In the list, find the respective service and set its Start Type to
Automatic.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on. In the parent device's 276 Credent ials for Windows Sy st ems settings,
please prefer using Windows domain credentials.
Note: If you use local credentials, please make sure the same Windows user accounts (with
same username and password) exist on both the system running the PRTG probe and the
target computer. Otherwise the sensor cannot connect correctly.
Note: Your Windows credentials may not contain any double quotation marks ("). If they do,
this sensor will not work!
1510 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
185 Windows Scheduled Task Sensor
Microsoft implemented two versions of scheduled task, V1 and V2. Windows 2000, Windows
XP, and Windows Server 2003 create scheduled tasks V1 by default. Later Windows versions
can create and read both versions.
§ If the system running the PRTG probe (either on the core server or a remote probe) runs on
one of these early Windows versions, you will not be able to monitor scheduled tasks of V2.
In this case, please create the tasks on the monitored machines compatible with "Windows
Server 2003, Windows XP, or Windows 2000" if there is a newer Windows version installed.
Note: These Windows versions are not officially supported by PRTG; see section Sy st em
Requirement s 21 .
§ If the system running the PRTG probe (either on the core server or a remote probe) runs on
Windows Vista or later, you will be able to monitor scheduled tasks of both V1 and V2 (i.e.
from all Windows versions).
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor scheduled tasks, PRTG will create one sensor for each task you choose.
The settings you make in this dialog are valid for all of the sensors that are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Task Name You see a list showing the names of all tasks found in the Windows
Task Scheduler on the target device. If there are no scheduled
tasks, you will see a corresponding message. Select the desired
items by adding check marks in front of the respective lines. One
sensor will be created for each selection. You can also select and
deselect all items by using the check box in the table head. Note: If
a task name changes after you created a sensor for it, please add
the sensor anew.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
28.05.2014 1511
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
185 Windows Scheduled Task Sensor
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Ignore Status Codes Define exit codes of the monitored task which will not be
processed by the sensor. If the external program returns one of
these values, they will be converted into the code 0. Enter a
comma separated list of exit codes or leave this field empty.
Name Shows the name of the task monitored by this sensor. Once a
sensor is created this value cannot be changed. It is shown for
reference purposes only. If you need to change this, please add
the sensor anew.
If Value Changes Define what will be done if the value which the external program
returns changes. You can choose between:
· Ignore changes: No action will be taken on change.
· Trigger 'change' not ificat ion: The sensor will send an internal
message indicating that its value has changed. In combination
with a Change Trigger, you can use this mechanism to trigger a
notification 1716 whenever the sensor value changes.
1512 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
185 Windows Scheduled Task Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
28.05.2014 1513
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
185 Windows Scheduled Task Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
1514 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
185 Windows Scheduled Task Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
28.05.2014 1515
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
185 Windows Scheduled Task Sensor
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1516 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
186 Windows System Uptime Sensor
The Windows System Uptime sensor monitors uptime of a Windows system using Windows
Performance Counters or Windows Management Instrumentation (WMI), as configured in the
"Windows Compatibility Options" of the parent device. It returns the total uptime.
Note: By default, this sensor type uses a hybrid approach, first trying to query data via
Windows Performance Counters (which needs less system resources), and using Windows
Management Instrumentation (WMI) as a fallback in case Performance Counters are not
available. When running in fallback mode, the sensor will re-try to connect via Performance
Counters after 24 hours. The default behavior can be changed in the Windows Compat ibilit y
Opt ions of the parent device's settings 280 this sensor is created on.
Sensors using the Windows Management Instrumentation (WMI) protocol have high impact on
the system performance! Try to stay below 200 WMI sensors per probe 77 . Above this number,
please consider using multiple Remot e Probes 2050 for load balancing.
For a general introduction to the technology behind WMI, please see Monit oring via WMI 1959
section.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on. In the parent device's 276 Credent ials for Windows Sy st ems settings,
please prefer using Windows domain credentials.
Note: If you use local credentials, please make sure the same Windows user accounts (with
same username and password) exist on both the system running the PRTG probe and the
target computer. If you fail to do so, a connection via Performance Counters will not be
possible. However, WMI connections may still work.
In order for this sensor to work with Windows Performance Counters, please make sure a
Windows version 2008 or later is installed on the computer running the PRTG probe: This is
either on the local system (on every node, if on a cluster probe), or on the system running a
remote probe 2050 . Note: The target system may well run on Windows 2003 or later.
In order for this sensor to work with Windows Performance Counters, please make sure the
Remote Registry Windows service is running on the target computer. If you fail to do so, a
connection via Performance Counters will not be possible. However, WMI connections may still
work.
To enable the service, please log in to the respective computer and open the services
manager (e.g. via services.msc). In the list, find the respective service and set its Start Type to
Automatic.
27.11.2012 1517
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
186 Windows System Uptime Sensor
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
1518 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
186 Windows System Uptime Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
27.11.2012 1519
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
186 Windows System Uptime Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
1520 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
186 Windows System Uptime Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
27.11.2012 1521
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
186 Windows System Uptime Sensor
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1522 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
187 Windows Updates Status (Powershell) Sensor
The Windows Updates Status (Powershell) sensor monitors the status of Windows updates on
a computer and counts the available and installed Windows updates—either from Microsoft or
from the local Windows Server Update Services (WSUS) server. This sensor can show the time
elapsed since the last update, as well as the following numbers:
You can find the considered updates in Server Manager (WSUS) under Roles | Windows Server
Updat e Services | Updat e Services | Comput ers | Report s.
Note: If the sensor cannot determine the Time since last update (for example, because the list
of updates is empty), it will show the value -1s and turn into a Warning status.
Note: This sensor type can have a high impact on the performance of your monitoring system.
Please use it with care! We recommend using not more than 50 sensors, on each probe, of this
type of sensor.
Note: We recommend setting the scanning interval 1525 of this sensor to at least 12 hours to limit
the load on the server being monitored.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on.
This sensor type requires the Microsoft .NET Framework to be installed on the computer
running the PRTG probe: Either on the local system (on every node, if on a cluster probe), or
on the system running the remote probe 2050 . If the framework is missing, you cannot create
this sensor. Note: You need to install the exact version required (a higher version will usually
not work; an exception applies to .NET 3.5 which comprises .NET 2.0 and .NET 3.0). Generally, it
is possible to run several .NET Framework versions on the same machine side-by-side. Please
install the latest update available for the required version.
The Windows Updates Status (Powershell) sensor uses PowerShell commands. In order to
monitor devices with this sensor, Remot e PowerShell access has to be enabled on the target
computer. For detailed information, please see More 589 section below.
03.04.2014 1523
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
187 Windows Updates Status (Powershell) Sensor
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
1524 03.04.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
187 Windows Updates Status (Powershell) Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
03.04.2014 1525
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
187 Windows Updates Status (Powershell) Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
1526 03.04.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
187 Windows Updates Status (Powershell) Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
More
Knowledge Base: How do I enable and use remote commands in Windows PowerShell?
§ http://kb.paessler.com/en/topic/44453
Knowledge Base: My Powershell sensor returns an error message. What can I do?
03.04.2014 1527
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
187 Windows Updates Status (Powershell) Sensor
§ http://kb.paessler.com/en/topic/59473
Knowledge Base: "No Logon Servers Available" when Using PowerShell Sensors
§ http://kb.paessler.com/en/topic/59745
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1528 03.04.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
188 WMI Custom Sensor
The WMI Custom Sensor performs a custom query via Windows Management Instrumentation
(WMI).
Note: Your Windows Management Instrumentation Query Language (WQL) query code must be
stored in a file on the system of the probe the sensor is created on: If used on a remote
probe, the file must be stored on the system running the remote probe. In a cluster setup,
please copy the file to every cluster node.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on.
Note: Sensors using the Windows Management Instrumentation (WMI) protocol have high
impact on the system performance! Try to stay below 200 WMI sensors per probe 77 . Above
this number, please consider using multiple Remot e Probes 2050 for load balancing.
For a general introduction to the technology behind WMI, please see Monit oring via WMI 1959
section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Channel Name Enter a name for the channel in which the received data will be
presented. The name will be displayed in graphs and tables. Please
enter a string. You can change the name later in the sensor's
channel settings 1709 .
WQL File Select a file that will be used for this sensor from the drop down
menu. It will be executed with every scanning interval. The menu
contains WQL scripts from the \Cust om Sensors\WMI WQL
script s sub folder of your PRTG installation. Please store your
script there. If used on a remote probe, the file must be stored on
the system running the remote probe. If used on a cluster probe,
you must store the file on all servers running a cluster node! For
more information on how to find this path, please see Dat a
St orage 2074 section. Note: Your query must return an integer or
float value. Strings are not supported!
28.05.2014 1529
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
188 WMI Custom Sensor
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
WQL File Shows the WQL file that is executed by the sensor with every
scanning interval. Once a sensor is created this value cannot be
changed. It is shown for reference purposes only. If you need to
change this, please add the sensor anew.
Placeholder <#PH1> In your WQL script, you can use up to three placeholders that you
can assign a value to using this field. Please enter a string for
variable <#PH1> or leave the field empty.
Placeholder <#PH2> In your WQL script, you can use up to three placeholders that you
can assign a value to using this field. Please enter a string for
variable <#PH2> or leave the field empty.
Placeholder <#PH3> In your WQL script, you can use up to three placeholders that you
can assign a value to using this field. Please enter a string for
variable <#PH3> or leave the field empty.
1530 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
188 WMI Custom Sensor
If Value Changes Define what shall be done in case the value of this sensor changes.
You can choose between:
· Ignore changes (default ): No action will be taken on change.
· Trigger 'On Change' not ificat ion: The sensor will send an
internal message indicating that its value has changed. In
combination with a Change Trigger, you can use this mechanism
to trigger a notification 1716 whenever the sensor value changes.
Channel Name Enter a name for the channel in which the received data will be
presented. The name will be displayed in graphs and tables. Please
enter a string.
Unit String Enter a unit for the data that will be received by your script. This is
for displaying purposes only. The unit will be displayed in graphs
and tables. Please enter a string.
Multiplication Define with which value the received values will be multiplied by. By
default, this is set to 1 in order to not change the received values.
Please enter an integer, a decimal value, or leave the field empty.
Division Define with which value the received values will be divided by. By
default, this is set to 1 in order to not change the received values.
Please enter an integer, a decimal value, or leave the field empty.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
28.05.2014 1531
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
188 WMI Custom Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
1532 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
188 WMI Custom Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
28.05.2014 1533
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
188 WMI Custom Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
1534 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
188 WMI Custom Sensor
More
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
28.05.2014 1535
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
189 WMI Custom String Sensor
The WMI Custom String sensor performs a custom string query via Windows Management
Instrumentation (WMI).
Note: Your Windows Management Instrumentation Query Language (WQL) query code must be
stored in a file on the system of the probe the sensor is created on: If used on a remote
probe, the file must be stored on the system running the remote probe. In a cluster setup,
please copy the file to every cluster node.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on.
Note: Sensors using the Windows Management Instrumentation (WMI) protocol have high
impact on the system performance! Try to stay below 200 WMI sensors per probe 77 . Above
this number, please consider using multiple Remot e Probes 2050 for load balancing.
For a general introduction to the technology behind WMI, please see Monit oring via WMI 1959
section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Channel Name Enter a name for the channel in which the received data will be
presented. The name will be displayed in graphs and tables. Please
enter a string. You can change the name later in the sensor's
channel settings 1709 .
WQL File Select a file that will be used for this sensor from the drop down
menu. It will be executed with every scanning interval. The menu
contains WQL scripts from the \Cust om Sensors\WMI WQL
script s sub folder of your PRTG installation. Please store your
script there. If used on a remote probe, the file must be stored on
the system running the remote probe. If used on a cluster probe,
you must store the file on all servers running a cluster node! For
more information on how to find this path, please see Dat a
St orage 2074 section.
1536 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
189 WMI Custom String Sensor
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
WQL File Shows the name of the file that this sensor is using. Once a sensor
is created this value cannot be changed. It is shown for reference
purposes only. If you need to change this, please add the sensor
anew.
Placeholder <#PH1> In your WQL script, you can use up to three placeholders that you
can assign a value to using this field. Please enter a string for
variable <#PH1> or leave the field empty.
Placeholder <#PH2> In your WQL script, you can use up to three placeholders that you
can assign a value to using this field. Please enter a string for
variable <#PH2> or leave the field empty.
Placeholder <#PH3> In your WQL script, you can use up to three placeholders that you
can assign a value to using this field. Please enter a string for
variable <#PH3> or leave the field empty.
14.01.2014 1537
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
189 WMI Custom String Sensor
If Value Changes Define what shall be done in case the value of this sensor changes.
You can choose between:
· Ignore changes (default ): No action will be taken on change.
· Trigger 'On Change' not ificat ion: The sensor will send an
internal message indicating that its value has changed. In
combination with a Change Trigger, you can use this mechanism
to trigger a notification 1716 whenever the sensor value changes.
Channel Name Enter a name for the channel in which the received data will be
presented. The name will be displayed in graphs and tables. Please
enter a string.
Unit String Enter a unit for the data that will be received by your script. This is
for displaying purposes only. The unit will be displayed in graphs
and tables. Please enter a string.
Multiplication Define with which value the received values will be multiplied by. By
default, this is set to 1 in order to not change the received values.
Please enter an integer, a decimal value, or leave the field empty.
Division Define with which value the received values will be divided by. By
default, this is set to 1 in order to not change the received values.
Please enter an integer, a decimal value, or leave the field empty.
Response Must Include Define which string must be part of the data that is received form
the WMI object. You can either enter plain text or a Regular
Expression 2048 . If the data does not include the search pattern, the
sensor will be set to an error state. Please enter a string or leave
the field empty.
Response Must Not Define which string must not be part of the data that is received
Include form the WMI object. You can either enter plain text or a Regular
Expression 2048 . If the data does include the search pattern, the
sensor will be set to an error state. Please enter a string or leave
the field empty.
For Keyword Search Define in which format you have entered the search expression in
Use the field above.
§ Plain Text : Search for the string as plain text. The characters *
and ? work here as placeholder, whereas * stands for no or any
number of characters and ? stands for exactly one character (as
known from Windows search). This behavior cannot be disabled,
so the literal search for these characters is not possible with
plain text search.
1538 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
189 WMI Custom String Sensor
Maximum Length of Define the maximum allowed length of the string that will be
String received from the WMI object. If it is longer than this value, the
sensor will be set to an error status. Please enter an integer value
or leave the field empty.
Extract Number Using Define if you want to filter out a numeric value from the string
Regular Expression received from the WMI object. You can convert this into a float
value, in order to use it with channel limits (see Sensor Channels
Set t ings 1709 ).
§ No ext ract ion: Do not extract a float value. Use the result as a
string value.
§ Ext ract a numeric value using a regular expression: Use a
regular expression to identify a numeric value in the string and
convert it to a float value. Define below. See also the example 1543
below.
Regular Expression This setting is only visible if number extraction is enabled above.
Enter a Regular Expression 2048 to identify the numeric value you
want to extract from the string returned by the WMI object. You
can use capturing groups here. Make sure the expression returns
numbers only (including decimal and thousands separators). The
result will be further refined by the settings below.
Index of Capturing This setting is only visible if number extraction is enabled above. If
Group your regular expression uses capturing groups, please specify
which one will be used to capture the number. Please enter an
integer value or leave the field empty.
Decimal Separator This setting is only visible if number extraction is enabled above.
Define which character is used as decimal separator for the number
extracted above. Please enter a string or leave the field empty.
Thousands Separator This setting is only visible if number extraction is enabled above.
Define which character is used as thousands separator for the
number extracted above. Please enter a string or leave the field
empty.
Sensor Result Define what will be done with the results the sensor receives.
Choose between:
§ Discard sensor result : Do not store the results.
14.01.2014 1539
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
189 WMI Custom String Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
1540 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
189 WMI Custom String Sensor
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
14.01.2014 1541
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
189 WMI Custom String Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
1542 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
189 WMI Custom String Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
If you want to extract a number in the response string using a regular expression, please note
that the index for captures in this sensor is based on 1 (not on 0). Furthermore, capturing
groups are not created automatically. The example below will illustrate this issue.
Assuming you would like to filter for the number 3.555, i.e., the percentage in the second
parentheses. Then enter the following regex in the Regular Expression field:
(\d+\.\d+).*(\d+\.\d+).*(\d+\.\d+)
As Index of Capt uring Group enter 3. This will extract the desired number 3.555.
14.01.2014 1543
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
189 WMI Custom String Sensor
The index has to be 3 in this case because the capturing groups here are the following:
Please keep in mind this note about index and capturing groups when using number
extraction.
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1544 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
190 WMI Event Log Sensor
The WMI Event Log sensor monitors a specific Windows log file using Windows Management
Instrumentation (WMI). It shows the number of new records (volume), the number of new
records per second (speed), and it returns the last message in the sensor status.
You can set the sensor to a desired status individually according to a new event log entry. For
details and how to find out the correct filter, see section More 1551 .
Note: This sensor type can have a high impact on the performance of your monitoring system.
Please use it with care! We recommend using not more than 50 sensors, on each probe, of this
type of sensor.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on.
Note: Sensors using the Windows Management Instrumentation (WMI) protocol have high
impact on the system performance! Try to stay below 200 WMI sensors per probe 77 . Above
this number, please consider using multiple Remot e Probes 2050 for load balancing.
For a general introduction to the technology behind WMI, please see Monit oring via WMI 1959
section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
If you select more than one log file, multiple sensors are created at once in the Add Sensor
dialog. The settings you make in this dialog are valid for all of the sensors that are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Log File The Windows event log provides several different log files. A list of
all available items is shown with their name. Select the desired
items by adding check marks in front of the respective lines. One
sensor will be created for each selection. You can also select and
deselect all items by using the check box in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
28.05.2014 1545
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
190 WMI Event Log Sensor
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Log file Shows the Windows log file that this sensor will monitor. Once a
sensor is created this value cannot be changed. It is shown for
reference purposes only. If you need to change this, please add
the sensor anew.
Event Type Specify the type of event that will be considered by this sensor.
Other event type will not be processed. Choose between the
following event types:
§ Any
§ Error
§ Warning
§ Informat ion
§ Securit y Audit Success
§ Securit y Audit Failure
Filter by Source Filter all received events for a certain event source. If enabled, only
messages matching the defined value will be considered by the
sensor. Choose between:
1546 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
190 WMI Event Log Sensor
Match String (Event This field is only visible if filtering is enabled above. Enter a source
Source) from which the events are to come from. Only events from a
source matching this string will be regarded, others ignored. Please
enter a string.
Filter by ID Filter all received events for a certain event ID. If enabled, only
messages matching the defined value(s) will be considered by the
sensor. Choose between:
· Off: Do not filter by event ID.
· On: Enable filtering by event ID.
Match Value (Event ID) This field is only visible if filtering is enabled above. Enter one or
more event IDs (comma separated) from which the events are to
come from. Only events with an ID matching one of the values will
be regarded. Please enter one integer value or more comma
separated integer values.
Filter by Category Filter all received events for a certain event category. If enabled,
only messages matching the defined value will be considered by
the sensor. Choose between:
· Off: Do not filter by event category.
· On: Enable filtering by event category.
Match String (Event This field is only visible if filtering is enabled above. Enter a category
Category) which the events are to have. Only events with a category
matching this string will be regarded. Please enter a string.
Filter by Event User Filter all received events for a certain event user. If enabled, only
messages matching the defined value will be considered by the
sensor. Choose between:
· Off: Do not filter by event user.
· On: Enable filtering by event user.
Match String (Event This field is only visible if filtering is enabled above. Enter a user
User) name which the event are to be assigned to. Only events with a
user name matching this string will be regarded. Please enter a
string.
28.05.2014 1547
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
190 WMI Event Log Sensor
Filter by Event Filter all received events for a certain event computer. If enabled,
Computer only messages matching the defined value will be considered by
the sensor. Choose between:
· Off: Do not filter by event computer.
· On: Enable filtering by event computer.
Match String (Event This field is only visible if filtering is enabled above. Enter a
Computer) computer name which the events are to be assigned to. Only
events with a computer name matching this string will be regarded.
Please enter a string.
Filter by Event Filter all received events for a certain event message. If enabled,
Message only messages matching the defined value will be considered by
the sensor. Choose between:
· Off: Do not filter by event message.
· On: Enable filtering by event message.
Match String (Event This field is only visible if filtering is enabled above. Enter a message
Message) which the event must contain. Only events with a message
matching this string will be regarded. Please enter a string.
Note: For the WMI Event Log Sensor, you can use the percent sign (%) as placeholder for any
or no character (as known from the asterisk sign (*) in Windows search) in combination with a
substring. For example, you can enter %RAS% for any event source containing the string RAS.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
1548 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
190 WMI Event Log Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
28.05.2014 1549
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
190 WMI Event Log Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
1550 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
190 WMI Event Log Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
More
Knowledge Base: Event Log Sensors: Setting Correct Status and Source Filter
§ http://kb.paessler.com/en/topic/59803
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
28.05.2014 1551
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
190 WMI Event Log Sensor
Others
For more general information about settings, please see Object Set t ings 142 section.
1552 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
191 WMI Exchange Server Sensor
The WMI Exchange Server sensor monitors a Microsoft Exchange Server 2003, 2007, 2010, or
2013 using Windows Management Instrumentation (WMI). It can show information about the
queue, delivery time, latency, users, etc.
Note: Existing former "WMI Exchange Server 2003/2007 Sensors" from previous PRTG versions
will continue to monitor your Exchange server in PRTG 9, but newly added Exchange server
sensors will be of the "WMI Exchange Server Sensor" type which is able to monitor Exchange
servers regardless of their version.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on.
Note: Sensors using the Windows Management Instrumentation (WMI) protocol have high
impact on the system performance! Try to stay below 200 WMI sensors per probe 77 . Above
this number, please consider using multiple Remot e Probes 2050 for load balancing.
For a general introduction to the technology behind WMI, please see Monit oring via WMI 1959
section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor an Exchange Server, PRTG will create one sensor for each performance
counter you choose. The settings you make in this dialog are valid for all of the sensors that
are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Performance Counter You see a list of data values the sensor can monitor on your
Exchange server. The available options depend on your Exchange
server configuration. PRTG shows all possible performance
counters with name and instance description (if available). Select
the desired items by adding check marks in front of the respective
lines. One sensor will be created for each selection. You can also
select and deselect all items by using the check box in the table
head.
You might be able to select aspects regarding:
§ SMTP Server: Queue Lengths
12.05.2014 1553
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
191 WMI Exchange Server Sensor
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
1554 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
191 WMI Exchange Server Sensor
Display Name These fields show the parameters that are used to query data for
this sensor from the target device.Once a sensor is created this
Instance value cannot be changed. It is shown for reference purposes only.
If you need to change this, please add the sensor anew.
WMI Class
Counter
Time Stamp
Time Frequency
Counter Type
Sensor Result Define what will be done with the result of the sensor. Choose
between:
§ Discard sensor result : Do not store the results.
§ Writ e sensor result t o disk (Filename: "Result of Sensor
[ID].t xt "): Store the last result received to the "Logs (System)"
directory (on the Master node, if in a cluster). This is for
debugging purposes. The file will be overridden with each
scanning interval. For information on how to find the folder used
for storage, please see Dat a St orage 2074 section.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
12.05.2014 1555
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
191 WMI Exchange Server Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
1556 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
191 WMI Exchange Server Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
12.05.2014 1557
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
191 WMI Exchange Server Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
1558 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
191 WMI Exchange Server Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
12.05.2014 1559
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
192 WMI Exchange Transport Queue Sensor
The WMI Exchange Server sensor monitors the length of transport queues of a Microsoft
Exchange Server 2003, 2007, 2010, or 2013 using Windows Management Instrumentation
(WMI). It shows the same information as shown in Windows System Monitor ('perfmon'). See
section More 1565 below for an explanation of the transport queue types.
Possible values that can be monitored: Active Mailbox Delivery Queue Length, Active Non-Smtp
Delivery Queue Length, Active Remote Delivery Queue Length, Aggregate Delivery Queue
Length (All Queues), Aggregate Shadow Queue Length, Categorizer Job Availability, Items
Completed Delivery Per Second, Items Completed Delivery Total, Items Deleted By Admin Total,
Items Queued For Delivery Expired Total, Items Queued for Delivery Per Second, Items Queued
For Delivery Total, Items Resubmitted Total, Largest Delivery Queue Length, Messages
Completed Delivery Per Second, Messages Completed Delivery Total, Messages Completing
Categorization, Messages Deferred Due To Local Loop, Messages Deferred during
Categorization, Messages Queued For Delivery, Messages Queued for Delivery Per Second,
Messages Queued For Delivery Total, Messages Submitted Per Second, Messages Submitted
Total, Poison Queue Length, Retry Mailbox Delivery Queue Length, Retry Non-Smtp Delivery
Queue Length, Retry Remote Delivery Queue Length, Shadow Queue Auto Discards Total,
Submission Queue Items Expired Total, Submission Queue Length, Unreachable Queue Length.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on.
Note: Sensors using the Windows Management Instrumentation (WMI) protocol have high
impact on the system performance! Try to stay below 200 WMI sensors per probe 77 . Above
this number, please consider using multiple Remot e Probes 2050 for load balancing.
For a general introduction to the technology behind WMI, please see Monit oring via WMI 1959
section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
If you select more than one queue, multiple sensors are created at once in the Add Sensor
dialog. The settings you make in this dialog are valid for all of the sensors that are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
1560 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
192 WMI Exchange Transport Queue Sensor
MSExchangeTransport You see a list of transport queues that can be monitored on your
Queues Exchange server. The available options depend on your Exchange
server configuration. PRTG shows all possible queues with name
and instance description (if available). Select the desired items by
adding check marks in front of the respective lines. One sensor will
be created for each selection. You can also select and deselect all
items by using the check box in the table head. Note: For
performance reasons, we recommend to only select necessary
items!
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Display Name These fields show the parameters that are used to query data for
this sensor from the target device.Once a sensor is created this
Instance value cannot be changed. It is shown for reference purposes only.
If you need to change this, please add the sensor anew.
WMI Class
28.05.2014 1561
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
192 WMI Exchange Transport Queue Sensor
Counter
Time Stamp
Time Frequency
Counter Type
Sensor Result Define what will be done with the result of the sensor. Choose
between:
§ Discard sensor result : Do not store the results.
§ Writ e sensor result t o disk (Filename: "Result of Sensor
[ID].t xt "): Store the last result received to the "Logs (System)"
directory (on the Master node, if in a cluster). This is for
debugging purposes. The file will be overridden with each
scanning interval. For information on how to find the folder used
for storage, please see Dat a St orage 2074 section.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
1562 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
192 WMI Exchange Transport Queue Sensor
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
28.05.2014 1563
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
192 WMI Exchange Transport Queue Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
1564 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
192 WMI Exchange Transport Queue Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
More
Knowledge Base: Types of Transport Queues in Microsoft Exchange
28.05.2014 1565
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
192 WMI Exchange Transport Queue Sensor
§ http://kb.paessler.com/en/topic/55413
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1566 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
193 WMI File Sensor
The WMI File monitors a file using Windows Management Instrumentation (WMI). It shows the
file size and the last modified date.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on.
Note: Sensors using the Windows Management Instrumentation (WMI) protocol have high
impact on the system performance! Try to stay below 200 WMI sensors per probe 77 . Above
this number, please consider using multiple Remot e Probes 2050 for load balancing.
For a general introduction to the technology behind WMI, please see Monit oring via WMI 1959
section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
27.11.2012 1567
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
193 WMI File Sensor
File name Enter the name of the file that this sensor will check. Please enter a
full local path. The file must exist on the computer your local or
remote probe is running on; UNC paths are not allowed here. For
example, when creating this sensor on a device under the local
probe, the file be accessible on the local system.
If timestamp changes Define what shall be done in case the timestamp of the file
changes. You can choose between:
· Ignore changes (default ): No action will be taken on change.
· Trigger 'On Change' not ificat ion: The sensor will send an
internal message indicating that its value has changed. In
combination with a Change Trigger, you can use this mechanism
to trigger a notification 1716 whenever the sensor value changes.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
1568 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
193 WMI File Sensor
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
27.11.2012 1569
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
193 WMI File Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
1570 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
193 WMI File Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
27.11.2012 1571
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
193 WMI File Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1572 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
194 WMI Free Disk Space (Multi Drive) Sensor
The WMI Free Disk Space (Multi Drive) sensor monitors the free disk space of one or multiple
drive(s) using Windows Management Instrumentation (WMI). It shows the space in percent and
total. One single sensor is used for all drives; the data is presented in different channels.
This sensor monitors logical partitions of a hard or fixed disk drive. PRTG identifies logical disks
by their drive letter, such as C.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on.
Note: Sensors using the Windows Management Instrumentation (WMI) protocol have high
impact on the system performance! Try to stay below 200 WMI sensors per probe 77 . Above
this number, please consider using multiple Remot e Probes 2050 for load balancing.
For a general introduction to the technology behind WMI, please see Monit oring via WMI 1959
section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Drive From the drop down menu, select the drive(s) you want to monitor.
We recommend using the default value. You can choose All to
monitor all available drives or you can choose one specific drive
letter to monitor this single drive only. The data in the drop down
menu may also contain drive letters that do not exist on your
device. The drive setting cannot be changed once the sensor is
created.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
14.01.2014 1573
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
194 WMI Free Disk Space (Multi Drive) Sensor
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Drive Shows the drive(s) that this sensor is monitoring; either All or a
specific drive letter. Once a sensor is created this value cannot be
changed. It is shown for reference purposes only. If you need to
change this, please add the sensor anew.
In this section you can set limits that are valid for all channels and all drives. By entering
limits, you can define when the sensor will enter a Warning or Down status; depending on
the data provided by all drives that this sensor monitors. If you want to define limits for
separate channels individually please use the limit settings in the sensor's Channels settings.
Note: All limits defined here are valid additionally to the limits defined in the particular
Channels settings!
Percentage Limit Check Enable or disable a limit check for the free space in percentage
channels of all drives. By default percentage limits are enabled with
lower warning and lower error limit. Choose between:
· Disable Percent age Limit s: Do not use the drives' data to
control the sensor's status.
· Enable Percent age Limit s: Define limits. Additional fields appear
below. The sensor will enter a warning or down state when free
space limits are undercut or overrun.
1574 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
194 WMI Free Disk Space (Multi Drive) Sensor
Upper Error Limit This field is only visible if percentage limit check is enabled above.
Specify an upper limit in percent for a Down status. If the free disk
space of one of your drives overruns this percent value, the sensor
will be set to Down. Please enter an integer value or leave the field
empty. Note: The limits set here are valid for all channels of this
sensor. You can additionally set individual limits for each sensor
channel in the Sensor Channels Set t ings 1709 . The limits set here
and in the channel settings are valid simultaneously!
Upper Warning Limit This field is only visible if percentage limit check is enabled above.
Specify an upper limit in percent for a Warning status. If the free
disk space of one of your drives overruns this percent value, the
sensor will be set to Warning. Please enter an integer value or
leave the field empty. Note: The limits set here are valid for all
channels of this sensor. You can additionally set individual limits for
each sensor channel in the Sensor Channels Set t ings 1709 . The
limits set here and in the channel settings are valid simultaneously!
Lower Warning Limit This field is only visible if percentage limit check is enabled above.
Specify a lower limit in percent for a warning state. If the free disk
space of one of your drives undercuts this percent value, the
sensor will be set to warning. Please enter an integer value or
leave the field empty. Note: The limits set here are valid for all
channels of this sensor. You can additionally set individual limits for
each sensor channel in the Sensor Channels Set t ings 1709 . The
limits set here and in the channel settings are valid simultaneously!
Lower Error Limit This field is only visible if percentage limit check is enabled above.
Specify a lower limit in percent for entering a Down status. If the
free disk space of one of your drives undercuts this percent value,
the sensor will be set to Down. Please enter an integer value or
leave the field empty. Note: The limits set here are valid for all
channels of this sensor. You can additionally set individual limits for
each sensor channel in the Sensor Channels Set t ings 1709 . The
limits set here and in the channel settings are valid simultaneously!
Byte Limit Check Enable or disable a limit check for the free bytes channels of all
drives. Choose between:
· Disable By t e Limit s: Do not use the drives' data to control the
sensor's status.
· Enable By t e Limit s: Define limits. Additional fields appear below.
The sensor will enter a warning or down state when free space
limits are undercut or overrun.
14.01.2014 1575
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
194 WMI Free Disk Space (Multi Drive) Sensor
Upper Error Limit This field is only visible if byte limit check is enabled above. Specify
an upper limit. Use the same unit as shown by the free bytes
channels of this sensor (by default this is MByte). If the free disk
space of one of your drives overruns this bytes value, the sensor
will be set to Down. Please enter an integer value or leave the field
empty. Note: The limits set here are valid for all channels of this
sensor. You can additionally set individual limits for each sensor
channel in the Sensor Channels Set t ings 1709 . The limits set here
and in the channel settings are valid simultaneously!
Upper Warning Limit This field is only visible if byte limit check is enabled above. Specify
an upper limit. Use the same unit as shown by the free bytes
channels of this sensor (by default this is MByte). If the free disk
space of one of your drives overruns this bytes value, the sensor
will be set to Warning. Please enter an integer value or leave the
field empty. Note: The limits set here are valid for all channels of
this sensor. You can additionally set individual limits for each
sensor channel in the Sensor Channels Set t ings 1709 . The limits set
here and in the channel settings are valid simultaneously!
Lower Warning Limit This field is only visible if byte limit check is enabled above. Specify
a lower limit. Use the same unit as shown by the free bytes
channels of this sensor (by default this is MByte). If the free disk
space of one of your drives undercuts this bytes value, the sensor
will be set to Warning. Please enter an integer value or leave the
field empty. Note: The limits set here are valid for all channels of
this sensor. You can additionally set individual limits for each
sensor channel in the Sensor Channels Set t ings 1709 . The limits set
here and in the channel settings are valid simultaneously!
Lower Error Limit This field is only visible if byte limit check is enabled above. Specify
a lower limit. Use the same unit as shown by the free bytes
channels of this sensor (by default this is MByte). If the free disk
space of one of your drives undercuts this bytes value, the sensor
will be set to Down. Please enter an integer value or leave the field
empty. Note: The limits set here are valid for all channels of this
sensor. You can additionally set individual limits for each sensor
channel in the Sensor Channels Set t ings 1709 . The limits set here
and in the channel settings are valid simultaneously!
Alarm on Missing/ If a monitored disk is removed or not found, values are set to zero.
Removed Disk Select the alarming approach in this case. Choose between:
§ Deact ivat e alarm (default ): Select this option if you do not
want an alarm for a removed disk.
§ Act ivat e Alarm: Select this option if you want to be alerted if a
monitored disk is removed.
1576 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
194 WMI Free Disk Space (Multi Drive) Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
14.01.2014 1577
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
194 WMI Free Disk Space (Multi Drive) Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
1578 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
194 WMI Free Disk Space (Multi Drive) Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
14.01.2014 1579
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
194 WMI Free Disk Space (Multi Drive) Sensor
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1580 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
195 WMI HDD Health Sensor
This sensor type connects to the parent device via Windows Management Instrumentation
(WMI) and monitors the health of IDE disk drives on the target system, using Self-Monitoring,
Analysis and Reporting Technology (S.M.A.R.T.). This is built into most modern IDE hard disk
drives.
Note: This sensor officially requires Windows Vista or later running on the target machine
which holds the hard disk drives you want to monitor. The sensor may not work reliably when
the target machine runs on Windows 2003 or Windows XP; due to a known bug in those
systems, the sensor may not be able to detect available hard disk drives.
Available sensor channels may vary, depending on the hardware used on the target system.
Available measurements may include: Read Error Rate, Spin-Up Time, Start/Stop Count,
Reallocated Sectors Count, Seek Error Rate, Power-On Hours, Spin Retry Count, Calibration
Retry Count, Power Cycle Count, Power-off Retract Count, Load Cycle Count, Temperature
Celsius, Reallocation Event Count, Current Pending Sector Count, Uncorrectable Sector Count,
UltraDMA CRC Error Count, Write Error Rate, Transfer Error Rate, Total LBAs Written, and Total
LBAs Read.
The channel names indicate the ID of the channel, followed by a colon, and the typical meaning
of the channel. Note: Some vendors define meanings other than the common one.
Every attribute of a disk assumes a value. PRTG shows these attributes as channels with their
last, minimum, and maximum value. These channel values change over time and indicate the
disk health—higher values correspond to a better health. The disk's attributes come with a
threshold, defined by the manufacturer of the drive. If a channel value is lower than this
threshold, the sensor is automatically set to a Warning status. This indicates that the Self-
Monitoring, Analysis and Reporting Technology (S.M.A.R.T.) status of the HDD might break
soon. Note: For some attributes are no thresholds defined and thus cannot be judged for a
status other than Up.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on.
Note: Sensors using the Windows Management Instrumentation (WMI) protocol have high
impact on the system performance! Try to stay below 200 WMI sensors per probe 77 . Above
this number, please consider using multiple Remot e Probes 2050 for load balancing.
For a general introduction to the technology behind WMI, please see Monit oring via WMI 1959
section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor the health of a disk, PRTG will create one sensor for each IDE device you
choose. The settings you make in this dialog are valid for all of the sensors that are created.
14.01.2014 1581
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
195 WMI HDD Health Sensor
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
SMART Specific
IDE Devices Please select one or more hard disks you want to add a sensor for.
A list of all available items is shown with their name. Select the
desired items by adding check marks in front of the respective
lines. One sensor will be created for each selection. You can also
select and deselect all items by using the check box in the table
head. . The items shown in the list are specific to the parent device
you create the sensor on.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
SMART Specific
Serial No. Shows the serial number of the monitored disk. Once a sensor is
created this value cannot be changed. It is shown for reference
purposes only. If you need to change this, please add the sensor
anew.
1582 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
195 WMI HDD Health Sensor
SMART Specific
Size (GB) Shows the size in Gigabyte of the monitored disk. Once a sensor is
created this value cannot be changed. It is shown for reference
purposes only. If you need to change this, please add the sensor
anew.
Name Shows the name of the monitored disk. Once a sensor is created
this value cannot be changed. It is shown for reference purposes
only. If you need to change this, please add the sensor anew.
Timeout (sec) Enter a timeout in seconds for the request. If the reply takes longer
than this value the request is aborted and an error message is
triggered.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
14.01.2014 1583
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
195 WMI HDD Health Sensor
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
1584 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
195 WMI HDD Health Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
14.01.2014 1585
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
195 WMI HDD Health Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1586 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
196 WMI Logical Disk Sensor
The WMI Logical Disk sensor monitors parameters of a logical disk of a Windows device using
Windows Management Instrumentation (WMI). It shows disk read/write time, queue, free space,
etc. on logical partitions of a disk drive.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on.
Note: Sensors using the Windows Management Instrumentation (WMI) protocol have high
impact on the system performance! Try to stay below 200 WMI sensors per probe 77 . Above
this number, please consider using multiple Remot e Probes 2050 for load balancing.
For a general introduction to the technology behind WMI, please see Monit oring via WMI 1959
section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Logical Disks You see a list showing the Name of the counters you can monitor
as well as the Inst ance, i.e. the respective logical disk (or '_Total'). If
there are no logical disks available, you will see a corresponding
message. From the list, choose all Name/Inst ance combinations
you want to monitor by adding a check mark in front of the
respective line (for example, choose '% Disk Read Time for C:'). For
each selection one sensor will be created using the defined
settings.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
12.05.2014 1587
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
196 WMI Logical Disk Sensor
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Display Name These fields show the parameters that are used to query data for
this sensor from the target device.Once a sensor is created this
Instance value cannot be changed. It is shown for reference purposes only.
If you need to change this, please add the sensor anew.
WMI Class
Counter
Time Stamp
Time Frequency
Counter Type
Sensor Result Define what will be done with the result of the sensor. Choose
between:
§ Discard sensor result : Do not store the results.
§ Writ e sensor result t o disk (Filename: "Result of Sensor
[ID].t xt "): Store the last result received to the "Logs (System)"
directory (on the Master node, if in a cluster). This is for
debugging purposes. The file will be overridden with each
scanning interval. For information on how to find the folder used
for storage, please see Dat a St orage 2074 section.
1588 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
196 WMI Logical Disk Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
12.05.2014 1589
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
196 WMI Logical Disk Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
1590 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
196 WMI Logical Disk Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
12.05.2014 1591
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
196 WMI Logical Disk Sensor
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1592 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
197 WMI Memory Sensor
The WMI Memory sensor monitors available (free) system memory on Windows systems using
Windows Management Instrumentation (WMI).
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on.
Note: Sensors using the Windows Management Instrumentation (WMI) protocol have high
impact on the system performance! Try to stay below 200 WMI sensors per probe 77 . Above
this number, please consider using multiple Remot e Probes 2050 for load balancing.
For a general introduction to the technology behind WMI, please see Monit oring via WMI 1959
section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
27.11.2012 1593
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
197 WMI Memory Sensor
Errors and invalid data This is an extended help field only. PRTG's WMI sensors are
equipped with the most efficient and accurate WMI queries.
However, Microsoft has changed (and will continue to do that in
the future) some WMI classes over the various Windows/
ServicePack/patchlevel versions, resulting in errors like "class not
valid" or "invalid data". Wherever possible PRTG features an
alternative query that might work in your specific circumstances.
When you keep getting errors for this sensor please try enabling
the alternative query method below.
Alternative query Choose the method PRTG uses to query via WMI. For compatibility
reasons, an alternative query method can be enabled. We
recommend using the default value. You can choose between:
· use default : Use PRTG's standard method to query WMI. This is
the best setting in most cases.
· use alt ernat ive: Use an alternative method to query WMI. If you
keep getting errors, please try this setting.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
1594 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
197 WMI Memory Sensor
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
27.11.2012 1595
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
197 WMI Memory Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
1596 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
197 WMI Memory Sensor
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
27.11.2012 1597
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
198 WMI Microsoft SQL Server 2005 Sensor (Deprecated)
We have made reasonable effort to fix this from our side but we were unable to. We do not
have instructions to circumvent this issue at this time. Please ask the vendor to fix this.
More
Knowledge Base: Why does my WMI Microsoft SQL Server 2005 Sensor not work anymore?
§ http://kb.paessler.com/en/topic/44713
The WMI Microsoft SQL Server sensor monitors the performance of a Microsoft SQL server via
Windows Management Instrumentation (WMI). This sensor can monitor SQL General
St at ist ics, Access Met hods, the Buffer Manager, the Memory Manager, the Locks
Manager, and SQL St at ist ics. The channels actually available for a sensor depend on which
performance counters you choose during setup.
Channel Overview
Full Scans Number of unrestricted full scans per second. These can be either
base-table or full-index scans.
1598 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
198 WMI Microsoft SQL Server 2005 Sensor (Deprecated)
Channel Overview
Page Splits Number of page splits per second that occur as the result of
overflowing index pages.
Buffer Cache Hit Ratio Percentage of pages found in the buffer cache without having to
read from disk. The ratio is the total number of cache hits divided
by the total number of cache lookups since an instance of SQL
Server was started. After a long period of time, the ratio moves
very little. Because reading from the cache is much less expensive
than reading from disk, you want this ratio to be high. Generally,
you can increase the buffer cache hit ratio by increasing the
amount of memory available to SQL Server.
Database Pages Number of pages in the buffer pool with database content.
Page Life Expectancy Number of seconds a page will stay in the buffer pool without
references.
Connection Memory Total amount of dynamic memory the server is using for maintaining
(KB) connections.
Optimizer Memory (KB) Total amount of dynamic memory the server is using for query
optimization.
Total Server Memory Total amount of dynamic memory (in kilobytes) that the server is
(KB) using currently.
Target Server Memory Total amount of dynamic memory the server can consume.
(KB)
SQL Cache Memory Total amount of dynamic memory the server is using for the
(KB) dynamic SQL cache.
Lock Requests Number of new locks and lock conversions per second requested
from the lock manager.
Average Wait Time Average amount of wait time (in milliseconds) for each lock request
that resulted in a wait.
28.05.2014 1599
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
198 WMI Microsoft SQL Server 2005 Sensor (Deprecated)
Channel Overview
SQL Compilations Number of SQL compilations per second. Indicates the number of
times the compile code path is entered. Includes compiles due to
recompiles. After SQL Server user activity is stable, this value
reaches a steady state.
SQL Re-Compilations Number of SQL recompiles per second. Counts the number of
times recompiles are triggered. In general, you want the recompiles
to be low.
Note: This sensor can only be added to a device (computer) running a Microsoft SQL database.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on.
Note: Sensors using the Windows Management Instrumentation (WMI) protocol have high
impact on the system performance! Try to stay below 200 WMI sensors per probe 77 . Above
this number, please consider using multiple Remot e Probes 2050 for load balancing.
For a general introduction to the technology behind WMI, please see Monit oring via WMI 1959
section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
MS SQL Server You see a list of all server instances available on the device. Display
Instance name and service name are provided as returned by the SQL
server. Please choose one or more instances by adding a check
mark in front of the respective line. For each instance one sensor
will be created.
1600 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
198 WMI Microsoft SQL Server 2005 Sensor (Deprecated)
SQL Server Version Enter the version of the SQL server. Usually, you can keep the
default value.
SQL Performance You see a list of different performance counters which can be
Counters monitored for the instance(s) selected above. The sensors created
for the server instances will all monitor the performance counter
you select here. Choose from:
§ General St at ist ics: Read general performance counters. This will
show the number of user connections, and the number of logins
and logouts per second.
§ Access Met hods: Read access method counters. This will show
the number of full scans, page splits, and table lock escalations,
per second.
§ Buffer Manager: Read buffer manager counters. This will show
the buffer cache hit ratio in percent, and the number of database
pages and stolen pages.
§ Memory Manager: Read memory manager counters. This will
show the connection memory, optimizer memory, total server
memory, target server memory, and SQL cache memory, in KB.
§ Locks: Read locks counters. This will show the number of lock
requests and deadlocks, per second, and the average wait time.
§ SQL St at ist ics: Read SQL statistics. This will show the number of
batch requests, SQL compilations, and SQL re-compilations, per
second.
Depending on your selection, a sensor with the specified channels
will be created. Note: In order to monitor several performance
counters for an instance, please add the sensor several times.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
28.05.2014 1601
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
198 WMI Microsoft SQL Server 2005 Sensor (Deprecated)
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Name Shows the name of the server instance monitored by this sensor.
Once a sensor is created this value cannot be changed. It is shown
for reference purposes only. If you need to change this, please add
the sensor anew.
WMI Class Name Select whether PRTG will select the name of the WMI class used for
monitoring automatically. Choose between:
§ Aut omat ic: Choose WMI class automatically. This is the
recommended setting.
§ Manual: Manually enter a WMI class name. Use this if your server
instance returns an error code in automatic mode.
WMI Class This field is only shown if manual WMI class selection is enabled
above. This setting is intended for experienced users only. Enter
the WMI class name that will be used for monitoring your server
instance.
Sensor Result Define what will be done with the results the sensor receives.
Choose between:
§ Discard sensor result : Do not store the results.
1602 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
198 WMI Microsoft SQL Server 2005 Sensor (Deprecated)
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
28.05.2014 1603
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
198 WMI Microsoft SQL Server 2005 Sensor (Deprecated)
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
1604 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
198 WMI Microsoft SQL Server 2005 Sensor (Deprecated)
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
28.05.2014 1605
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
198 WMI Microsoft SQL Server 2005 Sensor (Deprecated)
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1606 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
199 WMI Microsoft SQL Server 2008 Sensor
The WMI Microsoft SQL Server sensor monitors the performance of a Microsoft SQL server via
Windows Management Instrumentation (WMI). This sensor can monitor SQL General
St at ist ics, Access Met hods, the Buffer Manager, the Memory Manager, the Locks
Manager, and SQL St at ist ics. The channels actually available for a sensor depend on which
performance counters you choose during setup.
Channel Overview
Full Scans Number of unrestricted full scans per second. These can be either
base-table or full-index scans.
Page Splits Number of page splits per second that occur as the result of
overflowing index pages.
Buffer Cache Hit Ratio Percentage of pages found in the buffer cache without having to
read from disk. The ratio is the total number of cache hits divided
by the total number of cache lookups since an instance of SQL
Server was started. After a long period of time, the ratio moves
very little. Because reading from the cache is much less expensive
than reading from disk, you want this ratio to be high. Generally,
you can increase the buffer cache hit ratio by increasing the
amount of memory available to SQL Server.
Database Pages Number of pages in the buffer pool with database content.
Page Life Expectancy Number of seconds a page will stay in the buffer pool without
references.
Connection Memory Total amount of dynamic memory the server is using for maintaining
(KB) connections.
27.11.2012 1607
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
199 WMI Microsoft SQL Server 2008 Sensor
Channel Overview
Optimizer Memory (KB) Total amount of dynamic memory the server is using for query
optimization.
Total Server Memory Total amount of dynamic memory (in kilobytes) that the server is
(KB) using currently.
Target Server Memory Total amount of dynamic memory the server can consume.
(KB)
SQL Cache Memory Total amount of dynamic memory the server is using for the
(KB) dynamic SQL cache.
Lock Requests Number of new locks and lock conversions per second requested
from the lock manager.
Average Wait Time Average amount of wait time (in milliseconds) for each lock request
that resulted in a wait.
SQL Compilations Number of SQL compilations per second. Indicates the number of
times the compile code path is entered. Includes compiles due to
recompiles. After SQL Server user activity is stable, this value
reaches a steady state.
SQL Re-Compilations Number of SQL recompiles per second. Counts the number of
times recompiles are triggered. In general, you want the recompiles
to be low.
Note: This sensor can only be added to a device (computer) running a Microsoft SQL database.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on.
Note: Sensors using the Windows Management Instrumentation (WMI) protocol have high
impact on the system performance! Try to stay below 200 WMI sensors per probe 77 . Above
this number, please consider using multiple Remot e Probes 2050 for load balancing.
For a general introduction to the technology behind WMI, please see Monit oring via WMI 1959
section.
1608 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
199 WMI Microsoft SQL Server 2008 Sensor
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
MS SQL Server You see a list of all server instances available on the device. Display
Instance name and service name are provided as returned by the SQL
server. Please choose one or more instances by adding a check
mark in front of the respective line. For each instance one sensor
will be created.
SQL Server Version Enter the version of the SQL server. Usually, you can keep the
default value.
SQL Performance You see a list of different performance counters which can be
Counters monitored for the instance(s) selected above. The sensors created
for the server instances will all monitor the performance counter
you select here. Choose from:
§ General St at ist ics: Read general performance counters. This will
show the number of user connections, and the number of logins
and logouts per second.
§ Access Met hods: Read access method counters. This will show
the number of full scans, page splits, and table lock escalations,
per second.
§ Buffer Manager: Read buffer manager counters. This will show
the buffer cache hit ratio in percent, and the number of database
pages and stolen pages.
§ Memory Manager: Read memory manager counters. This will
show the connection memory, optimizer memory, total server
memory, target server memory, and SQL cache memory, in KB.
§ Locks: Read locks counters. This will show the number of lock
requests and deadlocks, per second, and the average wait time.
§ SQL St at ist ics: Read SQL statistics. This will show the number of
batch requests, SQL compilations, and SQL re-compilations, per
second.
27.11.2012 1609
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
199 WMI Microsoft SQL Server 2008 Sensor
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Name Shows the name of the server instance monitored by this sensor.
Once a sensor is created this value cannot be changed. It is shown
for reference purposes only. If you need to change this, please add
the sensor anew.
WMI Class Name Select whether PRTG will select the name of the WMI class used for
monitoring automatically. Choose between:
1610 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
199 WMI Microsoft SQL Server 2008 Sensor
WMI Class This field is only shown if manual WMI class selection is enabled
above. This setting is intended for experienced users only. Enter
the WMI class name that will be used for monitoring your server
instance.
Sensor Result Define what will be done with the results the sensor receives.
Choose between:
§ Discard sensor result : Do not store the results.
§ Writ e sensor result t o disk (Filename: "Result of Sensor
(ID].t xt "): Store the last result received to the "Logs (Sensors)"
directory (on the Master node, if in a cluster). This is for
debugging purposes. The file will be overridden with each
scanning interval. For information on how to find the folder used
for storage, please see Dat a St orage 2074 section.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
27.11.2012 1611
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
199 WMI Microsoft SQL Server 2008 Sensor
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
1612 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
199 WMI Microsoft SQL Server 2008 Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
27.11.2012 1613
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
199 WMI Microsoft SQL Server 2008 Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1614 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
200 WMI Microsoft SQL Server 2012 Sensor
The WMI Microsoft SQL Server sensor monitors the performance of a Microsoft SQL server via
Windows Management Instrumentation (WMI). This sensor can monitor SQL General
St at ist ics, Access Met hods, the Buffer Manager, the Memory Manager, the Locks
Manager, and SQL St at ist ics. The channels actually available for a sensor depend on which
performance counters you choose during setup.
Channel Overview
Full Scans Number of unrestricted full scans per second. These can be either
base-table or full-index scans.
Page Splits Number of page splits per second that occur as the result of
overflowing index pages.
Buffer Cache Hit Ratio Percentage of pages found in the buffer cache without having to
read from disk. The ratio is the total number of cache hits divided
by the total number of cache lookups since an instance of SQL
Server was started. After a long period of time, the ratio moves
very little. Because reading from the cache is much less expensive
than reading from disk, you want this ratio to be high. Generally,
you can increase the buffer cache hit ratio by increasing the
amount of memory available to SQL Server.
Database Pages Number of pages in the buffer pool with database content.
Page Life Expectancy Number of seconds a page will stay in the buffer pool without
references.
Connection Memory Total amount of dynamic memory the server is using for maintaining
(KB) connections.
21.12.2012 1615
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
200 WMI Microsoft SQL Server 2012 Sensor
Channel Overview
Optimizer Memory (KB) Total amount of dynamic memory the server is using for query
optimization.
Total Server Memory Total amount of dynamic memory (in kilobytes) that the server is
(KB) using currently.
Target Server Memory Total amount of dynamic memory the server can consume.
(KB)
SQL Cache Memory Total amount of dynamic memory the server is using for the
(KB) dynamic SQL cache.
Lock Requests Number of new locks and lock conversions per second requested
from the lock manager.
Average Wait Time Average amount of wait time (in milliseconds) for each lock request
that resulted in a wait.
SQL Compilations Number of SQL compilations per second. Indicates the number of
times the compile code path is entered. Includes compiles due to
recompiles. After SQL Server user activity is stable, this value
reaches a steady state.
SQL Re-Compilations Number of SQL recompiles per second. Counts the number of
times recompiles are triggered. In general, you want the recompiles
to be low.
Note: This sensor can only be added to a device (computer) running a Microsoft SQL database.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on.
Note: Sensors using the Windows Management Instrumentation (WMI) protocol have high
impact on the system performance! Try to stay below 200 WMI sensors per probe 77 . Above
this number, please consider using multiple Remot e Probes 2050 for load balancing.
For a general introduction to the technology behind WMI, please see Monit oring via WMI 1959
section.
1616 21.12.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
200 WMI Microsoft SQL Server 2012 Sensor
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
MS SQL Server You see a list of all server instances available on the device. Display
Instance name and service name are provided as returned by the SQL
server. Please choose one or more instances by adding a check
mark in front of the respective line. For each instance one sensor
will be created.
SQL Server Version Enter the version of the SQL server. Usually, you can keep the
default value.
SQL Performance You see a list of different performance counters which can be
Counters monitored for the instance(s) selected above. The sensors created
for the server instances will all monitor the performance counter
you select here. Choose from:
§ General St at ist ics: Read general performance counters. This will
show the number of user connections, and the number of logins
and logouts per second.
§ Access Met hods: Read access method counters. This will show
the number of full scans, page splits, and table lock escalations,
per second.
§ Buffer Manager: Read buffer manager counters. This will show
the buffer cache hit ratio in percent, and the number of database
pages and stolen pages.
§ Memory Manager: Read memory manager counters. This will
show the connection memory, optimizer memory, total server
memory, target server memory, and SQL cache memory, in KB.
§ Locks: Read locks counters. This will show the number of lock
requests and deadlocks, per second, and the average wait time.
§ SQL St at ist ics: Read SQL statistics. This will show the number of
batch requests, SQL compilations, and SQL re-compilations, per
second.
21.12.2012 1617
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
200 WMI Microsoft SQL Server 2012 Sensor
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Name Shows the name of the server instance monitored by this sensor.
Once a sensor is created this value cannot be changed. It is shown
for reference purposes only. If you need to change this, please add
the sensor anew.
WMI Class Name Select whether PRTG will select the name of the WMI class used for
monitoring automatically. Choose between:
1618 21.12.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
200 WMI Microsoft SQL Server 2012 Sensor
WMI Class This field is only shown if manual WMI class selection is enabled
above. This setting is intended for experienced users only. Enter
the WMI class name that will be used for monitoring your server
instance.
Sensor Result Define what will be done with the results the sensor receives.
Choose between:
§ Discard sensor result : Do not store the results.
§ Writ e sensor result t o disk (Filename: "Result of Sensor
(ID].t xt "): Store the last result received to the "Logs (Sensors)"
directory (on the Master node, if in a cluster). This is for
debugging purposes. The file will be overridden with each
scanning interval. For information on how to find the folder used
for storage, please see Dat a St orage 2074 section.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
21.12.2012 1619
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
200 WMI Microsoft SQL Server 2012 Sensor
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
1620 21.12.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
200 WMI Microsoft SQL Server 2012 Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
21.12.2012 1621
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
200 WMI Microsoft SQL Server 2012 Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1622 21.12.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
201 WMI Process Sensor
The WMI Process sensor monitors a Windows process using Windows Management
Instrumentation (WMI). It shows the absolute working set and commit size, the number of
threads and handles, as well as the average CPU usage (if there are multiple instances running)
and the total CPU usage of the process.
For the "total CPU usage" value of a process, all CPU usage values are summed up. The total is
divided by the number of all CPUs; the maximum value is 100%. This corresponds to the CPU
usage of all instances of this specific process. Regarding the "per instance" value, the summed
up CPU usage value is divided by the number of all instances. It shows the average CPU usage
of a single instance of the process on one CPU.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on.
Note: Sensors using the Windows Management Instrumentation (WMI) protocol have high
impact on the system performance! Try to stay below 200 WMI sensors per probe 77 . Above
this number, please consider using multiple Remot e Probes 2050 for load balancing.
For a general introduction to the technology behind WMI, please see Monit oring via WMI 1959
section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
04.12.2012 1623
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
201 WMI Process Sensor
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Executable Enter the name of the process that will be monitored. Please enter
the name of an executable file without the .exe extension. The
sensor will be set to an error state if the process is not active on
the device.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
1624 04.12.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
201 WMI Process Sensor
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
04.12.2012 1625
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
201 WMI Process Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
1626 04.12.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
201 WMI Process Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
04.12.2012 1627
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
201 WMI Process Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1628 04.12.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
202 WMI Remote Ping Sensor
The WMI Remote Ping sensor connects remotely to a Windows system using Windows
Management Instrumentation (WMI), then performs an Internet Control Message Protocol
(ICMP) echo request ("Ping") from this device to a specified target. The sensor shows the Ping
time from the remote device to the target device that is being pinged.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on.
Note: Sensors using the Windows Management Instrumentation (WMI) protocol have high
impact on the system performance! Try to stay below 200 WMI sensors per probe 77 . Above
this number, please consider using multiple Remot e Probes 2050 for load balancing.
For a general introduction to the technology behind WMI, please see Monit oring via WMI 1959
section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
27.11.2012 1629
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
202 WMI Remote Ping Sensor
Target Enter the DNS name or IP address of the target device the Ping is
sent to. The sensor will remotely connect to the parent device it is
created on via WMI, then perform a Ping request from this remote
device to the target device/server. Please enter a string.
Timeout (Seconds) Enter a timeout in seconds for the Ping. If the reply takes longer
than this value the request is aborted and an error message is
triggered. Please enter an integer value. The maximum is 300.
Packet Size (Bytes) Enter the packet size in bytes for the Ping. You can choose any
value between 1 and 10000. Please enter an integer value. We
recommend using the default value.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
1630 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
202 WMI Remote Ping Sensor
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
27.11.2012 1631
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
202 WMI Remote Ping Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
1632 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
202 WMI Remote Ping Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
27.11.2012 1633
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
203 WMI Security Center Sensor
The WMI Security Center sensor monitors the security status of a Windows computer using
Windows Management Instrumentation (WMI). It can monitor all security products that are
controlled by Windows Security Center / Windows Action Center. It returns a status code of
the monitored product and sets the sensor status to Warning if a product status is unknown,
if it is reported as out of date, or if the access scan is disabled. A sensor status showing Up
indicates that the product is up to date and the access scan is running.
0 Unknown Warning
4 Running, Up to date OK
Note: This sensor requires Windows XP SP2 or later on the target computer. The Windows
Security Center / Windows Action Center is only available on client Windows versions.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on.
Note: Sensors using the Windows Management Instrumentation (WMI) protocol have high
impact on the system performance! Try to stay below 200 WMI sensors per probe 77 . Above
this number, please consider using multiple Remot e Probes 2050 for load balancing.
For a general introduction to the technology behind WMI, please see Monit oring via WMI 1959
section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
1634 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
203 WMI Security Center Sensor
Security Center You see a list showing the Name and Ty pe of all security products
Products found in the Windows Security Center on the target device. If there
are no products, you will see a corresponding message. Select the
desired items by adding check marks in front of the respective
lines. One sensor will be created for each selection. You can also
select and deselect all items by using the check box in the table
head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Display Name Shows the name of the product monitored by this sensor. Once a
sensor is created this value cannot be changed. It is shown for
reference purposes only. If you need to change this, please add
the sensor anew.
Type Shows the type of the product monitored by this sensor. Once a
sensor is created this value cannot be changed. It is shown for
reference purposes only. If you need to change this, please add
the sensor anew.
14.01.2014 1635
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
203 WMI Security Center Sensor
If Value Changes Define what will be done in case the value of this sensor changes.
You can choose between:
· Ignore changes: No action will be taken on change.
· Trigger 'change' not ificat ion: The sensor will send an internal
message indicating that its value has changed. In combination
with a Change Trigger, you can use this mechanism to trigger a
notification 1716 whenever the sensor value changes.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
1636 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
203 WMI Security Center Sensor
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
14.01.2014 1637
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
203 WMI Security Center Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
1638 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
203 WMI Security Center Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
14.01.2014 1639
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
204 WMI Service Sensor
The WMI Service sensor monitors a Windows service using Windows Management
Instrumentation (WMI). It shows the execution time of the monitoring request. Additionally, it
can show CPU and pagefile usage, the number of handles and threads, and the working set of
the monitored service. You can monitor these channels if you enable Monit or ext ended
values in the sensor settings.
Note: The "Running (msec)" channel of this sensor shows the execution time of the monitoring
request. It does not refer to the time the Windows service has been running! As of PRTG
version 13, the name of this sensor channel is Sensor Execut ion Time.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on.
Note: Sensors using the Windows Management Instrumentation (WMI) protocol have high
impact on the system performance! Try to stay below 200 WMI sensors per probe 77 . Above
this number, please consider using multiple Remot e Probes 2050 for load balancing.
For a general introduction to the technology behind WMI, please see Monit oring via WMI 1959
section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
If you select more than one service multiple sensors are created at once in the Add Sensor
dialog.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Service A list of all available items is shown with their name. Select the
desired items by adding check marks in front of the respective
lines. One sensor will be created for each selection. You can also
select and deselect all items by using the check box in the table
head. Name and description are provided in the language of the
device's Windows installation. Later on, a sensor's status will be set
to Down if the service is not running.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
1640 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
204 WMI Service Sensor
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Monitoring Select whether you want to monitor CPU usage and other useful
performance counters. This may cause a "Class not found" error on
some Windows systems. If you do not monitor these counters, the
value '0' is returned for these channels. Choose between:
§ Just check if services is running: PRTG will only monitor the
channel "Sensor Execution Time".
§ Monit or ext ended values: PRTG will monitor also other useful
performance counters.
Service Shows the Windows service this sensor will monitor. Once a
sensor is created this value cannot be changed. It is shown for
reference purposes only. If you need to change this, please add
the sensor anew.
24.10.2013 1641
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
204 WMI Service Sensor
Description Shows the description for the service. Once a sensor is created
this value cannot be changed. It is shown for reference purposes
only. If you need to change this, please add the sensor anew.
Sensor Result Define what will be done with the result of the sensor. Choose
between:
§ Discard sensor result : Do not store the sensor result.
§ Writ e sensor result t o disk (Filename: "Result of Sensor
[ID].t xt "): Store the last result received from the sensor to the
"Logs (Sensor)" directory (on the Master node, if in a cluster). File
name: Result of Sensor [ID].txt. This is for debugging purposes.
The file will be overridden with each scanning interval. For
information on how to find the folder used for storage, please
see Dat a St orage 2074 section.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
1642 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
204 WMI Service Sensor
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
24.10.2013 1643
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
204 WMI Service Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
1644 24.10.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
204 WMI Service Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
24.10.2013 1645
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
205 WMI Share Sensor
The WMI Share sensor monitors a shared resource on a Windows system using Windows
Management Instrumentation (WMI). It shows the availability; you can set a sensor to Down
status for different share status messages.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on.
Note: Sensors using the Windows Management Instrumentation (WMI) protocol have high
impact on the system performance! Try to stay below 200 WMI sensors per probe 77 . Above
this number, please consider using multiple Remot e Probes 2050 for load balancing.
For a general introduction to the technology behind WMI, please see Monit oring via WMI 1959
section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
If you select more than one share multiple sensors are created at once in the Add Sensor
dialog. The settings you make in this dialog are valid for all of the sensors that are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Share Select the shares you want to add a sensor for. A list of all available
items is shown with their name. Select the desired items by adding
check marks in front of the respective lines. One sensor will be
created for each selection. You can also select and deselect all
items by using the check box in the table head. Note: In order to
provide any shares, the LanmanServer "Server" Windows service
must be running on the target computer. If it is not, there are no
shares and you will see a No Share available message here.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
1646 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
205 WMI Share Sensor
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Shared Recource
Shows information about the shared resource monitored by this
Description sensor. Once a sensor is created this value cannot be changed. It
is shown for reference purposes only. If you need to change this,
Type please add the sensor anew.
TypeID
Select under which conditions the sensor will change to a Down status from the list below.
As long as the share returns OK, the sensor status will be Up. Choose a Down condition by
adding a check mark symbol in front of the according line. Please choose none, one, or
several from the following conditions. Note: While in Down status, a sensor does not record
any data in all of its channels.
Error Set sensor to Down status if the share returns an error status. A
share in this status is not operational.
Degraded Set sensor to Down status if the share returns a degraded status.
A share in this status is still operational.
Unknown Set sensor to Down status if the share returns an unknown status.
14.01.2014 1647
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
205 WMI Share Sensor
Pred Fail Set sensor to Down status if the share returns a "predicted fail"
status. This indicates that an element is functioning properly but is
predicting a failure (for example, a SMART-enabled hard drive). A
share in this status is still operational.
Starting Set sensor to Down status if the share returns a starting status. A
share in this status is not operational.
Stopping Set sensor to Down status if the share returns a stopping status. A
share in this status is not operational.
Service Set sensor to Down status if the share returns a service status.
This can apply during disk mirror-resilvering, reloading a user
permissions list, or other administrative work on the monitored
device. Not all such work is online, but the managed element is
neither OK nor in one of the other states. A share in this status is
not operational.
Stressed Set sensor to Down status if the share returns a stressed status.
Nonrecover Set sensor to Down status if the share returns a "non recover"
status.
NoContact Set sensor to Down status if the share returns a "no contact"
status.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
1648 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
205 WMI Share Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
14.01.2014 1649
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
205 WMI Share Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
1650 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
205 WMI Share Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
14.01.2014 1651
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
205 WMI Share Sensor
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1652 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
206 WMI SharePoint Process Sensor
The WMI SharePoint Process sensor monitors a Microsoft SharePoint server using Windows
Management Instrumentation (WMI). It shows the number of current page requests, active
threads, and SQL queries currently executed, as well as global heap size, object cache always
live size, template cache size, and CPU utilization.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on.
Note: Sensors using the Windows Management Instrumentation (WMI) protocol have high
impact on the system performance! Try to stay below 200 WMI sensors per probe 77 . Above
this number, please consider using multiple Remot e Probes 2050 for load balancing.
For a general introduction to the technology behind WMI, please see Monit oring via WMI 1959
section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
If you select more than one SharePoint process, multiple sensors are created at once in the
Add Sensor dialog. The settings you make in this dialog are valid for all of the sensors that are
created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
SharePoint Processes You see a list of all SharePoint processes running on this device.
There is also a "_Total" process available. Select the desired items
by adding check marks in front of the respective lines. One sensor
will be created for each selection. You can also select and deselect
all items by using the check box in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
07.02.2013 1653
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
206 WMI SharePoint Process Sensor
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
SharePoint Process The name of the SharePoint process that is monitored by this
sensor. Once a sensor is created this value cannot be changed. It
is shown for reference purposes only. If you need to change this,
please add the sensor anew.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
1654 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
206 WMI SharePoint Process Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
07.02.2013 1655
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
206 WMI SharePoint Process Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
1656 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
206 WMI SharePoint Process Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
07.02.2013 1657
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
206 WMI SharePoint Process Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1658 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
207 WMI Terminal Services (Windows 2008) Sensor
The WMI Terminal Services sensor monitors the number of sessions on a Windows Terminal
Services (Remote Desktop Services) server using Windows Management Instrumentation
(WMI). It shows the number of active and total sessions. Active sessions are sessions with a
currently logged in user; inactive sessions (included in total) can be sessions with a
disconnected user that has not logged out, or system services using a session. Note: As "Total
Sessions", this sensor type will return the number of the active sessions, plus two additional
sessions: one for the console, and another for the services. So, the number of total sessions
may actually be higher than expected.
Note: Depending on the OS that will be monitored, please select either the sensor for
Windows XP/Vista/2003 or the one for Windows 2008.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on.
Note: Sensors using the Windows Management Instrumentation (WMI) protocol have high
impact on the system performance! Try to stay below 200 WMI sensors per probe 77 . Above
this number, please consider using multiple Remot e Probes 2050 for load balancing.
For a general introduction to the technology behind WMI, please see Monit oring via WMI 1959
section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
27.11.2012 1659
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
207 WMI Terminal Services (Windows 2008) Sensor
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
1660 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
207 WMI Terminal Services (Windows 2008) Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
27.11.2012 1661
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
207 WMI Terminal Services (Windows 2008) Sensor
§ Mast er object for parent : Make this sensor the master object
for its parent device. The sensor will influence the behavior of
the device it is created on: If the sensor is in a Down status, the
device will be paused. For example, it is a good idea to make a
Ping sensor the master object for its parent device to pause
monitoring for all other sensors on the device in case the device
cannot even be pinged. Additionally, the sensor will be paused if
the parent group of its parent device is in a Down status, or if it
is paused by another dependency.
Note: Testing your dependencies is easy! Simply choose Simulat e
Error St at us from the context menu of an object that other
objects depend on. A few seconds later all dependent objects
should be paused.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
1662 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
207 WMI Terminal Services (Windows 2008) Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
27.11.2012 1663
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
208 WMI Terminal Services (Windows XP/Vista/2003) Sensor
The WMI Terminal Services sensor monitors the number of sessions on a Windows Terminal
Services (Remote Desktop Services) server using Windows Management Instrumentation
(WMI). It shows the number of active and total sessions. Active sessions are sessions with a
currently logged in user; inactive sessions (included in total) can be sessions with a
disconnected user that has not logged out, or system services using a session. Note: As "Total
Sessions", this sensor type will return the number of the active sessions, plus two additional
sessions: one for the console, and another for the services. So, the number of total sessions
may actually be higher than expected.
Note: Depending on the OS that will be monitored, please select either the sensor for
Windows XP/Vista/2003 or the one for Windows 2008.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on.
Note: Sensors using the Windows Management Instrumentation (WMI) protocol have high
impact on the system performance! Try to stay below 200 WMI sensors per probe 77 . Above
this number, please consider using multiple Remot e Probes 2050 for load balancing.
For a general introduction to the technology behind WMI, please see Monit oring via WMI 1959
section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
1664 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
208 WMI Terminal Services (Windows XP/Vista/2003) Sensor
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
27.11.2012 1665
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
208 WMI Terminal Services (Windows XP/Vista/2003) Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
1666 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
208 WMI Terminal Services (Windows XP/Vista/2003) Sensor
§ Mast er object for parent : Make this sensor the master object
for its parent device. The sensor will influence the behavior of
the device it is created on: If the sensor is in a Down status, the
device will be paused. For example, it is a good idea to make a
Ping sensor the master object for its parent device to pause
monitoring for all other sensors on the device in case the device
cannot even be pinged. Additionally, the sensor will be paused if
the parent group of its parent device is in a Down status, or if it
is paused by another dependency.
Note: Testing your dependencies is easy! Simply choose Simulat e
Error St at us from the context menu of an object that other
objects depend on. A few seconds later all dependent objects
should be paused.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
27.11.2012 1667
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
208 WMI Terminal Services (Windows XP/Vista/2003) Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1668 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
209 WMI UTC Time Sensor
The WMI UTC Time sensor monitors the UTC time of a target device using Windows
Management Instrumentation (WMI). It shows the UTC time of the target device, and the time
difference between the PRTG system time and the target device, in seconds.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on.
Note: Sensors using the Windows Management Instrumentation (WMI) protocol have high
impact on the system performance! Try to stay below 200 WMI sensors per probe 77 . Above
this number, please consider using multiple Remot e Probes 2050 for load balancing.
For a general introduction to the technology behind WMI, please see Monit oring via WMI 1959
section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
27.11.2012 1669
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
209 WMI UTC Time Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
1670 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
209 WMI UTC Time Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
27.11.2012 1671
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
209 WMI UTC Time Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
1672 27.11.2012
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
209 WMI UTC Time Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
27.11.2012 1673
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
210 WMI Vital System Data (V2) Sensor
The WMI Vital System Data sensor monitors vital system parameters (CPU, system, memory,
disk, network, pagefile, etc.) using Windows Management Instrumentation (WMI).
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on.
Note: Sensors using the Windows Management Instrumentation (WMI) protocol have high
impact on the system performance! Try to stay below 200 WMI sensors per probe 77 . Above
this number, please consider using multiple Remot e Probes 2050 for load balancing.
For a general introduction to the technology behind WMI, please see Monit oring via WMI 1959
section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Performance Counter You see a list of available vital system data values the sensor can
monitor on the target device. The available options depend on
your configuration. PRTG shows all possible performance counters
with name and instance description (if available). Select the desired
items by adding check marks in front of the respective lines. One
sensor will be created for each selection. You can also select and
deselect all items by using the check box in the table head.
You can choose between the following counters:
§ CPU
§ Thread
§ Memory
§ Net work
§ Pagefile
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
1674 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
210 WMI Vital System Data (V2) Sensor
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
Display Name These fields show the parameters that are used to query data for
this sensor from the target device.Once a sensor is created this
Instance value cannot be changed. It is shown for reference purposes only.
If you need to change this, please add the sensor anew.
WMI Class
Counter
Time Stamp
Time Frequency
Counter Type
Sensor Result Define what will be done with the result of the sensor. Choose
between:
§ Discard sensor result : Do not store the results.
§ Writ e sensor result t o disk (Filename: "Result of Sensor
[ID].t xt "): Store the last result received to the "Logs (System)"
directory (on the Master node, if in a cluster). This is for
debugging purposes. The file will be overridden with each
scanning interval. For information on how to find the folder used
for storage, please see Dat a St orage 2074 section.
12.05.2014 1675
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
210 WMI Vital System Data (V2) Sensor
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
1676 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
210 WMI Vital System Data (V2) Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
12.05.2014 1677
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
210 WMI Vital System Data (V2) Sensor
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
1678 12.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
210 WMI Vital System Data (V2) Sensor
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
12.05.2014 1679
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
211 WMI Volume Sensor
The WMI Volume sensor monitors the free disk space on one drive or one logical volume using
Windows Management Instrumentation (WMI). It shows the space in percent and total. For each
drive or logical volume, one sensor is used.
This sensor monitors an area of storage on a hard disk. It can monitor local volumes that are
formatted, unformatted, mounted, or offline. A volume is formatted by using a file system, such
as File Allocation Table (FAT) or New Technology File System (NFTS), and might have a drive
letter assigned to it. One hard disk can have multiple volumes, and volumes can span multiple
physical disks. The sensor does not support disk drive management.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on.
Note: Sensors using the Windows Management Instrumentation (WMI) protocol have high
impact on the system performance! Try to stay below 200 WMI sensors per probe 77 . Above
this number, please consider using multiple Remot e Probes 2050 for load balancing.
For a general introduction to the technology behind WMI, please see Monit oring via WMI 1959
section.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
For devices with multiple volumes multiple sensors are created at once in the Add Sensor
dialog. The settings you make in this dialog are valid for all of the sensors that are created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
Volumes Select the volume(s) you want to add a sensor for. A list of all
available items is shown with their name. Select the desired items
by adding check marks in front of the respective lines. One sensor
will be created for each selection. You can also select and deselect
all items by using the check box in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
1680 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
211 WMI Volume Sensor
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
DeviceID Shows the id of the volume that this sensor is monitoring. Once a
sensor is created this value cannot be changed. It is shown for
reference purposes only. If you need to change this, please add
the sensor anew.
Drive Type Shows the type of the drive the sensor is monitoring. Once a
sensor is created this value cannot be changed. It is shown for
reference purposes only. If you need to change this, please add
the sensor anew.
Timeout (sec) Enter a timeout in seconds for the WMI request. If the reply takes
longer than this value the request is aborted and an error message
is triggered.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
07.02.2013 1681
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
211 WMI Volume Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
1682 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
211 WMI Volume Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
07.02.2013 1683
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
211 WMI Volume Sensor
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
1684 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
211 WMI Volume Sensor
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
07.02.2013 1685
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
212 WMI Volume Fragmentation Sensor
The WMI Volume Fragmentation sensor monitors the fragmentation of a logical volume via
Windows Management Instrumentation (WMI). It can show if a defragmentation is recommended
on the volume, the number of average fragments per file, the number of excess fragments in
total, the number of fragmented files in total, and file fragmentation in percent.
This sensor type uses lookups to determine the status values of some sensor channels. For
details, please see section Define Lookups 2039 .
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on.
Note: Sensors using the Windows Management Instrumentation (WMI) protocol have high
impact on the system performance! Try to stay below 200 WMI sensors per probe 77 . Above
this number, please consider using multiple Remot e Probes 2050 for load balancing.
For a general introduction to the technology behind WMI, please see Monit oring via WMI 1959
section.
This sensor type requires the Microsoft .NET Framework to be installed on the computer
running the PRTG probe: Either on the local system (on every node, if on a cluster probe), or
on the system running the remote probe 2050 . If the framework is missing, you cannot create
this sensor. Note: You need to install the exact version required (a higher version will usually
not work; an exception applies to .NET 3.5 which comprises .NET 2.0 and .NET 3.0). Generally, it
is possible to run several .NET Framework versions on the same machine side-by-side. Please
install the latest update available for the required version.
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
In order to monitor fragmentation on volumes, PRTG will create one sensor for each volume
you choose. The settings you make in this dialog are valid for all of the sensors that are
created.
The following settings for this sensor differ in the 'Add Sensor' dialog in comparison to the
sensor's settings page:
1686 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
212 WMI Volume Fragmentation Sensor
Volume Select one or more volumes you want to add a sensor for. A list of
all available items is shown with their name. Select the desired
items by adding check marks in front of the respective lines. One
sensor will be created for each selection. You can also select and
deselect all items by using the check box in the table head.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
14.01.2014 1687
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
212 WMI Volume Fragmentation Sensor
Drive Type Shows the type of the disk drive monitored by this sensor. Once a
sensor is created this value cannot be changed. It is shown for
reference purposes only. If you need to change this, please add
the sensor anew.
Drive Letter This field is only visible when the drive letter option is selected
above. Enter the letter of the drive you want to monitor followed
by a trailing colon, for example, C:.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
1688 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
212 WMI Volume Fragmentation Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
14.01.2014 1689
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
212 WMI Volume Fragmentation Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
1690 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
212 WMI Volume Fragmentation Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
14.01.2014 1691
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
212 WMI Volume Fragmentation Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1692 14.01.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
213 WMI Windows Version Sensor
The WMI Windows Version sensor reads the Windows version of the parent device via
Windows Management Instrumentation (WMI). It returns the version number (in a channel) as
well as the according version name (in the sensor message).
Note: This sensor type can have a high impact on the performance of your monitoring system.
Please use it with care! We recommend using not more than 50 sensors, on each probe, of this
type of sensor.
This sensor type requires the Microsoft .NET Framework to be installed on the computer
running the PRTG probe: Either on the local system (on every node, if on a cluster probe), or
on the system running the remote probe 2050 . If the framework is missing, you cannot create
this sensor. Note: You need to install the exact version required (a higher version will usually
not work; an exception applies to .NET 3.5 which comprises .NET 2.0 and .NET 3.0). Generally, it
is possible to run several .NET Framework versions on the same machine side-by-side. Please
install the latest update available for the required version.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on. In the parent device's 276 Credent ials for Windows Sy st ems settings,
please prefer using Windows domain credentials.
Note: If you use local credentials, please make sure the same Windows user accounts (with
same username and password) exist on both the system running the PRTG probe and the
target computer. Otherwise the sensor cannot connect correctly.
Note: Your Windows credentials may not contain any double quotation marks ("). If they do,
this sensor will not work!
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
07.02.2013 1693
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
213 WMI Windows Version Sensor
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
If Value Changes Define what will be done in case the value of this sensor changes.
You can choose between:
· Ignore changes (default ): No action will be taken on change.
· Trigger 'change' not ificat ion: The sensor will send an internal
message indicating that its value has changed. In combination
with a Change Trigger, you can use this mechanism to trigger a
notification 1716 whenever the sensor value changes.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
1694 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
213 WMI Windows Version Sensor
Sensor Display
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
07.02.2013 1695
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
213 WMI Windows Version Sensor
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
1696 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
213 WMI Windows Version Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
07.02.2013 1697
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
213 WMI Windows Version Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
1698 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
214 WSUS Statistics Sensor
The WSUS Statistics sensor monitors various statistics on a Windows Server Update Services
(WSUS) server using Windows Management Instrumentation (WMI).
It can show the number of: Approved updates, computers having update errors, computers
needing updates, computers not synchronized for 7 days, computers registered, computers up
to date, declined updates, expired updates, not approved critical or security updates, not
approved updates, total updates, unapproved needed updates, updates needed by computers,
updates needing files, updates up to date, updates with client errors, updates with server
errors, updates with stale update approvals, and the number of WSUS infrastructure updates
not approved for installation.
Note: This sensor type can have a high impact on the performance of your monitoring system.
Please use it with care! We recommend using not more than 50 sensors, on each probe, of this
type of sensor.
This sensor type requires the Microsoft .NET Framework to be installed on the computer
running the PRTG probe: Either on the local system (on every node, if on a cluster probe), or
on the system running the remote probe 2050 . If the framework is missing, you cannot create
this sensor. Note: You need to install the exact version required (a higher version will usually
not work; an exception applies to .NET 3.5 which comprises .NET 2.0 and .NET 3.0). Generally, it
is possible to run several .NET Framework versions on the same machine side-by-side. Please
install the latest update available for the required version.
For this sensor type credentials for Windows systems must be defined for the device you want
to use the sensor on. In the parent device's 276 Credent ials for Windows Sy st ems settings,
please prefer using Windows domain credentials.
Note: If you use local credentials, please make sure the same Windows user accounts (with
same username and password) exist on both the system running the PRTG probe and the
target computer. Otherwise the sensor cannot connect correctly.
Note: Your Windows credentials may not contain any double quotation marks ("). If they do,
this sensor will not work!
In order for this sensor to work, Microsoft's WSUS 3.0 Administration Console must be
installed on the computer running the PRTG probe: Either on the local system (on every node,
if on a cluster probe), or on the system running the remote probe.
07.02.2013 1699
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
214 WSUS Statistics Sensor
Add Sensor
The Add Sensor dialog appears when adding a new sensor on a device manually 220 . It only
shows the setting fields that are imperative for creating the sensor. Therefore, you will not see
all setting fields in this dialog. You can change all settings in the sensor's Set t ings tab later.
Sensor Settings
On the sensor's details page, click on the Set t ings tab to change settings.
Note: If not set explicitly in a sensor's settings, it will connect to the IP Address or DNS Name
defined in the settings of the parent device the sensor is created on.
Sensor Name Enter a meaningful name to identify the sensor. The name will be
shown by default in the device tree and in all alarms.
Tags Enter one or more tags, separated by space or comma. You can
use tags to group sensors and use tag-filtered views later on. Tags
are not case sensitive. We recommend using the default value. You
can add additional tags to it, if you like. Other tags are
automatically inherited 89 from objects further up in the device
tree. Those are not visible here.
Priority Select a priority for the sensor. This setting determines where the
sensor will be placed in sensor lists. Top priority will be at the top
of a list. You can choose from one star (low priority) to five stars
(top priority).
WSUS Server Port Define the port where the WSUS server service is running on.
Default value is 80. Please enter an integer value.
Use SSL Define if SSL-encryption will be used for the connection to the
WSUS server. Choose between:
§ Yes
§ No
If Value Changes Define what will be done in case the value of this sensor changes.
You can choose between:
· Ignore changes: No action will be taken on change.
1700 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
214 WSUS Statistics Sensor
· Trigger 'change' not ificat ion: The sensor will send an internal
message indicating that its value has changed. In combination
with a Change Trigger, you can use this mechanism to trigger a
notification 1716 whenever the sensor value changes.
Sensor Display
Primary Channel Select a channel from the list to define it as the primary channel. In
the device tree, the last value of the primary channel will always be
displayed underneath the sensor's name. The available options
depend on what channels are available for this sensor. Note: You
can set another primary channel later by clicking on the pin symbol
of a channel in the sensor's overview tab.
Chart Type Define how different channels will be shown for this sensor.
§ Show channels independent ly (default ): Show an own graph
for each channel.
§ St ack channels on t op of each ot her: Stack channels on top of
each other to create a multi-channel graph. This will generate an
easy-to-read graph which visualizes the different components of
your total traffic. Note: This option cannot be used in
combination with manual Vertical Axis Scaling (available in the
Sensor Channels Set t ings 1709 settings).
Stack Unit This setting is only available if stacked graphs are selected above.
Choose a unit from the list. All channels with this unit will be
stacked on top of each other. By default, you cannot exclude
single channels from stacking, if they use the selected unit.
However, there is an advanced procedure to do so.
Inherited Settings
By default, all following settings are inherited from objects higher in the hierarchy and should
be changed there, if necessary. Often, best practice is to change them centrally in the Root 224
group's settings. To change a setting for this object, disable inheritance by clicking on the
check mark symbol in front of the respective setting name. You will then see the options
described below.
Scanning Interval The scanning interval determines the time the sensor waits
between two scans. Select a scanning interval (seconds, minutes,
or hours) from the list. You can change the available intervals in
the system administration 1839 .
07.02.2013 1701
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
214 WSUS Statistics Sensor
Schedule Select a schedule from the list. Schedules can be used to monitor
for a certain time span (days, hours) throughout the week. With the
period list option it is also possible to pause monitoring for a
specific time span. You can create new schedules and edit existing
ones in the account settings 1817 . Note: Schedules are generally
inherited. New schedules will be added to existing ones, so all
schedules are active.
Maintenance Begins At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the start date and time of the
maintenance window.
Maintenance End At This field is only visible if maintenance window is enabled above.
Use the date time picker to enter the end date and time of the
maintenance window.
1702 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
214 WSUS Statistics Sensor
§ Mast er object for parent : Make this sensor the master object
for its parent device. The sensor will influence the behavior of
the device it is created on: If the sensor is in a Down status, the
device will be paused. For example, it is a good idea to make a
Ping sensor the master object for its parent device to pause
monitoring for all other sensors on the device in case the device
cannot even be pinged. Additionally, the sensor will be paused if
the parent group of its parent device is in a Down status, or if it
is paused by another dependency.
Note: Testing your dependencies is easy! Simply choose Simulat e
Error St at us from the context menu of an object that other
objects depend on. A few seconds later all dependent objects
should be paused.
Dependency This field is only visible if the select object option is enabled above.
Click on the reading-glass symbol and use the object selector 159
to choose an object on which the current sensor will be
dependent on.
Delay (Seconds) Define a time span. After the master object for this dependency
comes back to an Up status, monitoring of the depending objects
will be additionally delayed by the defined time span. This can help
avoid false alarms, for example, after a server restart, by giving
systems more time for all services to start up. Please enter an
integer value in seconds. Note: This setting is not available if you
choose this sensor to be the Mast er object for parent . In this
case, please define delays in the parent Device Set t ings 272 or the
superior Group Set t ings 253 .
07.02.2013 1703
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
214 WSUS Statistics Sensor
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Channel Unit Types For each type of sensor channel, define the unit in which data is
displayed. If defined on probe, group, or device level, these
settings can be inherited to all sensors underneath. You can set
units for the following channel types (if available):
§ Bandwidt h
§ Memory
§ Disk
§ File
§ Cust om
Note: Custom channel types can be set on sensor level only.
1704 07.02.2013
Part 6: Ajax Web Interface—Device and Sensor Setup | 8 Sensor Settings
214 WSUS Statistics Sensor
In order to change display settings, spike filter, and limits, please switch to the sensor's
Overview tab and click on the gear icon of a specific channel. For detailed information, please
see Sensor Channels Set t ings 1709 section.
Notifications
Click on the Not ificat ions tab to change notification triggers. For detailed information, please
see Sensor Not ificat ions Set t ings 1716 section.
Others
For more general information about settings, please see Object Set t ings 142 section.
07.02.2013 1705
Part 6: Ajax Web Interface—Device and Sensor Setup | 9 Additional Sensor Types (Custom Sensors)
Basics
For a general introduction, please see the sections about EXE/Script sensors and the API
documentation which contains details about the necessary return format for those sensors.
WMI Custom sensors allow executing WQL requests.
After installing PRTG Network Monitor you will already find a selection of custom EXE/Script
and WMI WQL script sensors in the PRTG program directory 2074 . Many of these are sample
projects that you can edit and improve for your needs.
1706 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 9 Additional Sensor Types (Custom Sensors)
To create a new sensor based on one of these files, create a new EX E/Script Sensor 431 and
choose the respective file from the drop down list.
To create a new sensor based on one of these files, create a new EX E/Script Advanced
Sensor 440 and choose the respective file from the drop down list.
To create a new sensor based on one of these files, create a new WMI Cust om Sensor 1529 and
choose the respective file from the drop down list.
A good resource is the PRTG Add-Ons website on the open source platform Google Code.
There are also additional tools available.
28.05.2014 1707
Part 6: Ajax Web Interface—Device and Sensor Setup | 9 Additional Sensor Types (Custom Sensors)
More
For the other sensor types that work out-of-the-box, please see
§ List of Available Sensor Ty pes 291
Knowledge Base: How can I test if parameters are correctly transmitted to my script when
using an EXE/Script sensor?
§ http://kb.paessler.com/en/topic/11283
1708 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 10 Sensor Channels Settings
On the sensor's Overview page, click on the gear icon of a specific channel gauge to change
its settings. A click on the pin symbol on the left of the gear icon in a gauge will make this
channel the primary channel of the selected sensor.
You can alternatively call the settings of a channel by clicking on the respective gear icon in
the channels data table underneath the gauges.
Note: For lookup 2039 channels, we recommend staying below 120 lookup values to get
expressive gauges. For non-primary lookup channels, the upper limit is around 40 lookup
values.
The available options are nearly the same for all sensor types. An exception applies to the
"Downtime" channel which is automatically calculated and does not offer all settings. Channels
with "absolute" values additionally have an option for defining the Value Mode. You can quickly
choose another channel of the selected sensor via the dropdown list on the top of the
settings dialog.
28.05.2014 1709
Part 6: Ajax Web Interface—Device and Sensor Setup | 10 Sensor Channels Settings
Name Enter a meaningful name to identify the channel (not editable for
script sensors after sensor creation). The name will be shown in
graphs and tables. You can automatically add the sensor's ID to the
name by using the placeholder [#id].
Unit This field is only visible for script sensors, the SNMP Custom
sensor, and the SNMP Library sensor. Enter a string describing the
unit of the returned values. This is for display purposes only. Please
enter a string.
1710 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 10 Sensor Channels Settings
Value Lookup This field is only visible for script sensors, the SNMP Custom
sensor, and the SNMP Library sensor. Select the lookup list to be
applied to this channel's settings.
Line Color Define in what color the channel will be displayed in graphs. You
can choose between
§ Aut omat ic
§ Manual
When you set this option to manual color definition please enter a
color below.
Color (#rrggbb) This option is only available if Manual is selected in the Line Color
setting above. Please either enter a color in hexadecimal RGB
notation (as in HTML/CSS), or choose a color from the visual color
selector. The field containing the hexadecimal color value will
change to the resulting color immediately in both cases.
Data This setting is available for most channels. Define how data will be
displayed. Choose between:
§ Display act ual values in [unit]: Display the values in the unit
shown.
§ Display in percent of maximum: Calculate and show percent
values based on a maximum value. Provide a maximum below.
Maximum ([unit]) This field is only visible if the percent of maximum setting is
selected above. Enter a value that will be regarded as maximum.
Please pay attention to the given unit. All percent values will be
calculated based on this value. Please enter an integer value.
28.05.2014 1711
Part 6: Ajax Web Interface—Device and Sensor Setup | 10 Sensor Channels Settings
Line Width Define in what color the channel will be displayed in graphs. Enter
an integer value in pixels. Although the line width is not limited, we
recommend using values between 1 and 7 only in order to achieve
optimal results.
Value Mode This setting is only available for sensor channels which return
absolute values. It is not available for sensors showing difference
values, such as traffic sensors. Depending on this setting, the
channel can not only show averages, but also minimum or
maximum values in the graphs for the respective time spans.
Choose between:
§ Average: The channel shows average values.
§ Minimum: The channel shows minimum values.
§ Maximum: The channel shows maximum values.
See section More for more information.
Decimal Places Define how many decimal places of the channel's data will be
displayed in graphs and tables. Choose between:
§ Aut omat ic: Let PRTG choose how many decimal places will be
used for optimal viewing results.
§ All: Force display of all available decimal places.
§ Cust om: Manually define the number of decimal places. If you
choose this option, an additional field will appear. Please enter an
integer value there.
Spike Filter A spike filter can be used to correct obviously faulty monitoring
data. Sometimes, sensors report enormously high or far too low
values; due to an error in data transmission, or due to
incompatibilities of the physical device you are monitoring. This can
make graphs unreadable. A spike filter can compensate for these
flaws. When enabled values above and below a certain limit are
disregarded in the monitoring data for graphs and tables. Note: The
monitoring data itself will not be changed (but only the
presentation of the data) and this setting is valid for all data of this
channel (also the historic data). Choose between:
§ Disable Filt ering: Display all data as it is; do not filter out spikes.
§ Enable Filt ering: Enable a filter to remove spike values.
Additional fields appear below.
Note: The spike filter option is not available for the channel
Downt ime.
1712 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 10 Sensor Channels Settings
Spike Filter Max. Value This field is only visible if spike filter is enabled above. Specify the
[unit] maximum value allowed in the channel's data. All values above this
value will be disregarded in graphs and tables. Please enter an
integer value or leave the field empty.
Spike Filter Min. Value This field is only visible if spike filter is enabled above. Specify the
[unit] minimum value allowed in the channel's data. All values below this
value will be disregarded in graphs and tables. Please enter an
integer value or leave the field empty.
Vertical Axis Scaling Define how the vertical axis for the channel is displayed in graphs.
Choose between:
§ Aut omat ic Scaling: Let PRTG decide on the optimum scaling;
usually ranging from the minimum to the maximum value. PRTG
will use one single scale for each unit label only.
§ Manual Scaling: Define the scaling manually. Additional fields
appear below. Defining manual axis scaling can make low values
better visible in your graph; but it may result in a chart with
multiple vertical axis for the same unit label.
Note: Settings for this option are ignored if Chart Type St ack
channels on t op of each ot her or Show in and out t raffic as
posit ive and negat ive area chart (available for traffic sensors) is
enabled in the sensor's Set t ings tab.
Vertical Axis Maximum This field is only visible if vertical axis scaling is enabled above.
[unit] Specify the maximum value that will be used on the vertical axis for
the channel. Enter an integer value.
Vertical Axis Minimum This field is only visible if vertical axis scaling is enabled above.
[unit] Specify the minimum value that will be used on the vertical axis for
the channel. Enter an integer value.
Limits The channel can affect the status of the sensor it is part of. By
entering limits, you can define when the sensor will enter a
Warning or Down status; depending on the channel's data. Using
this function, you can e.g. set a traffic sensor (which is usually
never in a down state) to error when certain limits that you
consider critical are reached.
Choose between:
§ Disable Limit s: Do not use the channel's data to control the
sensor's status.
§ Enable Limit s: Define limits. Additional fields appear below. The
sensor belonging to the channel will enter a Warning or Down
status when limits are undercut or overrun.
28.05.2014 1713
Part 6: Ajax Web Interface—Device and Sensor Setup | 10 Sensor Channels Settings
Note: The limits option is not available for the channel "Downtime".
Note: If a channel uses lookups 2039 , we strongly recommend you to
control the sensor status only via the lookup definition. If you
define limits in addition here, the sensor will use both the channel
limits and the status as defined in the lookup file. In this case,
channel limits will determine the overall status of the sensor and
overwrite the sensor message while the channel gauge still shows
the status as defined in the lookups.
Upper Error Limit [unit] This field is only visible if limits are enabled above. Specify an upper
limit for an error state. If the channel's values overrun this value,
the sensor will be set to Down. Note: While a sensor shows a
Down 121 status triggered by a limit, it will still receive data in its
channels. Please enter a decimal value or leave the field empty.
Upper Warning Limit This field is only visible if limits are enabled above. Specify an upper
[unit] limit for a warning state. If the channel's values overrun this value,
the sensor will be set to Warning. Please enter a decimal value or
leave the field empty.
Lower Warning Limit This field is only visible if limits are enabled above. Specify a lower
[unit] limit for a warning state. If the channel's values undercut this value,
the sensor will be set to Warning. Please enter a decimal value or
leave the field empty.
Lower Error Limit [unit] This field is only visible if limits are enabled above. Specify a lower
limit for an error state. If the channel's values undercut this value,
the sensor will be set to Down. Note: While a sensor shows a
Down 121 status triggered by a limit, it will still receive data in its
channels. Please enter a decimal value or leave the field empty.
Error Limit Message This field is only visible if limits are enabled above. Enter an
additional message. It will be added to the sensor's message when
entering a Down status. Please enter a string or leave the field
empty.
Warning Limit Message This field is only visible if limits are enabled above. Enter an
additional message. It will be added to the sensor's message when
entering a Warning status. Please enter a string or leave the field
empty.
More
Knowledge Base: What is the Value Mode in channel settings?
1714 28.05.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 10 Sensor Channels Settings
§ http://kb.paessler.com/en/topic/60238
For information about sensor settings, please see the following sections:
28.05.2014 1715
Part 6: Ajax Web Interface—Device and Sensor Setup | 11 Sensor Notifications Settings
Note: Although the sensors activate a trigger, you can set notification triggers higher in the
hierarchy (for example for groups or devices), thus defining triggers for multiple sensors using
the inheritance mechanism 87 .
Note
This section describes one of three steps to set up the notification system in PRTG. A
complete notification setup involves:
1. Check and set up the Not ificat ion Delivery settings. This will tell PRTG how to send
messages.
For detailed information, see Sy st em Administ rat ion—Not ificat ion Delivery 1843 .
2. Check and set up several Not ificat ions. This will define the kind of message and its
content.
For detailed information, see Account Set t ings—Not ificat ions 1817 .
3. Check and set up Not ificat ion Triggers for objects. These will provoke the defined
notifications.
For detailed information, see Sensor Not ificat ions Set t ings 1716 .
For background information, please see Not ificat ions 1749 section.
1716 03.04.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 11 Sensor Notifications Settings
On an object's detail page, click on the Not ificat ions tab to change sensor notification
triggers. The available options are the same for all objects. When defining triggers for probes,
groups, or devices, they can be inherited down to sensor level.
You see a list of all notification triggers that are defined higher in the hierarchy. The list is
empty when there are no triggers defined in groups or devices above the current object.
You can see the type and the notifications that are executed once this trigger is activated.
Trigger Inheritance Define whether the triggers shown above will be handed on to the
current object. Choose between:
§ Inherit t rigger(s) from parent object (s): Use the triggers
shown above.
§ Only use t riggers defined for t his object : Do not use the
triggers shown above; for this object only use the triggers
defined below.
This setting is valid for all triggers shown above. It is not possible
to only select some of them.
You can set up one or more of the following triggers, each with different setting options.
Which trigger types will be visible depends on the kind of object you're editing:
All notification triggers can be created in a very easy way, forming natural sentences. There are
different options for every type.
Define a trigger that is activated when a sensor changes its current status. This is the most
common reason to send out notifications. Click on the Add St at e Trigger button to add a
new trigger, or click on the Edit button next to an existing notification to change it. Then
define settings as described below. Every trigger will provoke one or more notification(s) 1817 to
be executed.
03.04.2014 1717
Part 6: Ajax Web Interface—Device and Sensor Setup | 11 Sensor Notifications Settings
St at e Trigger
When sensor is... Select the condition that will trigger the notification. The trigger will
be activated when a sensor enters the selected status. Choose
from the drop down menu:
§ Down: The trigger will be prompted if a sensor changes to a
Down status.
§ Warning: The trigger will be prompted if a sensor changes to a
Warning status.
§ Unusual: The trigger will be prompted if a sensor changes to an
Unusual status.
§ Part ial Down: The trigger will be prompted if a sensor changes
to a Down (Part ial) status (available in a cluster 81 configuration).
...for at least ... Define how many seconds will be waited before a notification is
seconds provoked. This can avoid false alarms in case a sensor 'flickers' and,
for example, changes to a down status for just a few seconds. If
the selected condition (i.e. the sensor status) persists after the
defined time in seconds, the notification will be triggered. Please
enter an integer value.
...perform... Select a notification that will be triggered if the condition (i.e. the
sensor status) selected is true and the latency time defined has
elapsed. Choose a notification from the drop down menu. The
menu shows all notifications defined in the Account Set t ings—
Not ificat ions 1817 setttings. You can also choose no not ificat ion
in order to only use other conditions for this trigger.
...and repeat every ... Define an interval in minutes in which the escalation notification
minutes (defined above) will be sent repeatedly. The second (escalation)
notification defined will be resent every x minutes. Please enter an
integer value.
1718 03.04.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 11 Sensor Notifications Settings
St at e Trigger
When condition clears Select a notification that will be triggered if the condition (i.e. the
perform... sensor status) selected is not true any more because the sensor's
status has changed again. Choose a notification from the drop
down menu. The menu shows all notifications defined in the
Account Set t ings—Not ificat ions 1817 setttings. You can also
choose no not ificat ion in order to only use other conditions for
this trigger.
Define a trigger that is activated when a sensor (for example, a traffic sensor) changes its
current speed. Click on the Add Speed Trigger button to add a new trigger, or click on the
Edit button next to an existing notification to change it. Then define settings as described
below. Every trigger will provoke one or more notification(s) 1817 to be executed.
Speed Trigger
When ... channel From the drop down menu, select the channel which's data will be
regarded for this comparison. Select Primary to generally use a
sensor's primary channel (this can be defined in the sensor's
settings 290 ) or choose a specific channel name from the list (there
are different channels for every sensor type). All following settings
for this trigger will be based on the chosen channel.
...is... Select the condition that will trigger the notification. Choose from
the drop down menu:
§ Above: The trigger will be prompted if the value of the selected
channel overruns a defined value.
§ Below: The trigger will be prompted if the value of the selected
channel undercuts a defined value.
§ Equal To: The trigger will be prompted if the value of the
selected channel is the same as a defined value.
§ Not Equal To: The trigger will be prompted if the value of the
selected channel is different than a defined value.
[value] Define the value the channel's data will be compared with. Please
enter an integer value.
03.04.2014 1719
Part 6: Ajax Web Interface—Device and Sensor Setup | 11 Sensor Notifications Settings
Speed Trigger
[scale] From the drop down menu, select the unit in which you entered
the [value] above. [scale] and [t ime] together define the unit for
the given value. If the channel's data is shown in a different unit
PRTG will automatically convert values internally. Choose between:
§ bit
§ kbit
§ mbit
§ gbit
§ t bit
§ By t e
§ KBy t e
§ MBy t e
§ GBy t e
§ TBy t e
[time] Select the time for the scale (so you create a scale per time
designation). Choose from the drop down menu:
§ second
§ minut e
§ hour
§ day
[scale] and [t ime] together define the unit for the given value. If
the channel's data is shown in a different unit PRTG will
automatically convert values internally.
..for at least ... Define how many seconds will be waited before a notification is
seconds provoked. This can avoid false alarms in case a channel reaches a
limit for just a few moments. If the combined channel condition of
[value], [scale], and [t ime] persists after the defined time span, the
notification will be triggered. Please enter an integer value.
1720 03.04.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 11 Sensor Notifications Settings
Speed Trigger
When condition clears Select a notification that will be triggered if the combined channel
perform... condition of [value], [scale], and [t ime] is not true any more
because the channel's value has changed again. Choose a
notification from the drop down menu. The menu shows all
notifications defined in the Account Set t ings—Not ificat ions 1817
settings. You can also choose no not ificat ion in order to only use
other conditions for this trigger.
Note: No escalation notification and no repeat are available for this trigger type.
Define a trigger that is activated when a sensor (for example, a traffic sensor) reaches a certain
volume limit in a specified time. Click on the Add Volume Trigger button to add a new trigger,
or click on the Edit button next to an existing notification to change it. Then define settings
as described below. Every trigger will provoke one or more notification(s) 1817 to be executed.
Volume Trigger
When ... channel From the drop down menu, select the channel which's data will be
regarded for this comparison. Select Primary to generally use a
sensor's primary channel (this can be defined in the sensor's
settings 290 ) or choose a specific channel name from the list (there
are different channels for every sensor type). All following settings
for this trigger will be based on the chosen channel.
...has reached... [value] Define the value the channel's data will be compared with. If the
channel's data overruns this value, a notification will be triggered.
Please enter an integer value.
[scale] From the drop down menu, select the unit in which you entered
the [value] above. [scale] and [t ime] together define the unit for
the given value. If the channel's data is shown in a different unit
PRTG will automatically convert values internally. Choose between:
§ By t e
§ KBy t e
§ MBy t e
§ GBy t e
03.04.2014 1721
Part 6: Ajax Web Interface—Device and Sensor Setup | 11 Sensor Notifications Settings
Volume Trigger
§ TBy t e
per [time] Select the time for the scale (so you create a scale per time
designation). Choose from the drop down menu:
§ Hour
§ Day
§ Week
§ Mont h
[scale] and [t ime] together define the unit for the given value. If
the channel's data is shown in a different unit PRTG will
automatically convert values internally.
Note: No escalation notification, no repeat, and no notification when condition clears are
available for this trigger type.
Define a trigger that is activated when a sensor reaches specific values. Click on the Add
Threshold Trigger button to add a new trigger, or click on the Edit button next to an existing
notification to change it. Then define settings as described below. Every trigger will provoke
one or more notification(s) 1817 to be executed.
Threshold Trigger
When ... channel From the drop down menu, select the channel which's data will be
regarded for this comparison. Select Primary to generally use a
sensor's primary channel (this can be defined in the sensor's
settings 290 ) or choose a specific channel name from the list (there
are different channels for every sensor type). All following settings
for this trigger will be based on the chosen channel.
1722 03.04.2014
Part 6: Ajax Web Interface—Device and Sensor Setup | 11 Sensor Notifications Settings
Threshold Trigger
...is... Select the condition that will trigger the notification. Choose from
the drop down menu:
§ Above: The trigger will be prompted if the value of the selected
channel overruns a defined value.
§ Below: The trigger will be prompted if the value of the selected
channel undercuts a defined value.
§ Equal To: The trigger will be prompted if the value of the
selected channel is the same as a defined value.
§ Not Equal To: The trigger will be prompted if the value of the
selected channel is different than a defined value.
[value] Define the value the channel's data will be compared with. It will be
directly compared to the channel's data. Please enter values in the
smallest possible (base) unit, for example, in bytes or seconds.
Please enter an integer value.
..for at least ... Define how many seconds will be waited before a notification is
seconds provoked. This can avoid false alarms in case a channel reaches a
limit for just a few moments. If the defined channel condition
persists after the defined time span, the notification will be
triggered. Please enter an integer value.
When condition clears Select a notification that will be triggered if the defined channel
perform... condition is not true any more because the channel's value has
changed again. Choose a notification from the drop down menu.
The menu shows all notifications defined in the Account Set t ings
—Not ificat ions 1817 settings. You can also choose no not ificat ion
in order to only use other conditions for this trigger.
Note: No escalation notification and no repeat are available for this trigger type.
03.04.2014 1723
Part 6: Ajax Web Interface—Device and Sensor Setup | 11 Sensor Notifications Settings
Define a trigger that is activated by an 'on change' trigger. Some sensors offer the option to
send such a trigger whenever sensor values have changed. Click on the Add Change Trigger
button to add a new trigger, or click on the Edit button next to an existing notification to
change it. Then define settings as described below. Every trigger will provoke one or more
notification(s) 1817 to be executed.
Change Trigger
When sensor changes Select a notification that will be triggered whenever a compatible
perform... sensor sends a 'change notification'. You can enable this option in
the settings 290 of some sensors. The notification trigger will be
activated immediately whenever a sensor sends an 'on change'
trigger. Choose a notification from the drop down menu. The menu
shows all notifications defined in the Account Set t ings—
Not ificat ions 1817 settings.
Note: There are no other options available for this trigger type.
For information about sensor settings, please see the following sections:
For more general information about object settings, please see section Object Set t ings 142 .
1724 03.04.2014
Part 7
Ajax Web Interface—Advanced Procedures
03.04.2014 1725
Part 7: Ajax Web Interface—Advanced Procedures |
Because the web interface works as a Single Page Application (SPA), you will rarely see a full
page refresh to avoid this performance impact due to redundant processing. Only single page
elements will be refreshed when necessary. All object setting dialogs are shown as pop-up
layers, so you will never lose the current context. This speeds up the user experience
appreciably and makes the configuration of objects in PRTG comprehensible.
The following sections introduce more advanced procedures in the Ajax Graphical User
Interface (GUI).
1726 03.04.2014
Part 7: Ajax Web Interface—Advanced Procedures |
§ Libraries 1759
§ Report s 1775
§ Maps 1794
§ Set up 1810
Related Topics
§ Ent erprise Console 1894
03.04.2014 1727
Part 7: Ajax Web Interface—Advanced Procedures | 1 Toplists
7.1 Toplists
Packet Sniffer and xFlow (NetFlow, jFlow, sFlow, IPFIX) sensor types can not only measure the
total bandwidth usage, they can also break down the traffic by IP address, port, protocol, and
other parameters. The results are shown in so-called Toplist s. This way PRTG is able to tell
which IP address, connection, or protocol uses the most bandwidth. PRTG looks at all network
packets (or streams) and collects the bandwidth information for all IPs, ports, and protocols. At
the end of the toplist period, PRTG stores only the top entries of each list in its database.
Storing all available analysis data in a database during the analysis process would create a huge
amount of data which would be very slow to transfer between probe and core and also
retrieving data would be too slow. By storing only the top 100 entries for short periods of
time it is possible to reduce the amount of data to a minimum while still being able to identify
devices with huge bandwidth usage.
Toplists Overview
Toplist s are available for xFlow, IPFIX, and Packet Sniffer sensors 291 only. Toplist graphs are
displayed right on the sensor overview page. By default, there are three different toplists
predefined for each sensor:
1728 03.04.2014
Part 7: Ajax Web Interface—Advanced Procedures | 1 Toplists
Click on one of these items to view a distribution chart and a list of source and destination IP
and port, protocols, kind of traffic in different channels, etc. It depends on the selected list
which information is available. Click on an entry in the Toplist Periods lists on the left side to
view data for a certain time span. By default, a time span of 15 minutes is set. Additionally,
several table list options 156 are available.
In order to print a toplist, click on the Print t his t oplist button to view a printer-friendly
version and then use the print option of your browser to send it to your printer. With Sensor
Overview you will return to the current sensor's overview tab. For a quick selection of other
toplists of the current sensor, click on one of the toplist icons at the top of the page.
In the sensor overview, you can add or delete new toplists, or edit existing ones.
03.04.2014 1729
Part 7: Ajax Web Interface—Advanced Procedures | 1 Toplists
Add
Click on the Add Toplist item in the sensor overview to create a new toplist. The available
options are the same as for editing 1730 a list.
Edit
Click on the small gear icon of a toplist item in the sensor overview to modify it.
Type § Top Talkers (Which IPs use t he most bandwidt h?): Shows
bandwidth usage by IP address.
§ Top Connect ions (Which connect ions use most bandwidt h?):
Shows bandwidth usage by connection.
§ Top Prot ocols (Which prot ocols use t he most bandwidt h?):
Shows bandwidth usage by protocol.
§ Cust om (Creat e y our own t oplist ): Create your own list by
selecting criteria below.
Toplist is based on This setting is only available if a custom type is selected above.
Select the fields you want to add to the toplist by adding a check
mark in front of the respective field name. The available options
depend on the type of sensor used. They're different for Packet
Sniffer, NetFlow v5, v9 (and IPFIX), and sFlow. Note: For
performance reasons, only select the field you really want to
monitor. Please see Performance Considerat ions 1731 section
below.
Period (Minutes) Define the interval for the toplist in minutes. Please enter an
integer value. Toplists always cover a certain time span. Once a
time span has passed, the top results are stored and a new toplist
is started. Note: In order to avoid load problems on your probe
system, please do not set this interval too long. Default setting is
15 minutes. Please see Performance Considerat ions 1731 section
below.
Top Count Define the length of your toplist. Only this number of entries will be
stored for each period. Please enter an integer value. Note: In
order to avoid load problems on your probe system, please do not
set this value as low as possible. Default setting is 100, in order to
store the top 100 entries for each period. Please see Performance
Considerat ions 1731 section below.
1730 03.04.2014
Part 7: Ajax Web Interface—Advanced Procedures | 1 Toplists
Probe/Core Data Define how the probe sends the toplist dataset to the core server.
Transfer Choose between:
§ According t o sensor int erval (default ): Send data in the
interval defined in the settings of the sensor this toplist is
created for. This can create a lot of bandwidth and CPU load with
many sniffer sensors, complex traffic, or long toplists.
§ Wait unt il t oplist period ends (less cpu&bandwidt h usage):
Send data once a toplist period has finished. This will create less
bandwidth usage and CPU load, but you cannot see the current
toplist in the web interface, but only toplists with finished
periods.
For more information, please see Performance Considerat ions 1731
section below.
Memory Limit (MB) Define the maximal amount of memory in MB the probe will use for
collecting the different connection information. Every toplist adds
its amount to the probe's memory consumption. Increase this value
if the number of captured connections is not sufficient. Please
enter an integer value.
Click on the Save button to store your settings. If you change tabs or use the main menu, all
changes to the settings will be lost!
Delete
Click on the small trashcan icon of a toplist item in the sensor overview to delete it. Confirm
with Delet e to delete the list.
Details
Performance Considerations
If you create toplists for data lines with considerable usage (for example, steady bandwidth
over 10 Mbit/s) or if the traffic is very diverse (for example, many IPs/ports with only little traffic
each) please consider the following aspects:
§ The probe gathers all information needed for the toplist in RAM memory during each period.
Only the top 100 entries are transferred to the core. Depending on the toplist type and
traffic patterns the required memory can grow into many megabytes.
§ Choose periods as short as desirable (especially important when traffic has a high level of
diversity) to minimize memory usage.
03.04.2014 1731
Part 7: Ajax Web Interface—Advanced Procedures | 1 Toplists
§ Memory requirements can grow almost exponentially with each field used in the toplists
definition (depending on traffic pattern). Avoid complex toplists for high and diverse traffic.
For example, Top Connect ions (5 fields) needs a lot more memory than Top Talkers (1
field).
§ If you experience high bandwidth usage between core and probe try to choose the Wait
unt il t oplist period ends option in the toplist settings 1730 .
§ If you experience Data incomplete, memory limit was exceeded messages try to increase the
memory limit in the toplist settings but keep an eye on the probe process' memory usage.
Notes
§ When working with toplists be aware that privacy issues can come up for certain
configurations of this feature. Using toplists you can track all single connections of an
individual PC to the outside world and you, as the administrator, must make sure that it is
legal for you to configure PRTG like this.
§ Keep in mind that toplists can be viewed through the web interface. You may not want to
show lists of domains used in your network to others. So you should restrict access to
sensor types having toplists.
§ Note that diagrams, for example, for top connections are not meant to be used for detailed
analysis. Rather they should indicate if there is an uncommon bigger change in this toplist.
More
§ Monit oring Bandwidt h via Flows 1966
1732 03.04.2014
Part 7: Ajax Web Interface—Advanced Procedures | 2 Arrange Objects
While viewing the device tree (or parts of it), click on the Manage tab to switch to a tree view
in which you can move monitoring objects using drag&drop in your browser window. For
more information, see section Manage Device Tree 222 .
When viewing the Overview tab of a device, you will see a list of all sensors on this device.
Click on the column headers Pos, Sensors, St at us, or Priorit y to re-sort the sensor list. To
change a sensor's position, simply click on the small grip at the beginning of the row, drag it to
the position you like, and drop it. Changes take effect immediately.
You can also right-click on any object to show the Context Menu 163 . Select the Move entry to
move sensors, devices, or groups up and down, or to move groups or devices into other
groups or on other probes.
14.01.2014 1733
Part 7: Ajax Web Interface—Advanced Procedures | 3 Clone Object
they bring about working sensors or not (which often depends on the settings of the cloned
device).
Note: You cannot clone 'fixed' objects, such as the root group or a probe device. You cannot
clone the sensor types QoS (Qualit y of Service) One Way Sensor 820 and QoS (Qualit y of
Service) Round Trip Sensor 826 .
Note: If you want to clone a sensor, a faster way will be to use the Manage Device Tree 222
function.
To start, right click on an object in your device tree, and from the context menu 163 , select
Clone.... An assistant will appear.
1734 03.04.2014
Part 7: Ajax Web Interface—Advanced Procedures | 3 Clone Object
Object To Be Cloned
New Object Name Enter a name for the cloned object. By default, the old name is filled
in, proceeded by Clone of.
New IP Address/DNS This field is only available when cloning a device. Enter the IP
Name address or DNS name for the new device.
From the device tree shown, choose an object you want to add the cloned object to. When
cloning a group or device, select a group. When cloning a sensor, select the device you
want to add it to.
Click on the Cont inue button to store your settings. If you change tabs or use the main menu,
all changes to the settings will be lost!
You will be redirected to the newly cloned object's overview 124 page. By default, all sensors
are initially paused to give you the chance to change settings before monitoring starts. Please
check the settings 142 and resume 162 monitoring.
Related Topics
§ Creat e Device Templat e 1741
03.04.2014 1735
Part 7: Ajax Web Interface—Advanced Procedures | 4 Multi-Edit
7.4 Multi-Edit
Device and sensor table lists, as well as some other lists, offer multi-edit functionality. With this,
you can bulk edit the properties of many objects at a time. Multi-edit is also available in the
Management tab if you select multiple objects by holding down the Ctrl key (see Manage
Device Tree 223 ).
Note: Using multi-edit, not all settings can be changed. PRTG will offer only settings which all
selected objects have in common.
Note: The multi-edit option is not available for the standard user groups 1861 PRTG
Administrators and PRTG Users Group.
Start with viewing a table list. For example, choose Sensors | By Ty pe | ... or Devices | Device
List | ... from the main menu. Table lists are also available in the Overview tab of Libraries 1759 ,
Maps 1794 , Report s 1775 , Not ificat ions 1749 , and Schedules 1827 .
In a table list, start multi-edit by selecting objects using the check boxes on the right. You can
also select all objects of the current page at once by clicking the check box in the table
header. Use the It em Count option to view more items per page. As soon as you select one
or more objects, the multi-edit menu will appear at the top of the table and chosen objects are
shaded in green.
1736 03.04.2014
Part 7: Ajax Web Interface—Advanced Procedures | 4 Multi-Edit
Depending on the object type, different functions are available. For example, for sensor lists,
some frequently used functions are available as quick buttons, such as Delet e, Pause, Resume,
Check Now, and Set t ings. If you click on one of those buttons, the respective function will be
applied to all selected objects.
Other options are available in the drop down menu. Hover the arrow symbol to show it.
The options in this menu vary depending on the kind of objects selected. If you choose an
entry, the respective function will be applied to all selected objects.
Once you have selected the objects you want to change settings for, click on the screwdriver
symbol to enter the edit settings mode. For available settings, please see below.
§ Hold down the Ctrl key and select multiple groups, devices, or sensors (one of a kind).
§ In the appearing dialog, select the settings you would like to edit, change the according
values and click on Save. The changes will be applied to all selected objects.
03.04.2014 1737
Part 7: Ajax Web Interface—Advanced Procedures | 4 Multi-Edit
Edit Settings—Settings
In the multi-selected sensors' Set t ings tab within the Edit Mult iple Object s popup, you can
edit most of the sensors' properties which they have in common, respectively in the Edit
Mult iple Object s popup for devices. For example, for devices or sensors, edit the name, tags,
priority, scanning interval, access rights, etc.
The available options depend on the selected objects and will vary according to your
selection. When editing multiple sensors, it may be useful to only choose one certain sensor
type from the list, so that there are as much settings as possible available for multi-edit.
In order to change a property, add a check mark in front of the respective line and then
change the settings. The new setting(s) will be applied to all objects you selected for multi-
edit. All properties that are not activated with a check mark will remain unchanged.
Click on the OK button to store your settings. If you close the popup via the X or Cancel
button, all changes to the settings will be lost!
1738 03.04.2014
Part 7: Ajax Web Interface—Advanced Procedures | 4 Multi-Edit
The Channel Set t ings tab in the Edit Mult iple Object s popup is only available when editing
sensors. You can edit settings of all channels which the selected sensors have in common.
Select a channel name from the Channel list. You can then edit, for example, channel name, ID,
display settings, colors, scaling, limits, etc.
The available options depend on the selected sensors and will vary according to your
selection. It may be useful to only choose one certain sensor type from the list, so that there
are as much channel settings as possible available for multi-edit.
In order to change a property, add a check mark in front of the respective line and then
change the channel settings. The new setting(s) will be applied to all sensors you selected for
multi-edit. All properties that are not activated with a check mark will remain unchanged.
Click on the OK button to store your settings. If you close the popup via the X or Cancel
button, all changes to the settings will be lost!
Related Topics
§ Working wit h Table List s 156
03.04.2014 1739
Part 7: Ajax Web Interface—Advanced Procedures | 4 Multi-Edit
1740 03.04.2014
Part 7: Ajax Web Interface—Advanced Procedures | 5 Create Device Template
To start, right click on a device in your device tree, and from the context menu 163 , select
Creat e Device Templat e.... An assistant will appear.
File Name Enter a name under which the file will be stored. It will be stored
with the extension .odt in the \PRTG Network Monitor
\devicetemplates sub-directory of your PRTG core installation (of
the Master node, if in a cluster). The file may not exist in this
directory, otherwise you will see an error message.
Template Name Enter a meaningful display name for the template, as it will appear in
the web interface.
28.05.2014 1741
Part 7: Ajax Web Interface—Advanced Procedures | 5 Create Device Template
Click on the Cont inue button to store your settings. If you change tabs or use the main menu,
all changes to the settings will be lost!
You should see a success message indicating that your template file was saved. Finished! The
device template is now stored in the program path of your PRTG core installation. Your device
template file contains all sensors, including their settings, of the original device.
During your next auto-discovery, choose the Aut omat ic sensor creat ion using specific
device t emplat e(s) option and select the name of your newly created device template from
the list. PRTG will then try to discover the stored sensor types on the new (or existing) device.
If the physical device answers to a sensor request, the sensor is added to the PRTG device.
Note: Numbers will be added to the original sensor names. For detailed information, please
see Aut o-Discovery 190 section.
There are a few settings which cannot be saved into a device template, and will therefore be
set to default, such as the Dependency Type setting Mast er object for parent (in Schedules
and Dependencies section), and Result Handling settings Writ e result do disk (as this is
intended for debugging purposes only). Also, settings in the Access Right s section are not
saved to avoid security flaws.
Furthermore, due to internal restrictions, the following sensor types will not be saved into a
device template:
§ Amazon CloudWat ch
§ Core/Probe/Clust er Healt h
§ DHCP
§ Ent erprise Virt ual Array
§ IPFIX
§ IPFIX (Cust om)
§ IPMI Sy st em Healt h
§ jFlow V5
§ jFlow V5 (Cust om)
§ Net Flow V5
§ Net Flow V5 (Cust om)
§ Net Flow V9
§ Net Flow V9 (Cust om)
§ Packet Sniffer
§ Packet Sniffer (Cust om)
§ Passive Applicat ion Performance
§ QoS (Qualit y of Service)
1742 28.05.2014
Part 7: Ajax Web Interface—Advanced Procedures | 5 Create Device Template
Once a device template is created, it is not possible to add additional sensors to it. If you want
to create a template with an extended set of sensors, please create a new one. Note: When
saving a new device template, all internal IDs of the sensors contained in this template are
updated. Therefore, when applying a new template to an existing device, all sensors contained
in this template will be newly created on this device, even if those sensors were previously
created using (another) device template!
Related Topics
§ Clone Object 1734
28.05.2014 1743
Part 7: Ajax Web Interface—Advanced Procedures | 6 Geo Maps
For each probe, group, or device, you can enter Locat ion information. PRTG will use the first
line of this information to query a geographical map which shows your objects. Your location
specification will be resolved to global geographical coordinates by the PRTG core server with
the help of an external map service provider.
PRTG will connect to the specified maps provider to get map tiles. These are used to set up
the graphical map. Then the defined locations will be marked with the corresponding object
icons and their status 1747 on the map. You can select your favorite map tiles provider in
Sy st em Administ rat ion—User Int erface 1832 (setting Geo Maps).
Geographical maps can be displayed on the device tree. PRTG will adjust the zoom of a map
automatically such that all locations of a selected object can be displayed. You can also add
geographical maps to PRTG Maps 1794 . For this concern, go to the PRTG Maps Designer 1800
(either in an existing map or creating a new one) and choose the entry Geo Maps from the
properties menu on the right.
1744 28.05.2014
Part 7: Ajax Web Interface—Advanced Procedures | 6 Geo Maps
In order to use geographical maps within the PRTG web interface 100 or Ent erprise Console 1894
1. In the system administration (within the web interface), select the maps provider and type
you want to view. There, you will also find an option to disable geo maps integration if you
do not want to use it. See section Sy st em Administ rat ion—User Int erface 1832 (setting
Geo Maps) for detailed information.
2. In your objects' settings 142 , add a city name, or address, or coordinates in the first line of
the Locat ion field. As soon as you view the details of such an object, a geographical map
will be shown. The Locat ion information will also be used when viewing objects in the
Ent erprise Console 1894 or when adding Geo Maps objects to PRTG Maps 1794 .
3. Make sure your PRTG core server has access to the internet in order to obtain map tiles. If a
proxy is mandatory in your network, please configure proxy settings accordingly. For
details, please see Sy st em Administ rat ion—Core & Probes 1849 . For details about tile server
domains, please see More 1748 section below.
28.05.2014 1745
Part 7: Ajax Web Interface—Advanced Procedures | 6 Geo Maps
Labeling Locations
You can define your own labels for locations of objects. For this concern, enter the desired
label in the first line of the Locat ion settings and provide the geo coordinates of the location
in the second line. In PRTG's geo map, this object will be displayed with the defined label.
Defining Loc ation New York City with Geo Coordinates and Label
Big Apple
The location New York City will appear with the label Big Apple then:
It is also possible to define the same label for different locations. For example, imagine your
company's headquarter is spread over several different locations. For each object representing
a dedicated headquarter in the PRTG device tree, enter its coordinates in the second line of
the respective Locat ion settings and the label "Headquarter" in the first line. All corresponding
objects will be displayed as "Headquarter". This way, you can easily find your desired objects
on the map.
1746 28.05.2014
Part 7: Ajax Web Interface—Advanced Procedures | 6 Geo Maps
On the geographical maps the different location icons will show the overall status at this
location by using a color code. Following, all possible location states are listed ordered by
their hierarchy:
Note: For detailed information about sensor states, please see Sensor St at es 121 section.
28.05.2014 1747
Part 7: Ajax Web Interface—Advanced Procedures | 6 Geo Maps
It is possible to show the location of an Android device and track its movements on PRTG Geo
Maps. PRTG can draw the route a device has taken directly into geo maps. For this feature, you
need the PRTG Mobile Probe for Android. See section More 1748 for details.
More
Knowledge Base: Which provider should I use for PRTG's "Geo Maps" feature?
§ http://kb.paessler.com/en/topic/34603
Knowledge Base: Which domains and ports does the GeoMaps feature use?
§ http://kb.paessler.com/en/topic/35823
Knowledge Base: Why does my street not appear on the Geo Map shown in PRTG?
§ http://kb.paessler.com/en/topic/35653
Knowledge Base: How do I get a Google Maps API key for use in PRTG?
§ http://kb.paessler.com/en/topic/32363
Knowledge Base: Which limitations apply when using the Google Maps API in PRTG?
§ http://kb.paessler.com/en/topic/7913
Knowledge Base: How can I change the way markers look like in PRTG's geo maps?
§ http://kb.paessler.com/en/topic/43153
Knowledge Base: How can I track geo data of my Mobile Probe device?
§ http://kb.paessler.com/en/topic/59647
1748 28.05.2014
Part 7: Ajax Web Interface—Advanced Procedures | 7 Notifications
7.7 Notifications
Notifications are used to send alerts to the user whenever PRTG discovers a defined status,
such as slow or failing sensors, or when threshold values are breached. You can define an
unlimited number of notifications allowing to use one, or more, of several communication
channels like email, text messaging, and many more. For video instructions, please see the
More 1750 section below.
Overview
§ Sensor st at us changes
For example, when a sensor changes status to Up or Down, if responses are slow, or
sensors show an Unusual status.
§ Sensor value t hreshold breaches
For example, when a sensor shows a request time higher than 1,000 ms for more than 30
minutes.
§ Speed t hreshold breaches
For example, when a traffic sensor shows more than 1 Mbit/s for more than 5 minutes.
§ Volume t hreshold breaches
For example, when a traffic sensor shows more than 1 Gbyte transferred in 24 hours.
§ Sensor value changes
For some sensors you can trigger a notification whenever the value changes, for example,
when monitoring files on a hard disk drive.
§ Send Email
§ Add Ent ry t o Event Log
§ Send Sy slog Message
§ Send SNMP Trap
§ Send SMS/Pager Message
§ Execut e HTTP Act ion
§ Execut e Program
§ Send Amazon Simple Not ificat ion Service (SNS) Message
§ Assign Ticket
For details, see section Account Set t ings—Not ificat ions 1820 .
Note: Usually there are three successive attempts to deliver a notification. If all of these
attempts fail, the notification is lost.
28.05.2014 1749
Part 7: Ajax Web Interface—Advanced Procedures | 7 Notifications
Notifications Setup
There are three steps to take in order to use notifications with PRTG. Please go through all of
them:
1. Check and set up the Not ificat ion Delivery settings. This will tell PRTG how to send
messages.
For detailed information, see Sy st em Administ rat ion—Not ificat ion Delivery 1843 .
2. Check and set up several Not ificat ions. This will define the kind of message and its
content.
For detailed information, see Account Set t ings—Not ificat ions 1817 .
3. Check and set up Not ificat ion Triggers for objects. These will provoke the defined
notifications.
For detailed information, see Sensor Not ificat ions Set t ings 1716 .
See section Set t ing Up Not ificat ions Based on Sensor Limit s: Example 1751 for a step-by-
step guide describing a potential notifications setup.
More
Video Tutorial: There is a video available on the Paessler video tutorials page.
§ http://www.paessler.com/support/video_tutorials
1750 28.05.2014
Part 7: Ajax Web Interface—Advanced Procedures | 7 Notifications
1 Setting Up Notifications Based on Sensor Limits: Example
Note: This documentation refers to the PRTG Sy st em Administ rat or user accessing the Ajax
interface on a master node. For other user accounts, interfaces, or nodes, not all of the
options might be available as described. When using a cluster installation, failover nodes are
read-only by default.
This section will show you exemplarily how to set up a notification for exceeded disk free
limits. The approach for this specific use case is examined step by step. You can easily adapt it
to declare limits for other sensor types.
There are several steps to take in order to set up notifications based on limits:
§ Step 1: 1751 Provide necessary information about the delivery of notifications (SMTP and SMS).
§ Step 2: 1751 Create notifications, specifying the type of notification and its content.
§ Step 3: 1752 Define thresholds that will change a sensor's status (this is not necessary for
every kind of notification).
§ Step 4: 1755 Add suitable triggers to objects which will evoke notifications if something is
going wrong in your network.
§ Step 5: 1756 Test if the created notification will be triggered and delivered correctly.
Note: When you set up your own notifications, you will not necessarily need to go through all
the steps described here. In this section, our main goal is to give you a general idea of the
notifications concept.
Before creating notifications, you first have to define how those notifications actually will be
delivered to your email account, mobile phone, or pager. To do so, choose Set up | Sy st em
Administ rat ion | Not ificat ion Delivery from PRTG's main menu bar. Specify the mechanism of
SMTP delivery, sender email and name, as well as the HELO ident. For SMS delivery, select your
service provider and provide the corresponding credentials. You can find details about
notification delivery in section Sy st em Administ rat ion—Not ificat ion Delivery 1843 .
In order to get an informative message when a disk is running out of capacity, create a
corresponding notification. Choose Set up | Account Set t ings | Not ificat ions from PRTG's
main menu bar and click on the button Add New Not ificat ion. Give the notification an
explanatory name; in our case you could use Disk Free Limit Notification. However, if you want
to trigger this notification on a global level (for example, for a probe or group) such that it
would not only apply to breached disk free limits, a general name would be more suitable (like
the predefined notification "Email to Admin"). If you leave the default text of the newly created
notification, it will already contain all necessary information, like:
12.05.2014 1751
Part 7: Ajax Web Interface—Advanced Procedures | 7 Notifications
1 Setting Up Notifications Based on Sensor Limits: Example
§ etc.
See section More 1757 for the other options you have here.
After providing this basic information, select the delivery method. In our case, we choose Send
Email for this notification by marking the corresponding checkbox. Specify who will receive
the notification, its subject, the format, the content of the email, and its priority. By default, the
email notification will contain several information parameters about the evoking sensor: its
name, status, time, message, location in the device tree, etc. Feel free to adjust email
messages to your needs (see section More 1757 ). You can choose any other notification
method, of course (see Account Set t ings—Not ificat ions 1820 ).
Once the notification is set up completely, click on Save. You will be redirected to the
notifications overview page. You can now use this notification for every trigger on every
object in your device tree.
Before creating triggers that evoke notifications, first specify the limits which you want to
apply to your disks. For example, if you want to be notified when a disk has exceeded 80% of
its capacity, force the sensor into a Warning status at this utilization. You have several options
to set limits for disk free sensors:
1752 12.05.2014
Part 7: Ajax Web Interface—Advanced Procedures | 7 Notifications
1 Setting Up Notifications Based on Sensor Limits: Example
§ Set limits checked against all disks in the settings of multi-drive sensors: WMI Free Disk
Space 1573 , SNMP Linux Disk Free 1122 , SSH Disk Free 1286
§ Enable limits in Channel settings of single sensors
§ You can achieve both with Mult i-Edit 1736
Step 3.1: Define Limits in Sensor Settings (Multi-Disk Free Sensors Only)
You can set limits for sensors monitoring multiple disks directly via the Set t ings tab on a
sensor's details page. Mult i-Edit 1738 for existing sensors is also possible. Open the settings of
the selected sensor(s) and go to section Set limit s checked against ALL disks. There, for
example, enable Percent age Limit Check. In the field Lower Warning Limit , enter the
percentage suitable to your needs. In our example, this would be 20. Alternatively, you can
use bytes to define a limit. However, we recommend using percentage values for more
flexibility. This limit will apply to all channels of this sensor representing disks.
Note: This sensor setting is only available for multi-drive sensors. You can omit Step 3.1 for all
sensors that are not from the type "disk free".
12.05.2014 1753
Part 7: Ajax Web Interface—Advanced Procedures | 7 Notifications
1 Setting Up Notifications Based on Sensor Limits: Example
In order to set specific limits for single disks, use the sensor's Channel settings. You can open
channel settings via the gear icon in the respective channel gauge or in the channels table.
Enable Limit s at the bottom of the channel settings dialog and specify your desired limits in
the Lower Warning Limit field. This limit will only apply to the respective channel.
Note: If you define channel limits when using the sensor's limit setting in the sensor's Set t ings
tab at the same time, the first limit that applies will be considered. This way, you can individually
define harder limits for single disks in a multi-disk sensor. All defined limits are valid side-by-
side.
You have to take the approach via channel settings for sensor types that monitor only one
(logical) disk, for example, the SNMP Disk Free Sensor 1020 . For these sensor types, you can
use Mult i-Edit 1739 if you want to apply the same limits for each of these sensors automatically.
§ To see all sensors of this type at a glance, just filter for it: From PRTG's main menu bar,
choose Sensors | By Ty pe | SNMP Disk Free.
§ Mark the checkboxes of the sensors you want to add a limit for.
§ Click the screwdriver symbol in the multi-edit bar.
§ Open the Channel Set t ings tab.
§ Select the channel you want to add a limit for; in this case it would be most likely the
channel Free Space.
§ Then Enable Limit s at the bottom of the dialog and enter the number in the correct field as
described above.
Once done, save these settings—the new limit will apply to all channels with this name of the
multi-edited sensors.
1754 12.05.2014
Part 7: Ajax Web Interface—Advanced Procedures | 7 Notifications
1 Setting Up Notifications Based on Sensor Limits: Example
You have specified limits to define when a sensor will go into a Warning (or Error) status. Now
you can create the according triggers. The trigger we use in this example is the St at e Trigger.
For details about other possible notification triggers, see section More 1757 .
§ You can set up a St at e Trigger on any level in your device tree. For example, open a group
containing the device(s) representing your disks.
§ Go on the Not ificat ions tab.
12.05.2014 1755
Part 7: Ajax Web Interface—Advanced Procedures | 7 Notifications
1 Setting Up Notifications Based on Sensor Limits: Example
Now you will be notified immediately when the capacity of one of your disks falls below the
defined limit, in this case 20% free disk space.
Finally, test the notification which you have created. You can trigger this notification for test
purposes immediately:
§ From the main menu bar 175 , choose Set up | Account Set t ings | Not ificat ions.
§ For the respective notification, click on the corresponding Test button.
Then, check if the notification was triggered and delivered correctly, depending on what
delivery method you defined before. If you do not get a notification (or a defined action is not
executed) at all, check the notification logs: From the main menu bar, choose Logs | Sy st em
Event s | Not ificat ions. Look for the triggered notification in the table list (verifying that the
notification delivery is set up correctly in general) and consider the corresponding message.
See section Logs 147 for more information.
1756 12.05.2014
Part 7: Ajax Web Interface—Advanced Procedures | 7 Notifications
1 Setting Up Notifications Based on Sensor Limits: Example
More
This section provides information about additional options you have when working with
notifications.
Not ifcat ion Delivery 1843 for details about editing header and footer of emails.
§ Ot her Triggers:
An alternative to the state trigger would be to add a Threshold Trigger; then you would not
need to set up limits explicitly, though, this trigger type would only be suitable for disk free
sensors when using the trigger for single sensors, one by one. Free disk sensors have free
space in percent as primary by default, other sensors have primary channels with the units
bytes or seconds. However, threshold triggers only apply to the primary or total channel.
General notification triggering by threshold might not work as expected for sensors of the
"percentage" type. You can find all available triggers in section Not ificat ions 1749 .
the Not ificat ions tab, and add a state trigger as described above. Note: Not all disk free
sensor types might appear. You can add them to this library in the settings of the library
node. There you can filter by type or tag 1768 and add missing sensors this way. You can also
filter by priority and other sensor properties.
12.05.2014 1757
Part 7: Ajax Web Interface—Advanced Procedures | 7 Notifications
1 Setting Up Notifications Based on Sensor Limits: Example
1758 12.05.2014
Part 7: Ajax Web Interface—Advanced Procedures | 8 Libraries
7.8 Libraries
With PRTG's Libraries feature you can create special views of your device tree with up-to-the-
minute monitoring status information, arranged the way you want it.
Example of a Library
In this section:
Introduction
Libraries is a powerful feature which enables you to create additional views of your device
tree, which are updated with the same scanning interval as your device tree, showing the same
monitoring data, but arranged in a way you want it. This is interesting if you want to show data
in different ways, e.g. depending on target groups or use case. For example, you can create a
library which contains an overview of all your bandwidth monitoring sensors, regardless of
which device they're running on.
§ Create libraries containing nodes with monitoring objects from all over your configuration
§ Show data from different PRTG probes in one library
§ Show different branches of your device tree right next to each other
14.01.2014 1759
Part 7: Ajax Web Interface—Advanced Procedures | 8 Libraries
§ Arrange sensors in a tree-like view regardless of which device they are running on
§ Filter your entire tree (or parts of it) for sensor type, state, or tag, showing only matching
sensors
You can create libraries easily, using drag&drop right within your browser.
PRTG comes with several pre-configured standard libraries, which you can use right away. You
can also change or delete them, if you like. The following libraries are automatically created
when you install PRTG for the first time (visible for the PRTG Administrator user). Some of them
will be initially empty, but as you add more sensors, they will be filled automatically according
to the filter settings defined for the nodes of the libraries:
Note: Sensors which are added to libraries are not counted against the maximum number of
sensors of your license.
Start Libraries
Click the Libraries entry from the main menu 178 to view or add custom views of your
network's status and monitoring data. Hover to show other menu items. Choose between:
§ All
Calls the Libraries feature where you can view or add custom device tree views of your
network's status and monitoring data.
§ Add Library
Lets you directly add 1762 a new library.
§ Select Library ›
Show existing libraries. Hover to show other menu items. Follow the menu path (it is specific
to your setup) to select a library.
Libraries List
In the All view, you see a list of all existing libraries. Using the links next to a library name, you
can perform the following actions.
1760 14.01.2014
Part 7: Ajax Web Interface—Advanced Procedures | 8 Libraries
Please see also Working wit h Table List s 156 . Additionally, there is multi-edit available. This
enables you to change properties of several objects at a time. For more details, please see
Mult i-Edit List s 1736 section.
For detailed information on how to create and edit libraries please see the following sections.
§ Libraries St ep By St ep 1762
§ Management 1766
14.01.2014 1761
Part 7: Ajax Web Interface—Advanced Procedures | 8 Libraries
1 Libraries Step By Step
In order to create a new library, follow the steps in this section. In the web interface, click on
the Libraries entry in the main menu to show the libraries main screen.
Note: This documentation refers to the PRTG Sy st em Administ rat or user accessing the Ajax
interface on a master node. For other user accounts, interfaces, or nodes, not all of the
options might be available as described. When using a cluster installation, failover nodes are
read-only by default.
In this section:
§ St ep 4: View 1764
Click on the Add Library button. An assistant is shown. Enter a Library Name, and define
Tags and Access Right s, if you like. Click on Cont inue.
1762 14.01.2014
Part 7: Ajax Web Interface—Advanced Procedures | 8 Libraries
1 Libraries Step By Step
Click to the Management tab. You will see a split screen: On the left side, your library is show
(empty in the beginning), and on the right side, you see a less colorful view of your device tree,
as known from the device tree's Management 222 tab.
From the device tree on the right side, drag objects and drop them on the library on the left
side. Each dropped object will be added immediately as a new Library Node. Repeat this
procedure as often as you wish until you have added all desired items to the library. Note:
When adding single sensors to the library, there can only be one sensor in one library node.
You can also create nested library nodes by adding a new node underneath an existing one.
Drag and drop nodes within the library to change their position. If you want to change the
monitoring object that is associated with a library node, you can change the Linked Object in
the node's settings.
14.01.2014 1763
Part 7: Ajax Web Interface—Advanced Procedures | 8 Libraries
1 Libraries Step By Step
Right-click on the name of a Library Node and from the context menu, select Edit | Set t ings...
to change the Node Display Set t ings. In this dialog, you can change the name of the library
and its tags, as well as the linked object, node type, and filters.
These settings are available for each library node. You can choose to either show the Linked
Object as a sub-tree of your device tree, or to view a collection of all sensors underneath the
Linked Object .
When selecting the sub-tree view, the library node will just look like a branch in your device
tree, as shown in the screen shot below for the library node names "My Sub Tree".
When selecting a sensor collection view, only the sensors underneath the Linked Object are
shown, omitting probes, groups, and devices. You can additionally filter by certain sensor
Ty pe, St at us, and Tags. Only matching sensors will be shown. The screen shot below shows
the same Linked Object as above, but in sensor collection view, additionally filtered for
sensors with a bandwidt hsensor tag.
Library with one Node Showing a Collec tion of Bandwidth Sensors Only
For detailed information, see Libraries and Node Set t ings 1768 (Overview—Library Node
Display Settings) section.
Step 4: View
Click on the Overview tab to see the final appearance of your library. You have the following
options:
§ Hover an object to view a popup window with recent monitoring and status data.
§ Use the sensor state selection bar to select which sensors you want to see for the library:
Simply remove check marks for sensor states you want to hide. Note: This function is the
same you know from the device tree's Sensor Status Bar 113 . The setting is reset the next
time you open the library.
§ Use the Device Tree View selection in the page header bar 113 to change the size of the
library display. Note: This function is the same you know from the device tree 115 .
1764 14.01.2014
Part 7: Ajax Web Interface—Advanced Procedures | 8 Libraries
1 Libraries Step By Step
§ Use the Search box in the page header bar 113 to search the library for a string in object
names. Matching objects will be shown full-colored, all others will be grayed out while the
filter is active. Click on the small x symbol in the search field to reset the filter. Note: This
function is the same you know from the device tree 113 .
It depends on the library's access rights and the currently logged in user account if it will be
visible to other PRTG users. Also, clicking on objects (for example, on sensors) will lead to
more detailed information about the object or to an error message indicating insufficient
access rights—depending on user account and access rights.
In libraries, you can right-click objects to access their Cont ext Menus 1774 .
14.01.2014 1765
Part 7: Ajax Web Interface—Advanced Procedures | 8 Libraries
2 Management
7.8.2 M anagement
Note: This documentation refers to the PRTG Sy st em Administ rat or user accessing the Ajax
interface on a master node. For other user accounts, interfaces, or nodes, not all of the
options might be available as described. When using a cluster installation, failover nodes are
read-only by default.
Click to the Management tab. You will see a split screen: On the left side, your library is show
(empty in the beginning), and on the right side, you see a less colorful view of your device tree,
as known from the device tree's Management 222 tab.
From the device tree on the right side, drag objects and drop them on the library on the left
side. Each dropped object will be added immediately as a new Library Node. Repeat this
procedure as often as you wish until you have added all desired items to the library. Note:
When adding single sensors to the library, there can only be one sensor in one library node.
You can also create nested library nodes by adding a new node underneath an existing one.
Drag and drop nodes within the library to change their position. If you want to change the
monitoring object that is associated with a library node, you can change the Linked Object in
the node's settings.
1766 07.02.2013
Part 7: Ajax Web Interface—Advanced Procedures | 8 Libraries
2 Management
Right-click on the name of a Library Node and from the context menu, select Edit | Set t ings...
to change the Node Display Set t ings. In this dialog, you can change the name of the library
and its tags, as well as the linked object, node type, and filters.
These settings are available for each library node. You can choose to either show the Linked
Object as a sub-tree of your device tree, or to view a collection of all sensors underneath the
Linked Object .
When selecting the sub-tree view, the library node will just look like a branch in your device
tree, as shown in the screen shot below for the library node names "My Sub Tree".
When selecting a sensor collection view, only the sensors underneath the Linked Object are
shown, omitting probes, groups, and devices. You can additionally filter by certain sensor
Ty pe, St at us, and Tags. Only matching sensors will be shown. The screen shot below shows
the same Linked Object as above, but in sensor collection view, additionally filtered for
sensors with a bandwidt hsensor tag.
Library with one Node Showing a Collec tion of Bandwidth Sensors Only
For detailed information, see Libraries and Node Set t ings 1768 (Overview—Library Node
Display Settings) section.
Context Menus
On right-click, there are different context menus available—in the Management as well as in
the Overview tab.
For detailed information, please see Cont ext Menus 1774 section.
07.02.2013 1767
Part 7: Ajax Web Interface—Advanced Procedures | 8 Libraries
3 Libraries and Node Settings
Using the libraries tabs you can access all functionalities and settings for a library.
Library Tabs
Overview
Click on the Overview tab any time to show the current state of your library.
While in the Overview tab, click on a library node's name to change its settings. Or, while in
the Management tab, right-click a library node's name and select Edit | Set t ings... from the
context menu. In both cases, the following settings are shown. Note: You can only change the
settings of a node if it contains monitoring objects already, e.g. groups, devices, or sensors.
Library Node Name Enter a meaningful name for the library node.
Linked Object Click on the reading-class symbol to change the object which is
linked with this library node. A popup window will appear, showing
the Object Select or 159 .
Node Type Select what you want to view for this library node. Choose
between:
§ Show a subt ree of t he device t ree in t he library : View all
objects underneath the linked object as a device tree.
§ Show a collect ion of (filt ered) sensors in t he library : View all
sensors underneath the linked object (only sensors are shown).
You can combine several filters with each other (see below).
Filter By Type This option is visible only if collection of sensors is enabled above.
Select if you want to filter the sensor list by a certain type. Choose
between:
§ Show all sensor t y pes: Do not filter for a sensor type.
1768 14.01.2014
Part 7: Ajax Web Interface—Advanced Procedures | 8 Libraries
3 Libraries and Node Settings
§ Show specific sensor t y pes only : Filter the sensor list of the
linked object for certain sensor type(s).
Note: This filter is applied in real-time. If the configuration
underneath the linked object changes, the library node will show
matching sensors accordingly.
Select Sensor Types This option is visible only if filtering by type is enabled above. A list
of all sensor types is shown, currently available sensor types are
shown in bold letters for your convenience. Set a check mark in
front of each sensor type you want to include in the library node
view. You can also select and deselect all items by using the check
box in the table head.
Note: This filter is applied in real-time. If the configuration
underneath the linked object changes, the library node will show
matching sensors accordingly.
Filter By Status This option is visible only if collection of sensors is enabled above.
Choose between:
§ Show all sensor st at es: Do not filter for a sensor status.
§ Show sensors wit h a specific st at us only : Filter the sensor list
of the linked object for sensors in certain states.
Select Sensor States This option is visible only if filtering by sensor state is enabled
above. A list of sensor states is shown. Set a check mark in front
of each status you want to include in the library node view.
Choose from:
§ Unknown
§ Up
§ Warning
§ Down
§ Paused
§ Unusual
§ Down (Acknowledged)
§ Down (Part ial)
You can also select and deselect all items by using the check box
in the table head.
Note: This filter is applied in real-time. If the configuration
underneath the linked object changes, the library node will show
matching sensors accordingly.
14.01.2014 1769
Part 7: Ajax Web Interface—Advanced Procedures | 8 Libraries
3 Libraries and Node Settings
Filter By Tags This option is visible only if collection of sensors is enabled above.
Choose between:
§ Show all sensor t ags: Do not filter for a tag.
§ Show object s wit h a specific t ag only : Filter the sensor list of
the linked object for sensors with a certain tag. Note: The tag of
a sensor can also be inherited 87 by a parent object.
Select Tags This option is visible only if collection of sensors is enabled above.
A list of all available tags is shown. Set a check mark in front of
each tag you want to include in the library node view. You can also
select and deselect all items by using the check box in the table
head.
Note: This filter is applied in real-time. If the configuration
underneath the linked object changes, the library node will show
matching sensors accordingly.
Filter By Priority This option is visible only if collection of sensors is enabled above.
Choose between:
§ Show all priorit ies: Do not filter for the priority setting 160 of a
sensor.
§ Show object s wit h specific priorit y only : Filter the sensor list
of the linked object for sensors with specific priority. Note: The
priority setting of a group, device, or sensor is ignored here; only
the priority setting of the sensor itself is regarded.
Select Priority This option is visible only if collection of sensors is enabled above.
Define which priority setting sensors must have to appear in this
collection. Set a check mark in front of each priority you want to
include in the library node view. Choose from:
§ ***** (highest )
§ ****
§ ***
§ **
§ * (lowest )
Note: This filter is applied in real-time. If the configuration
underneath the linked object changes, the library node will show
matching sensors accordingly.
Click on the Save button to store your settings. If you change tabs or use the main menu, all
changes to the settings will be lost!
1770 14.01.2014
Part 7: Ajax Web Interface—Advanced Procedures | 8 Libraries
3 Libraries and Node Settings
Note: After applying filters it might take several seconds for the changes to become visible.
This is due to internal filter processes running in the background.
Management
Click on the Management tab to edit the contents of your library, for example, to add items to
the library using drag&drop. For detailed descriptions, please see Management 1766 section.
Settings
14.01.2014 1771
Part 7: Ajax Web Interface—Advanced Procedures | 8 Libraries
3 Libraries and Node Settings
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists and in the device tree.
Exception: If a child object is visible to the user, the object is
visible in the device tree, though not accessible.
§ Read: Users in this group can see the object and review its
monitoring results.
§ Writ e: Users in this group can see the object, review its
monitoring results, and edit the object's settings. They cannot
edit access rights settings.
§ Full: Users in this group can see the object, review its monitoring
results, edit the object's settings, and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings. To automatically set all objects further
down in the hierarchy to inherit this object's access rights, set a
check mark for the Revert children's access right s t o inherit ed
option.
For more details about access rights, please see section User
Access Right s 94 .
Note: When giving access rights to a user group, all members of this user group will be able to
see the objects in the library just as seen by the user who originally created the library.
Click on the Save button to store your settings. If you change tabs or use the main menu, all
changes to the settings will be lost!
Notifications
You can define notification triggers for any kind of object libraries. This is even possible for
dynamic libraries which can change with every scanning interval, for example, when you filter a
library for the sensor status or priority. For details about how to use notifications, please see
section Not ificat ions 1749 .
Comments
In the Comment s tab you can enter free text for each object. This can be used for
documentation purposes or to leave information for other users.
1772 14.01.2014
Part 7: Ajax Web Interface—Advanced Procedures | 8 Libraries
3 Libraries and Node Settings
History
In the Hist ory tab all changes in the settings of an object are logged with a timestamp, the
PRTG user which conducted the change, and a message. The history log keeps the last 100
entries.
Delete
You can delete the entire library any time by clicking on the trash symbol on the right.
14.01.2014 1773
Part 7: Ajax Web Interface—Advanced Procedures | 8 Libraries
4 Context Menus
While in the Overview or the Management tab, right-click on any library node to show its
context menu.
§ Select either Det ails... or Edit | Set t ings... to get to the Libraries and Node Set t ings 1768 .
Note: While in the Overview tab, these settings are also accessible via left-click on the
node's name.
§ Edit | Rename... will give you an option to rename the library node quickly.
§ Remove from Library ... will remove this library node from the current library. Note: This will
not delete any objects in your device tree.
§ The Move | ... options will move the library node up and down within the library.
§ Click on the Send Link by email entry to open a new email using your system's standard
email client. It will contain a direct link to the page you're currently viewing.
In libraries there are the same Cont ext Menus 163 available you already know from the device
tree. With one exception: While accessing these menus within libraries, the Move and Delet e
options are disabled to avoid accidental changes to your device tree.
1774 03.04.2014
Part 7: Ajax Web Interface—Advanced Procedures | 9 Reports
7.9 Reports
Reports are used to analyze historic monitoring results over a specified time such as one or
more days, one month, or an entire year. You can create reports for all, or only for certain
sensors.
Introduction
PRTG includes a powerful reporting engine for ad-hoc, as well as scheduled report generation
in HTML and PDF format. Thus, reports can be run on demand or on a regular basis (for
example, once a day). You can create reports for one single sensor, or you choose a range of
sensors you want to create a report for. The content and layout of the report is controlled by
the report template of your choice and is the same for all sensors in a report.
Report Sample
The sample report above shows a report data for devices on a local probe. You can see graphs
for the preceding week, plus data tables with numeric results.
Start Reports
Click the Report s entry from the main menu 182 to view or add reports of your monitoring
data. Hover to show other menu items. Choose between:
§ All
Calls the Reports feature where you can view or add reports of your monitoring data.
§ Add Report
Lets you directly add a new report.
03.04.2014 1775
Part 7: Ajax Web Interface—Advanced Procedures | 9 Reports
§ Select Report ›
Show existing reports. Hover to show other menu items. Follow the menu path (it is specific
to your setup) to select a report.
Reports Overview
List of Reports
In the All view, you see a list of all existing reports. Every line shows information about one
report:
Using the buttons at the end of a line, you can Edit , Clone, and Delet e the respective report.
1776 03.04.2014
Part 7: Ajax Web Interface—Advanced Procedures | 9 Reports
Please see also Working wit h Table List s 156 . Additionally, there is multi-edit available. This
enables you to change properties of several objects at a time. For more details, please see
Mult i-Edit List s 1736 section.
Click on the Add Report button to add a new report, or click on the name of an existing
report to view and edit its settings. You can also run a pre-configured report easily by clicking
on its name and then using the options in the Run Now tab. For both options, please see
Report s St ep By St ep 1778 section.
For detailed information on how to create, edit, and schedule reports, please see the following
sections:
§ Report s St ep By St ep 1778
Automatic Averaging
For performance reasons, PRTG automatically averages monitoring data when calculating data
for large time spans. Data is then averaged regardless of the selected average interval.
Time Span in Report Minimum Level of Det ail (Average Int erval)
Up to 40 days Any
A report for a time span of more than 500 days is not possible. If you try to set a larger time
span, it will be reduced to 365 days automatically.
Related Topics
§ Review Monit oring Dat a 124
03.04.2014 1777
Part 7: Ajax Web Interface—Advanced Procedures | 9 Reports
1 Reports Step By Step
In order to create a new report, or run an existing one, follow the steps in this section. In the
web interface, click on the Report s entry in the main menu to show the reports main screen.
Note: This documentation refers to the PRTG Sy st em Administ rat or user accessing the Ajax
interface on a master node. For other user accounts, interfaces, or nodes, not all of the
options might be available as described. When using a cluster installation, failover nodes are
read-only by default.
PRTG is delivered with several pre-configured reports. In order to use one of them, click on a
report's name in the reports main screen, select the Set t ings tab. The other steps are the
same as for new reports. Although some settings are already given, we recommend checking
the settings. For example, check the sensors that will be included in the report. For some
reports that come with PRTG there are no sensors added yet. Continue with St ep 3 1779 in this
section.
Click on the Add Report button to add a new report. An assistant is shown where you can
define various settings. First, enter a Report Name.
1778 03.04.2014
Part 7: Ajax Web Interface—Advanced Procedures | 9 Reports
1 Reports Step By Step
In the Templat e section, select one of the report templates from the list. This will define the
overall look of your report and affect in which detail (interval) monitoring data is included. For a
detailed description on the available options, please see Report s Set t ings 1784 section. If you
are not sure, try a template that appears most suitable to you. You can change all settings
later.
Select a Securit y Cont ext (best choose PRTG Sy st em Administ rat or, if available), your
Timezone, and Paper Size for PDF generation. For detailed information, please see Report s
Set t ings 1784 section.
Choose the sensors you want to include in the report. First, when running in a cluster 81 ,
define the Clust er Node the monitoring data will be taken from. Select a specific node from
the list. If you select All nodes, a report with data from all of your cluster nodes will be
created, but only the primary channel of every sensor will appear in the report.
03.04.2014 1779
Part 7: Ajax Web Interface—Advanced Procedures | 9 Reports
1 Reports Step By Step
Every report will show monitoring results from sensor data. There are two ways to include
sensors in a report: You can either add sensors manually, or by tag. In the Add Sensors by
Tag field, enter one or more tags that matches the sensor range you want a report for. For
example, enter the tag bandwidthsensor to include all sensors that measure bandwidth (or
select it from the list of tags which PRTG suggests). PRTG provides this tag as default when
adding bandwidth sensors; so this tag typically gathers all bandwidth sensors, unless you have
configured your system differently. You can enter several tags; hit the enter key, comma, or
space after providing one tag and enter the next one. Use the Filt er Sensors by Tag field to
explicitly filter sensors with certain tags from the bulk of tags or manually selected sensors
defined above.
Tagging is a great tool to group sensors or other objects. For more information, see Tags 89
section. You can also leave the tag fields empty and only choose specific sensors manually
later.
In the Report Schedule section, choose if you want to run the report on a regular basis or on
demand only. Also choose which time Period will be covered by the report, and if you want to
show percentiles, add report comments, or special access rights. For detailed information,
please see Report s Set t ings 1784 section.
Click on the Cont inue button to store your settings. If you change tabs or use the main menu,
all changes to the settings will be lost!
When settings are saved, switch to the Sensors Select ed by Tag tab to see a list of all
sensors that were added by the tag(s) you defined in step 4. To change tags, go back to the
Set t ings tab. You can additionally add sensors manually. To do so, switch to the Select
Sensors Manually tab. See Report s Set t ings 1791 section for detailed information. The final
report will show sensors from both manual and by tag selection.
Switch to the Run Now tab, select the current or previous period, and in the Processing
Opt ions select View Report as HTML. Click the Run Report button. The report will be
generated in a new browser window or tab immediately. Depending on the number of selected
sensors and the used template, it may take a few minutes until you see the report. If you do
not want to wait, close the newly opened browser window or tab and select a PDF option in
the Processing Opt ions. Click on the Run Report button again. The report will then be
generated in the background and you will get a ToDo t icket or email once it is finished.
Note: For large PDF reports, PRTG will automatically split the output into separate files to avoid
huge PDF files. You can change the number of sensors included into each PDF file by editing
the report templates manually. See More 1793 section of Reports Settings 1784 .
1780 03.04.2014
Part 7: Ajax Web Interface—Advanced Procedures | 9 Reports
2 View and Run Reports
In the web interface, click on the Report s entry in the main menu to show the reports main
screen. Click on a report's name to select it. Using the reports tabs you can access all
functionalities and settings for this report. Click on the Go t o all report s button at the
bottom of the page to return to the list of Reports.
Report Tabs
Note: This documentation refers to the PRTG Sy st em Administ rat or user accessing the Ajax
interface on a master node. For other user accounts, interfaces, or nodes, not all of the
options might be available as described. When using a cluster installation, failover nodes are
read-only by default.
Run Now
In the Run Now tab you can execute a report immediately with the settings configured.
Report for Define the time span covered by the report. Choose between:
§ Current Period: Use monitoring data of the current period. The
actual time span depends on the report period type defined in
the report's settings 1784 . It can be today, this week, this month, or
this year.
§ Previous Period: Use monitoring data of the last period. The
actual time span depends on the report period type defined in
the report's settings 1784 . It can be yesterday, last week, last
month, or last year.
§ Select A Period: Use monitoring data of a period other than
current or previous. Select below.
§ Select Dat e Range Manually : Define a custom time span for the
monitoring data that will be used. Set start and end date below.
Date Range This selection is only visible if the period option is enabled above.
From the list, select a data range for which the report will be
generated. The actual time spans shown depend on the available
monitoring data and on the report period type defined in the
report's settings 1784 . It can be days, weeks, months, or years.
Start Date This selection is only visible if the date range option is enabled
above. Define the begin of the time span for which the report will
be generated. Click in the field and select a date from the calendar.
Make sure you define a valid period.
28.05.2014 1781
Part 7: Ajax Web Interface—Advanced Procedures | 9 Reports
2 View and Run Reports
End Date This selection is only visible if the date range option is enabled
above. Define the end of the time span for which the report will be
generated. Click in the field and select a date from the calendar.
Make sure you define a valid period.
Quick Range This selection is only visible if the date range option is enabled
above. Choose between different pre-defined ranges by simply
clicking on it. With each click the St art and End Dat e fields above
will be changed accordingly.
File Format and Define how you want to view the report. Choose between:
Delivery
§ View Report as HTML: Directly view the report in your web
browser. It will be loaded in a new browser window or tab.
§ Creat e and st ore PDF file: Create a PDF file of the report and
store it. Once finished, you will find it in the St ored Report s tab
and a ToDo ticket 150 will be created. By default, PRTG sends out
a notification mail to the administrator in this case.
§ Creat e PDF file, st ore it and send by email: Create a PDF file of
the report, store it, and send it via email once it is finished.
Note: For large PDF reports, PRTG will automatically split the output
into separate files to avoid huge PDF files. You can change the
number of sensors included into each PDF file by editing the report
templates manually. See More 1783 section below.
Note: In order to create PDF files, ensure that the print spooler
service is running on the system with your PRTG server.
Target Email Address This option is only visible if sending by email is selected above.
Please enter a valid email address the report will be sent to. Note:
Configuration for outgoing email can be changed in the Sy st em
Administ rat ion—Not ificat ion Delivery 1843 settings.
1782 28.05.2014
Part 7: Ajax Web Interface—Advanced Procedures | 9 Reports
2 View and Run Reports
Click on the Run Report button to start report generation. Depending on the number of
selected sensors, this may take a while. If you experience a long waiting time when generating
HTML reports for immediate view, please consider using one of the PDF options. You can then
view the report as soon as it's finished.
Note: Any sensor graphs in your report will only show the channels that are enabled via the
Show in Chart s option in the Sensor Channels Set t ings 1709 of the respective sensor.
Stored Reports
In the St ored Report s tab you can view PDF reports created in the past. Simply click on a
name to open the report. Reports are stored until they are deleted according to the data
purging settings of your PRTG configuration. You can set data purging limits for reports in the
Sy st em Administ rat ion—Core & Probes 1852 settings.
Other Tabs
For all other tabs, please see Report s Set t ings 1784 section.
More
Knowledge Base: Can I change the number of PDFs created by a report?
§ http://kb.paessler.com/en/topic/11863
28.05.2014 1783
Part 7: Ajax Web Interface—Advanced Procedures | 9 Reports
3 Reports Settings
In the web interface, click on the Report s entry in the main menu to show the reports main
screen. Click on a report's name to select it. Using the reports tabs you can access all
functionalities and settings for this report. Click on the Go t o all report s button at the
bottom of the page to return to the list of Reports.
Report Tabs
Note: This documentation refers to the PRTG Sy st em Administ rat or user accessing the Ajax
interface on a master node. For other user accounts, interfaces, or nodes, not all of the
options might be available as described. When using a cluster installation, failover nodes are
read-only by default.
Run Now
In the Run Now tab you can execute a report immediately with the settings configured. Please
see View and Run Report s 1781 section.
Stored Reports
In the St ored Report s tab you can view reports created in the past. Please see View and Run
Report s 1783 section.
Settings
Template Select a template for the report. This will define the overall look of
your report. There are several report templates delivered with
PRTG. They also define in which detail (interval) monitoring data is
included. You can choose from templates in the following
categories:
§ Dat a Table Only : Create a report with data tables only. Choose
from several intervals.
§ Graph Only : Create a report with graphs only. Choose from
several intervals.
§ Graph wit h Dat a Table: Create a report with graphs and data
table. Choose from several intervals.
1784 28.05.2014
Part 7: Ajax Web Interface—Advanced Procedures | 9 Reports
3 Reports Settings
Security Context Define the user account that will be used for access to monitoring
data. The report will only contain objects which the selected user
94 is allowed to view. Please choose a user from the list. The
available users depend on your configuration. By default, this is the
user that created the report. PRTG Administrator users can change
this setting.
Timezone Define the time zone that will be used for all date-specific settings
in this report (see below). Select a time zone from the dropdown
list.
Paper Size Define the paper size in which PDF reports will be created. Choose
between:
§ A4: Use German DIN A4 format.
§ Legal: Use US legal paper format.
§ Let t er: Use US letter paper format.
Sensors
Cluster Node This field is only visible when running PRTG in Clust ering 81 mode.
Define the cluster node the report will take monitoring data from.
Choose a cluster node from the list. The available options are
specific to your configuration. Select All nodes to create a report
with data from all of your cluster nodes. Note: A report for all
nodes will include data of the primary sensor channels only, not for
other sensor channels.
28.05.2014 1785
Part 7: Ajax Web Interface—Advanced Procedures | 9 Reports
3 Reports Settings
Sensors
Add Sensors Manually If you want to manually choose the sensors included in this report,
please save settings and switch to the Select Sensors Manually
1791 tab.
Add Sensors by Tag Define the sensors included in this report by tag. Enter one or
more tags; hit enter, space, or comma to confirm a tag. The report
will cover all sensors that have at least one of the tags. Please
enter a string or leave the field empty. Note: Tags are inherited 89
invisibly and automatically. So, for example, if you enter the tag of a
group here, the report will include all sensors within this group. For
detailed information, see Inherit ance of Set t ings 87 section. For
sensors that are added by tag, all sensor channels are included in
the report automatically, except All nodes is selected in the
Clust er Node selection above.
Filter Sensors by Tag Further filter sensors. This is used in combination with sensors that
are added manually, or added implicitly with their manually added
parent objects. From those sensors, only the ones with the tags
entered here will be included. Enter one or more tags to include
sensors in the report; hit enter, space, or comma to confirm a tag.
Please enter a string or leave the field empty.
Schedule
Report Schedule Define when the report will be run. Choose between:
§ No schedule (run int eract ive/on-demand only ): Only use the
options in the Run Now tab to start generation of this report
manually.
§ Every full hour: Run this report every 60 minutes.
§ Every day at a specific hour: Run this report every 24 hours.
§ Every specific day of a week: Run this report every 7 days.
Specify the day below.
§ Every specific day of a mont h: Run this report on a specific
day every month. Specify below.
§ The day aft er a quart er is finished (i.e. at 1. April for t he 1.
January - 31. March Quart er): Run this report for every quarter
of the year.
§ Every specific dat e: Run this report on a specific date every
year. Specify below.
1786 28.05.2014
Part 7: Ajax Web Interface—Advanced Procedures | 9 Reports
3 Reports Settings
Schedule
Specify Hour This setting is only visible if specific hour is selected above. From
the list, please select the hour you want to run the report at. PRTG
will automatically choose a suitable time within this hour, usually at
the beginning of it.
Specify Day This setting is only visible if the day of week or day of month
option is selected above. From the list, please select a day of week
or a date of the month you want to run the report. When selecting
Last , the report will always run on the last day of the month,
regardless of how many days the month has. When selecting a date
that does not exist in every month, e.g. the 30th in May, PRTG will
automatically run the report on the last day of this month.
Specify Date This setting is only visible if the specific date option is selected
above. Please enter a valid date in the form DD.MM, e.g. 31.12. The
report will be run annually on this date.
Scheduled Processing This setting is only visible if one of the schedule options is selected
above. Define what will be done when generating a report. Choose
between:
§ Save report t o disk and send it by email: Create a PDF file of
the report, store it, and send it via email. You will find the report
in your emails and in the St ored Report s tab. Define an email
address below.
§ Save report t o disk only : Create a PDF file of the report and
store it. Once finished, you will find it in the St ored Report s tab
and a ToDo ticket will be created. By default, PRTG will send out a
notification mail to the administrator in this case.
§ Send report by email only : Create a PDF file of the report and
send it via email once it is finished. The report is not permanently
stored, but only emailed. Define an email address below.
Note: For large PDF reports, PRTG will automatically split the output
into separate files to avoid huge PDF files. You can change the
number of sensors included into each PDF file by editing the report
templates manually. See More 1793 section below.
Email Address This setting is only visible if a send by email option is selected
above. Please enter a valid email address the report will be sent to.
To enter more addresses, separate them by comma. PRTG will send
a message with all recipients in the "To" field of the email. Note:
Configuration for outgoing email can be changed in the Sy st em
Administ rat ion—Not ificat ion Delivery 1843 settings.
28.05.2014 1787
Part 7: Ajax Web Interface—Advanced Procedures | 9 Reports
3 Reports Settings
Schedule
Send to User Group This setting is only visible if a send by email option is selected
above. From the drop down list, please choose a user group to
send an email with the report to all members of this group (you can
edit user groups under Sy st em Administ rat ion—User Groups 1861
). Note: If you define individual email addresses (see field above)
and a user group, the report will be sent to the individual email
addresses as well as to the members of the selected user group. In
both cases, PRTG will send one message with all recipients in the
"To" field of the email.
Period
Reported Period Define the time span covered by the report. Choose between:
§ Current : Use monitoring data of the current period. Define the
period type below.
§ Previous: Use monitoring data of the last period. Define the
period type below.
Report Period Type Define the type of period you want to create a report for. Choose
between:
§ Day
§ Week
§ Mont h
§ Quart er (January -March, April-June, et c.)
§ Year
Depending on your selection, different period selections are
shown below.
Day Period This setting is only visible if day period type is selected above.
Define the hours when a day starts and ends. Choose from the list
of hours. Default setting is 0:00-23:59.
1788 28.05.2014
Part 7: Ajax Web Interface—Advanced Procedures | 9 Reports
3 Reports Settings
Period
Week Period This setting is only visible if week period type is selected above.
Define when a week starts and ends. Choose between:
§ Monday -Sunday : A reported week will start on Monday.
§ Sat urday -Friday : A reported week will start on Saturday.
§ Sunday -Sat urday : A reported week will start on Sunday.
Month Period This setting is only visible if month period type is selected above.
Define when a month starts and ends. Choose between:
§ 1.-last day : A reported month will start on the first and end on
last of the month.
§ 15.-14.: A reported month will start von 15th and end on 14th of
the month.
Year Period This setting is only visible if year period type is selected above.
Define when a year starts and ends. Choose between:
§ 1/1-12/31: A reported year will start on January 1st.
§ 7/1-6/30: A reported year will start on July 1st.
Report only for specific Include certain time spans within the defined period only. When a
hours-of-day schedule is selected, only monitoring data for specified hours or
(Schedule) weekdays within the defined period are included in the report.
Select None to include all available monitoring data in the report, or
choose a schedule. For example, select the schedule Weekday s to
exclude all weekends from the report. The available schedules
depend on your configuration. For more information, please see
Account Set t ings—Schedules 1827 section.
Show Percentile Define if percentiles 2078 will be included in the report. Choose
between:
§ Off: Do not show percentiles
§ On: Add a column to data tables, showing percentiles for every
sensor channel.
Note: Percentiles are not available for all report templates. If a
template does not support percentiles, they will simply not show
up in the report, even when you enable this setting.
28.05.2014 1789
Part 7: Ajax Web Interface—Advanced Procedures | 9 Reports
3 Reports Settings
Show Percentile This setting is only visible when showing percentiles. Enter the
percentile number you want to calculate. If you choose, for
example, to calculate the 95th percentile, enter "95" here and 5 % of
peak values will be discarded.
Percentile Average This setting is only visible when showing percentiles. This is the
(seconds) averaging interval in seconds, which is used for percentile
calculation. Default value is 300 which is equivalent to 5 minutes.
Percentile Mode This setting is only visible when showing percentiles. Choose the
mode for percentile calculation:
§ Discret e: Discrete percentile chooses the next smaller discrete
value.
§ Cont inuous: Continuous percentile interpolates between
discrete values.
For details, see section Calculat ing Percent iles 2078 .
Report Comment s
Introduction Define a custom text that will show up on the first page of the
report. Please enter a string or leave the field empty.
Footer Comments Define a custom text that will show up on the last page of the
report. Please enter a string or leave the field empty.
1790 28.05.2014
Part 7: Ajax Web Interface—Advanced Procedures | 9 Reports
3 Reports Settings
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists.
§ Read: Users in this group can see the object and review its
settings.
§ Writ e: Users in this group can see the object, as well as review
and edit its settings. However, they cannot edit access rights
settings.
§ Full: Users in this group can see the object, as well as review and
edit its settings and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings.
Click on the Save button to store your settings. If you change tabs or use the main menu, all
changes to the settings will be lost!
Click on the Select Sensors Manually tab to manually choose sensors that will be included in
the report. You will see a split screen: On the left side, your list of objects is show (empty in
the beginning), and on the right side, you see a less colorful view of your device tree, as
known from the device tree's Management 222 tab. Adding objects to the report is very easy.
28.05.2014 1791
Part 7: Ajax Web Interface—Advanced Procedures | 9 Reports
3 Reports Settings
§ Add It ems
From the device tree on the right side, drag objects and drop them on the list on the left
side. This can be entire probes, groups, devices, or single sensors. Each dropped object will
be added immediately as a new list item. Repeat this procedure as often as you wish until
you have added all desired items to the library. Note: Objects that already exist in the list on
the left side will be grayed out in the device tree on the right side.
§ Remove
To remove any objects from the report, click on the trash can symbol next the respective list
item, or select several list items while holding down the Ctrl key and click on the green trash
symbol appearing at the top of the list.
Your selection is saved automatically, and there is no undo function. Note: The final report will
include both sensors selected manually and those selected by tag.
1792 28.05.2014
Part 7: Ajax Web Interface—Advanced Procedures | 9 Reports
3 Reports Settings
Click on the Sensors Select ed by Tag tab to view all sensors that are added to the report
depending on the report's Add Sensors by Tag setting. In the table list 156 , you will see all
sensors that are added by tag. This is for your information only, you cannot change sensors
here. However, you can switch to the report's Set t ings tab and change the tabs that are used
to add sensors. Additionally, you can also exclude sensors with certain tabs there. The final
report will include both sensors selected manually and those selected by tag.
For sensors that are added by tag, all sensor channels are included in the report automatically,
except All nodes is selected in the report's Clust er Node selection. In this case, only the
primary channel of every sensor is included. Note: The final report will include both sensors
selected manually and those selected by tag.
Comments
In the Comment s tab you can enter free text for each object. This can be used for
documentation purposes or to leave information for other users.
More
Knowledge Base: Can I change the number of PDFs created by a report?
§ http://kb.paessler.com/en/topic/11863
Knowledge Base: How can I show full channel names below report graphs?
§ http://kb.paessler.com/en/topic/58913
28.05.2014 1793
Part 7: Ajax Web Interface—Advanced Procedures | 10 Maps
7.10 Maps
With PRTG's Maps feature (some people might call this 'dashboards') you can create web pages
with up-to-the-minute monitoring status information in a customizable layout. Using this unique
concept, you can also make your overview pages of live data publicly available, if you like.
In this section:
Introduction
There are countless possibilities for the implementation of maps. For example, this feature can
be used to:
§ Create network maps with status icons for each device on the map.
1794 03.04.2014
Part 7: Ajax Web Interface—Advanced Procedures | 10 Maps
§ Create quick views of your network that can be shown on network operations center
screens.
§ Create a quick network overview for publishing on the Intranet, allowing at-a-glance
information for management of other employees.
§ Create a custom view of the most important sensors in your monitoring setup.
§ Create Top 10 lists of the sensors of a specific group or device.
Technically, a map is a usual HTML web page. You can build a schema of your network by
choosing from hundreds of device icons and connect them with lines. A map can consist of
the following elements:
§ A set of map items, which can include device icons, sensor status icons, graphs, data tables,
lists of sensors, connection lines, geographical maps, or custom HTML code.
§ An optional background image (a JPG, PNG, or GIF file, for example, your company logo or a
graphical view of your network).
You can also specify the size of the map. Using the AJAX-based map editor, you can place the
items anywhere on the map and you can also change their size. Each map has a unique URL
which can be used to link to the map. Users who want to access the map either need an
account in your PRTG installation, or can access a public URL of the map if you allow the Public
Access feature. Public maps contain a unique Map ID access key in the URL to block
unwanted visitors.
Start Maps
Click the Maps entry from the main menu 182 to view or add custom views of your network's
status and monitoring data. Hover to show other menu items. Choose between:
§ All
Calls the Maps feature where you can view or add custom views of your network's status
and monitoring data.
§ Add Map
Lets you directly add 1797 a new map.
§ Select Map ›
Show existing maps. Hover to show other menu items. Follow the menu path (it is specific
to your setup) to select a map.
Maps Overview
In the All view, you see a list of all existing maps. Using the links next to a map name, you can
perform the following actions.
03.04.2014 1795
Part 7: Ajax Web Interface—Advanced Procedures | 10 Maps
Please see also Working wit h Table List s 156 . Additionally, there is multi-edit available. This
enables you to change properties of several objects at a time. For more details, please see
Mult i-Edit List s 1736 section.
Map Rotation
To show several maps in a rotation, mark the desired maps using multi-edit 1736 and then select
Map Rot at ion from the multi-edit menu. You will be redirected to a page where the rotation is
shown. This requires login credentials for PRTG.
It is also possible to set up a public map rot at ion without login: Allow public access in the
settings 1806 of the desired maps. Use the corresponding map IDs with its secret keys to build a
URL that calls a public map rotation. The URL must have this format: the address of your PRTG
server, followed by /public/mapshow.htm?ids=. Then list the IDs of the desired maps, each
separated by a comma. Each map ID has to be connected with its secret key using a colon:
ht t p://yourprtgserver/public/mapshow.ht m?
ids=mapid1:secretkey1,mapid2:secretkey2,mapid3:secretkey3
While a map rotation is shown, you can change the refresh interval any time when hovering the
arrows symbol in the lower right corner. Choose between 10, 30, or 60 seconds, 10 minutes
or Refresh now.
For detailed information on how to create and edit maps, and to learn how to make them
accessible to others, please see the following sections.
§ Maps St ep By St ep 1797
1796 03.04.2014
Part 7: Ajax Web Interface—Advanced Procedures | 10 Maps
1 Maps Step By Step
In order to create a new map, follow the steps in this section. In the web interface, click on
Maps entry in the main menu to show the maps main screen.
Note: This documentation refers to the PRTG Sy st em Administ rat or user accessing the Ajax
interface on a master node. For other user accounts, interfaces, or nodes, not all of the
options might be available as described. When using a cluster installation, failover nodes are
read-only by default.
In this section:
Click on the Add Map button. An assistant is shown. Enter a Map Name and define Map
Lay out settings (size and optionally a background image). in the Public Access section, define
whether your map will be visible without login.
For detailed information, see Maps Ot her Set t ings 1806 section (Settings).
03.04.2014 1797
Part 7: Ajax Web Interface—Advanced Procedures | 10 Maps
1 Maps Step By Step
Click on the Cont inue t o st ep 2 button to open the Map Designer. Drag&drop an object
from the items list on the right side, define further properties of the item (mark it in the main
window of the map designer and see section Propert ies on the right), and confirm. The item
will be added immediately. Repeat this procedure as often as you wish until you have added all
desired items to the map. Drag items to change their position. Additionally, you can also draw
connection lines between items or edit existing items.
Click on the View Map tab to see the appearance of your map. Later, it will be shown the way
you see it there. If available for an object, most object names as well as all sensors can be
clicked on. It depends on the object's access rights and the currently logged in user account if
clicking the links will lead to more detailed information about the object or to an error
message indicating insufficient access rights.
Click on the Get HTML tab to get the direct URL of your map that you can share with others.
For detailed information, see Maps Ot her Set t ings 1808 section.
1798 03.04.2014
Part 7: Ajax Web Interface—Advanced Procedures | 10 Maps
1 Maps Step By Step
While showing a map, the single map items will be refreshed in the refresh interval defined for
this map.
03.04.2014 1799
Part 7: Ajax Web Interface—Advanced Procedures | 10 Maps
2 Maps Designer
Note: This documentation refers to the PRTG Sy st em Administ rat or user accessing the Ajax
interface on a master node. For other user accounts, interfaces, or nodes, not all of the
options might be available as described. When using a cluster installation, failover nodes are
read-only by default.
In this section:
§ More 1804
Due to the map designer's extensive scripting capability, it is important that you use a
compatible browser when editing maps. We recommend using Google Chrome 34 or later
(recommended) or Mozilla Firefox 28 or later. You can use Microsoft Internet Explorer 10 or 11
as well. The maps designer is not fully compatible with earlier versions of Internet Explorer or
Opera browsers.
Click on the Map Designer tab to open the editor. It might take a few moments to load (for
unresponsive script warnings, please see More 1804 section below). Here, you can create your
map by adding or changing items. The designer screen consists of three main parts: The
Device Tree on the left side, the current Map in the middle, and the Propert ies on the right
side.
1800 28.05.2014
Part 7: Ajax Web Interface—Advanced Procedures | 10 Maps
2 Maps Designer
Map Designer
§ Device Tree (left): Select the monitoring object which's data will be shown on the map
§ Propert ies (right): Define how the map item will be shown
Simply drag and drop any object from either side onto the map, or double-click on an object.
You will always see all changes immediately.
Use the Device Tree to select the monitoring object which's data will be shown on the map
(this can be a probe, a group, a device, or a single sensor). In order to find the right object, you
have the following options:
§ Use the arrow symbols at the beginning of each line to open nodes in the device tree to
show objects underneath probes, groups, and devices.
§ Enter a few characters into the Search box in the upper left corner to search for names (or
part of names) of objects in your configuration. The search results will be shown
immediately. Click on the red x icon to clear your search.
No matter which method you choose to find the desired object, you can always drag any
object from the Device Tree on a free area of the map to create a new map item. If you drag it
onto an existing map item, it will be replaced, while Propert ies and size will remain. You can
also select a map item and double click on a Device Tree object to replace the map item. If no
item is selected, a double-click on an object will add a new map item.
To gain more space for map editing, reduce the size of the Device Tree box by dragging its
right border to left (or to the right to enlarge it again).
28.05.2014 1801
Part 7: Ajax Web Interface—Advanced Procedures | 10 Maps
2 Maps Designer
Properties Selection
Use the Propert ies selection to define how the map item will be shown (for example, as an
icon, a map, a table, or a graph). Select the appearance in different categories. Hover a
property object to get a live preview of it (in most cases). Note: If a certain Propert ies object
is not available for the selected Device Tree object, you will see a corresponding text hint.
There are many different property object types available. Simply click a category's name to
show all available types.
1802 28.05.2014
Part 7: Ajax Web Interface—Advanced Procedures | 10 Maps
2 Maps Designer
§ Top 10
Choose from several tables showing the top 10 of sensors with certain monitoring data,
such as least used CPUs, highes bandwidth usage, best availability, slowest websites, etc.
Note: In order to provide live previews, PRTG calculates all top 10 lists from your monitoring
data when opening this tab. It may take a few seconds before thumbnails are shown.
§ Cust om HTML
This can be used, for example, to add external images or applets to your map. In order to
actually add custom HTML code to your map, please add this item and then click on it to edit
1803 . You can then copy your custom code into the HTML Before and HTML Aft er fields in
No matter which object you choose, you can always drag any object from the Propert ies box
on a free area of the map to create a new map item. If you drag it onto an existing map item, it
will be replaced, while its Device Tree object attributes and size will remain. You can also
select a map item and double click on an object in the Propert ies box to replace the map
item. If no item is selected, a double-click on an object will add a new map item.
To gain more space for map editing, reduce the size of the Propert ies box by dragging its left
border to right (or to the left to enlarge it again).
Click on a map item to select it. You can then edit its attributes with the fields in the upper part
of the Propert ies box on the right side:
§ Lay er field
The layer number defines if an item will be shown on top of or behind another item, if
overlapping. The item with the higher number will be shown on top. Enter a positive integer
value and click the Save button to save your settings. Alternative: Use the arrow symbols in
a map item's hover menu to Bring t o front or Send t o back an item one layer (see below).
§ HTML
Click on the arrow symbol underneath to show the HTML Before and HTML Aft er fields. Any
HTML code you enter in these fields will be added before respectively after the map item.
Please enter your custom HTML code that embeds an objects and click the Save button.
Your HTML object will be inserted. For example, you could enter the code <img src="http://
media.paessler.com/common/img/logoclaim_r1.gif"> to insert an image of the Paessler logo
from the Paessler website.
28.05.2014 1803
Part 7: Ajax Web Interface—Advanced Procedures | 10 Maps
2 Maps Designer
While an object is selected, use the cursor keys to move it by one pixel. Hold the Shift key in
combination with the cursor keys to move the object by 10 pixels.
You can draw connection lines between any map items via drag and drop. Simply click on the
grey handles next to an item and drag a line to another item you want to draw a connection
to. A line will be shown immediately. This can be useful to indicate network connections or
logical coherences between two items. To delete connection lines, click the scissors symbol in
the item's edit icons 1803 .
Lines between objects are colored dynamically. They will turn red as long as one of the
object's icons shows a red Down status. This will only affect half of the line, at the end where
the red sensor is shown. If both objects connected show a red sensor, this will result in a line
that is red all over.
Snap to Grid
Select whether to use Snap To Grid or Don't Snap, using the buttons underneath the Device
Tree box. This will affect how map items will be positioned when adding or moving them via
drag and drop. The setting is active immediately. With snap to grid enabled, you can place items
aligned with the grid only.
More
Knowledge Base: Why does my browser show an unresponsive script warning while loading
the Maps Designer?
§ http://kb.paessler.com/en/topic/19483
1804 28.05.2014
Part 7: Ajax Web Interface—Advanced Procedures | 10 Maps
2 Maps Designer
Knowledge Base: Where can I download free political/topographical map images for use in
PRTG map editor?
§ http://kb.paessler.com/en/topic/7463
Knowledge Base: Which audible notifications are available in PRTG? Can I change the default
sound?
§ http://kb.paessler.com/en/topic/26303
Knowledge Base: How can I add "deep links" into PRTG's interface for map status icons?
§ http://kb.paessler.com/en/topic/3763
Knowledge Base: How can I add or edit map objects used for PRTG's maps?
§ http://kb.paessler.com/en/topic/1703
Knowledge Base: Can you re-order or remove columns in sensor lists displayed in maps?
§ http://kb.paessler.com/en/topic/5523
Knowledge Base: How can I show up-to-date weather information, webcam and radar images in
PRTG's maps
§ http://kb.paessler.com/en/topic/9263
28.05.2014 1805
Part 7: Ajax Web Interface—Advanced Procedures | 10 Maps
3 Maps Settings
Using the Map tabs you can access all functionalities and settings for a map.
Map Tabs
View Map
Click on the View Map tab any time to show a preview of your map.
Map Designer
Click on the Map Designer tab to edit the contents of your map. Please see Maps Designer 1800
section.
Settings
Click on the Set t ings tab to open a map's general settings. Note: When using the Add Map
dialog, not all of these settings are available. You can change them later by clicking on the
Set t ings tab.
Security Context Define the user account that will be used for access to monitoring
data. The map will only contain objects which the selected user 94
is allowed to view. Please choose a user from the list. The available
users depend on your configuration. By default, this is the user that
created the map. PRTG Administrator users can change this setting.
Timezone Define the time zone that will be used for all date-specific options
in this map. Select a time zone from the list.
Tag Filter This setting affects table maps objects. Enter one or more tags
separated by space or comma to include sensors in tables. Only
sensors with one of the tags entered here will appear in this map's
data tables—including sensors which inherit 87 tags from parent
objects. Please enter a string or leave the field empty. Note: Use
with care! This setting will affect all tables of the current map!
1806 28.05.2014
Part 7: Ajax Web Interface—Advanced Procedures | 10 Maps
3 Maps Settings
Map Width Define the width of the map in pixels. Please enter an integer value.
Map Height Define the height of the map in pixels. Please enter an integer
value.
Background Picture Define if you want to use a background picture for the map.
Choose between:
§ On: Use a background image (define below).
§ Off: Do not use a background image.
Background Image This option is only visible if a background picture is enabled above.
Click on the Choose File button and select an image from your
computer or network. Note: Only images in the format JPG, PNG,
and GIF are supported. The file size must be smaller than 2 MB. If
you try to upload other images, you will get an error message. In a
cluster, background images are not automatically deployed to the
other nodes! In order to view maps on other nodes, please copy
the background pictures manually to \webroot\mapbackground of
the program directory on every node. For detailed information on
how to find this path, please see Dat a St orage 2074 section.
Background Color Select a background color for this Map. Either enter a hex color
code or choose a color from the color selector. The hex color
code field will always display the currently defined color.
Public Access
Public Access Define if others can see the map. Choose between:
§ No Public Access: Do not allow public access to the map. Only
users with both a login to the PRTG web interface and sufficient
access rights can see the map.
§ Allow Public Access: Allow access to the map using a unique
address. The URL contains a key that you can change below.
Secret Key This field is only visible if public access is enabled above. The key is
automatically generated. It is part of the public URL for the map.
You can also enter a customized string. We recommend using the
default value. For more information on public access, please see
the Get HTML 1808 section. Note: The characters comma "," and
colon ":" are not allowed in the secret key field!
28.05.2014 1807
Part 7: Ajax Web Interface—Advanced Procedures | 10 Maps
3 Maps Settings
Access Right s
User Group Access Define which user group(s) will have access to the object you're
editing. A table with user groups and right is shown; it contains all
user groups from your setup. For each user group you can choose
from the following access rights:
§ Inherit ed: Use the settings of the parent object.
§ None: Users in this group cannot see or edit the object. The
object does not show up in lists.
§ Read: Users in this group can see the object and review its
settings.
§ Writ e: Users in this group can see the object, as well as review
and edit its settings. However, they cannot edit access rights
settings.
§ Full: Users in this group can see the object, as well as review and
edit its settings and edit access rights settings.
You can create new user groups in the Sy st em Administ rat ion—
User Groups 1861 settings.
Click on the Save button to store your settings. If you change tabs or use the main menu, all
changes to the settings will be lost!
Get HTML
Your PRTG map is like a standalone HTML page. You can make it accessible to others, if you
like. Depending on the Public Access setting 1806 of your map, a visitor will need to provide
PRTG user account login data to view the map, or will see the map immediately using a URL
containing a secret key. When using this unique key, you can also include your map on
another webpage, embedding it via <iframe>.
§ Opt ion 1: Link t o a web page wit h t he map t hat requires login credent ials
The shown URL requires login credentials in order to display the map. PRTG will ask the user
trying to view the map via this URL for login credentials. Note: In the URL, usually the IP
address is given via which the page is available. Maybe a NAT translation is set in your
firewall, or you may want to use a domain name or a name from a dynamic DNS service for
public access. Please customize URL you use for access to your needs.
§ Opt ion 2: Link t o a web page t hat display s t he map wit hout a login
In order to get the shown URL working for public access without a login, enable Allow
Public Access in the settings tab 1806 of your map. Note: In the URL, usually the IP address is
given via which the page is available. Maybe a NAT translation is set in your firewall, or you
may want to use a domain name or a name from a dynamic DNS service for public access.
Please customize URL you use for access to your needs.
1808 28.05.2014
Part 7: Ajax Web Interface—Advanced Procedures | 10 Maps
3 Maps Settings
§ Opt ion 3: Show a map inside ot her web pages using an IFRAME
For your convenience, this shows source code for adding an iframe to another webpage. It
includes a URL for direct access. Just copy the code and paste it into your webpage's code.
Also enable Allow Public Access in the settings tab 1806 . Note: In the URL, usually the IP
address is given via which the page is available. Maybe a NAT translation is set in your
firewall, or you may want to use a domain name or a name from a dynamic DNS service for
public access. Please customize URL you use for access to your needs.
While a map is shown via these URLs, you can change the refresh interval any time by hovering
the arrows symbol in the lower right corner. Choose between 10, 30, or 60 seconds, 10
minutes or Refresh now.
Comments
In the Comment s tab you can enter free text for each object. This can be used for
documentation purposes or to leave information for other users.
History
In the Hist ory tab all changes in the settings of an object are logged with a timestamp, the
PRTG user which conducted the change, and a message. The history log keeps the last 100
entries.
Delete
You can delete the entire map any time by clicking on the trash symbol on the right.
More
Knowledge Base: How to disable links in public maps?
§ http://kb.paessler.com/en/topic/10283
28.05.2014 1809
Part 7: Ajax Web Interface—Advanced Procedures | 11 Setup
7.11 Setup
In the setup settings of the PRTG web interface, you can define almost all system settings for
PRTG. However, some of the machine-oriented settings are defined using two Windows
administration tools (see Ot hers 1811 section below).
Account Settings
§ Account Set t ings—My Account 1812
System Administration
§ Sy st em Administ rat ion—User Int erface 1831
1810 28.05.2014
Part 7: Ajax Web Interface—Advanced Procedures | 11 Setup
PRTG Status
§ PRTG St at us—Sy st em St at us 1869
Support
§ Support —Cont act Support 1889
Others
There are some settings that have to be made in the Sy st em Administ rat ion Tools 1998 ,
running as Windows applications. For more details, please see sections:
28.05.2014 1811
Part 7: Ajax Web Interface—Advanced Procedures | 11 Setup
1 Account Settings—My Account
In the My Account settings you can define values regarding your own PRTG user currently
logged in. All settings in this section are user specific. Some account control options may not
available, but can only be defined by the administrator.
My Ac c ount Settings
My Account Settings
Note: This documentation refers to the PRTG Sy st em Administ rat or user accessing the Ajax
interface on a master node. For other user accounts, interfaces, or nodes, not all of the
options might be available as described. When using a cluster installation, failover nodes are
read-only by default.
User Account
Display Name Enter a name for the user for display purposes. This will not be
used for login.
1812 14.01.2014
Part 7: Ajax Web Interface—Advanced Procedures | 11 Setup
1 Account Settings—My Account
User Account
Date Format Enter in what format dates will be displayed for the current user.
Note: This setting will take effect after the next login.
Password Define the user's password. For security reasons, the account
settings page does not contain the password. Choose between:
§ Don't change
§ Specify new password
If you choose to specify a new password, enter the old password,
and the new password twice.
Note: The new password must be at least 8 characters long; no
character may occur more than 3 times. It must contain a number
and a capital letter.
Hash The hash (passhash) value can the used as password substitute
when calling functions from PRTG's Application Programming
Interface (API) that require an authentication. For more information
please see Using t he PRTG API (Applicat ion Programming
Int erface) 2031 section.
Auto Refresh Type Specify how PRTG's web pages will be refreshed for the current
user. Choose between:
§ Refresh page element s using AJAX (recommended):
Automatically refresh the single page elements on the web
pages.
§ Refresh whole page: Automatically reload the whole page with
every refresh interval.
§ No aut o refresh: Do not automatically refresh web pages.
Auto Refresh Interval This setting is only relevant when auto refresh is enabled above.
(Sec.) Enter the number of seconds that will be waited between two
refreshes. We recommend using 30 seconds or more. Minimum
value is 20 seconds. Note: Shorter intervals create more CPU load
on the server running the PRTG core server. If you experience load
problems while using the web interface (or PRTG maps 1794 ), please
set a higher interval.
14.01.2014 1813
Part 7: Ajax Web Interface—Advanced Procedures | 11 Setup
1 Account Settings—My Account
Play Audible Alarms Define when an audible alarm will be played for the current user on
web pages whenever there are alarms 144 in PRTG. Choose
between:
§ Never: Do not play sound files on any web pages.
§ On dashboard pages only : When there are alarms, play a
predefined sound on dashboard 175 pages only. The sound will be
replayed with every refresh of a dashboard page.
§ On all pages: When there are alarms, play a predefined sound on
all web pages. The sound will be replayed with every page
refresh.
For more information about audible notifications and supported
browsers, please see More 1816 section below.
Ticket Sy st em
Email Notifications Define if you want to get emails from the ticket system. Choose
between:
§ I want t o receive an email whenever a t icket changes: You
will receive an email each time a ticket is assigned to you or your
user group, or if a ticket which is assigned to you or your user
group is changed. Note: If you edit tickets which are assigned to
you or your user group, or you assign a ticket to yourself or
your user group, you will not get an email.
§ I do not want t o receive any emails from t he t icket sy st em:
You will not get any emails about tickets.
Homepage URL Define the user's default page loaded after login and when clicking
on the Home 175 button in main menu.
Max. Groups/Devices In order to provide you with a speedy user experience PRTG tries
per Group to keep the page size for the page showing the device tree small
by automatically folding groups and devices with many items.
Define how many groups and devices are shown at maximum
before the automatic reduction is performed. We recommend using
a value between 10 and 30.
1814 14.01.2014
Part 7: Ajax Web Interface—Advanced Procedures | 11 Setup
1 Account Settings—My Account
Max. Sensors per In order to provide you with a speedy user experience PRTG tries
Device to keep the page size for the page showing the device tree small
by automatically folding groups and devices with many items.
Define how many sensors are shown at maximum before the
automatic reduction is performed. We recommend using a value
between 10 and 30.
Account Type This setting is only shown for administrator users. However, it is
not shown if the user you modify the account settings for is a
member of a group with administrative rights.
Define the account type for the current user. Choose between:
§ Read/Writ e User: The user may change settings.
§ Read Only User: The user may not edit any settings. This is a
good choice for public or semi-public logins.
Note: This setting cannot be changed for the default administrator
user.
Allow Acknowledge This setting is only visible if read only user is enabled above.
Alarms Acknowledging an alarm is an action which requires write access
rights. However, you can explicitly allow this action to read-only
users. If enabled, they still do not have write access, but may
acknowledge alarms 145 . Choose between:
§ Allow: Allow acknowledging alarms for this user.
§ Deny : The user will not be able to acknowledge alarms.
Primary Group This setting is only shown for administrator users. Select the
primary group for the current user. Every user has to be member of
a primary group to make sure there is no user without group
membership. Membership in other user groups is optional. For user
experience, there is no difference between the primary and other
user groups.
Status This setting is only shown for administrator users. Define the
status of the current user. Choose between:
§ Act ive: The current user can login to the account.
§ Inact ive: The current user's login is disabled. Use this option to
temporarily deny access for this user.
Note: This setting cannot be changed for the default administrator
user.
14.01.2014 1815
Part 7: Ajax Web Interface—Advanced Procedures | 11 Setup
1 Account Settings—My Account
Last Login Shows the time stamp of the user's last login. This setting is shown
for your information only and cannot be changed here.
User Groups
Member of Shows the groups the current user is member of. Access rights to
the device tree are defined on group level. This setting is shown
for your information only and cannot be changed here.
Comments
In the Comment s tab you can enter free text for each object. This can be used for
documentation purposes or to leave information for other users.
History
In the Hist ory tab all changes in the settings of an object are logged with a timestamp, the
PRTG user which conducted the change, and a message. The history log keeps the last 100
entries.
Click on the Cont inue button to store your settings. If you change tabs or use the main menu,
all changes to the settings will be lost!
More
Knowledge Base: Which audible notifications are available in PRTG? Can I change the default
sound?
§ http://kb.paessler.com/en/topic/26303
1816 14.01.2014
Part 7: Ajax Web Interface—Advanced Procedures | 11 Setup
2 Account Settings—Notifications
In the notifications settings you can define and change notifications for the currently logged in
PRTG user. They can be triggered for certain sensor states and data.
Note
This section describes one of three steps to set up the notification system in PRTG. A
complete notification setup involves:
1. Check and set up the Not ificat ion Delivery settings. This will tell PRTG how to send
messages.
For detailed information, see Sy st em Administ rat ion—Not ificat ion Delivery 1843 .
2. Check and set up several Not ificat ions. This will define the kind of message and its
content.
For detailed information, see Account Set t ings—Not ificat ions 1817 .
3. Check and set up Not ificat ion Triggers for objects. These will provoke the defined
notifications.
For detailed information, see Sensor Not ificat ions Set t ings 1716 .
For background information, please see Not ificat ions 1749 section.
28.05.2014 1817
Part 7: Ajax Web Interface—Advanced Procedures | 11 Setup
2 Account Settings—Notifications
Notifications Overview
Click on the Not ificat ions tab to show a list of all existing notifications. Using the links next
to the notification name, you can perform the following actions:
Please see also Working wit h Table List s 156 . Additionally, there is multi-edit available. This
enables you to change properties of several objects at a time. For more details, please see
Mult i-Edit List s 1736 section.
Notifications Settings
Click on the Add new not ificat ion button to add a new notification, or click on the name of
an existing notification to edit it.
Note: This documentation refers to the PRTG Sy st em Administ rat or user accessing the Ajax
interface on a master node. For other user accounts, interfaces, or nodes, not all of the
options might be available as described. When using a cluster installation, failover nodes are
read-only by default.
Notification Name Enter a meaningful name for the notification, for example, SMS to
service team or similar.
1818 28.05.2014
Part 7: Ajax Web Interface—Advanced Procedures | 11 Setup
2 Account Settings—Notifications
Schedule Define when this notification will be active. Please select None to
set it to always active, or choose a schedule from the list. Usually
schedules define when this notification will be active; schedules
defined as period list set this notification to inactive at the
corresponding time spans. The available options depend on your
setup. To add or change existing schedules, please see Account
Set t ings—Schedules 1827 section.