Log and Configuration Event Tracking

This page is an overview of the event tracking capabilities in VMware vFabric™ Hyperic®.

Hyperic Log Tracking Overview

System problems can often be detected or diagnosed from messages generated by operating systems, application servers, network services, or middleware throughout the environment. Hyperic can monitor messages in log files and in memory, and record events in the Hyperic database based on criteria you specify.

Hyperic Resource Types that Support Log Tracking

Hyperic supports log tracking for operating system platforms, network services, and most server types. If a resource supports log tracking, its Configuration Properties page contains log tracking configuration options.

Supported Log Message Types

Hyperic can monitor and record log events for:

  • Log file messages that specify log levels using log4j log levels.

  • Events written to Windows Event Logs.

  • Network request results for a variety of network services.

Log Tracking Configuration Options

You enable and configure log tracking for a resource on its Configuration Properties page. Navigate to the resource's Inventory page, and click Edit in the Configuration Properties section to display the Configuration Properties page.

Note: Log and configuration tracking must be enabled for a resource if you wish to log events for log messages or configuration changes. Event logging is automatic for alerts and control actions. Log tracking configuration options vary somewhat by resource type.

Log tracking options vary by resource type.

How to Set Up Log Tracking

For information about configuring log tracking see Set Up Log Tracking for a Resource in vFabric Hyperic Administration.

Hyperic Configuration Tracking Overview

You can configure Hyperic to log an event when specified files — usually configuration artifacts — associated with a managed resource are modified.

Configuration tracking is supported for most platform and server types; typically not for services.

The Hyperic Agent must be able to read a file to track it — ensure that file permissions are such that the Hyperic Agent can read files you wish to track.

You can base an alert definition for a resource or resource type on a configuration tracking event. For more information see Define an Alert for a Resource and Define an Alert for a Resource Group in vFabric Hyperic Administration.

Hyperic 4.6.5 provides two different configuration tracking mechanisms, described in the sections below:

Event-Based Configuration Tracking

In Hyperic 4.6.5, a new support class — org.hyperic.hq.product.FileChangeTrackPlugin — enables more detailed change tracking than available in previous versions of Hyperic. This plugin tracks the change type ("add", "delete", "modify", or "rename") and the actual changes in text files. In Hyperic 4.6.5 the following plugins have been updated to use FileChangeTrackPlugin:

  • Tomcat

  • Apache

  • WebSphere

  • WebLogic Server

  • JBoss

  • PostgreSQL

  • mySQL

  • Oracle

These plugins provide default Configuration File filters. Note that configuration tracking for these types is disabled by default. You can enable configuration tracking on the Configuration Properties page for a resource. The Event Center screenshot below lists configuration events for a server type managed by a plugin that uses event-based tracking.


Polling-Based Configuration Tracking

Plugins that have not been updated to use FileChangeTrackPlugin use the still-supported org.hyperic.hq.product.ConfigFileTrackPlugin class, which is polling-based, and tracks the time fact that a file was changed, but not details about the change that was made. The Event Center screenshot below lists configuration events for a server type managed by a plugin that uses polling-based tracking.


How to View Event Data

  • You can view configuration event data on:

    • The Monitor page for a resource. For more information, see ui-Monitor.CurrentHealth in vFabric Hyperic User Interface.

    • The Event Center page. For more information see ui-Event.Center in vFabric Hyperic User Interface.