Directory Scan monitoring default checks and policies

Checks the number of files present in a given directory and compares it to the provided warning and critical thresholds. Returns a CRITICAL, WARNING, or OK event based on the critical and warning thresholds.

Note:

• Counts the number of files inside the directory, not including files in subdirectories.
• The agent requires read and execute permissions on the directory being monitored.

check-directory-file-count.rb (options)

-d, --dir Absolute path to the directory to count the files (required)

-w, --warning Warning threshold (required)

-c, --critical Critical threshold (required)

-H, include_hidden_files Set active to true to include hidden files while counting (default is false)

Usage Example:

check-directory-file-count.rb -d /path/to/directory -w 50 -c 100

Compares the last modified time of the directory with the current time to determine if any updates have occurred within a defined time interval. Based on this comparison, the check returns a CRITICAL or OK event.

Note: The agent requires read and execute permissions on the directory being monitored.

commonchecks check-directory-integrity (options)

-d, --dirpath DIRPATH: Absolute path to the directory to check (required).

-i, --interval INTERVAL: Time interval in seconds to check for recent updates (required). Default value can be set to 180 seconds.

Usage example:

commonchecks check-directory-update -d /path/to/directory -i 180

Evaluates the age of a specified file by comparing its last modification time with the current time. Raises an alert if the file exceeds the defined critical or warning age thresholds.

Note: The agent requires read and execute permissions on the file being monitored.

commonchecks check-file-age (options)-f, --filepath FILEPATH: Absolute path to the file to check (required).

-c, --critical CRITICAL: Critical age threshold in minutes for the file (required).

-w, --warning WARNING: Warning age threshold in minutes for the file (required).

Usage example:commonchecks check-file-age -f /path/to/file.txt -c 120 -w 60

Compares the time needed to read a specified file and compares it with the critical and warning thresholds. Based on this comparison, the check returns a CRITICAL or OK event.

Note: The agent requires read and execute permissions on the file being monitored.

commonchecks check-file-response-time (options)-f, --filepath FILEPATH: Absolute path to the file to check (required).

-c, --critical CRITICAL: Critical threshold in seconds for file response time (required).

-w, --warning WARNING: Warning threshold in seconds for file response time (required).

-t, --timeout TIMEOUT: Maximum time allowed for reading the file content, specified in seconds. Time out value must be greater than the critical threshold value.

Usage example:commonchecks check-file-response-time -f /var/log/servicenow/agent-client-collector/acc.log -c 10 -w 5 -t 20

Measures the size of a file (the actual amount of data it contains) and compares it against specified thresholds. Returns a CRITICAL, WARNING, or OK event based on the comparison of the file size and the thresholds.

Note: The agent requires read and execute permissions on the file being monitored.

commonchecks check-file-size (options)-f, --filepath FILEPATH Absolute path to the required file (required).

-c, --critical CRITICAL. Critical threshold in kilobytes. Provide as a number without units (for example, 1000 for 1000 KB) (required)

-w, --warning WARNING. Warning threshold in kilobytes. Provide as a number without units (for example, 500 for 500 KB) (required)

Usage example:commonchecks check-file-size -f C:\ProgramData\ServiceNow\agent-client-collector\config\acc.yml

Measures the size of a file on disk against specified thresholds, returning a CRITICAL, WARNING, or OK event based on the thresholds.

Note: The agent requires read and execute permissions on the file being monitored.

commonchecks check-file-space (options)-f, --filepath FILEPATH: Absolute path to the relevant file (required).

-c, --critical CRITICAL: Critical threshold in kilobytes. Provided as a number without units (for example, 1000 for 1000 KB) (required)

-w, --warning WARNING: Warning threshold in kilobytes. Provided as a number without units (for example, 500 for 500 KB) (required)

-b, --blocksize BLOCKSIZE: Block size in bytes (Default = 4096) (required)

Usage example:

commonchecks check-file-space -f C:\ProgramData\ServiceNow\agent-client-collector\config\acc.yml

winchecks check-dir-space (options)-d, --dirpath DIRPATH: Absolute path to the directory being checked (required).

-c, --critical CRITICAL: Critical disk space threshold in kilobytes (required).

-w, --warning WARNING: Warning disk space threshold in kilobytes (required).

-t, --timeout TIMEOUT: Maximum time allowed for directory size calculation, specified in seconds (required).

Usage example:winchecks check-dir-space -d /path/to/directory -c 1000 -w 500 -t 120

Checks the number of files present in a given directory and compares it to the provided warning and critical thresholds. Returns a CRITICAL, WARNING, or OK event based on the critical and warning thresholds.

Note:

