Go to main content

man pages section 8: System Administration Commands

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

etracestat (8)

Name

etracestat - report end-to-end tracing statistics

Synopsis

etracestat show-server [-c] [[-p] [-o field[,...]] [interval [count]]
etracestat show-client [[-p] [-o field[,...]] [interval [count]]
etracestat help [subcommand-name]

Description

The etracestat command reports runtime end-to-end tracing statistics.

Options

The interval at which the output is updated is specified through the optional <interval> argument. The optional <count> argument can also be used to specify the number of updates which should be printed by the command before it terminates.

Every subcommand supports the following set of options:

–o field[,...]

If specified, lists the statistics fields which should be displayed. The fields supported by each subcommand are listed below.

–p

Displays output in a stable and machine-parseable format. The –o option is required with along with –p option.

Sub Commands

etracestat supports the following command forms:

show-server [–c] [[–p] [–o field[,...]] [interval [count]]

Displays the server statistics. The output depends on the options specified. The following fields are supported by this subcommand:

EVENTS

Total number of event received.

EVENTSERR

Total number of events which were discarded because they were corrupted.

EVENTSBYTES

Amount of event data in bytes received by server.

EVENTSDROPPED

Number of events dropped by server due to overload condition.

TRACES

Total number of traces assembled.

TRACESERR

Traces which failed to be assembled, for example due to missing events.

CLIENT

IP address of the tracing client.

When the –c option is specified, the command displays a per-client breakdown of the statistics. Only the CLIENT, TRACES, and TRACESERR fields are supported with that option.

When the –o option is not specified, only the EVENTS, TRACES, and TRACESERR traces are displayed.

show-client [–p] [[–o field[,...]] [interval [count]]

Displays the client statistics. The following fields are supported by this subcommand:

EVENTS

Total number of events sent to the server.

EVENTSBYTES

Amount of event data in bytes sent by client.

help [subcommand-name]

Displays all the etracestat supported subcommands or usage for the given subcommand. If you invoke help for a specific subcommand, the command syntax is displayed, along with an example. Using etracestat help without any argument displays all the subcommands.

Examples

Example 1 Displaying the Server Statistics

The following command displays the server statistics.

# etracestat show-server
      SERVER     TRACES  TRACESERR     EVENTS  EVENTSDROPPED
       local     181230         12    4884988              0
Example 2 Displaying the Server Per-Client Statistics

The following command displays the server per-client statistics.

# etracestat show-server -c
      SERVER               CLIENT     EVENTS  EVENTSERR  EVENTSDROPPED
       local         192.168.1.10    1547340          0              0
       local         192.168.1.10    3337668          0              0
Example 3 Displaying the Client Statistics

The following command displays the client statistics.

# etracestat show-client
      CLIENT         EVENTS
       local              0

Attributes

See attributes(7) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Availability
system/etrace
Interface Stability
See below

Screen output is Uncommitted. The invocation is Committed.

See Also

etraced(8)