This article applies to PRTG Network Monitor 16.1.22 or later

Using Meta-Scan Functionality for EXE/Script Advanced Sensors

As of PRTG version 16.1.22 it is possible to create custom EXE/Script Advanced sensors that use a meta-scan when you add the sensor via Auto-Discovery.

To apply this meta-scan functionality you can write a custom sensor using an executable file that returns an XML list. Your sensor can then use the data from the XML to create one sensor for each entry in this list. The data from the XML will be added to the according sensor.

What Do You Need?

There are a few things you have provide to add your custom EXE/Script Advanced sensor with meta-scan.

• You need your custom sensor in executable file format, for example, mysensor.exe (you can also use another supported executable file, for example, PS1 or BAT).
• You need a parameter that triggers the meta-scan, for example, -metascan
• When you run mysensor.exe –metascan it has to write XML output to the console in the following format: <prtg> <item> <name>Sensor name</name> <exefile>myfile.exe</exefile> <params>-run 1</params> </item> <item> <name>Sensor name 2</name> <exefile>myfile.exe</exefile> <params>-run 2</params> </item> [...] </prtg>
• You need a device template that adds your sensor using the meta-scan. The template has to look like this: <?xml version="1.0" encoding="UTF-8"?> <devicetemplate id="customexexml" name="my custom exe xml" priority="1"> <check id="ping" meta="ping"/> <create id="<my meta id>" kind="exexml" meta="customexexmlscan" requires="ping"> <metadata> <exefile> mysensor.exe </exefile> <exeparams> -metascan </exeparams> </metadata> <createdata/> </create> </devicetemplate>
• Replace <my meta id> with a unique ID.
• mysensor.exe is your custom sensor that returns an XML which is used to create the actual sensors.
• If the meta-scan needs credentials, you can use the same placeholders for <exeparams> as you can use in the parameters field in the EXE/Script Advanced sensor settings.
• You can use the same exe with different parameters or even different exe files for the meta-scan and the sensor itself.

You can now run an Auto-Discovery using this template (my custom exe xml in this example). This will add the sensors according to the XML output automatically. In this example, the added sensors Sensor name and Sensor name 2 will execute myfile.exe with the parameters -run 1 and -run 2.