xmhidalgo/atop repository overview

⁠atop: Performance monitor

atop⁠ is a 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.

This project⁠ builds a Docker image including the latest version of atop (v2.5.0).

The Docker image can be used to conveniently run the latest version of atop on old systems and/or systems where the user does not have full control over the OS image (e.g., managed Kubernetes nodes).

A typical application is debugging performance issues on production systems.

⁠Usage

The following command runs atop in interactive mode:

$ docker run --privileged --network=host --pid=host --uts=host --rm -it xmhidalgo/atop

Note that this will run atop as root with full access to the host resources. This is required for atop to properly monitor the host system and processes.

Additional arguments can be provided and will be passed to the atop process running inside the container:

$ alias atop='docker run --privileged --network=host --pid=host --uts=host --rm -it xmhidalgo/atop'
$ atop -V
Version: 2.5.0 - 2020/09/23 03:59:26     <[email protected]>

Here, we have defined a bash alias as a convenience.