Custom Sensors for use with PRTG Network Monitor
* = Not yet uploaded
| Name | Product | Description |
|---|---|---|
| * Get-CitrixConnectionsAllowed | Citrix XenApp/XenDesktop | Monitors VDA Servers in Maintenance Mode |
| Get-CitrixRegistrationState | Citrix XenApp/XenDesktop | Monitors the registration state of VDA Servers |
| Get-DFSRBacklog | DFS Replication | Monitors DFS Backlog between two servers |
| * Get-ExchangeBackPressure | Exchange | Monitors Exchange Back Pressure |
| Get-ClusterStatus.ps1 | Failover Clustering | Monitors the health of cluster nodes/resources |
| * TCPing.ps1 | PowerShell port of tcping for use with PRTG | |
| Get-MissingPrtgServers | PRTG Network Monitor | Monitors servers in AD missing from PRTG |
| PSx64 | PRTG Network Monitor | Elevates PowerShell scripts to run as 64-bit |
| * Get-RDSConnectionsAllowed | Remote Desktop Services | Monitors Terminal Servers denying new connections |
| * Get-RDSSessionHealth | Remote Desktop Services | Monitors null sessions/locked profile disks |
| Get-SqlDatabaseHealth | SQL Server | Monitors the health of SQL Server databases |
| Get-VeeamBackupStatus.ps1 | Veeam Backup & Replication | Realtime monitoring of Veeam Backup Jobs |
| * Get-VeeamBackupCount.ps1 | Veeam Backup & Replication | Monitors the number of backups completed per day |
| * Get-MissingBackupVMs | Veeam Backup & Replication | Gets VMs in vCenter missing from any backup jobs in Veeam |
| * Get-vCenterServiceStatus | VMware vCenter (VCSA) | Monitors vCenter services on VCSA 6.5+ |
| Get-VMHostDatastoreHealth | VMware vCenter | Monitor latency spikes on a datastore for when its disk is on the fritz |
The following modules are used across these scripts, and will be automatically installed if they are found to be missing
If you encounter any errors with any of the scripts that use these modules, it could be worth trying to install these modules manually yourself (note that for most scripts, these will need to be installed in the 32-bit version of PowerShell on your PRTG Probe).
Polishing scripts to meet the bare minimum of publishing to the internet is non-zero work; if any of the above missing scripts interest you please open an issue and I'll look at uploading them.
No guarantee is given as to the safety or reliability of any of the scripts in this repo.
Monitors the registration state of machines in a specified machine catalog on a specified Citrix Delivery Controller. Tested with XenApp/XenDesktop 7.12 or so (it's been years since I used Citrix).
%host) and the name of the machine catalog to monitorThis module uses remote PowerShell to execute the required commands on the specified Citrix Delivery Controller where the required Citrix PowerShell Module would be installed. As such considerations may need to be made to ensure the specified device can accept remote PowerShell requests from your PRTG Probe server (such as making sure you're connecting via the device's hostname rather than IP, that it can accept such remote connections in the first place, etc)
Monitors the number of files waiting to be replicated in all DFS Replication groups present on a specified computer. This script is a significantly refactored version of the Get-DFSRBacklog.ps1 script originally written by sgrinker and modified for PRTG by Tim Boothby. Contains additional bugfixes I encountered when trying to use their script for myself.
%host)You may also need to change the Security Context of the sensor to run in the context of the Windows credentials of the parent device, I'm not sure.
Monitors the status of all nodes and resources in a specified Windows Failover Cluster. This script was specifically designed for use with SQL Server Always On Availability groups (which integrates with Failover Clustering) however presumably it can be used with any other type of Failover Cluster as well. Custom lookups are used to make the status of each component look pretty.
Install-WindowsFeature rsat-clustering-powershell)Get-ClusterStatus.ps1 <clusterName> where <clusterName> is the name of the cluster to monitorAlerts when devices in a specified OU in Active Directory do not exist in a specified probe within PRTG.
contoso.local/Contoso/Servers, then you should specify the value Contoso/Servers), a wildcard expression that matches the probe(s) to check for devices in, and a comma delimited list of devices to exclude from the monitoringYou may also need to change the Security Context of the sensor to run in the context of the Windows credentials of the parent device, I'm not sure.
Devices are determined to be present or missing by comparing their Active Directory Name with their PRTG Host. If you're using FQDNs or IP Addresses for your hosts you'll need to modify the script to incorporate that logic (maybe use the Active Directory object's DNSHostName instead of Name)
Executes a specified EXEXML script within 64-bit PowerShell rather than 32-bit PowerShell. Since the PRTG Probe is (as of writing) a 32-bit process, when it attempts to execute your EXEXML scripts, it is forced to execute them in a 32-bit version of PowerShell. This is an issue however when utilizing third party modules that are exclusively 64-bit only. PSx64 allows you to work around this by instead specifying your script and all of its arguments to this simple utility, which then launches your script under PowerShell 64-bit and emits all of its output back to PRTG.
This program needs to be compiled before use. Install the latest version of Visual Studio (the Community edition is free) and compile in Release mode. The resulting EXE will be in the bin\Release directory
Monitors the health of all databases within a given SQL Server. A custom lookup is used to identify the health status of each database.
%host) and optional instance name (e.g. sql-1 SQLEXPRESS)Monitors Veeam Backup & Replication jobs. Includes last backup status, time to next backup, how long backup has been running for and the time since the last backup. Custom status message shows pertinent data based on the current state of the job. A custom lookup enhances the Backup State channel to identify the state of the last backup. When warnings or errors occur, displays the status text of such messages on the sensor within PRTG.
Get-VeeamBackupStatus.ps1 should be compatible with all backup types, and has been tested with the following
Severe performance issues can arise when a large number of continuous backup jobs have been configured for use with Get-VeeamBackupStatus. To reduce the impact of these jobs, it is recommended to modify the Session history retention to a lower value from within Veeam Backup & Replication (Menu -> General Options -> History).
As of writing, works with Veeam Backup & Replication 11. To put it bluntly, this script is an epic abomination that attempts to bypass Veeam's crappy PowerShell library (some cmdlets actually retrieve all objects of a given type before filtering(!)) to achieve high performance per-job Veeam monitoring at an MSP doing backups every hour across 40 or so different backup jobs. This script (for the most part) completely bypasses Veeam's PowerShell library and tampers with the underlying .NET types directly. This script can and will break with any given Veeam update.
This script exposes bugs in the PowerShell ISE's handling of PowerShell classes - often setting a breakpoint inside of them will not work - you have to break on Main and step in all the way directly. This script does not require Veeam Enterprise Manager. No attempt is made at backwards compatibility; when Veeam breaks the script, I fix it to make it work. No guarantee is made that such corrections will be uploaded to GitHib; this script is great, but be prepared to get your hands dirty when it breaks.
Main and step your way throughDisconnect-VBRServer is mega slow in Veeam 11; make sure the sensor has a big enough timeoutMonitors the health of a VMware datastore when its underlying physical hard drive appears to be malfunctioning. This sensor crudely monitors for any esx.problem.scsi.device.io.latency.high events that are being thrown on your system for a specified host, and if any are found the sensor enters an error state displaying the the last error that ESXi threw for one of your datastores.