EntireX Version 9.7
 —  Application Monitoring  —

Setting Up Application Monitoring

This document covers the following topics:


General Information

The collection of response times and other measuring data from your distributed applications in real time requires that you set up various components for application monitoring. EntireX Broker and/or the EntireX Adapter serve as the central components which control the data flow. Their configuration defines the following: whether application monitoring is generally enabled or disabled, the services that are used for monitoring (only for EntireX Broker), and the Application Monitoring Data Collector to which the measuring data is sent.

In addition, your applications need to be prepared for the collection and distribution of measuring data. This is automatically ensured when you use the appropriate EntireX components which support application monitoring. Further configuration on the side of the application is not required.

Top of page

Setting Up EntireX Broker

EntireX Broker controls the measuring data flow. Using specific attributes in the broker attribute file, the broker can be configured to enable application monitoring for selected services. There are broker-specific and service-specific attributes for application monitoring, and there are also application monitoring-specific attributes. For detailed information, see Broker Attributes.

Caution:
Changes in the broker attribute file require a restart of the broker. In addition, all involved client applications and RPC servers have to be restarted (after the restart of the broker) because they are caching information about the broker's application monitoring settings.

Configuration example:

DEFAULTS = BROKER 
  APPLICATION-MONITORING = YES 

DEFAULTS = APPLICATION-MONITORING 
  COLLECTOR-BROKER-ID = server12:57900 

DEFAULTS = SERVICE 
  APPLICATION-MONITORING-NAME = Payroll_Application
  CLASS = RPC, SERVER = HR, SERVICE = CALLNAT, APPLICATION-MONITORING = YES, APPLICATION-MONITORING-NAME = HR_Application
  CLASS = RPC, SERVER = *, SERVICE = CALLNAT, APPLICATION-MONITORING = YES

With this example configuration, application monitoring is enabled for all RPC/*/CALLNAT services. The service RPC/HR/CALLNAT uses the application monitoring name "HR_Application", all other services use the name "Payroll_Application". The Application Monitoring Data Collector runs on a host with the name "server12" and uses the port 57900.

Top of page

Setting Up the EntireX Adapter

The EntireX Adapter automatically supports application monitoring for the following connection types:

If you want to use application monitoring with the following connection types, you have to change the configuration of the EntireX Adapter (see the EntireX Adapter documentation for further information):

Top of page

Configuration for Application Monitoring

The configuration file entirex.appmondc.properties controls the startup of the Application Monitoring Data Collector. It is located in the config directory of your EntireX installation.

As a rule, it is not necessary to change the settings in this file after the installation. However, if required, you can change the following parameters:

Parameter Description
entirex.appmondc.port The TCP/IP port on which the Application Monitoring Data Collector accepts the monitoring data. This value is set during the installation of the Application Monitoring Data Collector.
entirex.appmondc.directory The name of the directory which will contain the CSV data files. The default value is <EntireX-install-dir>/appmondc/.

A data file has the name appmon<YYYYMMDD>.<HHMMSS>.csv. In addition, an overview file with the name appmon.overview.v1.csv is created.

entirex.appmondc.loglevel The log level for the log files. Possible values are:

OFF
FATAL
ERROR
WARNING
INFO
DEBUG
TRACE

The default value is ERROR.

Log files are always stored in the directory <EntireX-install-dir>/appmondc/. This is independent of the setting of the entirex.appmondc.directory parameter.

entirex.appmondc.maxlines The maximum number of rows per CSV data file. If the limit is reached, a new file is created. The default value is 100000.
entirex.appmondc.filesperday Automatically create a new CVS data file every day. The default value is no.
entirex.appmondc.usezeroasnullvalue Use "0" instead of an empty entry as the null value for all numeric KPI values in the CSV file. The default value is no.

Note:
If you plan to use the Application Monitoring MashApp, some of the above parameters require special settings. For further information, see Special Configuration for Application Monitoring.

Top of page

Starting and Stopping the Application Monitoring Data Collector

UNIX

The scripts mentioned below are located in the bin directory of your EntireX installation. By default, this is /opt/softwareag/entirex/bin.

Start of instruction setTo start the Application Monitoring Data Collector

Start of instruction setTo stop the Application Monitoring Data Collector

Windows

The Application Monitoring Data Collector is installed as an application and as a Windows service. During the installation, you can specify that the Windows service is to be started automatically. The name of this service is "Software AG EntireX Application Monitoring Data Collector 9.7".

Note:
You can access the list of services by opening the Start menu and then entering "services.msc" in the search box. There, you can start and stop the service manually.

Start of instruction setTo start the Application Monitoring Data Collector as an application

Start of instruction setTo stop the Application Monitoring Data Collector (service and application)

Top of page