Icinga PowerShell - Monitoring Windows
Find a file
Lord Hepipud ff4a0b2bbc
Merge pull request #841 from Icinga:feature/adds_new_type_info_for_checks_and_packages
Feature: Adds new [INFO] state for notice and un-checked monitoring objects

Adds new [INFO] state for `New-IcingaCheck` and `New-IcingaCheckPackage`, to allow the printing of simple informational objects as well as telling the user, which objects are currently actively checked by the plugin engine.

```powershell
icinga> Invoke-IcingaCheckCPU -Verbosity 3;

[INFO] CPU Load (All must be [OK])
\_ [INFO] Overall Load: 8.714580%
\_ [INFO] Socket #0 (All must be [OK])
   \_ [INFO] Core 0: 22.63846%
   \_ [INFO] Core 1: 11.04723%
   \_ [INFO] Core 2: 0.672020%
   \_ [INFO] Core 3: 0.500612%
   \_ [INFO] Core Total: 8.714580%
| totalload::ifw_cpu::load=8.714580%;;;0;100 0_0::ifw_cpu::load=22.63846%;;;0;100 0_1::ifw_cpu::load=11.04723%;;;0;100 0_2::ifw_cpu::load=0.672020%;;;0;100 0_3::ifw_cpu::load=0.500612%;;;0;100 0_total::ifw_cpu::load=8.714580%;;;0;100
```


```powershell
icinga> Invoke-IcingaCheckProcess -Verbosity 3 -Process  WmiApSrv -MemoryWarning '1MB' -PageFileWarning '1KiB';

[WARNING] Process Overview: 1 Warning [WARNING] WmiApSrv (All must be [OK])
\_ [WARNING] WmiApSrv (All must be [OK])
   \_ [WARNING] WmiApSrv [16476] (All must be [OK])
      \_ [INFO] CPU Usage: 0%
      \_ [WARNING] Memory Usage: Value 1.67MiB is greater than threshold 976.56KiB
      \_ [INFO] Page File Usage: 2.30KiB
      \_ [INFO] Thread Count: 5c
   \_ [INFO] WmiApSrv Summary (All must be [OK])
      \_ [INFO] CPU Usage: 0%
      \_ [INFO] Memory Usage: 1.67MiB
      \_ [INFO] Page File Usage: 2.30KiB
      \_ [INFO] Process Count: 1c
      \_ [INFO] Thread Count: 5c
| wmiapsrv::ifw_process::cpu=0%;;;0;100 wmiapsrv::ifw_process::memory=1748992B;;;0;8583315000 wmiapsrv::ifw_process::pagefile=2352B;;;0;34359740000 wmiapsrv::ifw_process::count=1c;;;; wmiapsrv::ifw_process::threads=5c;;;;
```
2025-12-15 16:54:32 +01:00
cache Fixes broken Framework cache 2025-04-22 14:51:34 +02:00
certificate Fixes certificate folder not present on first installation 2022-08-24 16:59:02 +02:00
custom Added proper support for custom plugins / lib elements 2019-10-07 00:04:30 +02:00
doc Adds new [INFO] state for Icinga check and checkpage objects 2025-12-15 16:50:19 +01:00
jobs Fixes IfW service installation on certain Windows environment 2025-02-03 12:37:37 +01:00
lib Adds new [INFO] state for Icinga check and checkpage objects 2025-12-15 16:50:19 +01:00
RoleCapabilities Adds support for JEA profiles 2021-09-02 09:23:10 +02:00
templates Adds Windows 2025 support and updates copyright year 2025-01-30 16:31:28 +01:00
.gitattributes Adding gitattributes file 2019-12-17 17:58:45 +01:00
.gitignore Various memory leak fixes and improvements 2024-02-02 10:48:09 +01:00
icinga-powershell-framework.psd1 Updates master to v1.14.0 2025-01-30 17:26:50 +01:00
icinga-powershell-framework.psm1 Fixes Icinga for Windows to never load custom user profiles 2025-11-19 09:49:29 +01:00
LICENSE Create LICENSE 2019-11-04 16:16:04 +01:00
PSScriptAnalyzerSettings.psd1 Fixes lots of code styling, spelling and script analyzer 2022-01-14 22:26:53 +01:00
README.md Updates README.md with badges 2023-07-06 17:10:01 +02:00

PowerShell Version GitHub Tag GitHub Issues GitHub Pull Requests

Icinga PowerShell Framework

The Icinga PowerShell Framework provides a wide range of configuration and check possibilities to ensure an easy integration and full monitoring of Windows environments. Each single chapter of this documentation will describe parts of the module and the possibilities.

Before you continue, please take a look at the Installation Guide

Documentation

Please take a look at the following content to get to know the possibilities of the module including examples on how to use it.

Developer Guide

If you wish to extend the Framework by yourself or write custom plugins for your environment, please have a look at the Developer Guide for detailed explanations of functions and code examples.

Contributing

The Icinga PowerShell Framework is an Open Source project and lives from your contributions. No matter whether these are feature requests, issues, translations, documentation or code.

  • Please check whether a related issue alredy exists on our Issue Tracker
  • Send a Pull Request
  • The master branch shall never be corrupt!