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

What is the Multi-Platform Probe and how can I use it?

Votes:

0

Your Vote:

Up

Down

I want to use the Multi-Platform Probe. What do I need to know?

linux nats probe prtg

Created on Nov 16, 2021 6:33:00 AM by  Florian Weik [Paessler Support]



6 Replies

Accepted Answer

Votes:

1

Your Vote:

Up

Down

This article applies as of PRTG 21.4.73

The Multi-Platform Probe (early alpha) for PRTG

With PRTG 21.4.73, we introduced the Multi-Platform Probe to extend the native monitoring capabilities on non-Windows platforms, for example Linux, Raspberry Pi, or NAS systems.

Info: ARM systems are now supported.


Content:

1. Disclaimer

2. Supported platforms

3. Limitations

4. Components

5. Download and installation

6. Frequently asked questions (FAQ)

7. Future


1. Disclaimer


Important: The Multi-Platform Probe is currently in the alpha phase. Unexpected issues can occur. We do not recommend that you use the feature on your production system.


2. Supported platforms


Disclaimer: We officially support the operating systems mentioned in the table below. You can try to run it on different operating systems on your own risk. We do not recommend that you use the probe on your production system.

Operating System (OS)OS VersionArchitectureComment
Microsoft WindowsServer 2019x86-64-
Microsoft WindowsServer 2016x86-64-
Microsoft Windows10 Version 21H1x86-64-
LinuxUbuntu 20.04• ARMv7 (32-bit)
• ARMv8 (32-bit, 64-bit)
• x86-64
Requires glibc as of version 2.28
Linux• Debian 10
• Debian 11
• ARMv7 (32-bit)
• ARMv8 (32-bit, 64-bit)
• x86-64
Requires glibc as of version 2.28
RHEL/CentOS• RHEL 8.4
• CentOS 8
x86-64Requires glibc as of version 2.28
Raspberry PI OS-• ARMv7 (32bit)
• ARMv8 (32-bit)
Supported models:
• RPi 2 Model B
• RPi 2 Model B v1.2
• RPi 3 Model B
• RPi 3 Model B+
• RPi 4 Model B


Info:

  • If you want to use the Multi-Platform Probe in one or more Docker containers, you can find a comprehensive installation guide here.
  • If you want to follow a step-by-step guide, see here.

3. Limitations

The Multi-Platform Probe is currently in the early alpha phase. Be aware that features are still missing and that the functionality is limited. The following features are currently not supported:


4. Components

The Multi-Platform Probe consists of three different components:

  1. Probe adapter
    • The probe adapter on the PRTG core server system
  2. NATS server
    • The NATS server handles the communication between Multi-Platform Probes and the PRTG core server.
    • Note: We recommend that you do not install the NATS server on the PRTG core server system.
  3. Multi-Platform Probe
    • The Multi-Platform Probe is where the actual monitoring takes place.
    • Note: We recommend that you do not install the probe on the PRTG core server system.
      Multi-Platform Probe Graphic
      Click to enlarge.

5. Download and installation

Follow the steps below to enable the use of the Multi-Platform Probe with PRTG Network Monitor.

Notes:

  • We recommend that you do not install the NATS server and the Multi-Platform Probe on the PRTG core server system.
  • Even though we have signed the scripts with our official code signing certificate, PowerShell may ask if you want to run a script from an untrusted publisher. If you select A for 'Always Run', the Paessler code signing certificate will be added to your trusted publishers and you will not be asked again. Right-click the script to see the certificate chain for verification.
  • You can find our setup tutorial videos here:

5.1 Download and install the NATS server

1. Download the correct script for your operating system. The script guides you through the installation process of the NATS server that is used for the communication between the Multi-Platform Probe and the PRTG core server.

PlatformDownload linkNotes
Windowsinstall-mpp-nats.ps1Executing the script requires that you run PowerShell as administrator.
Linuxinstall-mpp-nats.sh

Note: If you run the NATS server on a system that is not the PRTG core server system or the probe system, you must open a port in the firewall of the system that runs the NATS server.

5.2 Download and install the Multi-Platform Probe

Note: These scripts are the same as for the NATS server installation. You do not have to download the scripts again if you already downloaded them.

1. Download the correct script for your operating system. The script guides you through the installation process of the Multi-Platform Probe.

PlatformDownload linkNotes
Windowsinstall-mpp-nats.ps1Executing the script requires that you run PowerShell as administrator.
Linuxinstall-mpp-nats.sh

5.3 Download and install the probe adapter

1. Download the script and run it.

PlatformDownload linkNotes
Windowsinstall-probe-adapter.ps1Executing the script requires that you run PowerShell as administrator.

2. Add an Access Key under Setup | System Administration | Core & Probes in PRTG. The default access key is multi-platform-probe.

Notes:

  • After you successfully install the Multi-Platform Probe, a dialog box appears in PRTG. Click Approve to include the new probe in your device tree.
  • Do not click Approve and auto-discover. The Multi-Platform Probe does not support auto-discovery.

5.4 Run the NATS server or the Multi-Platform Probe on Docker

1. You can find a comprehensive guide for running the NATS server or the Multi-Platform Probe in a Docker container here.


6. Frequently asked questions (FAQ)

6.1 NATS server

6.1.1 I'm getting the following error during the installation process on Windows. What should I do? .\install-mpp-nats.ps1 : File <File Path> cannot be loaded because running scripts is disabled on this system.”.

1. Execute the following command: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope LocalMachine 2. Enter Y to confirm and press enter.
3. Execute the install-mpp-nats.ps1 script again.

