pcp-atopsar - Advanced System Activity Report (pcp-atop
related)
pcp [pcp options] atopsar
[atop options] [-r file|date] [-h host] [-R
cnt] [-b yy-mm-dd] hh:mm] [-e yy-mm-dd]
hh:mm]
pcp [pcp options] atopsar
[atop options] interval [samples]
The pcp-atopsar program can be used to report statistics at
the system level.
In the first synopsis line (no sampling interval specified),
pcp-atopsar extracts data from a raw logfile that has been recorded
previously by pmlogger(1) (or via the -w option of the
pcp-atop program).
You can specify the name of the logfile with the -r option of the
pcp-atopsar program. When a pmlogger daily logfile is used,
named $PCP_LOG_DIR/pmlogger/[host]/YYYYMMDD (where YYYYMMDD reflects
the date), the required date of the form YYYYMMDD can be specified with the
-r option instead of the filename, or the symbolic name 'y' can be
used for yesterday's daily logfile (this can be repeated so 'yyyy' indicates
the logfile of four days ago). If the -r option is not specified at
all, today's daily logfile is used by default.
By default, the hostname of the localhost will be used when resolving
pmlogger archives, however an alternative host can be
specified using the -h option.
The starting and ending times of the report can be defined using the options
-b and -e followed by a time argument of the form [yy-mm-dd]
hh:mm.
In the second synopsis line, pcp-atopsar reads actual
activity counters from the kernel with the specified interval (in
seconds) and the specified number of samples (optionally). When
pcp-atopsar is activated in this way it immediately sends the output
for every requested report to standard output. If only one type of report is
requested, the header is printed once and after every interval
seconds the statistical counters are shown for that period. If several
reports are requested, a header is printed per sample followed by the
statistical counters for that period.
When invoked via the pcp(1) command, the PCPIntro(1)
options -h/--host, -a/--archive,
-O/--origin, -s/--samples,
-t/--interval, -Z/--timezone and several other
pcp options become indirectly available, see PCPIntro(1) for
their descriptions.
Some generic flags can be specified to influence the behaviour of
the pcp-atopsar program:
- -S
- By default the timestamp at the beginning of a line is suppressed if more
lines are shown for one interval. With this flag a timestamp is given for
every output-line (easier for post-processing).
- -a
- By default certain resources as disks and network interfaces are only
shown when they were active during the interval. With this flag all
resources of a given type are shown, even if they were inactive during the
interval.
- -x
- By default pcp-atopsar only uses colors if output is directed to a
terminal (window). These colors might indicate that a critical occupation
percentage has been reached (red) or has been almost reached (cyan) for a
particular resource. See the man-page of atop for a detailed
description of this feature (section COLORS).
With the flag -x the use of colors is suppressed
unconditionally.
- -C
- By default pcp-atopsar only uses colors if output is directed to a
terminal (window). These colors might indicate that a critical occupation
percentage has been reached (red) or has been almost reached (cyan) for a
particular resource. See the man-page of atop for a detailed
description of this feature (section COLORS).
With the flag -C colors will always be used, even if output is not
directed to a terminal.
- -M
- Use markers at the end of a line to indicate that a critical occupation
percentage has been reached ('*') or has been almost reached ('+') for
particular resources. The marker '*' is similar to the color red and the
marker '+' to the color cyan. See the man-page of atop for a
detailed description of these colors (section COLORS).
- -H
- Repeat the header line within a report for every N detail lines.
The value of N is determined dynamically in case of output to a
tty/window (depending on the number of lines); for output to a file or
pipe this value is 23.
- -R
- Summarize cnt samples into one sample. When the logfile contains
e.g. samples of 10 minutes, the use of the flag '-R 6' shows a report with
one sample for every hour.
Other flags are used to define which reports are required:
- -A
- Show all possible reports.
- -c
- Report about CPU utilization (in total and per cpu).
- -g
- Report about GPU utilization (per GPU).
- -p
- Report about processor-related matters, like load-averages and hardware
interrupts.
- -P
- Report about processes.
- -m
- Current memory- and swap-occupation.
- -s
- Report about paging- and swapping-activity, and overcommitment.
- -B
- Report about Pressure Stall Information (PSI).
- -l
- Report about utilization of logical volumes.
- -f
- Report about utilization of multiple devices.
- -d
- Report about utilization of disks.
- -n
- Report about NFS mounted filesystems on NFS client.
- -j
- Report about NFS client activity.
- -J
- Report about NFS server activity.
- -i
- Report about the network interfaces.
- -I
- Report about errors for network-interfaces.
- -w
- Report about IP version 4 network traffic.
- -W
- Report about errors for IP version 4 traffic.
- -y
- General report about ICMP version 4 layer activity.
- -Y
- Per-type report about ICMP version 4 layer activity.
- -u
- Report about UDP version 4 network traffic.
- -z
- Report about IP version 6 network traffic.
- -Z
- Report about errors for IP version 6 traffic.
- -k
- General report about ICMP version 6 layer activity.
- -K
- Per-type report about ICMP version 6 layer activity.
- -U
- Report about UDP version 6 network traffic.
- -t
- Report about TCP network traffic.
- -T
- Report about errors for TCP-traffic.
- -h
- Report about Infiniband utilization.
- -O
- Report about top-3 processes consuming most processor capacity. This
report is only available when using a log file (not when specifying an
interval).
- -G
- Report about top-3 processes consuming most resident memory. This report
is only available when using a log file (not when specifying an
interval).
- -D
- Report about top-3 processes issuing most disk transfers. This report is
only available when using a log file (not when specifying an
interval).
- -N
- Report about top-3 processes issuing most IPv4/IPv6 socket transfers. This
report is only available when using a log file (not when specifying an
interval).
The following additional PCP command line long options are also
available:
- --align=align
- Force the initial sample to be aligned on the boundary of a natural time
unit align. Refer to PCPIntro(1) for a complete description
of the syntax for align.
- --archive=archive
- Performance metric values are retrieved from the set of Performance
Co-Pilot (PCP) archive log files identified by the argument
archive, which is a comma-separated list of names, each of which
may be the base name of an archive or the name of a directory containing
one or more archives.
- --finish=endtime
- When reporting archived metrics, the report will be restricted to those
records logged before or at endtime. Refer to PCPIntro(1)
for a complete description of the syntax for endtime.
- --host=host
- Fetch performance metrics from pmcd(1) on host, rather than
from the default localhost.
- --hostzone
- Use the local timezone of the host that is the source of the performance
metrics, as identified by either the --host or the --archive
options. The default is to use the timezone of the local host.
- --hotproc
- Use the pmdaproc(1) hotproc metrics.
- --interval=interval
- Set the reporting interval to something other than the default 1
second. The interval argument follows the syntax described in
PCPIntro(1), and in the simplest form may be an unsigned integer
(the implied units in this case are seconds).
- --samples=samples
- The samples option defines the number of samples to be retrieved
and reported.
- --start=starttime
- When reporting archived metrics, the report will be restricted to those
records logged at or after starttime. Refer to PCPIntro(1)
for a complete description of the syntax for starttime.
- --timezone=timezone
- Use timezone for the date and time. Timezone is in the
format of the environment variable TZ as described in
environ(7).
- --version
- Display version number and exit.
Depending on the requested report, a number of columns with output
values are produced. The values are mostly presented as a number of events
per second.
The output for the flag -c contains the following columns
per cpu:
- usr%
- Percentage of cpu-time consumed in user mode (program text) for all active
processes running with a nice value of zero (default) or a negative nice
value (which means a higher priority than usual). The cpu consumption in
user mode of processes with a nice value larger than zero (lower priority)
is indicated in the nice%-column.
- nice%
- Percentage of cpu time consumed in user mode (i.e. program text) for all
processes running witn a nice value larger than zero (which means with a
lower priority than average).
- sys%
- Percentage of cpu time consumed in system mode (kernel text) for all
active processes. A high percentage usually indicates a lot of system
calls being issued.
- irq%
- Percentage of cpu time consumed for handling of device interrupts.
- softirq%
- Percentage of cpu time consumed for soft interrupt handling.
- steal%
- Percentage of cpu time stolen by other virtual machines running on the
same hardware.
- guest%
- Percentage of cpu time used by other virtual machines running on the same
hardware (overlaps with usr%/nice%).
- wait%
- Percentage of unused cpu time while at least one of the processes in
wait-state awaits completion of disk I/O.
- idle%
- Percentage of unused cpu time because all processes are in a wait-state
but not waiting for disk-I/O.
The output for the flag -g contains the following columns
per GPU:
- busaddr
- GPU number and bus-ID (separated by '/').
- gpubusy
- GPU busy percentage during interval.
- membusy
- GPU memory busy percentage during interval, i.e. time to issue read and
write accesses on memory.
- memocc
- Percentage of memory occupation at this moment.
- memtot
- Total memory available.
- memuse
- Used GPU memory at this moment.
- gputype
- Type of GPU.
The output for the flag -p contains the following
values:
- pswch/s
- Number of process switches (also called context switches) per second on
this cpu. A process switch occurs at the moment that an active thread
(i.e. the thread using a cpu) enters a wait state or has used its time
slice completely; another thread will then be chosen to use the cpu.
- devintr/s
- Number of hardware interrupts handled per second on this cpu.
- clones/s
- The number of new threads started per second.
- loadavg1
- Load average reflecting the average number of threads in the runqueue or
in non-interruptible wait state (usually waiting for disk or tape I/O)
during the last minute.
- loadavg5
- Load average reflecting the average number of threads in the runqueue or
in non-interruptible wait state (usually waiting for disk or tape I/O)
during the last 5 minutes.
- loadavg15
- Load average reflecting the average number of threads in the runqueue or
in non-interruptible wait state (usually waiting for disk or tape I/O)
during the last 15 minutes.
The output for the flag -P contains information about the
processes and threads:
- clones/s
- The number of new threads started per second.
- pexit/s
- curproc
- Total number of processes present in the system.
- curzomb
- Number of zombie processes present in the system.
- thrrun
- Total number of threads present in the system in state 'running'.
- thrslpi
- Total number of threads present in the system in state 'interruptible
sleeping'.
- thrslpu
- Total number of threads present in the system in state 'uninterruptible
sleeping'.
The output for the flag -m contains information about the
memory- and swap-utilization:
- memtotal
- Total usable main memory size.
- memfree
- Available main memory size at this moment (snapshot).
- buffers
- Main memory used at this moment to cache metadata-blocks (snapshot).
- cached
- Main memory used at this moment to cache data-blocks (snapshot).
- dirty
- Amount of memory in the page cache that still has to be flushed to disk at
this moment (snapshot).
- slabmem
- Main memory used at this moment for dynamically allocated memory by the
kernel (snapshot).
- swptotal
- Total swap space size at this moment (snapshot).
- swpfree
- Available swap space at this moment (snapshot).
The output for the flag -s contains information about the
frequency of swapping:
- pagescan/s
- Number of scanned pages per second due to the fact that free memory drops
below a particular threshold.
- swapin/s
- The number of memory-pages the system read from the swap-device per
second.
- swapout/s
- The number of memory-pages the system wrote to the swap-device per
second.
- oomkill
- The number of processes being killed during the last interval due to lack
of memory/swap. The value -1 means that this counter is not supported by
the current kernel version.
- commitspc
- The committed virtual memory space i.e. the reserved virtual space for all
allocations of private memory space for processes.
- commitlim
- The maximum limit for the committed space, which is by default swap size
plus 50% of memory size. The kernel only verifies whether the committed
space exceeds the limit if strict overcommit handling is configured
(vm.overcommit_memory is 2).
The output for the flag -B contains the Pressure Stall
Information (PSI):
- cpusome
- Average pressure percentage during the interval for the category 'CPU
some'.
- memsome
- Average pressure percentage during the interval for the category 'memory
some'.
- memfull
- Average pressure percentage during the interval for the category 'memory
full'.
- iosome
- Average pressure percentage during the interval for the category 'I/O
some'.
- iofull
- Average pressure percentage during the interval for the category 'I/O
full'.
The output for the flags -l (LVM), -f (MD), and
-d (hard disk) contains the following columns per active unit:
- disk
- Name.
- busy
- Busy-percentage of the unit (i.e. the portion of time that the device was
busy handling requests).
- read/s
- Number of read-requests issued per second on this unit.
- KB/read
- Average number of Kbytes transferred per read-request for this unit.
- writ/s
- Number of write-requests (including discard requests) issued per second on
this unit.
- KB/writ
- Average number of Kbytes transferred per write-request for this unit.
- avque
- Average number of requests outstanding in the queue during the time that
the unit is busy.
- avserv
- Average number of milliseconds needed by a request on this unit (seek,
latency and data-transfer).
The output for the flag -n contains information about
activity on NFS mounted filesystems (client):
- mounted_device
- Mounted device containing server name and server directory being
mounted.
- physread/s
- Kilobytes data physically read from the NFS server by processes running on
the NFS client.
- KBwrite/s
- Kilobytes data physically written to the NFS server by processes running
on the NFS client.
When the NFS filesystem was mounted during the interval, the state 'M' is
shown.
The output for the flag -j contains information about NFS
client activity:
- rpc/s
- Number of RPC calls per second issued to NFS server(s).
- rpcread/s
- Number of read RPC calls per second issued to NFS server(s).
- rpcwrite/s
- Number of write RPC calls per second issued to NFS server(s).
- retrans/s
- Number of retransmitted RPC calls per second.
- autrefresh/s
- Number of authorization refreshes per second.
The output for the flag -J contains information about NFS
server activity:
- rpc/s
- Number of RPC calls per second received from NFS client(s).
- rpcread/s
- Number of read RPC calls per second received from NFS client(s).
- rpcwrite/s
- Number of write RPC calls per second received from NFS client(s).
- MBcr/s
- Number of Megabytes per second returned to read requests by clients.
- MBcw/s
- Number of Megabytes per second passed in write requests by clients.
- nettcp/s
- Number of requests per second handled via TCP.
- netudp/s
- Number of requests per second handled via UDP.
The output for the flag -i provides information about
utilization of network interfaces:
- interf
- Name of interface.
- busy
- Busy percentage for this interface. If the linespeed of this interface
could not be determined (e.g. for virtual interfaces), a question mark is
shown.
- ipack/s
- Number of packets received from this interface per second.
- opack/s
- Number of packets transmitted to this interface per second.
- iKbyte/s
- Number of Kbytes received from this interface per second.
- oKbyte/s
- Number of Kbytes transmitted via this interface per second.
- imbps/s
- Effective number of megabits received per second.
- ombps/s
- Effective number of megabits transmitted per second.
- maxmbps/s
- Linespeed as number of megabits per second. If the linespeed could not be
determined (e.g. virtual interfaces), value 0 is shown.
The linespeed is followed by the indication 'f' (full duplex) or 'h' (half
duplex).
The output for the flag -I provides information about the
failures that were detected for network interfaces:
- interf
- Name of interface.
- ierr/s
- Number of bad packets received from this interface per second.
- oerr/s
- Number of times that packet transmission to this interface failed per
second.
- coll/s
- Number of collisions encountered per second while transmitting
packets.
- idrop/s
- Number of received packets dropped per second due to lack of buffer-space
in the local system.
- odrop/s
- Number of transmitted packets dropped per second due to lack of
buffer-space in the local system.
- iframe/s
- Number of frame alignment-errors encountered per second on received
packets.
- ocarrier/s
- Number of carrier-errors encountered per second on transmitted
packets.
The output for the flag -w provides information about the
utilization of the IPv4-layer (formal SNMP-names between brackets):
- inrecv/s
- Number of IP datagrams received from interfaces per second, including
those received in error (ipInReceives).
- outreq/s
- Number of IP datagrams that local higher-layer protocols supplied to IP in
requests for transmission per second (ipOutRequests).
- indeliver/s
- Number of received IP datagrams that have been successfully delivered to
higher protocol-layers per second (ipInDelivers).
- forward/s
- Number of received IP datagrams per second for which this entity was not
their final IP destination, as a result of which an attempt was made to
forward (ipForwDatagrams).
- reasmok/s
- Number of IP datagrams successfully reassembled per second
(ipReasmOKs).
- fragcreat/s
- Number of IP datagram fragments generated per second at this entity
(ipFragCreates).
The output for the flag -W provides information about the
failures that were detected in the IPv4-layer (formal SNMP-names between
brackets):
- in: dsc/s
- Number of input IP datagrams per second for which no problems were
encountered to prevent their continued processing but that were discarded,
e.g. for lack of buffer space (ipInDiscards).
- in: hder/s
- Number of input IP datagrams per second discarded due to errors in the IP
header (ipInHdrErrors).
- in: ader/s
- Number of input IP datagrams per second discarded because the IP address
in the destination field was not valid to be received by this entity
(ipInAddrErrors).
- in: unkp/s
- Number of inbound packets per second that were discarded because of an
unknown or unsupported protocol (ipInUnknownProtos).
- in: ratim/s
- Number of timeout-situations per second while other fragments were
expected for successful reassembly (ipReasmTimeout).
- in: rfail/s
- Number of failures detected per second by the IP reassembly algorithm
(ipReasmFails).
- out: dsc/s
- Number of output IP datagrams per second for which no problems were
encountered to prevent their continued processing but that were discarded,
e.g. for lack of buffer space (ipOutDiscards).
- out: nrt/s
- Number of IP datagrams per second discarded because no route could be
found (ipOutNoRoutes).
The output for the flag -y provides information about the
general utilization of the ICMPv4-layer and some information per type of
ICMP-message (formal SNMP-names between brackets):
- intot/s
- Number of ICMP messages (any type) received per second at this entity
(icmpInMsgs).
- outtot/s
- Number of ICMP messages (any type) transmitted per second from this entity
(icmpOutMsgs).
- inecho/s
- Number of ICMP Echo (request) messages received per second
(icmpInEchos).
- inerep/s
- Number of ICMP Echo-Reply messages received per second
(icmpInEchoReps).
- otecho/s
- Number of ICMP Echo (request) messages transmitted per second
(icmpOutEchos).
- oterep/s
- Number of ICMP Echo-Reply messages transmitted per second
(icmpOutEchoReps).
The output for the flag -Y provides information about other
types of ICMPv4-messages (formal SNMP-names between brackets):
- ierr/s
- Number of ICMP messages received per second but determined to have
ICMP-specific errors (icmpInErrors).
- isq/s
- Number of ICMP Source Quench messages received per second
(icmpInSrcQuenchs).
- ird/s
- Number of ICMP Redirect messages received per second
(icmpInRedirects).
- idu/s
- Number of ICMP Destination Unreachable messages received per second
(icmpInDestUnreachs).
- ite/s
- Number of ICMP Time Exceeded messages received per second
(icmpOutTimeExcds).
- oerr/s
- Number of ICMP messages transmitted per second but determined to have
ICMP-specific errors (icmpOutErrors).
- osq/s
- Number of ICMP Source Quench messages transmitted per second
(icmpOutSrcQuenchs).
- ord/s
- Number of ICMP Redirect messages transmitted per second
(icmpOutRedirects).
- odu/s
- Number of ICMP Destination Unreachable messages transmitted per second
(icmpOutDestUnreachs).
- ote/s
- Number of ICMP Time Exceeded messages transmitted per second
(icmpOutTimeExcds).
The output for the flag -u provides information about the
utilization of the UDPv4-layer (formal SNMP-names between brackets):
- indgram/s
- Number of UDP datagrams per second delivered to UDP users
(udpInDatagrams).
- outdgram/s
- Number of UDP datagrams transmitted per second from this entity
(udpOutDatagrams).
- inerr/s
- Number of received UDP datagrams per second that could not be delivered
for reasons other than the lack of an application at the destination port
(udpInErrors).
- noport/s
- Number of received UDP datagrams per second for which there was no
application at the destination port (udpNoPorts).
The output for the flag -z provides information about the
utilization of the IPv6-layer (formal SNMP-names between brackets):
- inrecv/s
- Number of input IPv6-datagrams received from interfaces per second,
including those received in error (ipv6IfStatsInReceives).
- outreq/s
- Number of IPv6-datagrams per second that local higher-layer protocols
supplied to IP in requests for transmission (ipv6IfStatsOutRequests). This
counter does not include any forwarded datagrams.
- inmc/s
- Number of multicast packets per second that have been received by the
interface (ipv6IfStatsInMcastPkts).
- outmc/s
- Number of multicast packets per second that have been transmitted to the
interface (ipv6IfStatsOutMcastPkts).
- indeliv/s
- Number of IP datagrams successfully delivered per second to IPv6
user-protocols, including ICMP (ipv6IfStatsInDelivers).
- reasmok/s
- Number of IPv6 datagrams successfully reassembled per second
(ipv6IfStatsReasmOKs).
- fragcre/s
- Number of IPv6 datagram fragments generated per second at this entity
(ipv6IfStatsOutFragCreates).
The output for the flag -Z provides information about the
failures that were detected in the IPv6-layer (formal SNMP-names between
brackets):
- in: dsc/s
- Number of input IPv6 datagrams per second for which no problems were
encountered to prevent their continued processing but that were discarded,
e.g. for lack of buffer space (ipv6IfStatsInDiscards).
- in: hder/s
- Number of input datagrams per second discarded due to errors in the IPv6
header (ipv6IfStatsInHdrErrors).
- in: ader/s
- Number of input datagrams per second discarded because the IPv6 address in
the destination field was not valid to be received by this entity
(ipv6IfStatsInAddrErrors).
- in: unkp/s
- Number of locally-addressed datagrams per second that were discarded
because of an unknown or unsupported protocol
(ipv6IfStatsInUnknownProtos).
- in:
ratim/s
- Number of timeout-situations per second while other IPv6 fragments were
expected for successful reassembly (ipv6ReasmTimeout).
- in:
rfail/s
- Number of failures detected per second by the IPv6 reassembly-algorithm
(ipv6IfStatsReasmFails).
- out: dsc/s
- Number of output IPv6 datagrams per second for which no problems were
encountered to prevent their continued processing but that were discarded,
e.g. for lack of buffer space (ipv6IfStatsOutDiscards).
- out: nrt/s
- Number of IPv6 datagrams per second discarded because no route could be
found (ipv6IfStatsInNoRoutes).
The output for the flag -k provides information about the
general utilization of the ICMPv6-layer and some information per type of
ICMP-message (formal SNMP-names between brackets):
- intot/s
- Number of ICMPv6 messages (any type) received per second at the interface
(ipv6IfIcmpInMsgs).
- outtot/s
- Number of ICMPv6 messages (any type) transmitted per second from this
entity (ipv6IfIcmpOutMsgs).
- inerr/s
- Number of ICMPv6 messages received per second that had ICMP-specific
errors, such as bad ICMP checksums, bad length, etc
(ipv6IfIcmpInErrors).
- innsol/s
- Number of ICMP Neighbor Solicit messages received per second
(ipv6IfIcmpInNeighborSolicits).
- innadv/s
- Number of ICMP Neighbor Advertisement messages received per second
(ipv6IfIcmpInNeighborAdvertisements).
- otnsol/s
- Number of ICMP Neighbor Solicit messages transmitted per second
(ipv6IfIcmpOutNeighborSolicits).
- otnadv/s
- Number of ICMP Neighbor Advertisement messages transmitted per second
(ipv6IfIcmpOutNeighborAdvertisements).
The output for the flag -K provides information about other
types of ICMPv6-messages (formal SNMP-names between brackets):
- iecho/s
- Number of ICMP Echo (request) messages received per second
(ipv6IfIcmpInEchos).
- ierep/s
- Number of ICMP Echo-Reply messages received per second
(ipv6IfIcmpInEchoReplies).
- oerep/s
- Number of ICMP Echo-Reply messages transmitted per second
(ipv6IfIcmpOutEchoReplies).
- idu/s
- Number of ICMP Destination Unreachable messages received per second
(ipv6IfIcmpInDestUnreachs).
- odu/s
- Number of ICMP Destination Unreachable messages transmitted per second
(ipv6IfIcmpOutDestUnreachs).
- ird/s
- Number of ICMP Redirect messages received per second
(ipv6IfIcmpInRedirects).
- ord/s
- Number of ICMP Redirect messages transmitted per second
(ipv6IfIcmpOutRedirect).
- ite/s
- Number of ICMP Time Exceeded messages received per second
(ipv6IfIcmpInTimeExcds).
- ote/s
- Number of ICMP Time Exceeded messages transmitted per second
(ipv6IfIcmpOutTimeExcds).
The output for the flag -U provides information about the
utilization of the UDPv6-layer (formal SNMP-names between brackets):
- indgram/s
- Number of UDPv6 datagrams per second delivered to UDP users
(udpInDatagrams),
- outdgram/s
- Number of UDPv6 datagrams transmitted per second from this entity
(udpOutDatagrams),
- inerr/s
- Number of received UDPv6 datagrams per second that could not be delivered
for reasons other than the lack of an application at the destination port
(udpInErrors).
- noport/s
- Number of received UDPv6 datagrams per second for which there was no
application at the destination port (udpNoPorts).
The output for the flag -t provides information about the
utilization of the TCP-layer (formal SNMP-names between brackets):
- insegs/s
- Number of received segments per second, including those received in error
(tcpInSegs).
- outsegs/s
- Number of transmitted segments per second, excluding those containing only
retransmitted octets (tcpOutSegs).
- actopen/s
- Number of active opens per second that have been supported by this entity
(tcpActiveOpens).
- pasopen/s
- Number of passive opens per second that have been supported by this entity
(tcpPassiveOpens).
- nowopen
- Number of connections currently open (snapshot), for which the state is
either ESTABLISHED or CLOSE-WAIT (tcpCurrEstab).
The output for the flag -T provides information about the
failures that were detected in the TCP-layer (formal SNMP-names between
brackets):
- inerr/s
- Number of received segments per second received in error (tcpInErrs).
- retrans/s
- Number of retransmitted segments per second (tcpRetransSegs).
- attfail/s
- Number of failed connection attempts per second that have occurred at this
entity (tcpAttemptFails).
- estabreset/s
- Number of resets per second that have occurred at this entity
(tcpEstabResets).
- outreset/s
- Number of transmitted segments per second containing the RST flag
(tcpOutRsts).
The output for the flag -h provides information about
utilization of Infiniband ports:
- controller
- Name of controller.
- port
- Controller port.
- busy
- Busy percentage for this port.
- ipack/s
- Number of packets received from this port per second.
- opack/s
- Number of packets transmitted to this port per second.
- igbps/s
- Effective number of gigabits received per second.
- ogbps/s
- Effective number of gigabits transmitted per second.
- maxgbps/s
- Maximum rate as number of gigabits per second.
- lanes
- Number of lanes.
The output for the flag -O provides information about the
top-3 of processes with the highest processor consumption:
- pid
- Process-id (if zero, the process has exited while the pid could not be
determined).
- command
- The name of the process.
- cpu%
- The percentage of cpu-capacity being consumed. This value can exceed 100%
for a multithreaded process running on a multiprocessor machine.
The output for the flag -G provides information about the
top-3 of processes with the highest memory consumption:
- pid
- Process-id (if zero, the process has exited while the pid could not be
determined).
- command
- The name of the process.
- mem%
- The percentage of resident memory-utilization by this process.
The output for the flag -D provides information about the
top-3 of processes that issue the most read and write accesses to disk:
- pid
- Process-id (if zero, the process has exited while the pid could not be
determined).
- command
- The name of the process.
- dsk%
- The percentage of read and write accesses related to the total number of
read and write accesses issued on disk by all processes, so a high
percentage does not imply a high disk load on system level.
The output for the flag -N provides information about the
top-3 of processes that issue the most socket transfers for IPv4/IPv6:
- pid
- Process-id (if zero, the process has exited while the pid could not be
determined).
- command
- The name of the process.
- net%
- The percentage of socket transfers related to the total number of
transfers issued by all processes, so a high percentage does not imply a
high network load on system level.
To see today's cpu-activity so far (supposed that atop is
logging in the background):
- pcp-atopsar
To see the memory occupation for June 5, 2018 between 10:00 and
12:30 (supposed that pmlogger has been logging daily in the
background on host acme.com):
- pcp-atopsar -m -r $PCP_LOG_DIR/pmlogger/acme.com/20180605 -b
10:00 -e 12:30
-
or
- pcp-atopsar -m -r 20180605 -b 10:00 -e 12:30
-
or, suppose it is June 8, 2018 at this moment
- pcp-atopsar -m -r yyy -b 10:00 -e 12:30
Write a logfile with atop to record the system behaviour
for 30 minutes (30 samples of one minute) and produce all available reports
afterwards:
- pcp-atop -w /tmp/atoplog 60 30
- pcp-atopsar -A -r /tmp/atoplog
To watch TCP activity evolve for ten minutes (10 samples with
sixty seconds interval):
- pcp-atopsar -t 60 10
To watch the header-lines ('_' as last character) of all reports
with only the detail-lines showing critical resource consumption (marker '*'
or '+' as last character):
- pcp-atopsar -AM | grep '[_*+]$'
- /etc/atoprc
- Configuration file containing system-wide default values (mainly flags).
See related man-page.
- ~/.atoprc
- Configuration file containing personal default values (mainly flags). See
related man-page.
- $PCP_LOG_DIR/pmlogger/HOST/YYYYMMDD
- Daily data file, where YYYYMMDD are digits representing the date,
and HOST is the hostname of the machine being logged.
Environment variables with the prefix PCP_ are used to
parameterize the file and directory names used by PCP. On each installation,
the file /etc/pcp.conf contains the local values for these variables.
The $PCP_CONF variable may be used to specify an alternative
configuration file, as described in pcp.conf(5).
For environment variables affecting PCP tools, see
pmGetOptions(3).