PRTG Manual: Libraries and Node Settings

Using the libraries tabs, you can access all functionalities and settings for a library.

Library Tabs

Library Tabs

Overview

Click the Overview tab any time to show the current state of your library.

Library Node Display Settings

While in the Overview tab, click the name of a library node to change its settings. Or, while in the Management tab, right-click a library node's name and select Edit | Settings... from the context menu. In both cases, the following settings are shown.

icon-i-roundYou can only change the settings of a 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.

Security Context

Define the security context for the Overview tab of the library. Choose a PRTG user account to define which objects will be visible. All users with access to the library will see the same content in this library as the security context user will see.

icon-i-round-redOnly sensors that are visible in the library will trigger a library notification.

Tags

Enter one or more tags, separated by space or comma. For example, you can use tags later to search for the library. Tags are not case sensitive.

icon-i-roundIt is not possible to enter tags with a leading plus (+) or minus (-) sign, nor tags with round parentheses (()) or angle brackets (<>).

Node Display Settings

Linked Object

Click the reading-glass symbol to change the object that is linked to this library node. The Object Selector will appear.

Node Type

Select what you want to view for this library node. Choose between:

  • Show a subtree of the device tree in the library: View all objects underneath the linked object as a device tree.
  • Show a collection of filtered sensors in the library (max. 1000): View all sensors underneath the linked object (only sensors are shown). You can combine several filters with each other (see below).

icon-i-roundThe node can show up to 1,000 sensors, surplus sensors are discarded.

Filter By Type

This option is only visible 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 types: Do not filter for a sensor type.
  • Show specific sensor types only: Filter the sensor list of the linked object for certain sensor types.

icon-i-roundThis 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 only visible 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.

icon-i-roundThis filter is applied in real-time. If the configuration underneath the linked object changes, the library node will show matching sensors accordingly.

icon-i-roundYou cannot filter for sensor types that are defined in PRTG Mini Probes.

Filter By Status

This option is only visible if collection of sensors is enabled above. Choose between:

  • Show all sensor states: Do not filter for a sensor status.
  • Show sensors with a specific status only: Filter the sensor list of the linked object for sensors in certain states.

Select Sensor States

This option is only visible if filtering by sensor status 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 (Partial)

You can also select and deselect all items by using the check box in the table head.

icon-i-roundThis filter is applied in real-time. If the configuration underneath the linked object changes, the library node will show matching sensors accordingly.

Filter By Tags

This option is only visible if collection of sensors is enabled above. Choose between:

  • Show all tags: Do not filter for a tag.
  • Show objects with specific tags only: Filter the sensor list of the linked object for sensors with a certain tag.

icon-i-roundThe tag of a sensor can also be inherited by a parent object.

Select Tags

This option is only visible if collection of sensors is enabled above. Enter one or more tags of sensors that you want to include in the library node view. You can also use plus (must have) and minus (must not have) signs to categorize tags, for example, +snmp;–wmi (must have the tag snmp and must not have the tag wmi).

icon-i-roundThis 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 only visible if collection of sensors is enabled above. Choose between:

  • Show all priorities: Do not filter for the priority setting of a sensor.
  • Show objects with specific priority only: Filter the sensor list of the linked object for sensors with specific priority.

icon-i-roundThe 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 only visible 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)

icon-i-roundThis filter is applied in real-time. If the configuration underneath the linked object changes, the library node will show matching sensors accordingly.

Click OK to store your settings. If you close the dialog box via the X, all changes to the settings will be lost!

icon-i-roundAfter 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 the Management tab to edit the contents of your library, for example, to add items to the library using drag&drop.

icon-book-arrowsFor more details, see section Management.

Settings

Click the Settings tab to open a library's general settings.

Basic Library Node Settings

Library Name

Enter a meaningful name for the library.

Security Context

Define the security context for the Overview tab of the library. Choose a PRTG user account to define which objects will be visible. All users with access to the library will see the same content in this library as the security context user will see.

icon-i-round-redOnly sensors that are visible in the library will trigger a library notification.

Tags

Enter one or more tags, separated by space or comma. For example, you can use tags later to search for the library. Tags entered here are inherited to all library nodes underneath. Tags are not case sensitive.

Access Rights

Click inherited_settings_button to disrupt the inheritance. See section Inheritance of Settings for more information.

User Group Access

Define which user group(s) will have access to the object you're editing. A table with user groups and types of access rights is shown. It contains all user groups from your setup. For each user group, you can choose from the following access rights:

  • Inherited: Use the access rights settings of the parent object.
  • None: Users in this group cannot see or edit the object. The object neither shows up in lists nor 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.
  • Write: 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 System Administration—User Groups 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 rights to inherited option.

icon-book-arrowsFor more details on access rights, see the section User Access Rights.

icon-i-roundWhen 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.

Save your settings. If you change tabs or use the main menu, all changes to the settings will be lost!

Notification Triggers

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.

icon-book-arrowsFor details about how to use notifications, see section Notifications.

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.

Save your settings. If you change tabs or use the main menu, all changes to the settings will be lost!

History

In the History tab all changes in the settings of an object are logged with a timestamp, the name of the PRTG user who made the change, and a message. The history log retains the last 100 entries.

Delete

You can delete the entire library any time, simply right-click a library's name and select Delete... from the context menu.

 

 

Libraries—Topics