mgetinfo
The mgetinfo command retrieves information about a cell.
mgetinfo syntax
[-h|?] [-l<HomeLocation>] [-n <cellName> | -n @Host[/Port[#Key]]]
{-p <Var Value>} [-q] [-v] [-z] <Information>
The -n option is required if the cell is remote and defined in the mcell.dir file, or if the cell is local and named something other than Host.
The following table lists the command-specific options for mgetinfo. For a list of common command options that apply to all CLI commands, see Common options for event management CLI commands.
mgetinfo options
Option | Description |
---|---|
Information | Specifies the Information option to use. |
The following table describes the mgetinfo Information options:
mgetinfo options
Option | Description |
---|---|
Information | Specifies the Information option to use. |
The following table describes the mgetinfo Information options:
Information | Description |
---|---|
activity | Retrieves the activity status of the cell |
config | Retrieves configuration of a cell, including the cell name, home directory, Knowledge Base directory, and the full paths of all configuration files the cell uses |
connect | Retrieves information about the current connections that are open from and to the cell; see the following table for description of that information |
kbmodules | Lists KB modules with version information from the cell's loaded KB; information is displayed in raw format. When combined with the -v switch, it is returned in a more verbose and readable format. |
kbsources | Lists KB source files with version information from the cell's loaded KB; information is displayed in raw format. When combined with the -v switch, information is returned in a more verbose and readable format. |
metrics | Reports the metrics, collected by the cell. The metrics are stored in MC_CELL_METRIC data objects.
The following metrics are defined:
|
param | Retrieves the options found in the mcell.conf file. |
pid | Displays the process ID, parent process ID, and session ID of the cell process. |
profiling | Displays the time spent to run each rule.
When mgetinfo profiling is run without the -v option, the output is same data except for the first two lines which are summarized in one line containing state and total collection time and lines with dashes are not output. |
timer | Lists the following information for all timers set on all events:
|
services | Reports service metrics counting the components and relationships |
version | Displays the version number of the cell |
A connect request displays the information described in the following table.
mgetinfo connection information
Connect information | Description |
---|---|
All Connections | |
Client identifier | The identification number of the client as reported in the cell trace messages |
Direction | IN for incoming and OUT for outgoing |
Client type | The type of client, such as unknown, cell, browser, adapter, CLI, and EIF, which are reported as literal values |
Client name | the name of the connected program (for example: Impact Explorer, mposter, cellName) |
Source address | IP address/port of source side of the connection; for inbound connections, this is the client; for outbound, it is the cell |
Destination address | IP address/port of destination side of the connection; for inbound connections, this is the cell; for outbound, it is the destination |
Incoming Connections | |
User ID | The name of the user; user@host |
Clock delta | The difference between the time clocks for the sender and receiver in seconds, to be added to time stamps coming in to convert to the cell time |
Last received message sequence number | Sequence number of the last incoming message |
Last answered message sequence number | Sequence number of the last answered message |
Number of open queries on event | Number of open queries on EVENT classes |
Number of open queries on data | Number of open queries on DATA classes |
Internal low level buffer size | Size of internal low-level buffer used for returning answers to requests |
Outgoing Connections | |
Last connection trial at | Time stamp of last connection setup or trial |
Last message sent sequence number | Sequence number of last outgoing message |
Messages waiting for connection | Number of messages waiting for connection opening |
Messages sent, waiting for answer | Number of messages waiting for answer |