PRTG Manual: Add a Group
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.
There are several ways to manually add a group:
- Select Devices | Add Group from the main menu bar. A dialog appears that guides you through the process of adding a new group.
- Hover over
and select Add Group from the menu.
- Select Add Group from the context menu of the probe or group to which you want to add the new group. This skips step 1 and leads you directly to step 2.
The Add a Group dialog appears when you add a new group to a parent group. It only shows the settings that are required to create the group. Therefore, you do not see all settings in this dialog.
You can change all settings on the Settings tab of the group later. For more information, see section Group Settings.
Step 1: Select a Parent
Select the probe or group that you want to add the new group to. Click OK.
Setting |
Description |
---|---|
Group Name |
Enter a meaningful name to identify the group. By default, PRTG shows this name in the device tree, as well as in alarms, logs, notifications, reports, maps, libraries, and tickets.
|
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.
|
By default, all of the following settings are inherited from objects that are higher in the hierarchy. You should change them centrally in the root group settings if necessary. To change a setting for this object only, click under the corresponding setting name to disable the inheritance. You then see the options described below.
For more information, see section Inheritance of Settings.
Credentials for Windows Systems
Click to interrupt the inheritance.
Setting |
Description |
---|---|
Domain or Computer Name |
Enter the authority for Windows access. This is used for Windows Management Instrumentation (WMI) and other Windows sensors. If you want to use a Windows local user account on the target device, enter the computer name. If you want to use a Windows domain user account (recommended), enter the (Active Directory) domain name. If If you do not explicitly define it, PRTG automatically adds a prefix to use the NT LAN Manager (NTLM) protocol. Do not leave this field empty. |
User |
Enter the username for Windows access. Usually, you use credentials with administrator rights. |
Password |
Enter the password for Windows access. Usually, you use credentials with administrator rights. |
Credentials for Linux/Solaris/macOS (SSH/WBEM) Systems
Click to interrupt the inheritance.
Setting |
Description |
---|---|
User |
Enter a login name for the access via Secure Shell (SSH) and Web-based Enterprise Management (WBEM). Usually, you use credentials with administrator rights. |
Login |
Select the authentication method to use for the login:
|
Password |
This setting is only visible if you enable Via password above. Enter a password for the Linux access via SSH and WBEM. Usually, you use credentials with administrator rights. |
Private Key |
This setting is only visible if you enable Via private key above. Paste a private key into the field (OpenSSH format, unencrypted). Usually, you use credentials with administrator rights.
|
For WBEM Use Protocol |
Select the protocol to use for WBEM:
|
For WBEM Use Port |
Select how to set the port to use for WBEM:
|
WBEM Port |
This setting is only visible if you enable Set manually above. Enter the WBEM port number. |
SSH Port |
Enter the port number to use for SSH connections. The default port is 22.
|
SSH Rights Elevation |
Select the rights that you want to use to execute the command on the target system:
|
Target User |
This setting is only visible if you select a sudo or su option above. Enter a username to run the specified command as a user other than root. If you leave this field empty, you run the command as root. Make sure that you set the Linux password even if you use a public key or a private key for authentication. This is not necessary if the user is allowed to execute the command without a password. |
Password |
This setting is only visible if you choose to run the commands using su or sudo with password above. Enter the password for the specified target user. |
SSH Engine |
Select the method that you want to use to access data with SSH sensors:
|
Credentials for VMware/XenServer
Click to interrupt the inheritance.
Setting |
Description |
---|---|
User |
Enter a username for access to VMware ESXi/vCenter or Citrix XenServer. Usually, you use credentials with administrator rights. |
Password |
Enter a password for access to VMware ESXi/vCenter or Citrix XenServer. Usually, you use credentials with administrator rights.
|
VMware Protocol |
Select the protocol to use for the connection to VMware ESXi/vCenter or Citrix XenServer:
|
Session Handling |
Select if you want to reuse a session for VMware sensors:
|
Click to interrupt the inheritance.
Setting |
Description |
---|---|
SNMP Version |
Select the Simple Network Management Protocol (SNMP) version for the device connection:
|
Community String |
This setting is only visible if you select v1 or v2c above. Enter the community string of your devices. This is like a clear-text password for simple authentication. We recommend that you use the default value. |
Authentication Type |
This setting is only visible if you select v3 above. Select the authentication type:
|
User |
This setting is only visible if you select v3 above. Enter a username for secure authentication.
|
Password |
This setting is only visible if you select v3 above. Enter a password for secure authentication.
|
Encryption Type |
This setting is only visible if you select v3 above. Select an encryption type:
|
Encryption Key |
This setting is only visible if you select v3 above. Enter an encryption key. If you provide a key, PRTG encrypts SNMP data packets with the encryption algorithm that you selected above, which provides increased security. Enter a string or leave the field empty.
|
Context Name |
This setting is only visible if you select v3 above. Enter a context name only if the configuration of the device requires it. Context is a collection of management information that is accessible by an SNMP device. Enter a string. |
SNMP Port |
Enter the port for the SNMP communication. The default is 161. We recommend that you use the default value. |
Timeout (Sec.) |
Enter a timeout in seconds for the request. Enter an integer value. If the reply takes longer than this value, the sensor cancels the request and triggers an error message. The maximum timeout value is 300 seconds (5 minutes). |
Credentials for Database Management Systems
Click to interrupt the inheritance.
The settings you define in this section apply to the following sensors:
Setting |
Description |
---|---|
Port for Databases |
Select the port PRTG uses for connections to the monitored databases:
|
Custom Database Port |
Enter the number of the custom port that PRTG uses for database connections. Enter an integer value.
|
Authentication Mode |
Select the authentication mode for the connection to the Structured Query Language (SQL) database:
|
User |
This setting is only visible if you enable SQL server authentication above. Enter the username for the database connection. |
Password |
This setting is only visible if you enable SQL server authentication above. Enter the password for the database connection. |
Timeout (Sec.) |
Enter a timeout in seconds for the request. Enter an integer value. If the reply takes longer than this value, the sensor cancels the request and triggers an error message. The maximum timeout value is 300 seconds (5 minutes). |
Click to interrupt the inheritance.
For more information about the permissions that are necessary to query the AWS API, see the Knowledge Base: How do I set permissions for the Amazon Web Services (AWS) API key to use certain sensors in PRTG?
Setting |
Description |
---|---|
Access Key |
Enter your Amazon Web Services (AWS) access key. |
Secret Key |
Enter your AWS secret key. |
Click to interrupt the inheritance.
Setting |
Description |
---|---|
User |
Enter a username for authentication against the Dell EMC system. |
Password |
Enter a password for authentication against the Dell EMC system. |
Port |
Enter the port for the connection to the Dell EMC system. The default port for secure connections is 443. |
The Microsoft 365 Service Status sensor and the Microsoft 365 Service Status Advanced sensor use the following credentials to authenticate with Azure Active Directory (Azure AD).
For more information about the credentials and the permissions that are necessary to use the Microsoft 365 sensors, see the Knowledge Base: How do I obtain credentials and set permissions for the Microsoft 365 sensors?
Setting |
Description |
---|---|
Tenant ID |
Enter your Azure AD tenant ID.
|
Client ID |
Enter your Azure AD client ID. |
Client Secret |
Enter your Azure AD client secret. |
Credentials for Microsoft Azure
The Microsoft Azure Subscription Cost sensor and the Microsoft Azure Virtual Machine sensor use the following credentials to authenticate with Azure AD.
For more information about the credentials and permissions that are necessary use the Microsoft Azure sensors, see the Knowledge Base: How do I obtain credentials and create custom roles for the Microsoft Azure sensors?
Setting |
Description |
---|---|
Tenant ID |
Enter your Azure AD tenant ID.
|
Client ID |
Enter your Azure AD client ID. |
Client Secret |
Enter your Azure AD client secret. |
Subscription ID |
Enter your Azure AD subscription ID. |
Click to interrupt the inheritance.
Setting |
Description |
---|---|
User Credentials |
Select if you want to connect without credentials, or define credentials for the connection.
|
User |
This setting is only visible if you enable Username/Password above. Enter the username for access to the Message Queue Telemetry Transport (MQTT) broker. |
Password |
This setting is only visible if you enable Username/Password above. Enter the password for access to the MQTT broker. |
Port |
Enter the port number for MQTT connections. The default port for unsecure connections is 1883 and the default port for secure connections is 8883. |
Connection Security |
Select if you want to use a Secure Sockets Layer (SSL)/Transport Layer Security (TLS) secured connection:
|
Server Authentication |
This setting is only visible if you enable Use transport-level-security above. Select if you want to use a certificate for server authentication.
|
CA Certificate |
Copy the certificate authority (CA) certificate for verifying the MQTT server and paste it here.
|
Client Authentication |
This setting is only visible if you enable Use transport-level-security above. Select if you want to use a certificate for client authentication.
|
Client Certificate |
Copy the certificate that you created for authenticating the sensor against the server and paste it here.
|
Client Key |
Enter the client key for authentication against the server.
|
Client Key Password |
Enter the password for the client key certificate. |
Click to interrupt the inheritance.
Setting |
Description |
---|---|
Port |
Enter the port for the connection to the OPC Unified Architecture (OPC UA) server. The default port for secure connections is 4840. |
Server Path |
Enter the path of the OPC UA server endpoint if you run more than one server under the same IP address or DNS name. |
Security Mode |
Select if you want to use encryption:
|
Security Policy |
This setting is only visible if you select Sign or Sign & Encrypt above. Select if you want to use a security policy and define which one you want to use:
|
Client Certificate |
Copy the certificate that you created for authenticating the sensor against the OPC UA server and enter it here.
|
Client Key |
Enter the client key for authentication against the server.
|
Client Key Password |
Enter the password for the client key certificate. |
Select if you want to connect without credentials or define credentials for the connection:
|
|
User |
This setting is only visible if you enable Username/Password above. Enter the username for authentication against to the OPC UA server. |
Password |
This setting is only visible if you enable Username/Password above. Enter the password for authentication against to the OPC UA server. |
Credentials for Soffico Orchestra
Click to interrupt the inheritance.
Setting |
Description |
---|---|
Authentication Method |
Select whether to use an authentication method for the connection to Orchestra:
|
User |
This setting is only visible if you enabled the option Username/Password. Enter a username for authentication against the Orchestra platform. |
Password |
This setting is only visible if you enabled the option Username/Password. Enter a password for authentication against the Orchestra platform. |
Timeout (Sec.) |
Enter a timeout in seconds for the request. Enter an integer value. If the reply takes longer than this value, the sensor cancels the request and triggers an error message. The maximum timeout value is 300 seconds (5 minutes). |
Port |
Enter a port number for the connection to Orchestra. The default port for an HTTPS connection is 8443 and the default port for an HTTP connection is 8019. |
Protocol |
Select the protocol that you want to use for the connection to Orchestra:
|
Click to interrupt the inheritance.
Setting |
Description |
---|---|
User |
Enter the username of your Veeam Backup Enterprise Manager account. |
Password |
Enter the password of your Veeam Backup Enterprise Manager account. |
Port |
Enter a port number for the connection to the Veeam Backup Enterprise Manager. The default port for secure connections is 9398. |
Click to interrupt the inheritance.
Setting |
Description |
---|---|
User Group Access |
Select 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:
To automatically set all child objects to inherit this object's access rights, enable the Revert children's access rights to inherited option.
|
Click OK to save your settings. If you close the dialog without saving, all changes to the settings are lost.
KNOWLEDGE BASE
What security features does PRTG include?
How do I set permissions for the Amazon Web Services (AWS) API key to use certain sensors in PRTG?
How do I obtain credentials and set permissions for the Microsoft 365 sensors?
How do I obtain credentials and create custom roles for the Microsoft Azure sensors?