Monitoring the disk space used by HCL Workload Automation

You can use event-driven workload automation (EDWA) to monitor the disk space used by HCL Workload Automation and to start a predefined set of actions when one or more specific events take place. This type of event is managed by the TWSApplicationMonitor event provider. These types of events are supported on fault-tolerant agents only and not supported on dynamic agents. You can use EDWA to set up an event rule that monitors the used disk space, to verify that there is enough space to generate the Symphony and log files, and to allow the product to work correctly. For more information about event-driven workload automation, see the section about event-driven workload automation in the User's Guide and Reference .

When calculating disk space usage, the SSM agent divides the used space by the total space and then rounds up the result to the next highest integer. This is important to note especially when the usage is close to the specified threshold. See Example for the ge operator and Example for the le operator for examples on how this impacts the disk space usage calculation.

The following .XML file contains the definition of a sample event rule to monitor the disk usage percentage. This event rule triggers the MessageLogger action provider to write a message in a log file in an internal auditing database when the event occurs. For more information about the MessageLogger action provider, see MessageLogger actions :

<?xml version="1.0"?>
<eventRuleSet 	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
		xmlns="http://www.ibm.com/xmlns/prod/tws/1.0/event-management/rules"
		xsi:schemaLocation="http://www.ibm.com/xmlns/prod/tws/1.0/event-management/rules 
			http://www.ibm.com/xmlns/prod/tws/1.0/event-management/rules/EventRules.xsd">
	<eventRule name="FILESYSTEMFULL" ruleType="filter" isDraft="yes">
		<eventCondition name="twsDiskMonEvt1" eventProvider="TWSApplicationMonitor" eventType="TWSDiskMonitor">
			<scope>
				* Disk is filling up
			</scope>
			<filteringPredicate>
				<attributeFilter name="FillingPercentage" operator="ge">
					<value>usage_percentage</value>
				</attributeFilter>
				<attributeFilter name="Workstation" operator="eq">
					<value>workstation_name</value>
				</attributeFilter>
				<attributeFilter name="SampleInterval" operator="eq">
					<value>sample_interval</value>
				</attributeFilter>
				<attributeFilter name="MountPoint" operator="eq">
					<value>mount_point</value>
				</attributeFilter>

			</filteringPredicate>
		</eventCondition>
		<action actionProvider="MessageLogger" actionType="MSGLOG" responseType="onDetection">
			<scope>
				OBJECT=ADWDAD MESSAGE=Disk is filling up
			</scope>
			<parameter name="ObjectKey">
				<value>object_key</value>
			</parameter>
			<parameter name="Severity">
				<value>message_severity</value>
			</parameter>
			<parameter name="Message">
				<value>log_message</value>
			</parameter>
		</action>
	</eventRule>
</eventRuleSet>

where:

usage_percentage

Is the disk usage percentage.

Important: When creating the event rule, always use a whole integer in the range 1-99 (inclusive) to express the threshold value. Fractions, decimals and negative numbers are not supported and the event rule is ignored.

Supported operators are as follows:

ge

causes the event generation when the disk usage exceeds the percentage specified by the threshold value. If the condition described in the rule already exists when you deploy the rule, the related event is generated. If the condition does not exist at the time the rule is deployed, then the event is generated when the disk usage percentage reaches or exceeds the threshold. The event is generated again only if the disk usage percentage subsequently falls below the threshold value and then rises again and either reaches or exceeds the threshold. If you restart the SSM agent and the disk usage percentage is higher than the threshold value, the event is generated again.

Example for the ge operator provides an example in which the ge operator is set to 70%.

Table 1. Example for the ge operator
Mailbox name	Disk usage percentage	Action
Sample (0)	>= 70%	event generated
Sample (0)	< 70%	event not generated
Sample (n-1)	< 70%	event not generated
Sample (n)	>= 70%	event generated
Sample (n+1)	>= 70%	event not generated

le

causes the event generation when the disk usage percentage decreases under the threshold value. If the condition described in the rule already exists when you deploy the rule, the related event is not generated. The event is generated only the first time the specified disk usage percentage is reached. The event is generated again only if the disk usage percentage subsequently rises and exceeds the threshold value and then falls below the threshold. If you restart the SSM agent and the disk usage percentage is lower than the threshold value, the event is not generated until the disk usage percentage exceeds the threshold value and then falls below it again. Example for the le operator provides an example in which the le operator is set to 50%:

Table 2. Example for the le operator
Mailbox name	Disk usage percentage	Action
Sample (0)	<= 50%	event not generated
Sample (0)	> 50%	event not generated
Sample (n-1)	> 50%	event not generated
Sample (n)	<= 50%	event generated
Sample (n+1)	<= 50%	event not generated

workstation_name

Is the workstation on which the event is generated.

sample_interval

Is the interval, expressed in seconds, for monitoring the disk usage percentage.

mount_point

Is the mount point of the file system where HCL Workload Automation is installed, for example: "C:" on Windows™ systems or "/" on UNIX™ systems.

object_key

Is a key identifying the object to which the message pertains.

message_severity

Is the severity of the message.

log_message

Is the message to be logged.