Skip to main content

Preface

The “PRTG Group Creator” enables you to create tasks within automations that generate new groups based on user-defined conditions. Depending on the information Qbilon has collected about the IT landscape, multiple groups can be created in a batch. Additionally, multiple group creators can be created to address different PRTG core servers, ensuring monitoring compliance with actual assets across a larger IT landscape. A practical example of use is described here: Automate PRTG Monitoring.

Configuration

The “PRTG Group Creator” is one of several PRTG-specific task types that can be found in the “Data Writer” section:
PRTG Group Creator: Configuration

Name and Identifier

This is the name that will be displayed for this task within an automation. This name can be chosen freely. Qbilon automatically generates a valid identifier from the name that does not need to be edited by the user. The name can express which PRTG core the task was created for, for example, if you have several core servers in use.

Host und API Token

The host information is required so that the “PRTG Group Creator” knows on which PRTG Core Server it should create groups. The API token must have been created by the user in PRTG and must have full access rights to ensure that the “PRTG Element Deleter” has the necessary permissions to delete the defined assets in the PRTG instance. The API token can be created in PRTG under “Setup → Account Settings → API Keys”:
PRTG Group Creator: Host und API Token
The API token has the same access rights as the user who created it. If possible, use the same user for reading the PRTG data with a PRTG connector. Otherwise, the visible groups, devices, and sensors will differ from what the user who deleted them can see.

Allow Insecure Connections

Select this option if you are running PRTG with a self-signed certificate (the default installation) or if the certificate was issued by an unknown Trusted Third Party Authority that is not traditionally found in the default Java Trust Stores. Otherwise, connection problems may occur.

Group ID

Please enter the ID of the group under which the groups shall be created. The ID of the group can be found in your PRTG instance when you navigate to the respective group on the right-hand side together with the status and other high-level information for the group:
PRTG Group Creator: Group ID
Important: only enter the numerical value of the ID, i.e. WITHOUT the hashtag. Make sure that you do not enter any superfluous spaces.

Type

Use the type configuration parameter to select which PRTG assets from the recorded IT landscape are to be transferred to monitoring as a group. The other configuration parameters always refer to one of the assets found by this type filter. In addition to selecting a type, you can restrict the assets using additional conditions. For example, you can create a condition that only groups for “Azure Resource Groups” with a certain name or a “First Seen” value within the last hour are created. This implies that they have been newly added.

Name Attribute

The “Name Attribute Configuration” parameter is always evaluated in the context of one of the assets found, as defined by your specifications in the “Type Configuration”. Unlike previous configuration parameters, which had static values that could be specified directly, the final values for the name of the group to be created, for example, are calculated based on your specifications. Thus, enter the name of the attribute whose value you want to use as the name for the respective group here. Example You created a type configuration parameter for “Azure Resource Groups”. All resource group instances in Qbilon have a property, or attribute, called “Name.” If you enter “Name” as the value for the configuration parameter “Name Attribute,” Qbilon will create a new device for each resource group instance found. The name of each device will be the value of the “Name” property of the respective Azure resource group instance, e.g., “Production” or “Testing.”