Icinga PowerShell Plugins v1.3.0

1.3.0 (2020-12-01)

Issue and PRs

Upgrading to v1.3.0 (2020-12-01)

Plugin Argument Changes (Breaking Changes)

The following plugins received modifications to their existing arguments. Please keep in mind that updating to this version of the Icinga PowerShell Plugins, you must update your configuration to ensure everything is running properly and update all plugins on all systems. As for the Icinga Director, you have to import the new basket for these plugins to apply the configuration. How ever, current values assigned to these arguments will no longer apply and have to be reconfigured!

Invoke-IcingaCheckScheduledTask

The State argument for Invoke-IcingaCheckScheduledTask has been changed from String to Array, which will now support providing multiple states a task can be into. In addition we modified the Icinga PowerShell Framework to properly support ValidateSet for array arguments, fixed in #152. Please ensure to upgrade to v1.3.0 before generating the new configuration and importing it, as the fix ensures that array arguments still can only contain fixed values.

New Plugins

This release adds the following new plugin:

• Invoke-IcingaCheckNetworkInterface: Checks availability, state and Usage of Network interfaces and Interface Teams
• Invoke-IcingaCheckStoragePool: Checks availability, utilization and state of a StoragePool

Breaking changes

If you are going to install this plugin release, please have a look on the upgrading docs to not run into issues!

Enhancements

• #61 Adds exception handling in case permissions to access Windows Updates are missing on the system
• #73 Improves plugin creation Cmdlet to write a new permission section and to create the plugins doc folder in case it does not exist
• #74 Adds avg. disk queue length metric for monitoring and performance data to Invoke-IcingaCheckDiskHealth
• #78 Improves the documentation and output for Invoke-IcingaCheckService by adding metrics for all found services configured to run Automatic and adds service output on Verbosity 1 to show a list of all found services including their current state
• #85 Adds support on Invoke-IcingaCheckUsedPartitionSpace to ignore a Unknown in case all checks are filtered out. This will then return Ok instead if argument -IgnoreEmptyChecks is set. In addition you can now use -SkipUnknown which will transform an Unknown of partitions without data to Ok. Reworks #84
• #90 Adds support to ignore read only/offline disks on Invoke-IcingaCheckDiskHealth
• #101 Improves Invoke-IcingaCheckScheduledTask by changing the State argument from String to Array, allowing the comparison against multiple states. Important: Please have a look on the upgrading docs!
• #104 Adds plugin configuration files for Icinga Director and Icinga 2 within the config directory
• #109 Adds exception handling in case -Path argument is not set or not directing a file (including invalid path)

Bugfixes

• #75 Fixes unhandled arguments FileSizeGreaterThan and FileSizeSmallerThan for Invoke-IcingaCheckDirectory
• #77 Fix wrong filtering for EventIds for Invoke-IcingaCheckEventLog and improve the output by adding the EventLog messages on severity 1. In addition we now allow the filtering for message sources and increase performance by fetching EventLog data for new checks from the last 2 hours only
• #79 Fixes service check to exclude provided service names in case they contain the wildcard symbol '*' which causes the check to always return unknown
• #86 Fixes Get-IcingaCPUCount returns wrong count on empty arguments
• #97, #98 Fixes invalid performance data output for Invoke-IcingaCheckScheduledTask
• #102, #103 Fixes Invoke-IcingaCheckNetworkInterface plugins arguments being too long for Icinga Director
• #110 Fixes Invoke-IcingaCheckEventLog plugin throwing an unknown for valid arguments