PRTG Manual: Libraries and Node Settings

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

Library Tabs

Library Tabs

Overview

Click the Overview tab to show the status of your library.

Library Node Settings

While on the Overview tab, click the name of a library node to change its settings. Or, while on 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-round-blueYou can only change the settings of a library node if it already contains monitoring objects like groups, devices, or sensors.

Basic Library Node Settings

Setting

Description

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 user account to define which objects are visible. All users with access to the library see the same content in this library as the security context user sees.

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

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.

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

Library Node Display Settings

Setting

Description

Linked Object

Click the Search button to change the object that is linked to this library node. The object selector appears.

Node Type

Select what you want to view for this library node:

  • 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 (see below).

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

Filter By Type

This option is only visible if Show a collection of filtered sensors in the library (max. 1000) is enabled above. Select if you want to filter the sensor list by a certain type:

  • 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-round-blueThis filter is applied in real time. If the configuration underneath the linked object changes, the library node shows matching sensors accordingly.

Select Sensor Types

This option is only visible if Show specific sensor types only is enabled above. A list of all sensor types is shown. Available sensor types are shown in bold letters.

Set a check mark in front of each 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.

icon-i-round-blueThis filter is applied in real time. If the configuration underneath the linked object changes, the library node shows matching sensors accordingly.

icon-i-round-blueYou cannot filter for sensor types that are defined in mini probes.

Filter By Status

This option is only visible if Show a collection of filtered sensors in the library (max. 1000) 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 Show sensors with a specific status only is enabled above. A list of sensor states is shown. Set a check mark in front of each status that 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 all items or cancel the selection by using the check box in the table header.

icon-i-round-blueThis filter is applied in real time. If the configuration underneath the linked object changes, the library node shows matching sensors accordingly.

Filter By Tags

This option is only visible if Show a collection of filtered sensors in the library (max. 1000) 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-round-blueThe tag of a sensor can also be inherited by a parent object.

Select Tags

This option is only visible if Show a collection of filtered sensors in the library (max. 1000) 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-round-blueThis filter is applied in real time. If the configuration underneath the linked object changes, the library node shows matching sensors accordingly.

Filter By Priority

This option is only visible if Show a collection of filtered sensors in the library (max. 1000) 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 setting.

icon-i-round-blueThe 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 Show a collection of filtered sensors in the library (max. 1000) above. Define which priority setting sensors must have to appear in this collection. Set a check mark in front of each priority that you want to include in the library node view. Choose from:

  • ***** (highest)
  • ****
  • ***
  • **
  • * (lowest)

icon-i-round-blueThis filter is applied in real time. If the configuration underneath the linked object changes, the library node shows matching sensors accordingly.

icon-i-round-redClick OK to store your settings. If you close the dialog box via the X, all changes to the settings are lost.

icon-i-round-blueAfter applying filters, it might take several seconds for the changes to become visible. This is because of 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-and-drop.

icon-square-cyanFor more information, see section Management.

Settings

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

Basic Library Node Settings

Setting

Description

Library Node Name

Enter a meaningful name for the library.

Security Context

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

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

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.

Access Rights

Setting

Description

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.

icon-i-round-blueYou can create new user groups in the User Groups settings.

icon-i-round-blueWhen giving access rights to a user group, all user group members can see the objects in the library just as the user who originally created the library can see.

icon-i-round-redSave 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 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-square-cyanFor more information 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.

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 any time by right-clicking a library's name and selecting Delete from the context menu.

Libraries