utilFs

The utilFs event producer monitors the utilization of a file system.

Overview

The utilFs event producer monitors the utilization of a file system as a percentage. It resides under the fs directory. Currently, only JFS2 file systems support utilFs monitoring. Upon every file write, file creation and file deletion, the utilization of the file system is checked to see if it meets or exceeds the given threshold. There may be some file system specific operations which can affect the utilization of the file system, but utilFs may not be able to detect them until the next file write, creation or deletion. Thresholds which are exceeded due to the result of a file object deletion will not be notified until the next file write, create or deletion.

File systems with a monitor file path name larger than MAXPATHLEN in AHAFS cannot be monitored.

To avoid a flood of event notifications and potential performance impacts, it is highly recommended that utilFs events are monitored with a NOTIFY_CNT of 1.

Capabilities

AHAFS_THRESHOLD_VALUE_HIGH
AHAFS_THRESHOLD_VALUE_LOW
AHAFS_REMOTE_EVENT_ENABLED

Thresholds specified must be between 1 and 100, inclusive.

Return codes

The utilFs event producer uses return codes which are defined in <sys/ahafs_evProds.h>.

These return codes are used to indicate how the contents of the monitored directory were modified:

AHAFS_UTILFS_THRESH_HIT

The file system being monitored has reached the threshold specified.

AHAFS_UTILFS_UNMOUNT

The file system being monitored has been unmounted. This is an unavailable event.

Event producer message

This event producer does not pass any messages as part of its event data.

Acceptable monitor files

To monitor for file system utilization, a monitor file with the same path as the mount point of the file system to be monitored should be created under the utilFs.monFactory directory. For example, to monitor the file system /data/fs1, the monitor file /aha/fs/utilFs.monFactory/data/fs1.mon would be used.

Example event data

The following is event data from an AHAFS_UTILFS_THRESH_HIT event for an INFO_LVL of 3:

BEGIN_EVENT_INFO
TIME_tvsec=1271705858
TIME_tvnsec=704241888
SEQUENCE_NUM=0
CURRENT_VALUE=10
RC_FROM_EVPROD=1000
END_EVENT_INFO