What is this?

This knowledgebase contains questions and answers about PRTG Network Monitor and network monitoring in general. You are invited to get involved by asking and answering questions!

Learn more

PRTG Network Monitor

Intuitive to Use. Easy to manage.
More than 500,000 users rely on Paessler PRTG every day. Find out how you can reduce cost, increase QoS and ease planning, as well.

Free Download

Top Tags


View all Tags

I want to use the new UI and API v2. What do I need to know?

Votes:

2

Your Vote:

Up

Down

What do I have to do if I want to activate the new UI and API v2 of PRTG? What are the requirements? Where can I find frequently asked questions?

api prtg web-interface

Created on Oct 4, 2021 7:55:21 AM by  Florian Weik [Paessler Support]

Last change on Nov 23, 2022 10:11:51 AM by  Florian Weik [Paessler Support]



11 Replies

Votes:

0

Your Vote:

Up

Down

This article applies as of PRTG 22.4.81

The new UI and API v2 of PRTG

With PRTG 21.4.73 we introduced the first version of the new UI and API v2. The goal is to release a state-of-the-art web interface and RESTful API. In this article, you can find the available features, known issues, information about the activation of the new UI and API v2, the FAQ, and additional links about our plans.


Content

  1. Disclaimer
  2. Limitations, requirements and known issues
  3. Activate the new UI and API v2
  4. Available features
  5. Frequently asked questions (FAQ)
  6. More

Created on Oct 25, 2021 5:52:13 AM by  Florian Weik [Paessler Support]

Last change on Nov 23, 2022 10:12:56 AM by  Florian Weik [Paessler Support]



Votes:

0

Your Vote:

Up

Down

1. Disclaimer


Important: The new UI and API v2 are currently in the development phase. The set of features is still limited. For details, see 4. Available features.


Created on Oct 26, 2021 2:44:17 PM by  Florian Weik [Paessler Support]

Last change on Jan 26, 2023 7:07:45 AM by  Florian Weik [Paessler Support]



Votes:

0

Your Vote:

Up

Down

2. Limitations, requirements and known issues

2.1. Limitations

  • The new UI and API v2 are still missing important features. For a list of features, see Available features.
  • Clusters are currently not supported. If you run a cluster, the Open new UI button does not appear after you activate the new UI and API v2.
  • The new UI and API v2 are not available for Paessler PRTG Hosted Monitor in the development phase.

2.2. System requirements

Activating the new UI and API v2 starts an additional service which has a certain resource footprint. You do not need to take any extra precautionary steps if your installation follows the system requirements for PRTG which are laid out here. If your installation is already running considerably outside of these recommendations we suggest that you take a cautious approach to activating the new UI and API v2.

2.3. Known issues

  • Bug: Resuming a paused device can lead to an error message for no reason.
  • Bug: Cloning a group from one probe to another in the classic UI leads to incorrect limits for the channels of the cloned sensors in the new UI.
  • Bug: The sort_by parameter does not work correctly.

2.4. Fixed known issues

  • With PRTG 22.1.74, we fixed the issue that the PRTG application server could not establish a connection to a PRTG core server if the PRTG core server did not use the default IP address. The PRTC core server now always allows connections from the PRTG application server via the default IP address 127.0.0.1:23580.
  • With PRTG 22.1.74, we fixed the issue that caused the Sensor Factory sensor to not receive measurements. The channels of the Sensor Factory sensor now receive measurements as expected again.
  • With PRTG 22.2.76, we fixed the issue that the path of a moved or cloned object was not updated properly. Objects that were moved or cloned now receive a correct update of their path.
  • With PRTG 22.2.77, we fixed the issue that installations with a large amount of sensors and many user groups caused increased memory consumption.

Info: You can find comprehensive release notes for the new UI and API v2 here.

Created on Oct 26, 2021 2:45:13 PM by  Florian Weik [Paessler Support]

Last change on Jan 26, 2023 7:12:46 AM by  Florian Weik [Paessler Support]



Votes:

1

Your Vote:

Up

Down

