There are many times when you need to wait for something to finish, such as:
Some of these processes have some sort of progress indication, but sometimes the process is run through a layer of abstraction, and the only way to measure the progress is through its side effects. Some of these might be:
- A file being downloaded keeps growing.
- A directory extracted from a tarball fills up with files.
- The Ansible job builds a container.
You can query all of these things with commands like these:
$ ls -l downloaded-file $ find . | wc -l $ podman ps $ docker ps
But running these commands over and over, even if it is with the convenience of Bash history and the Up Arrow, is tedious.
Another approach is to write a little Bash script to automate these commands for you:
while : do docker ps sleep 2 done
But such scripts can also become tedious to write. You could write a little generic script and package it, so it's always available to you. Luckily, other open source developers have already been there and done that.
The result is the command
watch command is part of the
procps-ng package, so if you're on Linux, you already have it installed.
watch command periodically runs a command and shows its output. It has some text-terminal niceties, so only the latest output is on the screen.
The simplest usage is:
For example, prefixing the
docker ps command with
watch works like this:
$ watch docker ps
watch command, and a few creative Unix command-line tricks, can generate ad-hoc dashboards. For example, to count audit events:
$ watch 'grep audit: /var/log/kern.log |wc -l'
In the last example, it is probably useful if there's a visual indication that the number of audit events changed. If change is expected, but you want something to look "different,"
watch --differences works well. It highlights any differences from the last run. This works especially well if you are grepping in multiple files, so you can easily see which one changed.
If changes are not expected, you can ask for them to be highlighted "permanently" to know which ones to investigate by using
watch --differences=permanent. This is often more useful.
Finally, sometimes the command might be resource-intensive and should not be run too frequently. The
-n parameter controls the frequency. Watch uses two seconds by default, but
watch -n 10 might be appropriate for something more resource-intensive, like grepping for a pattern in any file in a subdirectory:
$ watch -n 10 'find . -type f | xargs grep suspicious-pattern'
Watch a command with watch
watch command is useful for many ad-hoc system administration tasks where you need to wait for some time-consuming step, without a progress bar, before moving on to the next one. Though this is not a great situation to be in,
watch can make it slightly better—and give you time to start working on those notes for the retrospective! Download the cheat sheet to keep helpful syntax and options close at hand.