sensu-windows-powershell-checks

Collection of Windows Powershell checks for Sensu

check-windows-http.ps1

Help

> check-windows-http.ps1 -?
NAME
    check-windows-http.ps1
    
SYNOPSIS
    This plugin checks availability of url provided as param. Optionally checks if substring exists in url content
    
SYNTAX
    check-windows-http.ps1 [-CheckAddress] <String> [[-ContentSubstring] <String>] [<CommonParameters>]

Param 1: CheckAddress

Required. Use valid http or https URL ex: https://sensu.io

Param 2: ContentSubString

Optional. Substring to match inside returned URL content.

Asset command usage

Powershell.exe -NonInteractive -NoProfile -ExecutionPolicy Bypass -NoLogo -Command check-windows-http.ps1  https://sensu.io monitoring

check-windows-disk.ps1

Help

> check-windows-disk.ps1 -?
NAME
    check-windows-disk.ps1
    
SYNOPSIS
    This plugin collects the Disk Usage and and compares against the WARNING and CRITICAL thresholds.
    
    
SYNTAX
    check-windows-disk.ps1 [-WARNING] <Int32> [-CRITICAL] <Int32> [[-IGNORE] <String>] [<CommonParameters>]
    
    
DESCRIPTION
    This plugin collects the Disk Usage and and compares against the WARNING and CRITICAL thresholds.

Param 1: Warning

Required. Warning disk usage percentage threshold.
Example -Warning 90

Param 2: Critical

Required. Critical disk usage percentage threshold.
Example -Critical 95

Param 3: Ignore

Optional. DeviceID regular expression to ignore.

Asset command usage

Powershell.exe -NonInteractive -NoProfile -ExecutionPolicy Bypass -NoLogo -Command check-windows-disk.ps1 90 95

check-windows-event-log.ps1

Help

> check-windows-event-log.ps1 -?

NAME
    check-windows-event-log.ps1
    
SYNOPSIS
    Returns all occurances of pattern in log file
    
    
SYNTAX
    check-windows-event-log.ps1 [-LogName] <String> [-Pattern] <String> 
    [[-CriticalLevel] <Int32>] [[-WarningLevel] <Int32>] [<CommonParameters>]
    
DESCRIPTION
    Checks Event log for pattern and returns the number criticals and warnings that match that pattern.

Param 1: LogName

Required. The name of the log file.
Example -LogName Application

Param 2: Pattern

Required. The pattern you want to search for.
Example -LogName Application -Pattern error

Param 3: CriticalLevel

Optional. Integer Event Log Level to trigger Critical return status. Defaults to 2 = Error.
Example -LogName Application -Pattern error -CriticalLevel 2

Param 4: WarningLevel

Optional. Integer Event Log Level to trigger Warning return status.  Defaults to 3 = Warning.
Example -LogName Application -Pattern error -WarningLevel 3

Asset command usage

Powershell.exe -NonInteractive -NoProfile -ExecutionPolicy Bypass -NoLogo -Command check-windows-event-log.ps1 -LogName Application -Pattern error

check-windows-disk-writeable.ps1

Help

> check-windows-disk-writeable.ps1 -?
NAME
    check-windows-disk-writeable.ps1
    
SYNOPSIS
    This plugin collects the mounted logical disks and tests they are writeable.
    
    
SYNTAX
    check-windows-disk-writeable.ps1 [[-DriveType] <String>] [[-Ignore] <String>] 
      [[-TestFile] <String>] [<CommonParameters>]
    
    
DESCRIPTION
    This plugin collects the mounted logical disks and tests they are writeable.

Param 1: DriveType

Optional. DriveType,
see available options at https://msdn.microsoft.com/en-us/library/windows/desktop/aa364939(v=vs.85).aspx
Specify multiple values as a comma separated string, e.g. "3,5"

Param 2: Ignore

Optional. Disk letters to ignore
Specify multiple values as a comma separated string, e.g. "C,D"

Param 3: TestFile

Optional. Test file to create on each disk to test it is writeable

Asset command usage

Powershell.exe -NonInteractive -NoProfile -ExecutionPolicy Bypass -NoLogo -Command check-windows-disk-writeable.ps1 -DriveType '3,5' -Ignore 'A,B' -TestFile '\test.txt'

check-windows-directory.ps1

Help

> check-windows-disk-directory.ps1 -?
NAME
    check-windows-directory.ps1
    
SYNOPSIS
    Checks if  directory exist
    
    
SYNTAX
    check-windows-directory.ps1 [-Dir] 
    <String> [<CommonParameters>]
    
    
DESCRIPTION
    Checks if directory exist

Param 1: Dir

Required. The name of the directory.
Example -Dir C:\Users\dir

Asset command usage

Powershell.exe -NonInteractive -NoProfile -ExecutionPolicy Bypass -NoLogo -Command check-windows-directory.ps1 -Dir C:\Users\dir