6.1.2 Where can I find the logs of the NATS server?

  • Windows: C:\ProgramData\Paessler\PRTG_NATS
  • Linux: /var/log/prtg/nats-server/

6.1.3 How can I change the configuration values?

Choose between the following approaches:

  • Run the installation script again and select the settings you want.
  • Modify the configuration without running the script again.
    • Windows: Modify the configuration under C:\ProgramData\Paessler\PRTG_NATS and restart the service PRTGNATSServerService after you made your changes.
    • Linux: Modify the configuration under /etc/prtg/nats-server/prtg-nats.config and restart the service by using the following command:

sudo systemctl restart prtg.nats-server.service

6.2 Probe adapter

6.2.1 Where can I find the logs of the probe adapter?

The probe adapter logs are stored in the PRTG program directory under C:\ProgramData\PRTG Network Monitor\ProbeAdapter. Additionally, the logs are written to the file Probe.log under C:\ProgramData\Paessler\PRTG Network Monitor\Logs\probe.

6.2.2 How can I change the configuration values?

Choose between the following approaches:

  • Run the installation script again and select the settings you want.
  • Modify the configuration without running the script again: Edit the file config.yaml under C:\Program Files (x86)\PRTG Network Monitor\ProbeAdapter\ and restart the PRTG core server service for your changes to take effect.

6.3 Multi-Platform Probe

6.3.1 Where can I find the logs of the Multi-Platform Probe?

  • Windows: C:\ProgramData\Paessler\PRTG_MPP\probe_logs
  • Linux: /var/log/prtg/mpprobe/

6.3.2 How can I change the configuration values?

  • Windows: The configuration on Windows is done via environment variables.
    • The corresponding variables have the prefix PRTGMPPROBE_. Restart the service PRTGMultiPlatformProbeService after you made your changes.
  • Linux: The configuration on Linux is done via environment variables as well.
    • Run prtgmpprobe –help for information about the relevant variables. The Multi-Platform Probe service uses the environment file at /etc/prtg/mpprobe/config.env. Run the following command after you made your changes:

sudo systemctl restart prtg.mpprobe.service

6.3.3 I'm getting the following errors when running the install script, what should I do?

Line 7: read: Illegal option -d
Line 85: function not found
Line 87: Syntax error: "}" unexpected

This likely means that you are trying to run the script with a shell other than Bash. Try to run the install script with the following command: sudo bash install-mpp-nats.sh

6.3.4 I'm getting the following errors in the probe log when running the probe adapter, what should I do? Could not create probe adapter: Initialization error ret: 7 for Dll="*PRTGPATH*\ProbeAdapter\probe_adapter.dll"

The error indicates that the probe adapter is unable to connect to the NATS server.

Try out the following:

  • Install the NATS server on the same system where the probe adapter or probe is running to make sure you can make a connection.
  • Check that your NATS server is listening on the correct port that has traffic being forwarded to it.
  • Check the IP addresses and passwords in your configurations.
  • Add debug:true to the NATS server configuration to see the incoming connection attempts. For more information about the NATS server configuration, see question 6.1.3 How can I change the configuration values?

7. Future

The Multi-Platform Probe is currently very limited with its supported features. In the upcoming weeks, we will introduce support for templates, auto-discovery, and other features. This will extend the available sensors on the probes by the following sensor families: Microsoft Azure, AWS, and Veeam. We would also love to hear your feedback about what else you would like to see on the Multi-Platform Probe.

Share your input with us in the Multi-Platform Probe survey here.

Created on Nov 16, 2021 6:35:16 AM by  Florian Weik [Paessler Support]

Last change on Nov 16, 2022 1:16:43 PM by  Florian Weik [Paessler Support]



Votes:

0

Your Vote:

Up

Down

Hi... This is a great improvement for PRTG...

Before we can start relying on this great new approach...

  1. What is the schedule for moving it into production ?
  2. Is NATS the choice of Messaging finalized ?
  3. Are there other options for messaging(MQTT) ?
  4. Are you going to integrate the Probe adapter into the base product ?

More to come... Thanks JR

Created on Nov 30, 2022 4:40:58 PM by  JR Andreassen (0) 2



Votes:

0

Your Vote:

Up

Down

Hi...

A couple of more questions for your FAQ :

  1. When will it be possible to run custom EXE/XML sensors from MPP.
  2. Is there a way to create custom sensors for the MPP ?
  3. Is there a published interface for creating custom sensors ?
    • When will it be available ?

Thanks JR

Created on Nov 30, 2022 4:45:51 PM by  JR Andreassen (0) 2



Votes:

0

Your Vote:

Up

Down

Hi JR!

Hope you are well. At the moment, our development works on a broader feature set for the Multi-Platform-Probe. However, we have no timeline or ETA when new features or the BETA status starts.

Created on Dec 5, 2022 9:24:35 AM by  Moritz Heller [Paessler Support]



Votes:

0

Your Vote:

Up

Down

Hello
I can't download the Linux Install script because there seems to be a problem with the certificate chain of your download page (https://download3.paessler.com/). --> This server's certificate chain is incomplete.
Can you please fix this.
Thank you.
Best Regards,
Alain

Created on Dec 28, 2022 3:01:35 PM by  Alain B. (10) 1



Votes:

0

Your Vote:

Up

Down

Hello,

please provide the full link of the resource which cannot be downloaded.

Created on Dec 30, 2022 5:45:45 PM by  Arne Seifert [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.