1ATOPSAR(1) General Commands Manual ATOPSAR(1)
2
3
4
6 atopsar - Advanced System Activity Report (atop related)
7
9 atopsar [-flags...] [-r file|date ] [-R cnt ] [-b hh:mm ] [-e hh:mm ]
10 atopsar [-flags...] interval [ samples ]
11
13 The program atopsar can be used to report statistics on system level.
14
15 In the first synopsis line (no sampling interval specified), atopsar
16 extracts data from a raw logfile that has been recorded previously by
17 the program atop (option -w of the atop program).
18 You can specify the name of the logfile with the -r option of the atop‐
19 sar program. When a daily logfile of atop is used, named
20 /var/log/atop/atop_YYYYMMDD (where YYYYMMDD reflects the date), the
21 required date of the form YYYYMMDD can be specified with the -r option
22 instead of the filename, or the symbolic name 'y' can be used for yes‐
23 terday's daily logfile (this can be repeated so 'yyyy' indicates the
24 logfile of four days ago). If the -r option is not specified at all,
25 today's daily logfile is used by default.
26 The starting and ending times of the report can be defined using the
27 options -b and -e followed by a time argument of the form hh:mm.
28
29 In the second synopsis line, atopsar reads actual activity counters
30 from the kernel with the specified interval (in seconds) and the speci‐
31 fied number of samples (optionally). When atopsar is activated in this
32 way it immediately sends the output for every requested report to stan‐
33 dard output. If only one type of report is requested, the header is
34 printed once and after every interval seconds the statistical counters
35 are shown for that period. If several reports are requested, a header
36 is printed per sample followed by the statistical counters for that
37 period.
38
39 Some generic flags can be specified to influence the behaviour of the
40 atopsar program:
41
42 -S By default the timestamp at the beginning of a line is suppressed
43 if more lines are shown for one interval. With this flag a time‐
44 stamp is given for every output-line (easier for post-processing).
45
46 -a By default certain resources as disks and network interfaces are
47 only shown when they were active during the interval. With this
48 flag all resources of a given type are shown, even if they were
49 inactive during the interval.
50
51 -x By default atopsar only uses colors if output is directed to a
52 terminal (window). These colors might indicate that a critical
53 occupation percentage has been reached (red) or has been almost
54 reached (cyan) for a particular resource. See the man-page of
55 atop for a detailed description of this feature (section COLORS).
56 With the flag -x the use of colors is suppressed unconditionally.
57
58 -C By default atopsar only uses colors if output is directed to a
59 terminal (window). These colors might indicate that a critical
60 occupation percentage has been reached (red) or has been almost
61 reached (cyan) for a particular resource. See the man-page of
62 atop for a detailed description of this feature (section COLORS).
63 With the flag -C colors will always be used, even if output is not
64 directed to a terminal.
65
66 -M Use markers at the end of a line to indicate that a critical occu‐
67 pation percentage has been reached ('*') or has been almost
68 reached ('+') for particular resources. The marker '*' is similar
69 to the color red and the marker '+' to the color cyan. See the
70 man-page of atop for a detailed description of these colors (sec‐
71 tion COLORS).
72
73 -H Repeat the header line within a report for every N detail lines.
74 The value of N is determined dynamically in case of output to a
75 tty/window (depending on the number of lines); for output to a
76 file or pipe this value is 23.
77
78 -R Summarize cnt samples into one sample. When the logfile contains
79 e.g. samples of 10 minutes, the use of the flag '-R 6' shows a
80 report with one sample for every hour.
81
82 Other flags are used to define which reports are required:
83
84 -A Show all possible reports.
85
86 -c Report about CPU utilization (in total and per cpu).
87
88 -p Report about processor-related matters, like load-averages and
89 hardware interrupts.
90
91 -P Report about processes.
92
93 -m Current memory- and swap-occupation.
94
95 -s Report about paging- and swapping-activity, and overcommitment.
96
97 -l Report about utilization of logical volumes.
98
99 -f Report about utilization of multiple devices.
100
101 -d Report about utilization of disks.
102
103 -n Report about NFS mounted filesystems on NFS client.
104
105 -j Report about NFS client activity.
106
107 -J Report about NFS server activity.
108
109 -i Report about the network interfaces.
110
111 -I Report about errors for network-interfaces.
112
113 -w Report about IP version 4 network traffic.
114
115 -W Report about errors for IP version 4 traffic.
116
117 -y General report about ICMP version 4 layer activity.
118
119 -Y Per-type report about ICMP version 4 layer activity.
120
121 -u Report about UDP version 4 network traffic.
122
123 -z Report about IP version 6 network traffic.
124
125 -Z Report about errors for IP version 6 traffic.
126
127 -k General report about ICMP version 6 layer activity.
128
129 -K Per-type report about ICMP version 6 layer activity.
130
131 -U Report about UDP version 6 network traffic.
132
133 -t Report about TCP network traffic.
134
135 -T Report about errors for TCP-traffic.
136
137 -O Report about top-3 processes consuming most processor capacity.
138 This report is only available when using a log file (not when
139 specifying an interval).
140
141 -G Report about top-3 processes consuming most resident memory. This
142 report is only available when using a log file (not when specify‐
143 ing an interval).
144
145 -D Report about top-3 processes issueing most disk transfers. This
146 report is only available when using a log file (not when specify‐
147 ing an interval).
148
149 -N Report about top-3 processes issueing most IPv4/IPv6 socket trans‐
150 fers. This report is only available when using a log file (not
151 when specifying an interval).
152
154 Depending on the requested report, a number of columns with output val‐
155 ues are produced. The values are mostly presented as a number of
156 events per second.
157
158 The output for the flag -c contains the following columns per cpu:
159
160 usr% Percentage of cpu-time consumed in user mode (program text)
161 for all active processes running with a nice value of zero
162 (default) or a negative nice value (which means a higher
163 priority than usual). The cpu consumption in user mode of
164 processes with a nice value larger than zero (lower prior‐
165 ity) is indicated in the nice%-column.
166
167 nice% Percentage of cpu time consumed in user mode (i.e. program
168 text) for all processes running witn a nice value larger
169 than zero (which means with a lower priority than average).
170
171 sys% Percentage of cpu time consumed in system mode (kernel
172 text) for all active processes. A high percentage usually
173 indicates a lot of system calls being issued.
174
175 irq% Percentage of cpu time consumed for handling of device
176 interrupts.
177
178 softirq% Percentage of cpu time consumed for soft interrupt han‐
179 dling.
180
181 steal% Percentage of cpu time stolen by other virtual machines
182 running on the same hardware.
183
184 guest% Percentage of cpu time used by other virtual machines run‐
185 ning on the same hardware (overlaps with usr%/nice%).
186
187 wait% Percentage of unused cpu time while at least one of the
188 processes in wait-state awaits completion of disk I/O.
189
190 idle% Percentage of unused cpu time because all processes are in
191 a wait-state but not waiting for disk-I/O.
192
193 The output for the flag -p contains the following values:
194
195 pswch/s Number of process switches (also called context switches)
196 per second on this cpu. A process switch occurs at the
197 moment that an active thread (i.e. the thread using a cpu)
198 enters a wait state or has used its time slice completely;
199 another thread will then be chosen to use the cpu.
200
201 devintr/s Number of hardware interrupts handled per second on this
202 cpu.
203
204 clones/s The number of new threads started per second.
205
206 loadavg1 Load average reflecting the average number of threads in
207 the runqueue or in non-interruptible wait state (usually
208 waiting for disk or tape I/O) during the last minute.
209
210 loadavg5 Load average reflecting the average number of threads in
211 the runqueue or in non-interruptible wait state (usually
212 waiting for disk or tape I/O) during the last 5 minutes.
213
214 loadavg15 Load average reflecting the average number of threads in
215 the runqueue or in non-interruptible wait state (usually
216 waiting for disk or tape I/O) during the last 15 minutes.
217
218 The output for the flag -P contains information about the processes and
219 threads:
220
221 clones/s The number of new threads started per second.
222
223 pexit/s
224
225 curproc Total number of processes present in the system.
226
227 curzomb Number of zombie processes present in the system.
228
229 thrrun Total number of threads present in the system in state
230 'running'.
231
232 thrslpi Total number of threads present in the system in state
233 'interruptible sleeping'.
234
235 thrslpu Total number of threads present in the system in state
236 'uninterruptible sleeping'.
237
238 The output for the flag -m contains information about the memory- and
239 swap-utilization:
240
241 memtotal Total usable main memory size.
242
243 memfree Available main memory size at this moment (snapshot).
244
245 buffers Main memory used at this moment to cache metadata-blocks
246 (snapshot).
247
248 cached Main memory used at this moment to cache data-blocks (snap‐
249 shot).
250
251 dirty Amount of memory in the page cache that still has to be
252 flushed to disk at this moment (snapshot).
253
254 slabmem Main memory used at this moment for dynamically allocated
255 memory by the kernel (snapshot).
256
257 swptotal Total swap space size at this moment (snapshot).
258
259 swpfree Available swap space at this moment (snapshot).
260
261 The output for the flag -s contains information about the frequency of
262 swapping:
263
264 pagescan/s Number of scanned pages per second due to the fact that
265 free memory drops below a particular threshold.
266
267 swapin/s The number of memory-pages the system read from the swap-
268 device per second.
269
270 swapout/s The number of memory-pages the system wrote to the swap-
271 device per second.
272
273 commitspc The committed virtual memory space i.e. the reserved vir‐
274 tual space for all allocations of private memory space for
275 processes.
276
277 commitlim The maximum limit for the committed space, which is by
278 default swap size plus 50% of memory size. The kernel only
279 verifies whether the committed space exceeds the limit if
280 strict overcommit handling is configured (vm.overcom‐
281 mit_memory is 2).
282
283 The output for the flags -l (LVM), -f (MD), and -d (hard disk) contains
284 the following columns per active unit:
285
286 disk Name.
287
288 busy Busy-percentage of the unit (i.e. the portion of time that
289 the device was busy handling requests).
290
291 read/s Number of read-requests issued per second on this unit.
292
293 KB/read Average number of Kbytes transferred per read-request for
294 this unit.
295
296 writ/s Number of write-requests issued per second on this unit.
297
298 KB/writ Average number of Kbytes transferred per write-request for
299 this unit.
300
301 avque Average number of requests outstanding in the queue during
302 the time that the unit is busy.
303
304 avserv Average number of milliseconds needed by a request on this
305 unit (seek, latency and data-transfer).
306
307 The output for the flag -n contains information about activity on NFS
308 mounted filesystems (client):
309
310 mounted_device
311 Mounted device containing server name and server directory
312 being mounted.
313
314 physread/s Kilobytes data physically read from the NFS server by pro‐
315 cesses running on the NFS client.
316
317 KBwrite/s Kilobytes data physically written to the NFS server by pro‐
318 cesses running on the NFS client.
319 When the NFS filesystem was mounted during the interval,
320 the state 'M' is shown.
321
322 The output for the flag -j contains information about NFS client activ‐
323 ity:
324
325 rpc/s Number of RPC calls per second issued to NFS server(s).
326
327 rpcread/s Number of read RPC calls per second issued to NFS
328 server(s).
329
330 rpcwrite/s Number of write RPC calls per second issued to NFS
331 server(s).
332
333 retrans/s Number of retransmitted RPC calls per second.
334
335 autrefresh/s
336 Number of authorization refreshes per second.
337
338 The output for the flag -J contains information about NFS server activ‐
339 ity:
340
341 rpc/s Number of RPC calls per second received from NFS client(s).
342
343 rpcread/s Number of read RPC calls per second received from NFS
344 client(s).
345
346 rpcwrite/s Number of write RPC calls per second received from NFS
347 client(s).
348
349 MBcr/s Number of Megabytes per second returned to read requests by
350 clients.
351
352 MBcw/s Number of Megabytes per second passed in write requests by
353 clients.
354
355 nettcp/s Number of requests per second handled via TCP.
356
357 netudp/s Number of requests per second handled via UDP.
358
359 The output for the flag -i provides information about utilization of
360 network interfaces:
361
362 interf Name of interface.
363
364 busy Busy percentage for this interface. If the linespeed of
365 this interface could not be determined (for virtual inter‐
366 faces or in case that atop or atopsar had no root-privi‐
367 leges), a question mark is shown.
368
369 ipack/s Number of packets received from this interface per second.
370
371 opack/s Number of packets transmitted to this interface per second.
372
373 iKbyte/s Number of Kbytes received from this interface per second.
374
375 oKbyte/s Number of Kbytes transmitted via this interface per second.
376
377 imbps/s Effective number of megabits received per second.
378
379 ombps/s Effective number of megabits transmitted per second.
380
381 maxmbps/s Linespeed as number of megabits per second. If the line‐
382 speed could not be determined (for virtual interfaces or in
383 case that atop or atopsar had no root-privileges), value 0
384 is shown.
385 The linespeed is followed by the indication 'f' (full
386 duplex) or 'h' (half duplex).
387
388 The output for the flag -I provides information about the failures that
389 were detected for network interfaces:
390
391 interf Name of interface.
392
393 ierr/s Number of bad packets received from this interface per sec‐
394 ond.
395
396 oerr/s Number of times that packet transmission to this interface
397 failed per second.
398
399 coll/s Number of collisions encountered per second while transmit‐
400 ting packets.
401
402 idrop/s Number of received packets dropped per second due to lack
403 of buffer-space in the local system.
404
405 odrop/s Number of transmitted packets dropped per second due to
406 lack of buffer-space in the local system.
407
408 iframe/s Number of frame alignment-errors encountered per second on
409 received packets.
410
411 ocarrier/s Number of carrier-errors encountered per second on trans‐
412 mitted packets.
413
414 The output for the flag -w provides information about the utilization
415 of the IPv4-layer (formal SNMP-names between brackets):
416
417 inrecv/s Number of IP datagrams received from interfaces per second,
418 including those received in error (ipInReceives).
419
420 outreq/s Number of IP datagrams that local higher-layer protocols
421 supplied to IP in requests for transmission per second
422 (ipOutRequests).
423
424 indeliver/s Number of received IP datagrams that have been successfully
425 delivered to higher protocol-layers per second (ipInDeliv‐
426 ers).
427
428 forward/s Number of received IP datagrams per second for which this
429 entity was not their final IP destination, as a result of
430 which an attempt was made to forward (ipForwDatagrams).
431
432 reasmok/s Number of IP datagrams successfully reassembled per second
433 (ipReasmOKs).
434
435 fragcreat/s Number of IP datagram fragments generated per second at
436 this entity (ipFragCreates).
437
438 The output for the flag -W provides information about the failures that
439 were detected in the IPv4-layer (formal SNMP-names between brackets):
440
441 in: dsc/s Number of input IP datagrams per second for which no prob‐
442 lems were encountered to prevent their continued processing
443 but that were discarded, e.g. for lack of buffer space
444 (ipInDiscards).
445
446 in: hder/s Number of input IP datagrams per second discarded due to
447 errors in the IP header (ipInHdrErrors).
448
449 in: ader/s Number of input IP datagrams per second discarded because
450 the IP address in the destination field was not valid to be
451 received by this entity (ipInAddrErrors).
452
453 in: unkp/s Number of inbound packets per second that were discarded
454 because of an unknown or unsupported protocol (ipInUnknown‐
455 Protos).
456
457 in: ratim/s Number of timeout-situations per second while other frag‐
458 ments were expected for successful reassembly (ipReasmTime‐
459 out).
460
461 in: rfail/s Number of failures detected per second by the IP reassembly
462 algorithm (ipReasmFails).
463
464 out: dsc/s Number of output IP datagrams per second for which no prob‐
465 lems were encountered to prevent their continued processing
466 but that were discarded, e.g. for lack of buffer space
467 (ipOutDiscards).
468
469 out: nrt/s Number of IP datagrams per second discarded because no
470 route could be found (ipOutNoRoutes).
471
472 The output for the flag -y provides information about the general uti‐
473 lization of the ICMPv4-layer and some information per type of ICMP-mes‐
474 sage (formal SNMP-names between brackets):
475
476 intot/s Number of ICMP messages (any type) received per second at
477 this entity (icmpInMsgs).
478
479 outtot/s Number of ICMP messages (any type) transmitted per second
480 from this entity (icmpOutMsgs).
481
482 inecho/s Number of ICMP Echo (request) messages received per second
483 (icmpInEchos).
484
485 inerep/s Number of ICMP Echo-Reply messages received per second
486 (icmpInEchoReps).
487
488 otecho/s Number of ICMP Echo (request) messages transmitted per sec‐
489 ond (icmpOutEchos).
490
491 oterep/s Number of ICMP Echo-Reply messages transmitted per second
492 (icmpOutEchoReps).
493
494 The output for the flag -Y provides information about other types of
495 ICMPv4-messages (formal SNMP-names between brackets):
496
497 ierr/s Number of ICMP messages received per second but determined
498 to have ICMP-specific errors (icmpInErrors).
499
500 isq/s Number of ICMP Source Quench messages received per second
501 (icmpInSrcQuenchs).
502
503 ird/s Number of ICMP Redirect messages received per second (icmp‐
504 InRedirects).
505
506 idu/s Number of ICMP Destination Unreachable messages received
507 per second (icmpInDestUnreachs).
508
509 ite/s Number of ICMP Time Exceeded messages received per second
510 (icmpOutTimeExcds).
511
512 oerr/s Number of ICMP messages transmitted per second but deter‐
513 mined to have ICMP-specific errors (icmpOutErrors).
514
515 osq/s Number of ICMP Source Quench messages transmitted per sec‐
516 ond (icmpOutSrcQuenchs).
517
518 ord/s Number of ICMP Redirect messages transmitted per second
519 (icmpOutRedirects).
520
521 odu/s Number of ICMP Destination Unreachable messages transmitted
522 per second (icmpOutDestUnreachs).
523
524 ote/s Number of ICMP Time Exceeded messages transmitted per sec‐
525 ond (icmpOutTimeExcds).
526
527 The output for the flag -u provides information about the utilization
528 of the UDPv4-layer (formal SNMP-names between brackets):
529
530 indgram/s Number of UDP datagrams per second delivered to UDP users
531 (udpInDatagrams).
532
533 outdgram/s Number of UDP datagrams transmitted per second from this
534 entity (udpOutDatagrams).
535
536 inerr/s Number of received UDP datagrams per second that could not
537 be delivered for reasons other than the lack of an applica‐
538 tion at the destination port (udpInErrors).
539
540 noport/s Number of received UDP datagrams per second for which there
541 was no application at the destination port (udpNoPorts).
542
543 The output for the flag -z provides information about the utilization
544 of the IPv6-layer (formal SNMP-names between brackets):
545
546 inrecv/s Number of input IPv6-datagrams received from interfaces per
547 second, including those received in error (ipv6IfStatsInRe‐
548 ceives).
549
550 outreq/s Number of IPv6-datagrams per second that local higher-layer
551 protocols supplied to IP in requests for transmission
552 (ipv6IfStatsOutRequests). This counter does not include
553 any forwarded datagrams.
554
555 inmc/s Number of multicast packets per second that have been
556 received by the interface (ipv6IfStatsInMcastPkts).
557
558 outmc/s Number of multicast packets per second that have been
559 transmitted to the interface (ipv6IfStatsOutMcastPkts).
560
561 indeliv/s Number of IP datagrams successfully delivered per second to
562 IPv6 user-protocols, including ICMP (ipv6IfStatsInDeliv‐
563 ers).
564
565 reasmok/s Number of IPv6 datagrams successfully reassembled per sec‐
566 ond (ipv6IfStatsReasmOKs).
567
568 fragcre/s Number of IPv6 datagram fragments generated per second at
569 this entity (ipv6IfStatsOutFragCreates).
570
571 The output for the flag -Z provides information about the failures that
572 were detected in the IPv6-layer (formal SNMP-names between brackets):
573
574 in: dsc/s Number of input IPv6 datagrams per second for which no
575 problems were encountered to prevent their continued pro‐
576 cessing but that were discarded, e.g. for lack of buffer
577 space (ipv6IfStatsInDiscards).
578
579 in: hder/s Number of input datagrams per second discarded due to
580 errors in the IPv6 header (ipv6IfStatsInHdrErrors).
581
582 in: ader/s Number of input datagrams per second discarded because the
583 IPv6 address in the destination field was not valid to be
584 received by this entity (ipv6IfStatsInAddrErrors).
585
586 in: unkp/s Number of locally-addressed datagrams per second that were
587 discarded because of an unknown or unsupported protocol
588 (ipv6IfStatsInUnknownProtos).
589
590 in: ratim/s Number of timeout-situations per second while other IPv6
591 fragments were expected for successful reassembly
592 (ipv6ReasmTimeout).
593
594 in: rfail/s Number of failures detected per second by the IPv6 reassem‐
595 bly-algorithm (ipv6IfStatsReasmFails).
596
597 out: dsc/s Number of output IPv6 datagrams per second for which no
598 problems were encountered to prevent their continued pro‐
599 cessing but that were discarded, e.g. for lack of buffer
600 space (ipv6IfStatsOutDiscards).
601
602 out: nrt/s Number of IPv6 datagrams per second discarded because no
603 route could be found (ipv6IfStatsInNoRoutes).
604
605 The output for the flag -k provides information about the general uti‐
606 lization of the ICMPv6-layer and some information per type of ICMP-mes‐
607 sage (formal SNMP-names between brackets):
608
609 intot/s Number of ICMPv6 messages (any type) received per second at
610 the interface (ipv6IfIcmpInMsgs).
611
612 outtot/s Number of ICMPv6 messages (any type) transmitted per second
613 from this entity (ipv6IfIcmpOutMsgs).
614
615 inerr/s Number of ICMPv6 messages received per second that had
616 ICMP-specific errors, such as bad ICMP checksums, bad
617 length, etc (ipv6IfIcmpInErrors).
618
619 innsol/s Number of ICMP Neighbor Solicit messages received per sec‐
620 ond (ipv6IfIcmpInNeighborSolicits).
621
622 innadv/s Number of ICMP Neighbor Advertisement messages received per
623 second (ipv6IfIcmpInNeighborAdvertisements).
624
625 otnsol/s Number of ICMP Neighbor Solicit messages transmitted per
626 second (ipv6IfIcmpOutNeighborSolicits).
627
628 otnadv/s Number of ICMP Neighbor Advertisement messages transmitted
629 per second (ipv6IfIcmpOutNeighborAdvertisements).
630
631 The output for the flag -K provides information about other types of
632 ICMPv6-messages (formal SNMP-names between brackets):
633
634 iecho/s Number of ICMP Echo (request) messages received per second
635 (ipv6IfIcmpInEchos).
636
637 ierep/s Number of ICMP Echo-Reply messages received per second
638 (ipv6IfIcmpInEchoReplies).
639
640 oerep/s Number of ICMP Echo-Reply messages transmitted per second
641 (ipv6IfIcmpOutEchoReplies).
642
643 idu/s Number of ICMP Destination Unreachable messages received
644 per second (ipv6IfIcmpInDestUnreachs).
645
646 odu/s Number of ICMP Destination Unreachable messages transmitted
647 per second (ipv6IfIcmpOutDestUnreachs).
648
649 ird/s Number of ICMP Redirect messages received per second
650 (ipv6IfIcmpInRedirects).
651
652 ord/s Number of ICMP Redirect messages transmitted per second
653 (ipv6IfIcmpOutRedirect).
654
655 ite/s Number of ICMP Time Exceeded messages received per second
656 (ipv6IfIcmpInTimeExcds).
657
658 ote/s Number of ICMP Time Exceeded messages transmitted per sec‐
659 ond (ipv6IfIcmpOutTimeExcds).
660
661 The output for the flag -U provides information about the utilization
662 of the UDPv6-layer (formal SNMP-names between brackets):
663
664 indgram/s Number of UDPv6 datagrams per second delivered to UDP users
665 (udpInDatagrams),
666
667 outdgram/s Number of UDPv6 datagrams transmitted per second from this
668 entity (udpOutDatagrams),
669
670 inerr/s Number of received UDPv6 datagrams per second that could
671 not be delivered for reasons other than the lack of an
672 application at the destination port (udpInErrors).
673
674 noport/s Number of received UDPv6 datagrams per second for which
675 there was no application at the destination port (udpNo‐
676 Ports).
677
678 The output for the flag -t provides information about the utilization
679 of the TCP-layer (formal SNMP-names between brackets):
680
681 insegs/s Number of received segments per second, including those
682 received in error (tcpInSegs).
683
684 outsegs/s Number of transmitted segments per second, excluding those
685 containing only retransmitted octets (tcpOutSegs).
686
687 actopen/s Number of active opens per second that have been supported
688 by this entity (tcpActiveOpens).
689
690 pasopen/s Number of passive opens per second that have been supported
691 by this entity (tcpPassiveOpens).
692
693 nowopen Number of connections currently open (snapshot), for which
694 the state is either ESTABLISHED or CLOSE-WAIT (tcpCur‐
695 rEstab).
696
697 The output for the flag -T provides information about the failures that
698 were detected in the TCP-layer (formal SNMP-names between brackets):
699
700 inerr/s Number of received segments per second received in error
701 (tcpInErrs).
702
703 retrans/s Number of retransmitted segments per second (tcpRe‐
704 transSegs).
705
706 attfail/s Number of failed connection attempts per second that have
707 occurred at this entity (tcpAttemptFails).
708
709 estabreset/s
710 Number of resets per second that have occurred at this
711 entity (tcpEstabResets).
712
713 outreset/s Number of transmitted segments per second containing the
714 RST flag (tcpOutRsts).
715
716 The output for the flag -O provides information about the top-3 of pro‐
717 cesses with the highest processor consumption:
718
719 pid Process-id (if zero, the process has exited while the pid
720 could not be determined).
721
722 command The name of the process.
723
724 cpu% The percentage of cpu-capacity being consumed. This value
725 can exceed 100% for a multithreaded process running on a
726 multiprocessor machine.
727
728 The output for the flag -G provides information about the top-3 of pro‐
729 cesses with the highest memory consumption:
730
731 pid Process-id (if zero, the process has exited while the pid
732 could not be determined).
733
734 command The name of the process.
735
736 mem% The percentage of resident memory-utilization by this
737 process.
738
739 The output for the flag -D provides information about the top-3 of pro‐
740 cesses that issue the most read and write accesses to disk:
741
742 pid Process-id (if zero, the process has exited while the pid
743 could not be determined).
744
745 command The name of the process.
746
747 dsk% The percentage of read and write accesses related to the
748 total number of read and write accesses issued on disk by
749 all processes, so a high percentage does not imply a high
750 disk load on system level.
751
752 The output for the flag -N provides information about the top-3 of pro‐
753 cesses that issue the most socket transfers for IPv4/IPv6:
754
755 pid Process-id (if zero, the process has exited while the pid
756 could not be determined).
757
758 command The name of the process.
759
760 net% The percentage of socket transfers related to the total
761 number of transfers issued by all processes, so a high per‐
762 centage does not imply a high network load on system level.
763
765 To see today's cpu-activity so far (supposed that atop is logging in
766 the background):
767
768 atopsar
769
770 To see the memory occupation for June 5, 2012 between 10:00 and 12:30
771 (supposed that atop has been logging daily in the background):
772
773 atopsar -m -r /var/log/atop_20120605 -b 10:00 -e 12:30
774
775 or
776
777 atopsar -m -r 20120605 -b 10:00 -e 12:30
778
779 or, suppose it is June 8, 2012 at this moment
780
781 atopsar -m -r yyy -b 10:00 -e 12:30
782
783 Write a logfile with atop to record the system behaviour for 30 minutes
784 (30 samples of one minute) and produce all available reports after‐
785 wards:
786
787 atop -w /tmp/atoplog 60 30
788
789 atopsar -A -r /tmp/atoplog
790
791 To watch TCP activity evolve for ten minutes (10 samples with sixty
792 seconds interval):
793
794 atopsar -t 60 10
795
796 To watch the header-lines ('_' as last character) of all reports with
797 only the detail-lines showing critical resource consumption (marker '*'
798 or '+' as last character):
799
800 atopsar -AM | grep '[_*+]$'
801
803 /etc/atoprc
804 Configuration file containing system-wide default values (mainly
805 flags). See related man-page.
806
807 ~/.atoprc
808 Configuration file containing personal default values (mainly
809 flags). See related man-page.
810
811 /var/log/atop/atop_YYYYMMDD
812 Daily data file, where YYYYMMDD are digits representing the date.
813
815 atop(1), atoprc(5), atopacctd(8), netatop(4), netatopd(8)
816 http://www.atoptool.nl
817
819 Gerlof Langeveld (gerlof.langeveld@atoptool.nl)
820
821
822
823Linux March 2017 ATOPSAR(1)