epadmin-history

epadmin history target — Shows recent transaction, CPU usage, and shared memory metrics.

SYNOPSIS

epadmin [globalparameters] command history [commandparameters]

DESCRIPTION

The history target displays recent metrics about transactions, CPU usage, and shared memory usage for the specified nodes. The default metrics history is for one second, with an optional --seconds parameter to specify longer intervals.

For example, the following command:

epadmin --servicename=A.sbuser display history --seconds 10

returns this result:

[A.sbuser] Version: 2
[A.sbuser] Shared Memory Total: 536870912
[A.sbuser] Shared Memory Used: 203674736
[A.sbuser] CPU % User: 3
[A.sbuser] CPU % System: 2
[A.sbuser] CPU % Idle: 95
[A.sbuser] Transactions: 109
[A.sbuser] Average Transaction Latency (usecs): 168
[A.sbuser] Transaction Deadlocks: 0

The history target has two commands:

The designation [sn|ad] in syntax examples is a reminder that this command requires either the global parameter ‑‑servicename or the ‑‑adminport and ‑‑hostname combination to identify the node or cluster of interest.

epadmin display history

Shows a single set of the node or cluster's performance metrics and returns.

epadmin [sn|ad] display history
epadmin [sn|ad] display history --seconds=5

display command parameters

Command Parameter Description Required
seconds Integer value for metrics interval to display. No. The default is one second.

epadmin stream history

Runs a continuous display of the node or cluster's performance metrics for the specified interval until interrupted with Ctrl+C.

epadmin [sn|ad] stream history
epadmin [sn|ad] stream history --seconds=10

stream command parameters

Command Parameter Description Required
seconds Integer value for metrics interval to display. No. The default is one second.