Dockerman Docs
Kubernetes

Debug Assistant

Launch an ephemeral debug pod alongside a target pod to diagnose network, DNS, and filesystem issues.

Added in v4.8.0. Use Debug Assistant to launch an ephemeral debug pod next to a target pod and open a shell with debugging tools preinstalled.

When to use Debug Assistant

  • The target image is minimal, such as distroless or scratch, and has no shell.
  • You need tools like tcpdump, dig, curl, or nc that are not in the target image.
  • You need to inspect mounted volumes or the pod's network namespace without touching the pod itself.
  • You are debugging a CrashLoopBackOff and the pod never stays up long enough for kubectl exec.

Launch a debug pod

Select the target pod

From Pods or Workloads, choose Debug on the pod you want to inspect.

Configure sharing options

Choose whether to share the process namespace, the network namespace, and mounted volumes.

Wait for the debug pod to be Ready

Dockerman creates the pod and waits for it to become Ready before it opens the terminal.

Interact via the embedded terminal

The debug pod opens in a Dockerman terminal tab.

Debug presets

Dockerman ships three built-in presets that pre-configure the debug port and protocol for common runtimes:

PresetPortProtocol
Node.js9229Inspector
Go (Delve)2345DAP
Python (debugpy)5678DAP

Select a preset when launching the debug pod to skip manual port configuration.

What's inside the debug pod

ToolPurpose
bash, shShells
ps, top, htopProcess inspection
netstat, ssConnection state
tcpdumpPacket capture
curl, wgetHTTP probing
dig, nslookupDNS resolution
ncRaw TCP and UDP checks
vim, lessFile inspection
straceSyscall tracing when the kernel allows it

Common debug workflows

Cleanup

The debug pod is ephemeral. Close the terminal tab or exit the shell when you are done, and Dockerman cleans it up for you.