This page last changed on Nov 11, 2008 by mmcgarry.

Editing a Resource's Configuration Properties

Topics marked with * relate to HQ Enterprise-only features.

This inventory screen allows users to edit a resource's configuration properties, that is, those data that HQ needs to properly monitor and, in some cases, control the resource. Users can also enable and disable log and configuration tracking for the resource.

Product-Specific Configuration
The configuration information displayed and available for editing in each section depends entirely on the resource type (product). Product-specific information can be found through the list of products managed by HQ. These pages list what metrics are gathered for a resource type, what control actions (if any) are available for the resource type, whether log and configuration tracking are supported, and any special configuration that users must perform in order for HQ to manage the product. All of this information is ultimately defined in the plugin for that product.

Feedback is welcome. Click Add Comment at the bottom of the page.

Tasks Available on This Screen

On this screen, users can do the following tasks:

To enable or disable auto-discovery of this resource:

  • Check Auto-Discover and click .

To enable and configure log tracking of this resource:

  1. Check Enable Log Tracking.
  2. In Track Event Log Level, select a log level. Only events of a level greater than or equal to this level will be tracked. The hierarchy of log levels, from greatest to least, is: Error, Warn, Info, Debug.
    Mapping of error type to log-level:
    error type Log Level
    emerg,alert,crit,error Error
    warn Warn
    info,notice Info
    debug Debug
  3. In Log Pattern Match, provide a substring or a regular expression that must be matched by a log message. For more information, see java.util.regex.Pattern.
  4. In Log Pattern Exclude, provide a substring that, if found in a log message, will cause the message to be excluded.
  5. In Log Files, specify a comma-delimited list of log files to track.
    The HQ Agent must be able to read these files, so make sure permissions are set appropriately.
  6. Click .

To enable and configure configuration tracking of this resource:

  1. Check Enable Config Tracking.
  2. In Configuration Files, specify a comma-delimited list of log files to track.
  3. Click .

back to top

Sections on This Screen

Top

The top of the screen displays this message:

 Please verify that this resource has been enabled for monitoring by following the directions below.

if log and configuration tracking are not already enabled on the resource or if the user must do something in order for HQ to monitor the resource. For example, the message would appear on a MySQL database resource if the username and password had not been provided. Click directions below to be taken directly to the place on the screen where the necessary instructions are listed.

Shared

This section lists properties that apply to both "monitoring" and "control" aspects of the resource, in other words, general product configuration properties.

Monitoring

This section lists all the information necessary to perform log and configuration tracking for a resource. Not all resource types support log and configuration tracking.

In this section, users can also enable or disable auto-discovery of the resource. HQ's strength lies largely in its auto-discovery of network resources. The Auto-Discovery checkbox should thereful almost always be checked. On rare occasions, however, users might want to disable auto-discovery because it is being too "aggressive" in discovering things on the network.

Control

This section lists the information necessary for HQ to perform control actions on this resource. Not all resource types have associated control actions: Platforms, applications, and mixed groups do not have control actions.

Example
For an Apache server, HQ can perform these control actions: start, stop, restart, graceful, startssl, and configtest. In order for HQ to do that, the user must provide the following information about the Apache installation:

  • pidfile: The Apache httpd pid file
  • program: The apache httpd control program
  • prefix: Prefix arguments to the control program
  • timeout: Timeout of control operations (measured in seconds)

The Rest

The rest of the screen provides resource type-specific (product-specific) configuration information (if it exists) necessary for HQ to monitor the resource. This information is also found on the product-specific pages in the Managed Products section of the help.

Also, an explanation of the log- and configuration-tracking fields, as explained above, is provided.

back to top


Return to HQ User Interface Reference.

fb_ok.gif (image/gif)
Document generated by Confluence on Apr 20, 2010 15:01