Monitor a Windows Service with PowerShell Module

329854343 · May 31, 2022, 10:23am

Hello, so I want to monitor a few windows services, like the wsus-service on our wsus.
We use the Icinga2 Director Module!

On all of our windows clients is the Icinga2 Agent installed (also known as PowerShell Module).

Is it possible to monitor a specific service?
I’ve look through the forum and google, some said its possible with nsclient++, some say you can add a command??

Can someone please tell me if it is possible with the standard PowerShell module?
Is there maybe a guide I can follow?

Director version (System - About): 1.9.1
Icinga Web 2 version and modules (System - About): 2.10.1
Icinga 2 version (icinga2 --version): r2.13.3-1
Operating System and version: Ubuntu 20.04.4 LTS

moreamazingnick · May 31, 2022, 11:22am

check if you have icinga-powershell-plugins installed
import your Icinga Powershell plugins in icinga Director
icinga-powershell-plugins/config/director at master · Icinga/icinga-powershell-plugins · GitHub]
Create a director service template for Invoke-IcingaCheckService
add director service to template with the windows service you want to observe
deploy and pray

329854343 · May 31, 2022, 12:26pm

Thanks for the fast reaction!
How exactly do I import those extended plugins?
Do I need to download them and put them in a special directory?

moreamazingnick · May 31, 2022, 2:23pm

Please tell me:
How did you install the agent?

329854343 · May 31, 2022, 2:32pm

With following script:

[Net.ServicePointManager]::SecurityProtocol = 'tls12, tls11';
$ProgressPreference                         = 'SilentlyContinue';
[string]$ScriptFile                         = 'C:\Users\Public\IcingaForWindows.ps1';

Invoke-WebRequest `
    -UseBasicParsing `
    -Uri 'https://packages.icinga.com/IcingaForWindows/IcingaForWindows.ps1' `
    -OutFile $ScriptFile;

& $ScriptFile `
    -ModuleDirectory 'C:\Program Files\WindowsPowerShell\Modules\' `
    -SkipWizard;


Remove-Item C:\Users\Public\IcingaForWindows.ps1



Use-Icinga;
Start-IcingaAgentInstallWizard `
    -DirectorUrl            'http://###SERVERNAME###/icingaweb2/director/' `
    -SelfServiceAPIKey      '###GENERATED KEY###' `
    -UseDirectorSelfService 1 `
    -OverrideDirectorVars   0 `
    -Reconfigure `
    -RunInstaller

moreamazingnick · May 31, 2022, 8:54pm

Open a powershell as adminstrator and insert:

Use-Icinga;
Install-IcingaFrameworkComponent -Name plugins;

after that you have the powershell plugins installed.
after that you read my second post again…

329854343 · June 1, 2022, 2:28pm

Hello, okay, I installed the plugins on the agent server

But on the master - is service-windows the right command?

When I create that service-template I see no way to declare what service I want to check exactly?
Or do I need to install the plugins on the master the same way too?

moreamazingnick · June 7, 2022, 7:51pm

service-windows is the old monitoring-tools check, this works too but without powershell and only with the real service name, for example wuauserv but not “Windows Update”

if you want to use the powershell plugins you have to import your Icinga Powershell plugins in icinga Director using baskets, see link above

329854343 · June 8, 2022, 3:22pm

Okay, I’ve found out that I can configure the command Invoke-IcingaCheckService.

As from what I understand, baskets are used to apply already configured checkServices?
But at some point I need to configure what exacly I want to monitor, I dont really understand where?

As seen in the screenshot I tried to put value to declare that I want to use the Plugin and what service I want to monitor, is that totally wrong?

I dont know if its just the language barrier for me, but the official documentation from icinga2 do not really clarify how to configure the plugin in practice.