Skip to content

Troubleshooting Tools

Log Streaming

  • All Workload Types: Stream logs from Pods, Deployments, DaemonSets, StatefulSets, ReplicaSets, and Jobs — not just individual pods. For higher-level workloads, logs from all underlying pods are aggregated.
  • Multi-Pod Log Viewing: Select individual pods within a workload to view their logs separately or together.
  • Multi-Container Selection: For pods with multiple containers, choose which container's logs to view.
  • Follow Mode: Live-tail logs as they stream in, equivalent to kubectl logs -f.
  • Search / Filter: Filter log lines by keyword to reduce noise when looking for specific events.
  • Timestamps: Toggle timestamps on or off per session.
  • Tail Size: Configure how many lines to load initially before following live output.
  • Line Wrapping: Toggle line wrapping for wide log lines.
  • ANSI Color Rendering: Log output with ANSI color codes is rendered with proper colors, making structured logs from frameworks like Logrus or Zap readable.
  • Font Size: Adjust the font size of the log view independently.
  • Text Styling: Customize the log viewer's text style — font family, size, and weight — so log output matches your reading preferences.
  • Export: Save the current log buffer to a file on your local device.

Pod File System

  • File Browser: Open a running container and browse its file system directly — navigate directories, inspect what is actually on disk, and find the file you need without piecing together ls output in a shell.
  • Copy from Pod: Transfer files from a running container to your local device — equivalent to kubectl cp. Large files download reliably, with progress shown as the transfer runs.
  • Copy to Pod: Push a local file into a running container, for swapping a config file or dropping in a tool during an investigation.
  • From AI Chat: The same transfers can be requested in conversation — see AI Assistance.

Terminal

Exec and attach sessions open a full terminal emulator inside Kubeterm using an embedded XTerm engine.

  • Exec into Container: Open a shell in any running container. A container selector is shown for pods with multiple containers.
  • Attach: Attach to the main process's stdio of a running container.
  • ANSI Color Support: Terminal output with ANSI escape codes is rendered with proper colors and formatting.
  • Text Selection & Copy: Select and copy content from the terminal.
  • Font Size: Zoom the terminal font in and out independently of the rest of the UI.
  • Text Styling: Customize the shell's text style — font family, size, and weight — independently of the log viewer and the rest of the app.
  • Ctrl Sequences: Common control characters (Ctrl+C, Ctrl+D, etc.) are handled correctly.
  • Mobile Keyboard: On mobile, a virtual keyboard overlay provides access to special keys (Tab, Escape, arrow keys, function keys) that don't appear on a standard soft keyboard.

Port Forwarding

  • One-Click Setup: Configure a port forward from a Pod or Service detail view — specify local and remote ports and start immediately.
  • Persistent Sessions: Active port forwards are tracked in a dedicated list and survive navigation. You don't lose your forward by switching views.
  • Multiple Simultaneous Forwards: Maintain several port-forward sessions at once, each visible in the port forward list with its configuration.
  • Default kubeconfig Compatibility: Port forwarding works correctly alongside your default kubeconfig without conflicts.

Debug Containers

  • Ephemeral Containers: Attach an ephemeral debug container to a running pod without restarting it, for situations where the existing container image lacks debugging tools.
  • Node Debugging: Launch a debug container on a specific node to investigate node-level issues.