This document covers the following topics:
EntireX Broker controls the measuring data flow. Using the attributes described in this chapter, the Broker can be configured to enable application monitoring for selected services.
The attributes are defined in the Broker attribute file. For detailed information on this file, see Broker Attributes in the webMethods EntireX documentation.
The Broker-specific attribute section begins with the keyword
DEFAULTS=BROKER. It contains attributes that apply to the EntireX
Broker. At startup time, the attributes are read and duplicate or missing
values are treated as errors. When an error occurs, the EntireX Broker stops
execution until the problem is corrected.
To enable application monitoring in EntireX Broker, the following attribute is available:
| Attribute | Values | Opt/ Req |
Operating System | |||||||
|---|---|---|---|---|---|---|---|---|---|---|
|
|
|
|
|
|
||||||
| APPLICATION-MONITORING or APPMON | YES | NO | O | z | w | ||||||
|
||||||||||
The application monitoring-specific attribute section begins with the
keyword DEFAULTS=APPLICATION-MONITORING. It contains attributes
that apply to the application monitoring functionality. At startup time, the
attributes are read if the Broker-specific attribute
APPLICATION-MONITORING=YES is specified. Duplicate or missing
values are treated as errors. When an error occurs, application monitoring is
turned off and EntireX Broker continues execution.
| Attribute | Values | Opt/ Req |
Operating System | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
|
|
|
|
||||||||||
| COLLECTOR-BROKER-ID | A64 | R | z | w | ||||||||||
| Identifies the Application Monitoring Data Collector. Has the format host-name:port-number, where host-name is the host where the Application Monitoring Data Collector is running and port-number is the port number of the Application Monitoring Data Collector. The default port is 57900. | ||||||||||||||
| APPLICATION-MONITORING-NAME or APPMON-NAME | A100 | O | z | w | ||||||||||
| Specifies a default application monitoring name. This value is used by Optimize and MashZone to group the measuring data collected for services that use the same application monitoring name. | ||||||||||||||
| TRACE-LEVEL | 0 - 3 | O | z | w | ||||||||||
The level of tracing to be
performed while the Broker is running with application monitoring.
A trace level should be used only when requested by Software AG support. |
||||||||||||||
Each section begins with the keyword DEFAULTS=SERVICE.
Services with common attribute values can be grouped together. The attributes
defined in the grouping apply to all services specified within it. However, if
a different attribute value is defined immediately following the service
definition, that new value applies.
| Attribute | Values | Opt/ Req |
Operating System | |||||||
|---|---|---|---|---|---|---|---|---|---|---|
|
|
|
|
|
|
||||||
| APPLICATION-MONITORING or APPMON | YES | NO | O | z | w | ||||||
|
||||||||||
| APPLICATION-MONITORING-NAME or APPMON-NAME | A100 | O | z | w | ||||||
| Specifies the application
monitoring name. This value is used by Optimize and MashZone to group the
measuring data collected for services that use the same application monitoring
name.
If omitted, the default value from the
|
||||||||||
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" in Optimize and MashZone, 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.
