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.12.0 latest

1.12.0 (2024-03-26)

Issues and PRs

Bugfixes

  • #673 Fixes a memory leak while fetching Windows EventLog information by using CLI tools and inside the Hyper-V provide
  • #678 Fixes various memory leaks in Icinga for Windows API core and check handler
  • #680 Fixes exception in some cases, when provider or metrics return values as null instead of 0 while units are being used for check objects
  • #683 Fixes JEA installer to exclude domain from user name length check, which can easily exceed the Windows 20 digits username limit
  • #685 Fixes an issue while trying to stop the JEA process in certain cases, which results in an error during installation but has no other effect on the environment
  • #686 Fixes certutil error handling and message output in case the icingaforwindows.pfx could not be created
  • #687 Fixes Icinga for Windows port handling on installation, which will now use the proper defined port for communicating with the Icinga CA
  • #699 Fixes Icinga for Windows password management for the managed user icinga, which could fail in some cases because of ambiguous characters or complexity errors and will now retry up to 10 times before giving up
  • #702 Fixes an issue with Icinga Director Self-Service API, which ignored the defined service user

Enhancements

  • #313 Adds IWKB entry IWKB000017 handling issues with failed checks once SCOM is uninstalled as example
  • #587 Adds support to create own snapshot repositories with New-IcingaRepository
  • #631 Deduplicates -C try { Use-Icinga ... boilerplate by adding it to the PowerShell Base template and removing it from every single command
  • #669 Adds new metric to the CPU provider, allowing for distinguishing between the average total load as well as the sum of it
  • #679 Adds a new data provider for fetching process information of Windows systems, while sorting all objects based on a process name and their process id
  • #682 Adds new data provider for fetching Eventlog information to increase performance and reduce memory impact
  • #688 Adds new handling to add scheduled tasks in Windows for interacting with Icinga for Windows core functionality as well as an auto renewal task for the Icinga for Windows certificate generation
  • #690 Adds automatic renewal of the icingaforwindows.pfx certificate for the REST-Api daemon in case the certificate is not yet present, valid or changed during the runtime of the daemon while also making the icingaforwindows.pfx mandatory for all installations, regardless of JEA being used or not
  • #692 Renames Restart-IcingaWindowsService to Restart-IcingaForWindows and adds alias for backwards compatibility to start unifying the Icinga for Windows cmdlets
  • #693 Adds new command Restart-Icinga to restart both, the Icinga Agent and Icinga for Windows
  • #694 Adds support for check objects not being added to summary header
  • #695 Adds security hardening to JEA profiles by always prohibit certain cmdlets
  • #700 Adds feature to support using pipes and multi lines for plugin documentation
  • #701 Adds new command Test-IcingaForWindows to check the current environment health by also improving internal handlings on how service information are fetched, preventing a lock on those

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

Release tarball
application/gzip 2024-03-26 Download from Github

Release Icinga for Windows v1.11.1

1.11.1 (2023-11-07)

Issues and PRs

Bugfixes

  • #659 Fixes configuration writer which publishes invalid Icinga plain configuration files
  • #660 Fixes Update-Icinga not updating to the latest available version for a component and specifying -Version is updating to the latest one instead of the given one instead
  • #661 Fixes Icinga Agent installation and uninstallation, which could cause unintended automatic reboots
  • #662 Fixes JEA-Profiles always being updated during Update-Icinga calls, even when no component or non JEA related components were updated
  • #664 Fixes JEA profile compiler not including REST-Api configuration during first installation

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

Release tarball
application/gzip 2023-11-07 Download from Github

Release Icinga for Windows v1.11.0

1.11.0 (2023-08-01)

Issues and PRs

Bugfixes

  • #579 Fixes error message during config generation with Get-IcingaCheckCommandConfig to make it more clear, in case the custom variables generated are too long for the Icinga Director import
  • #603 Fixes service filter to handle exclude with wildcards instead of requiring the full service name (not applying to the display name)
  • #609 Fixes config generator to never use set_if = true on Icinga 2/Icinga Director configuration
  • #611 Fixes Sync-IcingaRepository which did not save the SSH user and host inside the repository configuration, preventing Update-IcingaRepository to work properly and added missing scp progress
  • #615 Fixes the framework migration tasks which fails in case multiple versions of the framework are installed, printing warnings in case there is
  • #617 Fixes failing calls for plugins which use a switch argument like -NoPerfData, which is followed directly by the -ThresholdInterval argument
  • #621 Fixes -ThresholdInterval key detection on newer systems
  • #634 Fixes an issue with Clear-Host which could cause an exception during certain automation tasks, causing it to fail
  • #645 Fixes error and exception handling while using API-Checks, which now will in most cases always return a proper check-result object and also abort while running into plugin execution errors, in case a server is not reachable by the time sync plugin for example
  • #646 Fixes REST-Api to allow arguments for check execution with and without leading -
  • #648 Fixes some memory management while using the REST-Api to clear connection objects once they are no longer required

Enhancements

  • #544 Adds support to configure the Icinga Director JSON string for registering hosts via self-service API
  • #572 Adds support to write the name of the repository synced/created into the local ifw.repo.json file
  • #573 Adds support to run command icinga with new argument -NoNewInstance, to use -RebuildCache as example to update the current PowerShell instance with all applied changes
  • #613 Adds a -Version parameter to the Update-Icinga command, to be able to update a component to a specified version [@log1-c]
  • #619 Adds feature to securely read enum provider values with new function Get-IcingaProviderEnumData
  • #623 Adds support to provide the Icinga service user written as user@domain
  • #633 Adds support for Icinga 2.14.0 native Icinga for Windows API communication
  • #635 Adds support for Write-IcingaAgentApiConfig function to configure the Icinga Agent TLS cipher list setting by new argument -CipherList
  • #637 Adds new base handling for future data providers with first metrics for CPU information
  • #638 Adds option for formatted, colored console prints with Write-ColoredOutput
  • #640 Adds support to set the flag -NoSSLValidation for Cmdlets icinga and Install-Icinga, to ignore errors on self-signed certificates within the environment
  • #643 Adds support for -RebuildCache flag on icinga cmd to rebuild component cache as well
  • #644 Adds progress bar output to repository interaction (sync, update, new) instead of plain text output
  • #649 Adds new basic data provider base for Hyper-V information
  • #655 Adds IWKB and test/manage Cmdlets for SCOM intercept counters
  • #656 Adds new feature to write document content easier by storing it in memory first and then allowing to write it to disk at once with proper UTF8 encoding

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

Release tarball
application/gzip 2023-08-01 Download from Github
Newer Older