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]



1 Reply

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+


Info: If you want to use the Multi-Platform Probe in one or more Docker containers, you can find a comprehensive installation guide 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.
    • We recommend that you do not install the NATS server on the PRTG core server system.
  3. Multi-Platform Probe
    • We recommend that you do not install the probe on the PRTG core server system.

4.1 Illustration

Multi-Platform Probe Graphic
Click to enlarge.


5. Download and installation


Disclaimer: We recommend that you do not install the NATS server and the Multi-Platform Probe on the PRTG core server system.

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

Note: 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 won't be asked again. Right clicking the script will also show the certificate chain for verification.

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 link
Windowsinstall-mpp-nats.ps1
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 probe adapter

1. Download the script and run it.

PlatformDownload link
Windowsinstall-probe-adapter.ps1

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

5.3 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 link
Windowsinstall-mpp-nats.ps1
Linuxinstall-mpp-nats.sh

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.

Note: After you successfully install the Multi-Platform Probe, you see a dialog box in PRTG. Click Approve to include the new probe in your device tree.

Note: Do not click Approve and auto-discover. The Multi-Platform Probe does not support the auto-discovery.


6. Frequently asked questions (FAQ)

6.1 NATS server

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

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

6.1.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.
    • 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.2 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 Jul 21, 2022 12:39:47 PM by  Florian Weik [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.