3. Activate the new UI and API v2

  1. Open the setup settings of PRTG. To do so, select Setup | Overview or enter the following URL http(s)://<yourprtgserver>/setup.htm.
  2. Find the Activate New UI And API v2 option on the bottom-right side and click Activate.Setting
    Click to enlarge.
  3. The activation dialog contains a link to this Knowledge Base article. Read the information in this article and the disclaimer carefully. Afterwards, enable the check box to confirm that you have read the disclaimer, and click OK to activate the new UI and API v2.Pop up
    Click to enlarge.

    Important: Make sure that port 8443 (HTTPS) or port 8080 (HTTP) and port 23580 (HTTPS and HTTP) are free.
  4. After the PRTG application server was installed and the PRTG core server was restarted, you can use the Open new UI button in the top-right corner to open the new UI, or enter the respective URL: http(s)://<yourprtgserver>:Port
    • The new UI and API v2 use the following port for secured connections: 8443
    • The new UI and API v2 use the following port for unsecured connections: 8080

To open Swagger, click Try out under the PRTG API v2 card on the new UI homepage or enter http(s)://<yourprtgserver>:Port/api/v2/oas/.

Created on Oct 26, 2021 2:51:33 PM by  Florian Weik [Paessler Support]

Last change on Jan 27, 2023 9:16:35 AM by  Florian Weik [Paessler Support]



Votes:

0

Your Vote:

Up

Down

4. Available features

The current version of the new UI and API v2 includes the following features:

  • Read: Probes, groups, devices, sensors, and channel data
  • Pause, Resume, Scan: Probes, groups, devices, sensors
  • Acknowledge: Sensors
  • Graphs: Line graphs with measurements and limits for each sensor channel
  • API keys: API keys to authenticate with the API v2

Check the PRTG Release notes for newly added features.

Created on Oct 28, 2021 1:26:06 PM by  Florian Weik [Paessler Support]

Last change on Jan 27, 2023 9:17:06 AM by  Florian Weik [Paessler Support]



Votes:

0

Your Vote:

Up

Down

5. Frequently asked questions (FAQ)

5.1 What are the new UI and API v2 of PRTG?

The new UI (PRTG web interface) is the redesign of the PRTG web interface based on user research. The new UI will be fully responsive and will work on every screen size. We are working hard on following the Web Content Accessibility Guidelines (WCAG) and ensuring that PRTG is accessible to as many people as possible.

The new PRTG API v2 is the new RESTful API of PRTG. The goal of the API v2 is to enable you to easily automate your monitoring and to integrate it with other tools. The API v2 is comprehensively documented and consistent across all endpoints.

5.2 Do you plan to deactivate the classic PRTG web interface and API (v1) soon?

We plan to deactivate the classic PRTG web interface and API (v1) once the new UI and API v2 are stable and feature complete. We will communicate the period for the deactivation with advance notice.

5.3 What happens if I activate the new UI and API v2 in my PRTG installation?

If you activate the new UI and API v2, an additional service called PRTG Application Server will be installed. For more information, see question 5.7 "What is the PRTG application server?" below.

After the activation, the classic PRTG web interface and the new UI as well as the PRTG API (v1) and the PRTG API v2 are available side by side. If the network and firewall rules allow it, users can access them via different ports.

5.4 What is the PRTG application server?

The PRTG application server is the service that delivers the new UI and API v2. After the installation of the PRTG application server, PRTG automatically creates the Application Server Health (Autonomous) sensor that helps you to monitor the status of your PRTG application server.

5.5 Should I activate the new UI and API v2 on my production system?

You can use the new UI and API v2 on your production system if the system meets the requirements. Keep in mind that the PRTG application server uses additional resources. Although the new UI and API v2 are in the development phase, they run stable and are comprehensively tested.

5.6 Does the new PRTG application server support the same Transport Layer Security (TLS) and cipher configurations as the PRTG web server?

The PRTG application server honors the connection security settings that are configured under Setup | System Administration | User Interface in section PRTG Web Server in the classic PRTG web interface.

However, the TLS versions that are included in the different security settings slightly differ from the settings of the PRTG web server. These are the TLS versions that the PRTG application server offers:

  • High security (TLS 1.3)
    • For comparison:
      • PRTG Web Server Settings: High security (TLS 1.2)
  • Default security (TLS 1.2 and TLS 1.3)
    • For comparison:
      • PRTG Web Server Settings: Default security (TLS 1.2)
  • Weakened security (TLS 1.0, TLS 1.1, TLS 1.2, and TLS 1.3)
    • For comparison:
      • PRTG Web Server Settings: Weakened security (SSLv3, TLS 1.0, TLS 1.1, TLS 1.2)

