PRTG Manual: User Accounts
On the User Accounts tab, administrators can add new user accounts, edit user accounts, and define which user groups that users are members of.
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.
If 15 minutes (900) seconds have passed since your last credential-based login and you open a setup page from a different setup page, PRTG asks you to enter your credentials again for security reasons. A dialog box appears. Enter your Login Name and Password and click OK to continue.
In this section:
The User Accounts tab shows a list of all user accounts in this PRTG installation and various types of information about each user.
Column Header |
Description |
---|---|
Object |
Shows the name of the user account. Click the user account to open its settings. |
Type |
Shows the user type, for example, read-only user. |
Shows the primary email address of the user account. |
|
Primary Group |
Shows the primary group of the user account. Click the user group name to open its settings. |
Group Memberships |
Shows all user groups that the user account belongs to. |
Active/Paused |
Shows the status of the user account. This can be active or paused. |
For more information, see section Working with Table Lists.
You have several options to add user accounts:
- To add a new user to PRTG Network Monitor, hover over and select Add User from the menu. The options are almost the same as for editing users.
- To add a new user to PRTG Hosted Monitor, click Invite User. The options are almost the same as for editing users but PRTG Hosted Monitor automatically generates the initial account password. The new user can change it later. Click Send Invite to save your settings and to send the invitation per email to the defined primary email address.
- To batch-add several users at once, hover over and select Add Multiple Users from the menu. In the dialog box that appears, select a user group from the dropdown list and enter or paste a list of email addresses. Separate them by a space, comma, semicolon, or a new line. Click OK to confirm. For each email address, PRTG creates a new, local user account in the user group, using the email address as the value for Login Name, Display Name, and Primary Email Address. PRTG automatically generates a new password and sends it to the email address.
Access rights to device tree objects, libraries, maps, reports, or the ticket system are defined in user groups. Make sure that the user is a member of the correct user group with the required group access rights.
You cannot delete predefined objects such as the PRTG System Administrator user account, the PRTG Users Group, or the PRTG Administrators group.
Click on a user account and select the various tabs to change the different settings.
Setting |
Description |
---|---|
Login Name |
Enter a login name for the user account. The login name must not contain the following invalid characters: " / \ [ ] : ; | = , + * ? < > This option is not available in PRTG Hosted Monitor. |
Display Name |
Enter a display name that the user recognizes. PRTG uses it for display purposes only, for example on the Welcome page. 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? |
Primary Email Address |
Enter the primary email address. This is the email address that PRTG uses by default for the ticket system, including important system messages, and password recovery. Make sure that your email client can show HTML emails, otherwise you cannot read emails from PRTG. |
Login Type |
This setting is only visible for PRTG Hosted Monitor instances if a Microsoft Entra ID connection (formerly Azure Active Directory) has been successfully configured.
For more information, see the Knowledge Base: How to integrate Microsoft Entra ID into PRTG Hosted Monitor?. |
Password |
Define whether to change the password for the user account:
For security reasons, PRTG does not display the password. If you specify a new password, enter the old password, then enter the new password twice. The new password must be at least 8 characters long. It must contain a number and a capital letter. Do not use leading or trailing whitespaces in the new password. This option is not available in PRTG Hosted Monitor. |
Passhash |
Click Show passhash to display the passhash for the user account. This is necessary for authentication for the PRTG API. This setting is for your information only. You cannot change it. This option is not available in PRTG Hosted Monitor. |
These settings are only available in PRTG Hosted Monitor.
Setting |
Description |
---|---|
API User Name |
Shows the API user name of the user account. This is necessary for authentication for the PRTG API. This setting is for your information only. You cannot change it. |
API Passhash |
Click Show passhash to display the API passhash of the user account. This is recommended for authentication for the PRTG API. This setting is for your information only. You cannot change it. |
Generate API Passhash |
Click Generate new passhash to reset the passhash of the user. |
Setting |
Description |
---|---|
User Type |
Define the user type:
Read-only users cannot be members of groups with administrative rights. This setting is not available for the PRTG System Administrator user account. |
Acknowledge Alarms |
This setting is only visible if you select Read-only user above. Acknowledging an alarm is an action that requires write access. However, you can explicitly allow a read-only user to acknowledge alarms:
|
Password Change |
This setting is only visible if you select Read-only user above. Define if the user can change their account password:
|
Primary Group |
Select the primary group for the user account from the dropdown list. Every user account must be a member of a primary group to make sure there is no user account without group membership. Membership in other user groups is optional. You cannot change the primary group of Active Directory users. Users that you add via Active Directory integration can only have the respective Active Directory group as their primary group. Select Create new user group for this user to create a user group for the new user. This option is only visible when you add a new user account. The default name of the new user group is the Display Name of the new user. |
Status |
Define the status of the user:
This setting is not available for the PRTG System Administrator user account. |
Last Login |
Shows the time stamp of the last login of the user account. This setting is for your information only. You cannot change it. |
Setting |
Description |
---|---|
Member of |
Shows the user groups that the user account is a member of. You can define access rights to device tree objects, libraries, maps, reports and the ticket system at group level. This setting is for your information only. You cannot change it. |
Setting |
Description |
---|---|
Automatic Refresh |
Define if you want PRTG to automatically reload web pages in the PRTG web interface for the user:
|
Refresh Interval (Sec.) |
This setting is only visible if you select Automatically refresh pages (default) above. Enter the number of seconds that PRTG waits between two refreshes. We recommend that you use 30 seconds or more. The minimum value is 20 seconds. The maximum value is 600 seconds. Shorter refresh intervals create more CPU load on the probe system. If you experience load issues while using the PRTG web interface (or maps), set a longer refresh interval. |
Audible Alarms |
Define whether PRTG plays an audible alarm on web pages in the PRTG web interface when there is a new alarm:
PRTG only plays audible alarms if the New Alarms value in the global header area of the PRTG web interface is greater than 0 after a page refresh. PRTG does not consider the number of old alarms. For more information, see the Knowledge Base: Which audible notifications are available in the PRTG web interface and in the PRTG app for desktop? and Why are audible alerts in public maps not working in Chrome? |
Home Page URL |
Define the user's default home page in the PRTG web interface. This is the page that the user sees after logging in or when selecting Home from the main menu. Enter a PRTG-internal web page. |
Time Zone |
Define the time zone for the user account. Depending on the time zone that you select, PRTG shows the local time zone of the user account in all data tables and graph legends. PRTG receives the Coordinated Universal Time (UTC) from the system time of the PRTG core server for this purpose. If you get a warning message about differing time zones, see the Knowledge Base: Why do I get a warning message when time zones differ? |
Date Format |
Select the date format for the user:
This setting takes effect after the next login. |
Color Mode |
Select a color mode for the PRTG web interface:
|
Setting |
Description |
---|---|
Email Notifications |
Define if the user receives emails from the ticket system:
|
Save your settings. If you leave the page, all changes to the settings are lost.
The Notification Contacts tab shows a list of all notification contacts of the selected user account.
Setting |
Description |
---|---|
Description |
Shows the description for the email contact. |
Recipient |
Shows the email address for the email contact. |
Type |
Shows the type of the notification contact. |
You can add new notification contacts under Setup | Account Settings | Notification Contacts.
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.
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.
On the API Keys tab, you can add, edit, and delete API keys that are specific to the user account. For more information, see section API Keys.
KNOWLEDGE BASE
What security features does PRTG include?
Which audible notifications are available in the PRTG web interface and in the PRTG app for desktop?
Why are audible alerts in public maps not working in Chrome?
Why do I get a warning message when time zones differ?
There are some settings that you must define in the PRTG Administration Tool. For more information, see sections: