The latest release announcements are available on https://icinga.com/blog/.
Please read the upgrading documentation before upgrading to a new release.
Released closed milestones can be found on GitHub.
- #397 Adds support to
Invoke-IcingaCheckEventLogto provide occurring problem event id's for the Eventlog and corresponding acknowledgement id's, providing an indicator if certain issues are resolved or still present - #409 Adds support to
Invoke-IcingaCheckProcessfor reporting properly if a defined process was not found on the system and using-OverrideNotFoundargument to define the plugin output in this case - #413 Adds argument
Limit100PercenttoInvoke-IcingaCheckCPUfor limiting each threads CPU usage to 100% - #419 Removes process list feature for
Invoke-IcingaCheckCPU, which causes too much CPU overhead and increase execution time by a lot without substantial gain of information
- #398 Fixes an issue with service names not interpreted correctly by
Invoke-IcingaCheckServicein case it contains[] - #401 Fixes
Invoke-IcingaCheckDirectorywhich could not resolve-Patharguments in case closing[or open brackets]were part of the path - #412 Fixes
Invoke-IcingaCheckServiceto not add summary performance metrics in case the user filtered for specific services
- #375 Fixes a memory leak on the Icinga EventLog provider for fetching Windows EventLog information
- #384 Adds new data provider for Invoke-IcingaCheckProcess and extends functionality by adding a new 'ExcludeProcess' argument
- #386 Adds new provider for Invoke-IcingaCheckEventLog, to improve performance and fix memory leaks
- #288 Adds support to
Invoke-IcingaCheckPartitionSpaceto define mandatory partitions which should always be present - #366 Adds support to
Invoke-IcingaCheckCPUto report top CPU consuming process information as well as a switch to change the overall load from average to sum - #378 Adds support for
Invoke-IcingaCheckServiceto change the output for not found services from UNKNOWN to OK, WARNING or CRITICAL instead
- #358 Fixes broken Icinga plain configuration
- #360 Fixes
Invoke-IcingaCheckMemorywhich uses the wrong unit for the pagefile plugin, wrong values, exceptions and %-Values not working
- #342 Fixes an issue for disk health plugin, which can fail in some cases due to an invalid conversion from the MSFT output from int to string
- #346 Fixes the pagefile provider at
Get-IcingaMemoryPerformanceCounterwhich returned the pagefile size in MB instead of Bytes
- #332 Adds support to provide different credentials for the
Invoke-IcingaCheckUNCPathplugin, to run the check for a different user account - #348 Adds feature to
Invoke-IcingaCheckPerfCounterto summarize an entire performance counter category, in case all instances of the check fail to prevent large outputs being written into the database - #355 Updates
Invoke-IcingaCheckCPUto use new data providers directly from the Icinga PowerShell Framework.
- The new CPU metrics will now be separated between the actual sockets of the system, allowing an overview on multi socket systems, which CPU is assigned more loads
- Metrics will now be separated by
0_1for the index, which in this example is socket 0 and core 1.
- #323 Fixes
Invoke-IcingaCheckServiceto write invalid performance data in case one service is actively checked and returningUNKNOWNbecause it does not exist
- #322 Adds flag
-IgnoreServicefor pluginInvoke-IcingaCheckTimeSyncto ignore the time service being evaluated during check runtime
- #199 Fixes
Invoke-IcingaCheckDiskHealthto add disk metadata like serial number and friendly name for any disk type processed - #308 Fixes function
Get-IcingaServiceCheckNamewhich was not public anymore since v1.9.0, causing MSSQL plugins to not work properly - #319 Removes performance data for
Invoke-IcingaCheckCheckSum, as there are no real performance metrics to write which are allowed by icinga
- #276 Extends
Invoke-IcingaCheckUpdatesfor allowing to check if there is a pending reboot on the system remaining to finalize Windows updates - #284 Adds support to exclude certain exit codes from throwing critical for
Invoke-IcingaCheckScheduledTask[Paul-Weisser] - #300 Adds a new flag
-ConnectionErrAsCrittoInvoke-IcingaCheckHTTPStatus, allowing to change theUNKNOWNresult in case a connection to the website is not possible toCRITICAL - #301 Adds support to use
IncludeandExcludefilters forInvoke-IcingaCheckPerfCounter - #312 Adds support to exclude certificates by thumbprints for
Invoke-IcingaCheckCertificateby adding thumbprints to the-ExcludePatternargument - #316 Adds support to include and exclude network devices for
Invoke-IcingaCheckNetworkInterfaceby their device and interface name, besides the internal id
- Windows Base
- Windows-Plugins-Web
- Invoke-IcingaCheckPartitionSpace
- Invoke-IcingaCheckNetworkInterface
- Invoke-IcingaCheckUpdates
- Invoke-IcingaCheckUptime
- Invoke-IcingaCheckCPU
- Invoke-IcingaCheckService
- Invoke-IcingaCheckMemory
- hostalive
- Adds new plugin Invoke-IcingaCheckHttpJsonResponse to check results returned by a JSON web request #290. [DOliana]
- #283 Fixes random
Add-Typeexceptions during runtime compilation by replacing it withAdd-IcingaAddTypeLib - #286 Fixes
Invoke-IcingaCheckHTTPStatuswhich is not returning the request time, in case the target website is not providing content - #299 Fixes integration with
Inventorymodule
- #298 Adds support for Icinga for Windows v1.9.0 module isolation
- #250 Fixes alias
Invoke-IcingaCheckUsedPartitionSpacewhich is not working on Windows 2012R2 or older and being replaced with a native function - #246 Fixes wrong
UNKNOWNonInvoke-IcingaCheckServicewhile using service display name with the-Serviceargument instead of the service name - #261 Fixes
Invoke-IcingaCheckCertificatewhich always included the CertStore because no option to not check the certificate store was available - #262 Fixes method NULL exception on empty EventLog entries for
Invoke-IcingaCheckEventLog - #271 Fixes JEA error which detected
ScriptBlocksin the plugin collection - #272 Fixes file encoding for
Invoke-IcingaCheckTimeSyncwhich was not UTF8 before, causing the JEA profile writer to ignore the file - #274 Fixes
Invoke-IcingaCheckScheduledTaskfor wildcard task names, which added the unknown package in case wildcards were used for task names
- #143, #220, #256 Improves
Invoke-IcingaCheckUpdates, splitting updates into different categories, allowing the check for the update count based on these categoriesMicrosoft Defender,Security Updates,Rollup Updatesand allOther Updates. The-UpdateFilterwill only apply to the total update count, allowing additional customisation. By running the plugin with-Verbosity 1, it will now also print the list of the update names if the the thresholds are printingWarning,CriticalorUnknown - #204 Extends functionality of
Invoke-IcingaCheckDirectoryby allowing to monitor file counts, adding folder count to monitoring, different files sizes (total size, average, smallest file and largest file) and allows to print the entire file list fetched by the plugin - #205 Adds new plugin
Invoke-IcingaCheckProcessfor detailed monitoring of running services for CPU, Memory, PageFile and ThreadCount usage and total running processes
- #187 Fixes
Invoke-IcingaCheckUsedPartitionSpaceandInvoke-IcingaCheckDiskHealthin case mirrored disks are used within the system, causing an exception on duplicate partition id's - #200 Fixes
UNKNOWNforInvoke-IcingaCheckUsedPartitionSpace, in case the main partition has no space left which should returnCRITICALinstead - #233 Fixes used partition space plugin performance by fetching only partition space data instead of entire disk information collection and renamed it to represent the new method of being able to toggle between free and used space for partitions
- #235 Fixes operational status monitoring output for
Invoke-IcingaCheckDiskHealth
- #199 Adds additional metadata to
Invoke-IcingaCheckDiskHealthfor disk serial number, assigned partitions, boot device, device id, system device and device name - #211 Adds feature to
Invoke-IcingaCheckService, allowing to filter for specific service startup types in case the plugin is used to check for specific services with-Service - #237 Adds support for
Invoke-IcingaCheckHTTPStatusto add the content of the website output by using the flag-AddOutputContent - #241 Adds possibility to switch between free and used monitoring for
Invoke-IcingaCheckUNCPathand consolidates monitoring like other plugins, with dynamic % monitoring. - #243 Removes function
Publish-IcingaPluginDocumentation, as this function will move directly into the Icinga PowerShell Framework
- #221 Fixes
Invoke-IcingaCheckFirewallto not use variable with name-Profileas argument, as it is reserved for PowerShell internals - #224 Fixes
Invoke-IcingaCheckUsedPartitionSpacelabel names, which might have caused conflicts with Graphite/InfluxDB, because of changed metric unit - #226 Fixes class names of
Add-TypeforGet-IcingaDiskAttributesandGet-IcingaUNCPathSizeand adds checks if the class was already added inside the session
- #208 Adds additional features to
Invoke-IcingaCheckScheduledTask, allowing to monitor exit codes, missed runs and last/next run time of a task - #217 Adds feature for
Invoke-IcingaCheckPerfCounterwith new switch-IgnoreEmptyChecksto change the output fromUNKNOWNtoOK, in case no performance counters were found - #222 Replaces
Get-FileHashwith own implementation asGet-IcingaFileHash, to work with new JEA integration - #223 Removes the function
Get-IcingaServices, as this function has been moved to the Icinga PowerShell Framework - #225 Adds support for plugins to work in JEA context
- #196 Fixes unhandled PermissionDenied exceptions for
Invoke-IcingaCheckDirectory, in case required permissions for files and folders were not set - #202 Fixes
\and/which are now removed again for-Includeand-Excludearrays onInvoke-IcingaCheckUsedPartitionSpace.
#163 Checks the response time, the return code and content of HTTP requests.
#172 Checks the number of paths for each MPIO driver on your system.
Please have a look on the upgrading docs for these plugins
- Invoke-IcingaCheckNetworkInterface
- Invoke-IcingaCheckMemory
- Invoke-IcingaCheckUsedPartitionSpace
- #14 Rework of
Invoke-IcingaCheckMemoryto use new features from 1.5.0 for % handling and added page file check content including arguments. Please have a look on the upgrading docs - #71 Rework
Invoke-IcingaCheckUsedPartitionSpaceto properly use Framework v1.5.0 functionality and resolve upper/lower case drive filtering - #156 Adds feature to modify the output status of
Invoke-IcingaCheckCertificatefromUNKNOWNtoOKin case no certificate was found by setting the new argument-IgnoreEmpty - #159 Replaces the deprecated function
Get-EventLogwithGet-WinEvent. In addition, the plugin received a new argument-MaxEntriesto allow additional filtering for the number of events fetched to improve performance in addition. The EventLog now also supports an array with list items, allowing easier filtering for severities which are allowed inside the EventLog. - #167 Upgrades plugin configuration files to Framework version 1.5.0. Please have a look on the upgrading docs
- #181 Improves the handling for the Network Interface plugin and moves the
Get-IcingaNetworkInterfaceUnitsfrom the plugin repository into the Framework
- #144 Fixes filtering for
Invoke-IcingaCheckEventLogwhich resulted in wrong results, depending on the plugin configuration - #147 Fixes wrong comparison for file size on
Get-IcingaDirectorySizeSmallerThan, used byInvoke-IcingaCheckDirectory - #148 Fixes exception on
Invoke-CheckNetworkInterfacewhile two team interfaces with the identical name are present on the system - #154 Fixes
Invoke-IcingaCheckDirectoryby setting-FileNamesargument to*as default for allowing to fetch all files for a given directory by default - #160 While filtering for certain services with
Get-IcingaServices, there were some attributes missing from the collection. These are now added resulting in always correct output data. - #161 Fixes a copy & paste error on
Invoke-IcingaCheckUsedPartitionSpace, as a wrong check variable was used for forcingUnknownresults - #171 Fixes wrong OK states for
Invoke-IcingaCheckPerfCounter, in case counters for categories with instances were not present - #176 Fixes offset calculation for
Invoke-IcingaCheckTimeSync, to allow negative offset as well - #178 Fixes exception handling for
Invoke-IcingaCheckNLAto properly handle errors while checking for connection profiles - #185 Fixes Network interface percent for teams not working
- #186 Fixes possible exception on Icinga for Windows installation, if plugins were removed, no new shell session was created and therefor plugins are not able to load
If you are going to install this plugin release, please have a look on the upgrading docs before!
- #114 Adds possibility to exclude certificates matching a certain pattern
- #134 Adds autoloading for plugin information to standardize the development and projects and fixes plenty of spelling/code styling errors
- #135 Adds new check plugin
Invoke-IcingaCheckTCP - #137 Adds new configuration for Icinga for Windows v1.4.0 to make future configuration changes unnecessary. Please read the upgrading docs before upgrading!
- #139 Adds check note for the last boot time for
Invoke-IcingaCheckUptimewhich is being displayed by using-Verbosity 2on the check configuration - #140 Adds new plugin
Invoke-IcingaCheckUNCPathto test for network share paths or other volumes to fetch the size and free space from them - #141 Update Icinga Director and Icinga 2 conf files with new DSL parser for array elements to properly escape string values with single quotes. Please read the upgrading docs
- #136 Improves
Invoke-IcingaCheckEventLogtime filter by allowing simple input like-After 5hand fixes issue on filtering by formatting the time data into required formatyyyy/MM/dd HH:mm:ss
- #123 Fixes wrong documented user group for accessing Performance Counter objects which should be
Performance Monitor Users - #124 Fixes crash on
Invoke-IcingaCheckServiceif an automatic service is not running - #126 Fixes code base for
Invoke-IcingaCheckServiceby preferring to fetch the startup type of services by using WMI instead ofGet-Services, as the result ofGet-Servicesmight be empty in some cases - #128 Fixes invalid Icinga 2 configuration files due to special characters, invalid attributes and wrong boolean values
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
If you are going to install this plugin release, please have a look on the upgrading docs to not run into issues!
- #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
pluginsdoc folder in case it does not exist - #74 Adds
avg. disk queue lengthmetric for monitoring and performance data toInvoke-IcingaCheckDiskHealth - #78 Improves the documentation and output for
Invoke-IcingaCheckServiceby adding metrics for all found services configured to runAutomaticand adds service output on Verbosity 1 to show a list of all found services including their current state - #85 Adds support on
Invoke-IcingaCheckUsedPartitionSpaceto ignore aUnknownin case all checks are filtered out. This will then returnOkinstead if argument-IgnoreEmptyChecksis set. In addition you can now use-SkipUnknownwhich will transform anUnknownof partitions without data toOk. Reworks #84 - #90 Adds support to ignore read only/offline disks on
Invoke-IcingaCheckDiskHealth - #101 Improves
Invoke-IcingaCheckScheduledTaskby changing theStateargument fromStringtoArray, 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
-Pathargument is not set or not directing a file (including invalid path)
- #75 Fixes unhandled arguments
FileSizeGreaterThanandFileSizeSmallerThanforInvoke-IcingaCheckDirectory - #77 Fix wrong filtering for EventIds for
Invoke-IcingaCheckEventLogand 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-IcingaCPUCountreturns wrong count on empty arguments - #97, #98 Fixes invalid performance data output for
Invoke-IcingaCheckScheduledTask - #102, #103 Fixes
Invoke-IcingaCheckNetworkInterfaceplugins arguments being too long for Icinga Director - #110 Fixes
Invoke-IcingaCheckEventLogplugin throwing an unknown for valid arguments
This release adds the following new plugins:
- Invoke-IcingaCheckTimeSync: Allows to compare local machine time with a time server to check for possible time missmatch
- Invoke-IcingaCheckScheduledTask: Allows to check the current state for a list of provided scheduled tasks
- Invoke-IcingaCheckDiskHealth: Allows to check for several disk Performance Counters and the disk health in general
- #34 Replaces plugin CIM/WMI calls for new Framework wrapper function
Get-IcingaWindowsInformationto properly handle config/permission errors
- #32 Improves plugin doc generate to update existing .md files and create new ones only if required
- #28 Adds unknown state for each included service during a service check which was not found on the host
- #33 Adds support to generate plugin docs for different plugin module repos
- #38 Adds new plugin
Invoke-IcingaCheckDiskHealth - #39 Fixes Performance Counters check plugin to throw error in case Performance Counter do not exist or a simply not present
- #42 Improves performance of
Invoke-IcingaCheckCPUfor multi socket systems and optimises the code - #44 Adds check for Performance Counter categories 'Memory' and 'Processor' if they are present on a system, throwing an 'Unknown' if not
- #30 Fixes $null input value for certificate check, causing the Director import to fail
- #36 Fixes Ok return value for Invoke-IcingaCheckDirectory while -Path argument is not set
- #37 Fixes
-FileNamesargument being ignored for Invoke-IcingaCheckDirectory while not using the-Recurseargument - #40 Fixes
Get-TimeZoneCmdlet not known forInvoke-IcingaCheckTimeSyncon Windows 2012 R2 and older - #50, #51 Fixes possible crash/artifacts on plugin output for EventLog check while filters do not match any entry
This release adds two new plugins to the collection:
- Invoke-IcingaCheckICMP: Allows to execute ping checks from the Windows Agent to other hosts
- Invoke-IcingaCheckCertificate: Allows to check certificates on disk or inside the Windows Cert Store
- #26 Fixes Invoke-IcingaCheckEventLog to use EventIds instead of InstanceIds for filtering and output
- #19 Fixes exclude of EventLog ids for Invoke-IcingaCheckEventLog
- #27 Fixes User provider to prevent almost infinite loop on AccountDomainSid resolving
This release fixed several smaller design and documentation issues as well as improving the general output of the plugins.
If you installed the previous RC versions of the Framework or the Plugins, you will have to generate the Icinga Director Basket configuration again and re-import the newly generated JSON file. Please be aware that because of possible changes your old custom variables containing arguments and thresholds might not apply due to new custom variable naming and handling. Please ensure to have a backup of your Icinga Director before applying any changes
- #5 Used partition space will now output usage in bytes as well (formatted to MB/GB/TB depending on size)
- #9 The memory plugin is now calculating the missing thresholds
- #4 Fixes unused partition space plugin not working on Windows 7 or older
- #8 Fixes unit auto detection for memory plugin
- Initial release candidate for the new Icinga PowerShell Plugins