Monitoring Windows Disks

fabian · May 29, 2026, 8:02am

Hello guys,

I have this warning in my icinga2 daemon -C command:

[2026-05-29 09:54:40 +0200] warning/Checkable: CheckCommand ‘disk-windows’ used by ‘lt-xyz.whberlin.local!check disk plugin test’ (in /var/lib/icinga2/api/packages/director/b02b9e6c-d407-49ea-941b-49652dfef13d/zones.d/icinga2host/services.conf: 17:1-17:39) is DEPRECATED and will be removed in v2.18. Further uses of this check command won’t be logged.

I have IcingaForWindows plugins installed in my monitoring environment. I want to use the recent plugins which are not deprecated.

I checked it and the Invoke-IcingaCheckDiskHealth instead of check_disk checks different parameters.

I also tried to use Invoke-IcingaCheckPartitionSpace but I don’t really get what I do have to set as critical and warning values as example.

Could you please give me a hint what is the recent equivalent to disk-windows?

Thank you for your help.

Best regards,

Fabian

moreamazingnick · May 29, 2026, 8:52am

github.com/Icinga/icinga-powershell-plugins

doc/plugins/16-Invoke-IcingaCheckUsedPartitionSpace.md

master

# Invoke-IcingaCheckUsedPartitionSpace

## Description

Checks how much space on a partition is used.

Invoke-IcingaCheckUsedPartition returns either 'OK', 'WARNING' or 'CRITICAL', based on the thresholds set.
e.g 'C:' is at 8% usage, WARNING is set to 60%, CRITICAL is set to 80%. In this case the check will return OK.
Beside that the preset for percentage or unit measurement is now free to design, regardless of % values or GiB/TiB
and so on.

The plugin will return `UNKNOWN` in case partition data (size and free space) can not be fetched. This is
normally happening in case the user the plugin is running with does not have permissions to fetch this
specific partition data.

More Information on https://github.com/Icinga/icinga-powershell-plugins

## Permissions

To execute this plugin you will require to grant the following user permissions.

This file has been truncated. show original

Best Regards
Nicolas

fabian · May 29, 2026, 9:47am

Hello Nicolas,

Thank you for your reply. I tried to use it but could you probably give me an additional hint what would be good values as “warning” and “critical” tresholds? I tried 80% for warning and 90% for critical first. Afterwards I tried 20% for warning and 10% for critical.

This is the output I get with 80% and 90% levels:

Free Partition Space: 1 Unknown 2 Critical 3 Ok Partition E: Partition \\?\Volume{690a57be-c493-4e8c-9be1-cf6ea7c28b66}\, Partition D:
\_ Partition \\?\Volume{690a57be-c493-4e8c-9be1-cf6ea7c28b66}\: Value 1.04GiB (99,23%) is greater than threshold 967.50MiB (90%)
\_ Partition D: Value 29.23GiB (99,77%) is greater than threshold 26.37GiB (90%)

This is the output I get with 20% warning and 10% critical levels:

Free Partition Space: 6 Unknown Partition \\?\Volume{18b6357c-2ea7-4d71-aedc-819adcee8fc1}\, Partition \\?\Volume{4fb31bde-536e-4cea-91a5-fe6a3b00df29}\, Partition \\?\Volume{690a57be-c493-4e8c-9be1-cf6ea7c28b66}\, Partition C:, Partition D:, Partition E:
\_ Partition \\?\Volume{18b6357c-2ea7-4d71-aedc-819adcee8fc1}\: Warning threshold range “204472400” is greater than Critical threshold range “102236200”
\_ Partition \\?\Volume{4fb31bde-536e-4cea-91a5-fe6a3b00df29}\: Warning threshold range “54525960” is greater than Critical threshold range “27262980”
\_ Partition \\?\Volume{690a57be-c493-4e8c-9be1-cf6ea7c28b66}\: Warning threshold range “225443800” is greater than Critical threshold range “112721900”
\_ Partition C: Warning threshold range “95866480000” is greater than Critical threshold range “47933240000”
\_ Partition D: Warning threshold range “6291456000” is greater than Critical threshold range “3145728000”

Can I work with percentages here?

Thank you.

moreamazingnick · May 29, 2026, 12:03pm

Which version of the powershell plugins/ framework do you use?
Can you please format your posts. Guidelines - Icinga Community

You also need to consider that this are nagios style thresholds
10% means everything is bad that is outside of 0-10% which works for disk used but not for disk free

For disk free you most likely need 10%: which means everything <10% will alert

github.com/Icinga/icinga-powershell-plugins

doc/10-Icinga-Plugins.md

master

# Icinga Plugins

Below you will find a documentation for every single available plugin provided by this repository. Most of the plugins allow the usage of default Icinga threshold range handling, which is defined as follows:

| Argument | Throws error on | Ok range                     |
| ---      | ---             | ---                          |
| 20       | < 0 or > 20     | 0 .. 20                      |
| 20:      | < 20            | between 20 .. ∞              |
| ~:20     | > 20            | between -∞ .. 20             |
| 30:40    | < 30 or > 40    | between {30 .. 40}           |
| `@30:40  | ≥ 30 and ≤ 40   | outside -∞ .. 29 and 41 .. ∞ |

Please ensure that you will escape the `@` if you are configuring it on the Icinga side. To do so, you will simply have to write an *\`* before the `@` symbol: \``@`

To test thresholds with different input values, you can use the Framework Cmdlet `Get-IcingaHelpThresholds`.

Each plugin ships with a constant Framework argument `-ThresholdInterval`. This can be used to modify the value your thresholds are compared against from the current, fetched value to one collected over time by the Icinga for Windows daemon. In case you [Collect Metrics Over Time](https://icinga.com/docs/icinga-for-windows/latest/doc/110-Installation/06-Collect-Metrics-over-Time/) for specific time intervals, you can for example set the argument to `15m` to get the average value of 15m as base for your monitoring values. Please note that in this example, you will require to have collected the `15m` average for `Invoke-IcingaCheckCPU`.

```powershell
icinga> icinga { Invoke-IcingaCheckCPU -Warning 20 -Critical 40 -Core _Total -ThresholdInterval 15m }

This file has been truncated. show original

fabian · June 1, 2026, 5:59am

Thank you so much.

Do you mean if there is some computer data that I just copy them into a quote like this?

Output?

Thank you for your help. It helped me a lot.

moreamazingnick · June 1, 2026, 7:42am

Yes and also keep in mind that some chars have formating functionality **strong text** is evaluated to strong text in this forum

Here are the Guidelines - Icinga Community.

there also was a getting started tutorial.

Best Regards
Nicolas