The xmpeek command allows you to query any host about the status of its xmtopas daemon.
The xmpeek command is used to list down the data consumers that currently have instruments (stat sets) defined with the xmtopas daemon, and list down all known data consumers by the xmtopas daemon . The xmpeek command is also used to print down all the available SPMI statistics for any given host.
| Item | Description |
|---|---|
| -a | If this flag is specified, one line is listed for each data consumer known by the daemon. If this flag is not used, only data consumers that currently have instruments (stat sets) defined with the daemon are listed. This flag is optional. |
| -l | This flag is explained in the Using the xmpeek Program to Print Available Statistics document. This flag is optional. |
| hostname | If the hostname is specified, the daemon on the named host is asked. If no host name is specified, the daemon on the local host is asked. |
The following is an example of the output from the xmpeek program:
Statistics for xmtopas daemon on *** birte ***
Instruments currently defined: 1
Instruments currently active: 1
Remote monitors currently known: 2
--Instruments--- Values Packets
Internet Protocol
Defined Active Active Sent Address Port Hostname
------- ------- ------- ------- ---------------- ---- ----------
1 1 16 3,344 129.49.115.208 3885 xtraOutput from xmpeek can take two forms.
The first form is a line that informs you that the xmtopas daemon is not feeding any data-consumer programs. This form is used if no statsets are defined with the daemon and no command flags are supplied.
The second form includes at least as much as is shown in the preceding example, except that the single detail line for the data consumer on host xtra is shown only if either the -a flag is used or if the data consumer has at least one instrument (statset) defined with the daemon. Note that xmpeek itself appears as a data consumer because it uses the RSi API to contact the daemon. Therefore, the output always shows at least one known monitor.
In the fixed output, first the name of the host where the daemon is running is shown. Then follows three lines giving the totals for current status of the daemon. In the above example, you can see that only one instrument is defined and that it's active. You can also see that two data consumers are known by the daemon, but that only one of them has an instrument defined with the daemon in birte. Obviously, this output was produced without the -a flag.
An example of more activity is shown in the following sample output from xmpeek. The output is produced with the command:
xmpeek -a birte Notice that some detail lines show zero instruments defined. Such lines indicate that an are_you_there message was received from the data consumer but that no states were ever defined or that any previously defined states were erased.
Statistics for smeared daemon on *** birte ***
Instruments currently defined: 16
Instruments currently active: 14
Remote monitors currently known: 6
--Instruments--- Values Packets Internet Protocol
Defined Active Active Sent Address Port Hostname
8 8 35 10,232 129.49.115.203 4184 birte
6 4 28 8,322 129.49.246.14 3211 umbra
0 0 0 0 129.49.115.208 3861 xtra
1 1 16 3,332 129.49.246.14 3219 umbra
0 0 0 0 129.49.115.203 4209 birte
1 1 16 422 129.49.115.208 3874 xtra
------- ------- ------- ----------
16 14 95 22,308Notice that the same host name may appear more than once. This is because every running copy of xmperf and every other active data-consumer program is counted and treated as a separate data consumer, each identified by the port number used for UDP packets as shown in the xmpeek output.
The second detail shows that one particular monitor on host umbra has six instruments defined but only four active. This would happen if a remote xmperf console has been opened but is now closed. When you close an xmperf console, it stays in the Monitor menu of the xmperf main window and the definition of the instruments of that console remains in the tables of the data-supplier daemon but the instruments are not active.