Icinga PowerShell Framework

This PowerShell module will allow to fetch data from Windows hosts and use them for inventory and monitoring solutions. Together with the Icinga Web 2 module, a detailed overview of your Windows infrastructure will be drawn.

Release Icinga for Windows v1.4.1

1.4.1 (2021-03-10)

Issue and PRs

Bugfixes

  • #222 Fixes an issue with [Secure.String] arguments for PowerShell plugins, caused by ConvertTo-IcingaSecureString Cmdlet not being pre-loaded
  • #224 Fixes "memory leak" on background daemon for registered service checks, by clearing the error stack and manually calling the PowerShell garbage collector to force freeing of memory

icinga-powershell-framework-v1.4.1.tar.gz

Release tarball
application/gzip 2021-03-10 Download from Github

Release Icinga for Windows v1.4.0

1.4.0 (2021-03-02)

Issue and PRs

Breaking Changes

There are changes made to the pre-compiled configuration files and Get-IcingaCheckCommandConfig. Please have a look on the upgrading before applying the new configuration files.

Enhancements

  • #180 Ensure check data are separated from each thread and not accessible from one thread to another to prevent conflicting results
  • #193 Adds optional support for adding milliseconds to Get-IcingaUnixTime with the -Milliseconds argument for more detailed time comparison
  • #198 Adds support to flush the content of the Icinga Agent API directory with a single Cmdlet Clear-IcingaAgentApiDirectory
  • #203 Removes experimental state of the Icinga PowerShell Framework code caching and adds docs on how to use the feature
  • #205 Ensure Icinga for Windows configuration file is opened as read-only for every single task besides actually modifying configuration content
  • #207 Adds new Argument -LabelName to New-IcingaCheck, allowing the developer to provide custom label names for checks and override the default based on the check name.
  • #210 Updates the Icinga DSL for building PowerShell arrays to ensure all string values are properly escaped with '. In case the user already wrapped commands with ' by himself, this will not have an effect as we only add single quotes for escaping if they are not present already
  • #211 Adds feature to uninstall single components for Icinga for Windows or to uninstall everything and start entirely from new
  • #213 Added support to fetch network interface for Register-IcingaDirectorSelfServiceHost directly from provided director url
  • #213 Added support for Icinga Framework Code Cache file being deleted once the feature is disabled
  • #213 Added support to suppress any console output for the current PowerShell session by using Disable-IcingaFrameworkConsoleOutput and to enable it again by using Enable-IcingaFrameworkConsoleOutput
  • #213 Added support for -Release argument for Get-IcingaFrameworkServiceBinary suppressing questions and using GitHub as source directly if set
  • #213 Added support to color console output by using Write-IcingaConsolePlain with the new argument -ForeColor
  • #213 Added new feature to write Icinga for Windows console headers more easily, better structured and formatted with Write-IcingaConsoleHeader by adding line content as array elements

Bugfixes

  • #206 Fixes background service check daemon for collecting metrics over time which will no longer share data between configured checks which might cause higher CPU load and a possible memory leak
  • #208 Fixes Convert-IcingaPluginThresholds which sometimes did not return proper numeric usable values for our internal functions, causing issues on plugin calls. In addition the function now also supports the handling for % units.
  • #213 Fixed possible crash on Get-IcingaAgentFeatures if PowerShell is not running as administrator and therefor the command icinga2 feature list can not be processed
  • #213 Fixed ConvertTo-IcingaSecureString to return $null for empty strings instead of throwing an exception
  • #214 Fixes wrong [Unknown] PluginNotInstalled exception because of new plugin configuration and wrong checking against APi result in case feature is enabled
  • #215 Fixes wrong used variable for arguments on API call checks

Experimental

  • #204 Adds experimental feature to forward checks executed by the Icinga Agent to an internal REST-Api, to reduce the performance impact on systems with lower resources available
  • #213 Adds new experimental feature Management Console for better and easier management for Icinga for Windows and improved automation and deployed.

icinga-powershell-framework-v1.4.0.tar.gz

Release tarball
application/gzip 2021-03-01 Download from Github

Release Icinga for Windows v1.3.1

1.3.1 (2021-02-04)

Issue and PRs

Bugfixes

  • #186 Fixes path handling for custom local/web path sources for service binary installation
  • #188 Removes hardcoded zones director-global and global-zones which were always set regardless of user specification. This fix will ensure the user has the option to add or not add these zones
  • #189 Fixes wrong documented user group for accessing Performance Counter objects which should be Performance Monitor Users
  • #192 Fixes code base for Invoke-IcingaCheckService by preferring to fetch the startup type of services by using WMI instead of Get-Services, as the result of Get-Services might be empty in some cases
  • #195 Fix Agent installer crash on package lookup with different files in directory
  • #196 Fix Icinga 2 .conf file generator to no longer generate invalid plain configuration files
  • #197 Fixes progress bar appearance on check outputs for certain plugins, by disabling the entire PowerShell progress bar during the usage of Icinga for Windows

icinga-powershell-framework-v1.3.1.tar.gz

Release tarball
application/gzip 2021-02-03 Download from Github