This is the docker container of the Multi-Platform Probe for Paessler PRTG. Use this container to install and configure the multi-platform probe to monitor remote systems.
For more information about remote probes and PRTG, see the PRTG Manual: Remote Probes and Multiple Probes.
Requires as of PRTG 24.2.96. We recommend that you always update to the latest version of PRTG via the Auto-Update feature.
Requires a NATS server connection configured in PRTG.
The set up to use this container is a three-part process:
ℹ️ If you already have a NATS server configured in PRTG, skip to step 3.
Paessler GmbH provides the NATS Server for Paessler PRTG Windows installer that does the following:
- Installs the NATS server executable.
- Configures the NATS server.
- Installs and starts the NATS server service in the background.
For the installer and step-by-step instructions on how to set up a NATS server on Windows, see section Step 1: Install a NATS server in the Multi-Platform Probe for PRTG (PDF) manual.
ℹ️ If you want to deploy your NATS server on a non-Windows system, see the NATS documentation on their website.
Once you set up your NATS server, you must configure PRTG to accept connections to the NATS server. This is done from the PRTG web interface via Setup | Cores & Probes | Multi-Platform Probe Connection Settings.
For step-by-step instructions on how to configure PRTG, see section Step 2: Configure connection in PRTG in the Multi-Platform Probe for PRTG (PDF) manual.
You can now use containers to set up multi-platform probe instances.
To run the multi-platform probe for PRTG, you have to create a configuration file with at least the following items:
access_key: YOUR_PROBE_ACCESS_KEY
nats:
url: tls://localhost:23561
authentication:
user: USER
password: PASSWORD
You must put the configuration file into the /config/config.yml
volume of the docker container.
For all available configuration options, see config.full-example.yml.
ℹ️ If necessary you can put your custom CA certificate into /config/certs
and specify it in the /config/config.yml
as well:
access_key: YOUR_PROBE_ACCESS_KEY
nats:
url: tls://localhost:23561
authentication:
user: USER
password: PASSWORD
server_ca: /config/certs/ca.crt
ℹ️ The container also used the /config
volume to store the multi-platform probe's GID and therefore cannot be set as read-only (:ro
) unless you specify the multi-platform probe's GID as an environment variable.
You can also use the /opt/paessler/share/scripts
volume for the scripts of the Script v2 sensor.
docker run -it \
--network bridge \
-v ./scripts:/opt/paessler/share/scripts:ro \
-v ./config:/config \
--cap-add NET_ADMIN \
--cap-add NET_RAW \
paessler/multi-platform-probe:latest
You can also use docker-compose
. There is an example file here: docker-compose.yml
The multi-platform probe container supports all safe environment variables which are environment variables which do not contain secrets. While the container provides some defaults, we recommend that you change the following environment variables to your liking:
Environment Variable | Description | Default |
---|---|---|
PRTGMPPROBE__NAME |
The name of the object shown in PRTG. | multi-platform-probe@$(hostname) |
PRTGMPPROBE__ID |
The GID of the multi-platform probe. This must be a valid UUIDv4. The container automatically generates the GID when you create it and stores the GID in the /config volume. If you want to ensure that you always get the same UUIDv4, then we recommend that you use uuidgen(1) with a unique DNS string for your container, e.g. uuidgen --namespace @dns --name com.paesslerfans.containers.acme --sha1 . |
Randomly generated on the first run. |
We are thankful for any feedback or ideas on how to improve. If you want to submit feedback or report an issue, please open an issue in our Issue Tracker.
See LICENSE for the full MIT License text.