• Counts the number of files inside the directory, not including files in subdirectories.
• The agent requires read and execute permissions on the directory being monitored.

check-directory-file-count.rb (options)

-d, --dir Absolute path to the directory to count the files (required)

-w, --warning Warning threshold (required)

-c, --critical Critical threshold (required)

-H, include_hidden_files Set active to true to include hidden files while counting (default is false)

Usage Example:

check-directory-file-count.rb -d /path/to/directory -w 50 -c 100

Compares the last modified time of the directory with the current time to determine if any updates have occurred within a defined time interval. Based on this comparison, the check returns a CRITICAL or OK event.

Note: The agent requires read and execute permissions on the directory being monitored.

commonchecks check-directory-integrity (options)

-d, --dirpath DIRPATH: Absolute path to the directory to check (required).

-i, --interval INTERVAL: Time interval in seconds to check for recent updates (required). Default value can be set to 180 seconds.

Usage example:

commonchecks check-directory-update -d /path/to/directory -i 180

Evaluates the age of a specified file by comparing its last modification time with the current time. Raises an alert if the file exceeds the defined critical or warning age thresholds.

Note: The agent requires read and execute permissions on the file being monitored.

commonchecks check-file-age (options)-f, --filepath FILEPATH: Absolute path to the file to check (required).

-c, --critical CRITICAL: Critical age threshold in minutes for the file (required).

-w, --warning WARNING: Warning age threshold in minutes for the file (required).

Usage example:commonchecks check-file-age -f /path/to/file.txt -c 120 -w 60

Compares the time needed to read a specified file and compares it with the critical and warning thresholds. Based on this comparison, the check returns a CRITICAL or OK event.

Note: The agent requires read and execute permissions on the file being monitored.

commonchecks check-file-response-time (options)-f, --filepath FILEPATH: Absolute path to the file to check (required).

-c, --critical CRITICAL: Critical threshold in seconds for file response time (required).

-w, --warning WARNING: Warning threshold in seconds for file response time (required).

-t, --timeout TIMEOUT: Maximum time allowed for reading the file content, specified in seconds. Time out value must be greater than the critical threshold value.

Usage example:commonchecks check-file-response-time -f /var/log/servicenow/agent-client-collector/acc.log -c 10 -w 5 -t 20

Measures the size of a file (the actual amount of data it contains) and compares it against specified thresholds. Returns a CRITICAL, WARNING, or OK event based on the comparison of the file size and the thresholds.

Note: The agent requires read and execute permissions on the file being monitored.

commonchecks check-file-size (options)-f, --filepath FILEPATH Absolute path to the required file (required).

-c, --critical CRITICAL. Critical threshold in kilobytes. Provide as a number without units (for example, 1000 for 1000 KB) (required)

-w, --warning WARNING. Warning threshold in kilobytes. Provide as a number without units (for example, 500 for 500 KB) (required)

Usage example:commonchecks check-file-size -f C:\ProgramData\ServiceNow\agent-client-collector\config\acc.yml

Measures the size of a file on disk against specified thresholds, returning a CRITICAL, WARNING, or OK event based on the thresholds.

Note: The agent requires read and execute permissions on the file being monitored.

commonchecks check-file-space (options)-f, --filepath FILEPATH: Absolute path to the relevant file (required).

-c, --critical CRITICAL: Critical threshold in kilobytes. Provided as a number without units (for example, 1000 for 1000 KB) (required)

-w, --warning WARNING: Warning threshold in kilobytes. Provided as a number without units (for example, 500 for 500 KB) (required)

-b, --blocksize BLOCKSIZE: Block size in bytes (Default = 4096) (required)

Usage example:

commonchecks check-file-space -f C:\ProgramData\ServiceNow\agent-client-collector\config\acc.yml

linuxchecks check-directory-size (options)-d, --dirpath DIRPATH: Absolute path to the directory being checked (required).

-c, --critical CRITICAL: Critical disk space threshold in kilobytes (required).

-w, --warning WARNING: Warning disk space threshold in kilobytes (required).

-t, --timeout TIMEOUT: Maximum time allowed for directory size calculation, specified in seconds (required).

Usage example:linuxchecks check-directory-size -d path/to/directory -c 100 -w 50 -t 30

linuxchecks check-directory-space (options)-d, --dirpath DIRPATH: Absolute path to the directory being checked (required).

-c, --critical CRITICAL: Critical disk space threshold in kilobytes (required).

-w, --warning WARNING: Warning disk space threshold in kilobytes (required).

-t, --timeout TIMEOUT: Maximum time allowed for directory size calculation, specified in seconds (required).

Usage example:linuxchecks check-directory-space -d /path/to/directory -c 10 -w 5 -t 30