Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 10 additions & 0 deletions docs/06-Troubleshooting/shell.md
Original file line number Diff line number Diff line change
Expand Up @@ -227,6 +227,16 @@ ig -h
ig run trace_dns:latest
```

## [mpstat](https://www.man7.org/linux/man-pages/man1/mpstat.1.html)

Tool for detailed reporting of processor-related statistics. `mpstat` is useful for network troubleshooting because it shows how much CPU time is spent handling SoftIRQs, which are often triggered by network traffic, helping identify interrupt bottlenecks or imbalanced CPU usage. SoftIRQs (Software Interrupt Requests) are a type of deferred interrupt handling mechanism in the Linux kernel used to process time-consuming tasks—like network packet handling or disk I/O—outside the immediate hardware interrupt context, allowing faster and more efficient interrupt processing without blocking the system.

This example usage of `mpstat` monitors CPU usage statistics, specifically focusing on SoftIRQ usage, across all CPU cores, sampled every 1 second, for 5 intervals.

```shell
mpstat -P ALL 1 5 | grep -E '(CPU|%soft|Average)'
```

## Troubleshooting

### Timeouts
Expand Down
1 change: 1 addition & 0 deletions shell/Dockerfile
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,7 @@ RUN tdnf install -y \
nmap \
nmap-ncat \
openssh \
sysstat \
socat \
tcpdump \
wget \
Expand Down
Loading