Inspecting correlator state
The engine_inspect
tool lets you inspect the state of a running correlator. This means you can review the applications loaded and running on a correlator. The executable for this tool is located in the Apama/bin
directory.
Synopsis
To inspect applications on a running correlator, run the following command:
engine_inspect [ options ]
When you run this command with the –h
option, the usage message for this command is shown.
Description
The engine_inspect
tool retrieves state information from a running correlator and sends it to stdout
. By default, the tool outputs information on the monitors, event types and container types currently injected in a correlator.
You can filter this list by specifying command-line options. When you specify one or more of the -m
, -j
, -e
, -t
, -x
, -P
, or -R
options, the engine_inspect
tool displays only the information indicated by the option(s) you specify. See the table below for more information on these options.
Options
The engine_inspect
tool takes the following options:
Option |
Description |
---|---|
|
Displays the names of all EPL monitors in the correlator and the number of monitor instances each monitor has spawned. |
|
Displays the names of all Java plug-in application JARs in the correlator. |
|
Displays the names of all event types in the correlator and the number of templates of each type, as defined in listener specifications. This includes each event template in an |
|
Displays the current EPL timers active within the system. The four types of timers which may be displayed here are |
|
Displays the names of any user-defined contexts, how many monitor instances are running in each context, what channels each context is subscribed to, and how many entries are on each context’s input queue. |
|
Displays a list of the custom (user-defined) aggregate functions that have been injected. You use aggregate functions in stream queries. Apama built-in aggregate functions are not listed. |
|
Displays the names of any plug-in receivers, the channels the plug-in is subscribed to, and the number of items on the plug-in’s input queue. A plug-in receiver is an EPL plug-in that is subscribed to one or more channels. |
|
Displays the names of any external receivers, each receiver’s address, the channels each receiver is subscribed to, and the number of entries on each receiver’s output queue. |
|
Indicates that you want raw output, which is more suitable for machine parsing. Raw output provides the name of each entity in the correlator followed by the number of instances associated with that entity. For a monitor, you get the number of its monitor instances. For an event type, you get the number of its templates. For example:
|
|
Displays usage information. |
|
Name of the host on which the correlator is running. The default is |
|
Port on which the correlator is listening. The default is |
|
Displays process names and versions in addition to application information. Optional. The default is to display only application information. |
|
Displays version information for the |
Exit status
The engine_inspect
tool returns the following exit values:
Value | Description |
---|---|
0 |
All status requests were processed successfully. |
1 |
No connection to the correlator was possible or the connection failed. |
2 |
Other error(s) occurred while requesting/processing status. |