Note: If you have set a registry key to override the Secure Sockets Layer (SSL)/TLS version and cipher suites of PRTG web server connections, these settings do NOT apply to the PRTG application server.

5.7 Does the PRTG application server support custom SSL certificates?

Yes, the PRTG application server uses the same certificate as the PRTG web server. To use your own SSL certificate, move the certificate file to the \cert subfolder in the PRTG program directory. For more information, see PRTG Manual: Using Your Own SSL Certificate with the PRTG Web Server.

5.8 Does Paessler PRTG Hosted Monitor support the new UI and API v2?

The new UI and API v2 are not available for Paessler PRTG Hosted Monitor in the current phase. Check the PRTG Release notes regularly to find out once the new UI and API v2 are available for Paessler PRTG Hosted Monitor.

5.9 Can I use the new UI and API v2 if I run a cluster?

The new UI and API v2 do not yet support PRTG installations that run in cluster mode. We plan to change this in the future. Check the PRTG Release notes regularly to find out once the new UI and API v2 are available for PRTG installations that run in cluster mode.

5.10 Can I hide the “Activate New UI And API v2” banner in PRTG?

Yes, to globally hide the banner, follow the instructions here.

5.11 How can I deactivate the new UI and API v2?

You can deactivate the new UI and API v2 via the PRTG web interface or the PRTG Administration Tool.

PRTG web interface:

  1. Open the setup settings in the PRTG web interface. To do so, select Setup | Overview in the global header area or enter the following URL http(s)://<yourprtgserver>/setup.htm.
  2. Find the Deactivate New UI And API v2 option on the bottom-right side and click Deactivate.
  3. In the dialog that appears, click OK.

PRTG Administration Tool:

  1. Open the PRTG Administration Tool on the PRTG core server system.
  2. Navigate to tab PRTG Application Server.
  3. Click Uninstall Service.

Created on Nov 2, 2021 2:43:09 PM by  Florian Weik [Paessler Support]

Last change on Jan 27, 2023 9:18:52 AM by  Florian Weik [Paessler Support]



Votes:

0

Your Vote:

Up

Down

6. More

6.1 PRTG Roadmap

If you want to know what we are working on right now, check the PRTG Roadmap.

6.2 Feedback form and survey

Please share your experience with the new UI and API v2 with us here.

You can also participate in the API v2 survey here.

6.3 Video tutorials

See also our video tutorials about the new UI and API v2:

PRTG tutorial new user interface
Click to watch video.

PRTG tutorial API v2
Click to watch video.

6.4 API v2 documentation

You can find the API v2 overview here.

You can find an API v2 reference documentation with all of the available endpoints here.

Created on Nov 3, 2021 6:59:01 AM by  Florian Weik [Paessler Support]

Last change on Nov 23, 2022 10:11:30 AM by  Florian Weik [Paessler Support]



Votes:

0

Your Vote:

Up

Down

Where is the SSO function on the login to new interface? This seriously needs adding ASAP. We enabled it then realised this and have since not used it at all.

Created on Jan 21, 2022 6:00:11 AM by  AuRiSmith (100)



Votes:

0

Your Vote:

Up

Down

Hi Richard,

Since we are still working on the new web interface, we will add this feature in future.


Kind regards

Felix Wiesneth - Team Tech Support

Created on Jan 21, 2022 8:50:43 AM by  Felix Wiesneth [Paessler Support]



Votes:

0

Your Vote:

Up

Down

I do not see this option on my install even though I am past the version mentioned.

Created on Apr 13, 2022 10:00:35 PM by  pcookhayboo (0)



Votes:

1

Your Vote:

Up

Down

Hello Peter,

Are logged in with an administrator account? Please double-check if you are in the latest version available of PRTG. If the issue persists and/or you have more questions to the new UI, don't hesitate to contact us via [email protected] .


Kind regards

Felix Wiesneth - Team Tech Support

Created on Apr 14, 2022 6:08:55 AM by  Felix Wiesneth [Paessler Support]



Please log in or register to enter your reply.


Disclaimer: The information in the Paessler Knowledge Base comes without warranty of any kind. Use at your own risk. Before applying any instructions please exercise proper system administrator housekeeping. You must make sure that a proper backup of all your data is available.