Skip to content

Files

Latest commit

 

History

History
69 lines (46 loc) · 3.27 KB

09-Invoke-IcingaCheckMemory.md

File metadata and controls

69 lines (46 loc) · 3.27 KB

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