Docker images for debugging network issues in K8s
Posted on November 21, 2021 by Adrian Wyssmann ‐ 2 min read
Troubleshooting networking issues in docker and kubernetes is often difficult and the root cause can be in different places including the underlying networking infrastructure. I have collected some information which might be helpful.
Most importantly, is that you understand the concepts of networking in docker and kubernetes:
- Docker: Networking overview
- Kubernetes: Cluster Networking
- Kubernetes: Services, Load Balancing, and Networking
Docker images
In order to debug issues you need the right tools. The following docker images provide a set of tools. While netshoot
is my preference, the others are also very helpful:
Docker Image | Description |
---|---|
nicolaka/netshoot | a Docker + Kubernetes network trouble-shooting swiss-army container |
gopher-net/dockerized-net-tools | Collection of Dockerized Open Source Network Monitoring, Performance and Management Related Tools |
Praqma/Network-MultiTool | Multi-arch multitool for container network troubleshooting |
So you can use these docker images to test dns resolution or tracing a ping
Usage on Docker
You can start the container and then login to it
You can also run some commands directly rather than login to the container:
Run a command and then delete the container again:
Usage on Kubernetes
You can either create a single pod - without a deployment:
Or you create a deployment:
Then you open the console of the pod
Which tool for what?
As Linux user you might be familiar with most of the tools provided within these containers. If not, I really recommend to have a look at https://github.com/nicolaka/netshoot, which gives you a lot of details.