Sign-up for the Orb newsletter

and get product news, info and tips...

File Details Agent

The Orb Data File Details Agent collects file or directory data from Windows servers using regular expressions to identify the files and directories.

File Monitoring

Many applications that form the backbone of customer solutions rely on the creation and timely processing of files and/or directories. Those file/directory names are commonly dynamic, often including transaction IDs or date and time stamps. Although the Windows OS Agent File Trend Attribute Group can collect data on files and directories the selected Watch name is a literal string, making it redundant for many applications. This agent is designed to resolve this problem, enabling data to be collected from files/directories matching one or more predefined regular expression.

The search can be limited to a single directory or a specified number of sub-directories. Data collected can then form the basis for a standard Situation formula, for example generating a situation event when the file creation time is greater than one hour old, a condition that may indicate that the application has stopped processing in-bound data.
The Orb Data File Details Agent is built on IBM Tivoli Monitoring 6.2.3 Agent Builder technology. It includes support for the Self-defining agent feature and is shipped with the TCR Cognos data model for reports generation.

File Details

The File Details Agent gathers file and directory data based on a local configuration file. The file can define one or more regular expression based search to identify the files or directories from which to collect data.

For example, an application may receive files for processing in the directory C:\Application\input , with the file names in the format IN-##########.csv. It may be expected that the application processes the information in each file within 5 minutes. In this scenario the File Details Agent may be configured to search the directory C:\Application\input for files using the regular expression match IN-[\d]{10}.csv. The size and time stamp data would be collected and a situation defined to alert if the create time stamp is greater than 5 minutes old.

 

File Details Agent - Search Details Workspace

 

 In addition, to the file or directory details the agent also provides:

  • Summary information for each search, including the total number of files/directories  that matched the specific search
  • Remote visibility of the configuration file
  • Runtime Messages from the underlying data gathering process

File Details Agent - Search Summary Workspace

 

Features and Benefits

  • Multiple file and directory searches can be initiated
  • UNC Paths supported
  • Optional Integration with Orb Data Self-Service Portal
  • Associated Application, Process or Service data displayed in the TEP Client

Situations

The following situations are supplied with the agent:

Situation Severity Description
FD_Summary_Count_W Warning One or more files/directories exists in the specified search directory has exceeded 1
FD_Runtime_Message_C Critical A FATAL message has been nlogged by the file details agent
FD_Runtime_Message_M Minor An ERROR message has been nlogged by the file details agent
FD_Runtime_Message_W Warning A WARNING message has been nlogged by the file details agent
FD_PerformanceObj_SlowResponse_W Warning The data collection for the agent took longer than 10 seconds

Configuration

The agent can be configured to search one or more directory using regular expressions to identify the files/directories of interest.

This file can be maintained locally, or centrally using a tool such as the Orb Data Self Service Portal or the ITM Centralized Configuration feature.

Support

Version 1.0 of the agent supports the Windows 32/64 bit operating systems.

The Orb Data File Details Agent is built on IBM Tivoli Monitoring 6.2.3 Agent Builder technology. It includes support for the Self-defining agent feature and is shipped with the TCR Cognos data model for reports generation.



 

Add your comment

Type the characters you see in the picture below




Display #