OS Manuals

/usr/bin/cilium-bugtool

Cilium is a networking, observability, and security solution with an eBPF-based dataplane

From cilium-fips-1.20 1.20.3-r4 (enterprise-packages), captured 2026-11-08 by running cilium-bugtool --help (exit 0). permalink

Collects agent & system information useful for bug reporting

Usage:
  cilium-bugtool [OPTIONS] [flags]
  cilium-bugtool [command]

Examples:
	# Collect information and create archive file
	$ cilium-bugtool
	[...]

	# Collect and retrieve archive if Cilium is running in a Kubernetes pod
	$ kubectl get pods --namespace kube-system
	NAME                          READY     STATUS    RESTARTS   AGE
	cilium-kg8lv                  1/1       Running   0          13m
	[...]
	$ kubectl -n kube-system exec cilium-kg8lv -- cilium-bugtool
	$ kubectl cp kube-system/cilium-kg8lv:/tmp/cilium-bugtool-243785589.tar /tmp/cilium-bugtool-243785589.tar

Available Commands:
  completion  Generate the autocompletion script for the specified shell
  help        Help about any command

Flags:
      --archive                   Create archive when false skips deletion of the output directory (default true)
      --archive-prefix string     String to prefix to name of archive if created (e.g., with cilium pod-name)
  -o, --archiveType string        Archive type: tar | gz (default "tar")
      --config string             Configuration to decide what should be run (default "./.cilium-bugtool.config")
      --dry-run                   Create configuration file of all commands that would have been executed
      --enable-markdown           Dump output of commands in markdown format
      --envoy-dump                When set, dump envoy configuration from unix socket (default true)
      --envoy-metrics             When set, dump envoy prometheus metrics from unix socket (default true)
      --exclude-object-files      Exclude per-endpoint object files. Template object files will be kept
      --exec-timeout duration     The default timeout for any cmd execution in seconds (default 30s)
      --get-pprof                 When set, only gets the pprof traces from the cilium-agent binary
  -h, --help                      help for cilium-bugtool
  -H, --host string               URI to server-side API
      --hubble-metrics            When set, hubble prometheus metrics (default true)
      --hubble-metrics-port int   Port to query for hubble metrics (default 9965)
      --parallel-workers int      Maximum number of parallel worker tasks, use 0 for number of CPUs
      --pprof-debug int           Debug pprof args
      --pprof-port int            Pprof port to connect to. Known Cilium component ports are agent:6060, operator:6061, apiserver:6063 (default 6060)
      --pprof-trace-seconds int   Amount of seconds used for pprof CPU traces (default 180)
  -t, --tmp string                Path to store extracted files. Use '-' to send to stdout. (default "/tmp")

Use "cilium-bugtool [command] --help" for more information about a command.
Options (20)
OptionDescriptionSource
--archiveCreate archive when false skips deletion of the output directory (default true)help
--archive-prefix stringString to prefix to name of archive if created (e.g., with cilium pod-name)help
-o, --archiveType stringArchive type: tar | gz (default "tar")help
--config stringConfiguration to decide what should be run (default "./.cilium-bugtool.config")help
--dry-runCreate configuration file of all commands that would have been executedhelp
--enable-markdownDump output of commands in markdown formathelp
--envoy-dumpWhen set, dump envoy configuration from unix socket (default true)help
--envoy-metricsWhen set, dump envoy prometheus metrics from unix socket (default true)help
--exclude-object-filesExclude per-endpoint object files.help
--exec-timeout durationThe default timeout for any cmd execution in seconds (default 30s)help
--get-pprofWhen set, only gets the pprof traces from the cilium-agent binaryhelp
-h, --helphelp for cilium-bugtoolhelp
-H, --host stringURI to server-side APIhelp
--hubble-metricsWhen set, hubble prometheus metrics (default true)help
--hubble-metrics-port intPort to query for hubble metrics (default 9965)help
--parallel-workers intMaximum number of parallel worker tasks, use 0 for number of CPUshelp
--pprof-debug intDebug pprof argshelp
--pprof-port intPprof port to connect to.help
--pprof-trace-seconds intAmount of seconds used for pprof CPU traces (default 180)help
-t, --tmp stringPath to store extracted files.help

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.