<%NUMBERING1%>.<%NUMBERING2%>.<%NUMBERING3%> PRTG Manual: Libraries and Node Settings
This documentation refers to an administrator that accesses the PRTG web interface on a master node. Other user accounts, interfaces, or failover nodes might not have all of the options in the way described here. In a cluster, note that failover nodes are read-only by default.
Use the library tabs to access all functionalities and settings of a library.
Library Tabs
Overview
Click the Overview tab to show the status of your library.
Management
Click the Management tab to edit the contents of your library, for example, to add items to the library via drag-and-drop.
For more information, see section Library Management.
Library Node Settings
To change the settings of a library node, go to a library's Overview tab and click the name of a library node. You can also open the library node settings on the Management tab via the library node's context menu.
You can only change the settings of a library node if it already contains monitoring objects like groups, devices, or sensors.
Basic Library Node Settings
|
|
Library Node Name
|
Enter a meaningful name for the library node.
If the name contains angle brackets (<>), PRTG replaces them with braces ({}) for security reasons. For more information, see the Knowledge Base: What security features does PRTG include?
|
Security Context
|
Define the security context for the Overview tab of the library. Select a user account from the dropdown list to define which objects are visible. All users with access to the library can only see the objects that the selected user account has the rights to view.
Only sensors that are visible in the library trigger a notification.
Basically, the security context defines the minimum access rights to objects like libraries, reports, or maps, that a user account has. If the security context of an object is PRTG System Administrator, for example, every user sees all objects in a library, in a report, or on a map, no matter what the particular user access rights are.
|
Tags
|
Enter one or more tags. Confirm each tag with the Spacebar key, a comma, or the 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.
It is not possible to enter tags with a leading plus (+) or minus (-) sign, nor tags with parentheses (()) or angle brackets (<>).
For performance reasons, it can take some minutes until you can filter for new tags that you added.
|
Library Node Display Settings
|
|
Linked Object
|
Click and use the object selector to change the object in the device tree that the library node references.
|
Library Node View
|
Select how you want to view the objects that PRTG shows underneath the library node:
- Show a subtree of the device tree: View all objects underneath the linked object as you can see them in the device tree, including probes, groups, and devices.
- Show a collection of filtered sensors: Only view the sensors underneath the linked object without probes, groups, and devices. You can use filters to show only specific sensors.
The library node can show up to 1,000 sensors. PRTG discards further sensors.
|
Filter by Sensor Type
|
This setting is only visible if you select Show a collection of filtered sensors above. Select if you want to filter the displayed sensors by specific sensor types:
- Show all sensor types: Do not filter by sensor types.
- Show only specific sensor types: Filter the displayed sensors by specific sensor types.
PRTG applies this filter in real time. If the configuration underneath the linked object changes, the library node accordingly shows matching sensors.
|
Sensor Types
|
This setting is only visible if you select Show only specific sensor types above. You can see a list of all sensor types. PRTG displays sensors that are in use in bold print.
Enable the check box in front of a sensor type that you want to include in the library node view.
You can also select all items or cancel the selection by using the check box in the table header.
PRTG applies this filter in real time. If the configuration underneath the linked object changes, the library node accordingly shows matching sensors.
You cannot filter for sensor types that are defined in mini probes.
|
Filter by Sensor Status
|
This setting is only visible if you select Show a collection of filtered sensors above. Select if you want to filter the displayed sensors by specific sensor states:
- Show all sensor states: Do not filter by sensor status.
- Show only sensors in specific states: Filter the displayed sensors by specific sensor states.
|
Sensor States
|
This setting is only visible if you select Show only sensors in specific states above. You can see a list of all sensor states.
Enable the check box in front of a sensor status to include all sensors that show this status in the library node view:
- Unknown
- Up
- Warning
- Down
- Paused by user
- Unusual
- Down (Acknowledged)
- Down (Partial)
You can also select all items or cancel the selection by using the check box in the table header.
PRTG applies this filter in real time. If the configuration underneath the linked object changes, the library node accordingly shows matching sensors.
|
Filter by Tag
|
This setting is only visible if you select Show a collection of filtered sensors above. Select if you want to filter the displayed sensors by specific tags:
- Show all tags: Do not filter by tag.
- Show only sensors with specific tags: Filter the displayed sensors by specific tags.
|
Tags
|
This setting is only visible if you select Show only sensors with specific tags above. Enter one or more tags for sensors that you want to include in the library node view. You can also use the plus sign (+) or the minus sign (-) to categorize tags as must have or must not have, for example, +snmp;–wmi (must have the tag snmp and must not have the tag wmi).
The tag of a sensor can also be inherited from a parent object.
For performance reasons, it can take some minutes until you can filter for new tags that you added.
PRTG applies this filter in real time. If the configuration underneath the linked object changes, the library node accordingly shows matching sensors.
|
Filter by Priority
|
This setting is only visible if you select Show a collection of filtered sensors above. Select if you want to filter the displayed sensors by specific priorities:
- Show all priorities: Do not filter by priority.
- Show only sensors with specific priorities: Filter the displayed sensors by specific priorities.
PRTG ignores the priority settings of a parent object. It only regards the priority setting of the sensor itself.
|
Priorities
|
This setting is only visible if you select Show only sensors with specific priorities above. You can see a list of all available priorities.
Enable the check box in front of a priority to include all sensors that have this priority in the library node view:
- ***** (highest priority)
- ****
- ***
- **
- * (lowest priority)
PRTG applies this filter in real time. If the configuration underneath the linked object changes, the library node accordingly shows matching sensors.
|
Click OK to save your settings. If you close the dialog without saving, all changes to the settings are lost.
After you apply filters, it might take several seconds for the changes to become visible. This is because of internal filter processes that run in the background.
Settings
Click the Settings tab to open a library's general settings.
Basic Library Node Settings
|
|
Library Node Name
|
Enter a meaningful name for the library.
If the name contains angle brackets (<>), PRTG replaces them with braces ({}) for security reasons. For more information, see the Knowledge Base: What security features does PRTG include?
|
Security Context
|
Define the security context for the Overview tab of the library. Select a user account from the dropdown list to define which objects are visible. All users with access to the library can only see the objects that the selected user account has the rights to view.
Only sensors that are visible in the library trigger a notification.
Basically, the security context defines the minimum access rights to objects like libraries, reports, or maps, that a user account has. If the security context of an object is PRTG System Administrator, for example, every user sees all objects in a library, in a report, or on a map, no matter what the particular user access rights are.
|
Tags
|
Enter one or more tags. Confirm each tag with the Spacebar key, a comma, or the 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.
For performance reasons, it can take some minutes until you can filter for new tags that you added.
|
Access Rights
|
|
User Group Access
|
Define the user groups that have access to the object. You see a table with user groups and group access rights. The table contains all user groups in your setup. For each user group, you can choose from the following group access rights:
- No access: Users in this user group cannot see or edit the object. The object does not show up in lists.
- Read access: Users in this user group can see the object and view its settings.
- Write access: Users in this user group can see the object and view and edit its settings. However, they cannot edit the object's access rights settings.
- Full access: Users in this user group can see the object, view and edit its settings, and edit its access rights settings.
You can create new user groups in the User Groups settings.
|
When you give access rights to a user group, all user group members can see the objects in the respective library.
Save your settings. If you change tabs or use the main menu without saving, all changes to the settings are lost.
Notification Triggers
You can define notification triggers for any kind of library, also for dynamic libraries that can change with every scanning interval, for example, when you filter a library by sensor status or priority.
Comments
On the Comments tab, you can enter free text for each object. You can use this function for documentation purposes or to leave information for other users.
History
On the History tab, all changes in the settings of an object are logged with a time stamp, the name of the user who made the change, and a message. The history log retains the last 100 entries.
Delete
You can delete the entire library at any time. Right-click a library's name and select Delete from the context menu.
More
Knowledge Base
What security features does PRTG include?