This document covers the following topics:
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.
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.
The EntireX Adapter automatically supports application monitoring for the following connection types:
EntireX RPC Connection
EntireX RPC Listener Connection
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):
EntireX Direct RPC Connection
EntireX Direct RPC Listener Connection
IMS Connect Connection
CICS ECI Connection
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:
The default value is Log files are always stored in the directory
<EntireX-install-dir>/appmondc/. This is independent
of the setting of the |
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.
The scripts mentioned below are located in the bin directory of your EntireX installation. By default, this is /opt/softwareag/entirex/bin.
To start the Application Monitoring Data Collector
Run the start script appmondc.bsh from a shell.
To stop the Application Monitoring Data Collector
Run the start script stopappmondc.bsh from a shell.
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.
To start the Application Monitoring Data Collector as an application
Choose the following from the Windows Start menu:
Or:
Run the script appmondc.bat which is located in
the bin directory of your EntireX installation.
To stop the Application Monitoring Data Collector (service and application)
Choose the following from the Windows Start menu:
Or:
Run the script stopappmondc.bat which is
located in the bin directory of your EntireX
installation.