Invoke-IcingaCheckMemory¶
Description¶
Checks on memory usage
Invoke-IcingaCheckMemory returns either ‘OK’, ‘WARNING’ or ‘CRITICAL’, based on the thresholds set. e.g memory is currently at 60% usage, WARNING is set to 50%, CRITICAL is set to 90%. In this case the check will return WARNING.
More Information on https://github.com/Icinga/icinga-powershell-plugins
Permissions¶
To execute this plugin you will require to grant the following user permissions.
Performance Counter¶
- \Memory\% committed bytes in use
- \Memory\Available Bytes
- \Paging File(_Total)\% usage
Required User Groups¶
- Performance Monitor Users
Arguments¶
| Argument | Type | Required | Default | Description |
|---|---|---|---|---|
| Warning | Object | false | Used to specify a Warning threshold. In this case an string value. The string has to be like, “20B”, “20KB”, “20MB”, “20GB”, “20TB”, “20PB” This is using the default Icinga threshold handling. It is possible to enter e.g. 10% as threshold value if you want a percentage comparison. |
|
| Critical | Object | false | Used to specify a Critical threshold. In this case an string value. The string has to be like, “20B”, “20KB”, “20MB”, “20GB”, “20TB”, “20PB” This is using the default Icinga threshold handling. It is possible to enter e.g. 10% as threshold value if you want a percentage comparison. |
|
| PageFileWarning | Object | false | Allows to check the used page file and compare it against a size value, like “200MB” This is using the default Icinga threshold handling. It is possible to enter e.g. 10% as threshold value if you want a percentage comparison. |
|
| PageFileCritical | Object | false | Allows to check the used page file and compare it against a size value, like “200MB” This is using the default Icinga threshold handling. It is possible to enter e.g. 10% as threshold value if you want a percentage comparison. |
|
| IncludePageFile | Array | false | @() | Allows to filter for page files being included for the check |
| ExcludePageFile | Array | false | @() | Allows to filter for page files being excluded for the check |
| Verbosity | Int32 | false | 0 | |
| NoPerfData | SwitchParameter | false | False | |
| ThresholdInterval | String | Change the value your defined threshold checks against from the current value to a collected time threshold of the Icinga for Windows daemon, as described here. An example for this argument would be 1m or 15m which will use the average of 1m or 15m for monitoring. |
Examples¶
Example Command 1¶
Invoke-IcingaCheckMemory -Verbosity 3 -Warning 60 -Critical 80
Example Output 1¶
[WARNING]: % Memory Check 78.74 is greater than 60
Example Command 2¶
Invoke-IcingaCheckMemory -WarningPercent 30 -CriticalPercent 50
Example Output 2¶
[WARNING] Check package "Memory Usage" - [WARNING] Memory Percent Used
\_ [WARNING] Memory Percent Used: Value "48.07%" is greater than threshold "30%"
| 'memory_percent_used'=48.07%;0:30;0:50;0;100 'used_bytes'=3.85GB;;;0;8
1