check-windows-ram.ps1

Help

> check-windows-ram.ps1 -?
NAME
    check-windows-ram.ps1

SYNOPSIS
    This plugin collects the RAM Usage and compares against the WARNING and CRITICAL thresholds.
    
SYNTAX
    check-windows-ram.ps1 [-WARNING] 
    <Int32> [-CRITICAL] <Int32> [<CommonParameters>]

Param 1: Warning

Required. Warning ram usage percentage threshold

Param 1: Critical

Required. Critical rame usage percentage threshold

Asset command usage

Powershell.exe -NonInteractive -NoProfile -ExecutionPolicy Bypass -NoLogo -Command check-windows-ram.ps1 90 95

check-windows-process.ps1

Help

> check-windows-process.ps1 -?
NAME
    check-windows-process.ps1
    
SYNOPSIS
    This plugin checks whether a User-inputted process is running or not.
    
    
SYNTAX
    check-windows-process.ps1 [-ProcessName] <String> [<CommonParameters>]

Param 1: ProcessName

Required. Name of user process to check

Asset command usage

Powershell.exe -NonInteractive -NoProfile -ExecutionPolicy Bypass -NoLogo -Command check-windows-process.ps1 powershell

check-windows-cpu-load.ps1

Help

> check-windows-cpu-load.ps1 -?
NAME
    check-windows-cpu-load.ps1
    
SYNOPSIS
    This plugin collects the CPU Usage and compares against the WARNING and CRITICAL thresholds.
    
    
SYNTAX
    check-windows-cpu-load.ps1 [-WARNING] 
    <Int32> [-CRITICAL] <Int32> [<CommonParameters>]

Param 1: Warning

Required. Warning cpu load percentage threshold

Param 1: Critical

Required. Critical cpu load percentage threshold

Asset command usage

Powershell.exe -NonInteractive -NoProfile -ExecutionPolicy Bypass -NoLogo -Command check-windows-cpu-load.ps1 90 95

check-windows-processor-queue-length.ps1

Help

> check-windows-processor-queue-length.ps1 -?
NAME
    check-windows-processor-queue-length.ps1
    
SYNOPSIS
    This plugin collects the Processor Queue Length and compares against the WARNING and CRITICAL thresholds.
    
    
SYNTAX
    check-windows-processor-queue-length.ps1 [-WARNING] 
    <Int32> [-CRITICAL] <Int32> [<CommonParameters>]

Param 1: Warning

Required. Warning processor queue length threshold

Param 1: Critical

Required. Critical processor queue length threshold

Asset command usage

Powershell.exe -NonInteractive -NoProfile -ExecutionPolicy Bypass -NoLogo -Command check-windows-processor-queue-length.ps1 5 10

check-windows-pagefile.ps1

Help

> check-windows-pagefile.ps1 -?
NAME
    check-windows-pagefile.ps1
    
SYNOPSIS
    This plugin collects the Pagefile Usage and compares against the WARNING and CRITICAL thresholds.
    
SYNTAX
    check-windows-pagefile.ps1 [-WARNING] 
    <Int32> [-CRITICAL] <Int32> [<CommonParameters>]

Param 1: Warning

Required. Warning pagefile usage percentage threshold

Param 1: Critical

Required. Critical pagefile usage percentage threshold

Asset command usage

Powershell.exe -NonInteractive -NoProfile -ExecutionPolicy Bypass -NoLogo -Command check-windows-pagefile.ps1 75 85

check-windows-log.ps1

Help

> check-windows-log.ps1 -?

NAME
    check-windows-log.ps1
    
SYNOPSIS
    Returns all occurances of pattern in log file
    
SYNTAX
    check-windows-log.ps1 [-LogPath] <String> [-Pattern] <String> [<CommonParameters>]
    
DESCRIPTION
    Checks log file for pattern and returns line(s) containing pattern

Param 1: LogPath

Required. The path of the log file.
Example -LogPath example.log

Param 2: Pattern

Required. The pattern you want to search for.
Example -LogPath example.log -Pattern error

Asset command usage

Powershell.exe -NonInteractive -NoProfile -ExecutionPolicy Bypass -NoLogo -Command check-windows-log.ps1 -LogPath example.log -Pattern error

check-windows-service.ps1

Help

> check-windows-service.ps1 -?
NAME
    check-windows-service.ps1
    
SYNOPSIS
    This plugin checks whether a User-inputted Windows service is running or not.
    
    
SYNTAX
    check-windows-service.ps1 [-ServiceName] <String> [<CommonParameters>]

Param 1: ServiceName

Required.  Service name to check.

Asset command usage

Powershell.exe -NonInteractive -NoProfile -ExecutionPolicy Bypass -NoLogo -Command check-windows-service.ps1 sshd