Product Documentation
Abstract
The new Launcher heartbeat file in Transformation Extender version 9.0.0.2 summarizes the status of Launcher systems and watches in a JSON-formatted log file that an external program can read to automatically monitor Launcher status.
Content
Configure the following new options in the [Launcher] section of the dtx.ini file to enable and configure the Launcher heartbeat file:
HeartbeatFileInterval
Specify the interval in seconds between heartbeat files. Specifying 0 disables heartbeat monitoring.
HeartbeatFileKeepNum
Specify the number of heartbeat files to keep before the oldest file is deleted.
When enabled, the Launcher logs the following information in the heartbeat file:
- Current time in ISO8601 format
- System statistics:
- Output equivalent to the launcher -summary command
- Launcher warning, error, and fatal error counts. Informational messages about log file enablement are not counted.
- System deltas:
- Number of successful maps, map errors, and total number of maps since the last heartbeat interval
- Number of system warnings, errors, and fatal errors since the last heartbeat interval
- Watch statistics:
- Watch name
- Summary:
- Number of instances triggered
- Total time of all instances in milliseconds
- Minimum time for one instance in milliseconds
- Maximum time for one instance in milliseconds
- Average time for one instance in milliseconds
- Delta:
The change to each of the Summary values since the last heartbeat interval
- CompoundSystem04-11-17-05-45-42-AM_myhost.json
Older heartbeat files have a numeric index appended to the file extension. For example:
- CompoundSystem04-11-17-05-45-42-AM_myhost.json.1
The log file format is similar to the following:
"Time": "2017-04-11T16:05:23-0400",
"System Statistics":
- "System Status": "Running",
"Active Component Maps": "0",
"Active Listeners Up": "20",
"Active Listeners Down": "0",
"Active Connections": "1",
"Start Time": "2017-04-11T16:05:00-0400",
"Success Time (dhms)": "0:15",
"Failure Time (dhms)": "0:00",
"Up Time (dhms)": "0:23",
"Pending Initialization": "0",
"Pending Initialization Maximum": "12",
"Pending Resource": "0",
"Pending Connection": "0",
"Pending Total Maps": "0",
"History Successes": "369",
"History Failures": "0",
"History Total Maps": "369",
"History Connection Failures": "0",
"History Deadlocks Detected": "0",
"History Function Failures": "0",
"System Warnings": "1",
"System Errors": "11",
"System Fatals": "0"
"System Deltas":
- "History Successes": "206",
"History Failures": "0",
"History Total Maps": "206",
"System Warnings": "0",
"System Errors": "0",
"System Fatals": "0"
"Watch Statistics":
- "Name": "PreProcessEnvelope",
"Summary":
- "Triggered": "3",
"Tot Time (ms)": "384",
"Min Time (ms)": "80",
"Max Time (ms)": "208",
"Ave Time (ms)": "128"
- "Triggered": "2",
"Tot Time (ms)": "176",
"Min Time (ms)": "80",
"Max Time (ms)": "96",
"Ave Time (ms)": "88"
"Summary":
- "Triggered": "3",
"Tot Time (ms)": "135",
"Min Time (ms)": "31",
"Max Time (ms)": "67",
"Ave Time (ms)": "45"
- "Triggered": "2",
"Tot Time (ms)": "68",
"Min Time (ms)": "31"
"Max Time (ms)": "37",
"Ave Time (ms)": "34"
[{"Product":{"code":"SSVSD8","label":"IBM Transformation Extender"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"Launcher","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"},{"code":"PF035","label":"z\/OS"}],"Version":"9.0.0.2","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}}]
Was this topic helpful?
Document Information
Modified date:
08 August 2018
UID
swg27049851