References > Component Monitor Types > Directory Size Monitor

Directory Size monitor

This component monitor determines the disk space used by the files in a directory, optionally including all subdirectories. Files that do not match the File Extensions Filter are not included in the disk space calculation.

It may be difficult to monitor the size of a folder containing hundreds or thousands of files, because the monitor timeout duration may lapse before the target computer can finish computing the file sizes and sending the response.

Statistic

The disk space used in bytes.

Agent-less or Orion agent for Windows requirements

Implementation of these components relies either on WMI or windows file share access to the target machine.

Orion agent for Linux requirements

Python implementation leverages native filesystem access directly from the python script running locally on the target agent machine. Due to the configuration settings, switching between agent-less and Orion agent for Linux will not establish a correct connection as the file path in UNC format will not work on a Linux-based computer. For details, see Linux system configurations for component monitors.

Field Descriptions

Description

This field provides a default description of the monitor. You have the ability to override the default description by adding to or replacing the text, which is automatically saved. The variable to access this field is ${UserDescription}.

Enable Component

Determines whether the component is enabled. Disabling the component leaves it in the application in a deactivated state not influencing either SolarWinds SAM application availability or status.

Credential for Monitoring

Select a credential that has read access to the file. If the credential you need is not already present in the credentials list, use the Quick Credentials section to add a new credential.

Full directory Path

The path to the monitored directory. Specify the path in Universal Naming Convention (UNC) format. For example: \\computername\c$\logfiles\. The path can include the variable ${IP}, which represents the target node's IP address.

File Extensions Filter

Determines which file extensions are included in the disk space usage calculations for the directory size. It is a text matching filter, and * is a wildcard.

Include Subdirectories

Determines whether the contents of sub-directories are included in the disk space usage calculations for the directory size.

Convert Value

Checking the Convert Value check box opens the Formula box. From here, you have the ability to manipulate the returned value with a variety of mathematical possibilities. You can choose common functions from the drop down lists to manipulate the returned value, or you can select the Custom Conversion option. For more information, see Conversion value.

Statistic Threshold

This field allows you to specify when a threshold that indicates a warning or critical level has been breached. Logical operators are in the drop down followed by a blank field for you to enter the value of this threshold. For example: Less than 15 for warning and Less than 5 for critical. See setting Application Monitor Thresholds for more information.

User Notes

This field allows you to add notes for easy reference. You can access this field by using the variable, ${UserNotes}.