From 6d5106d7cac3e26ab5d87f650beabdfc0969bf22 Mon Sep 17 00:00:00 2001 From: xielh <5604895+xielhxie@user.noreply.gitee.com> Date: Fri, 23 Oct 2020 10:42:44 +0800 Subject: [PATCH] update README.en.md. --- README.en.md | 69 ++++++++++++++++++++++++++++++++++------------------ 1 file changed, 45 insertions(+), 24 deletions(-) diff --git a/README.en.md b/README.en.md index 9e7f31e..b44e8b7 100644 --- a/README.en.md +++ b/README.en.md @@ -1,36 +1,57 @@ # atop -#### Description -atop is an interactive monitor to view the load on a Linux system -#### Software Architecture -Software architecture description +### Description -#### Installation +Atop is an interactive monitor to view the load on a Linux system. Atop is an ASCII full-screen performance monitor for Linux +that is capable of reporting the activity of all processes (even if processes have finished during the interval), daily +logging of system and process activity for long-term analysis, highlighting overloaded system resources by using +colors,etcetera. At regular intervals, it shows system-level activity related to the CPU, memory, swap, disks (including LVM) +and network layers, and for every process (and thread) it shows e.g. the CPU utilization, memory growth, disk utilization, +priority, username, state, and exit code. In combination with the optional kernel module netatop, it even shows network +activity per process/thread. In combination with the optional daemon atopgpud, it also shows GPU activity on system level and +process level. -1. xxxx -2. xxxx -3. xxxx +### Highlights +- The command atop has some major advantages compared to other performance monitoring tools: -#### Instructions +- Resource consumption by all processes. It shows the resource consumption by all processes that were active during the +interval, so also the resource consumption by those processes that have finished during the interval. -1. xxxx -2. xxxx -3. xxxx +- Utilization of all relevant resources. Obviously it shows system-level counters concerning utilization of cpu and +memory/swap, however it also shows disk I/O and network utilization counters on system level. -#### Contribution +- Permanent logging of resource utilization. It is able to store raw counters in a file for long-term analysis on system level +and process level. These raw counters are compressed at the moment of writing to minimize disk space usage. By default, the +daily logfiles are preserved for 28 days. System activity reports can be generated from a logfile by using the atopsar +command. -1. Fork the repository -2. Create Feat_xxx branch -3. Commit your code -4. Create Pull Request +- Highlight critical resources.It highlights resources that have (almost) reached a critical load by using colors for the +system statistics. +- Scalable window width. It is able to add or remove columns dynamically at the moment that you enlarge or shrink the width of +your window. -#### Gitee Feature +- Resource consumption by individual threads. It is able to show the resource consumption for each thread within a process. -1. You can use Readme\_XXX.md to support different languages, such as Readme\_en.md, Readme\_zh.md -2. Gitee blog [blog.gitee.com](https://blog.gitee.com) -3. Explore open source project [https://gitee.com/explore](https://gitee.com/explore) -4. The most valuable open source project [GVP](https://gitee.com/gvp) -5. The manual of Gitee [https://gitee.com/help](https://gitee.com/help) -6. The most popular members [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/) +- Watch activity only. By default, it only shows system resources and processes that were really active during the last +interval, so output related to resources or processes that were completely passive during the interval is by default +suppressed. + +- Watch deviations only. For the active system resources and processes, only the load during the last interval is shown (not +the accumulated utilization since system boot or process startup). + +- Accumulated process activity per user. For each interval, it is able to accumulate the resource consumption for all +processes per user. + +- Accumulated process activity per program. For each interval, it is able to accumulate the resource consumption for all +processes with the same name. + +- Accumulated process activity per container. For each interval, it is able to accumulate the resource consumption for all +processes within the same container. + +- Network activity per process. In combination with the optional kernel module netatop, it shows process-level counters +concerning the number of TCP and UDP packets transferred, and the consumed network bandwidth per process. + +- GPU activity on system level and per process. In combination with the optional daemon atopgpud, it shows system-level and +process-level counters concerning the load and memory utilization per GPU. \ No newline at end of file -- Gitee