New Question
 
 
PRTG Network Monitor

Intuitive to Use.
Easy to manage.

200.000 administrators have chosen PRTG to monitor their network. Find out how you can reduce cost, increase QoS and ease planning, as well.

Free PRTG
Download >>

 

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

 

Top Tags


View all Tags


How to monitor baramundi with PRTG

Votes:

0

Your Vote:

Up

Down

Can I monitor my baramundi Management Suite (bMS) installation with PRTG? What steps do I need to take?

baramundi exe-script-advanced-sensor powershell prtg script

Created on Dec 4, 2018 9:00:25 AM by  Brandy Mauff [Paessler Support]

Last change on Dec 5, 2018 11:21:22 AM by  Brandy Mauff [Paessler Support]



1 Reply

Accepted Answer

Votes:

0

Your Vote:

Up

Down

This article applies to PRTG Network Monitor 18 or later

Monitoring baramundi Management Suite with PRTG

You can monitor your baramundi Management Suite (bMS) with the EXE/Script Advanced sensor from PRTG and a custom script. With the custom script, you can create a custom bMS Endpoint sensor, a custom bMS Endpoint Summary sensor, and a custom bMS Job Summary sensor. These sensors allow you to monitor important aspects of your bMS installation.

Requirements

  • The custom scripts are built using PowerShell 5.1. Ensure that you have installed this version on the probe system.
  • The custom sensors use the bConnect interface to read information from your bConnect installation. Ensure that you have installed and configured the bConnect interface before you create sensors in PRTG.
  • Ensure that the bConnect interface uses TLS.

Copy and Save the Files

Before you can create the custom sensors in PRTG, you need to save the scripts and lookups in the respective subfolders of the probe system's PRTG program directory. You can find the files in the baramundisoftware/PRTG-Sensors project on GitHub.


Optional: You can also execute the PowerShell script PublishTo-Prtg.ps1 to automatically copy the files to the respective folders of the PRTG program directory.


Copy and save the following scripts in the Custom Sensors\EXEXML subfolder of the PRTG program directory.

  • bMS Endpoint Summary.ps1
  • bMS Endpoint.ps1
  • bMS Job Summary.ps1
  • bMS Sensor.psm1

Copy and save the following lookup files in the lookups\custom subfolder of the PRTG program directory.

  • oid.baramundi.compliancestate.ovl
  • oid.baramundi.managementstate.ovl

Note: If necessary, (re)load the lookup files by clicking the Load Lookups and File Lists button in the PRTG web interface under Setup | System Administration | Administrative Tools.

Store the bConnect Context

To access the bConnect interface, authentication with a username and password is required. To store the bConnect context (URL and password), follow these steps.

  • Log in to the Windows account that will be used for access from PRTG.
  • Open a PowerShell prompt.
  • Change the location to the directory that contains the PowerShell scripts in PRTG using the following command.

sl "${env:ProgramFiles(x86)}\PRTG Network Monitor\Custom Sensors\EXEXML"

  • Import the module that contains the basic functionality for the sensors.

Import-Module '.\bMS Sensor.psm1'

  • Call the function Set-bConnectContext.

PS C:\Program Files (x86)\PRTG Network Monitor\Custom Sensors\EXEXML> Set-bConnectContext

  • Provide the following information:

Note: Before creating sensors in PRTG, you can use the cmdlet Test-b-ConnectContext to test the connectivity to the bConnect interface.

Monitoring bMS Endpoints

You can monitor the status of a single endpoint registered in the bMS using the EXE/Script Advanced sensor and the custom script to create a custom bMS Endpoint sensor. This sensor has the following channels.

  • Compliance state
  • Job Instances: Finished cancelled
  • Job Instances: Finished error
  • Job Instances: Requirements not met
  • Job Instances: Skipped due to incompatibility
  • Job Instances: Total
  • Job Instances: Waiting for user
  • Job Instances: Waiting for user (non-blocking)
  • Last seen in hours
  • Management state

1. Create a new device in PRTG with the IP address of the device to be monitored.

2. On the device, create a new EXE/Script Advanced sensor.

3. Under EXE/Script select bMS Endpoint.ps1.

4. Enter the FQDN or display name of the monitored device under Parameters, for example %host.

5. Under Security Context, select the security context that matches the Windows user who stored the files. Because the PRTG probe is run by the local SYSTEM user by default, you will have to use the Windows credentials of the parent device that match this user in most cases.

6. Click Create to add the sensor.

Monitoring bMS Endpoint Summary

You can monitor general aspects of all endpoints registered in the bMS using the EXE/Script Advanced sensor and the custom script to create a custom bMS Endpoint Summary sensor. This sensor has the following channels.

  • Active Endpoints
  • Compliance check deactivated
  • Inactive endpoints
  • Max last seen in days
  • Not compliant endpoints
  • Total endpoints

1. Create a new device in PRTG with the IP address of the bMS server.

2. On the device, create a new EXE/Script Advanced sensor.

3. Under EXE/Script select bMS Endpoint Summary.ps1.

4. Under Security Context, select the security context that matches the Windows user who stored the files. Because the PRTG probe is run by the local SYSTEM user by default, you will have to use the Windows credentials of the parent device that match this user in most cases.

5. Click Create to add the sensor.

Monitoring bMS Jobs

You can monitor the status of jobs on endpoints in the bMS using the EXE/Script Advanced sensor and the custom script to create a custom bMS Job Summary sensor. This sensor has the following channels.

  • Finished cancelled
  • Finished error
  • Requirements not met
  • Skipped due to incompatibility
  • Total Instances
  • Waiting for user
  • Waiting for user (non-blocking)

1. Create a new device in PRTG with the IP address of the bMS server.

2. On the device, create a new EXE/Script Advanced sensor.

3. Under EXE/Script select bMS Job Summary.ps1.

4. Under Parameters, enter the job name.

5. Under Security Context, select the security context that matches the Windows user who stored the files. Because the PRTG probe is run by the local SYSTEM user by default, you will have to use the Windows credentials of the parent device that match this user in most cases.

6. Click Create to add the sensor.

Troubleshooting

If you receive an error regarding unsupported file formats or have other issues with your sensors, take the following steps to help identify the cause.

  • If you have issues with your baramundi sensors, enable a Write EXE result to disk option under EXE Result in the sensor's settings. This is helpful for troubleshooting.
  • Ensure that the sensor stores the EXE result in the file system so that you can access the error message in the \Logs (Sensors) subfolder of the PRTG program directory.
  • Run Test-bConnectContext to check whether the bConnect connection works.
  • Ensure that the bConnect certificate is trusted on the machine where the probe system is running.

See Also

Created on Dec 4, 2018 10:12:07 AM by  Brandy Mauff [Paessler Support]

Last change on Dec 10, 2018 7:44:58 AM by  Brandy Mauff [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.