OS Manuals

/usr/bin/pilot-agent

Nanny binary for Istio Envoy

From istio-pilot-agent-1.22 1.22.8-r9 (enterprise-packages), captured 2026-11-08 by running pilot-agent --help (exit 0). permalink

2026-11-08T04:19:56.148738Z	warn	OS CA Cert could not be found for agent
Istio Pilot agent runs in the sidecar or gateway container and bootstraps Envoy.

Usage:
  pilot-agent [command]

Available Commands:
  completion           Generate the autocompletion script for the specified shell
  help                 Help about any command
  istio-clean-iptables Clean up iptables rules for Istio Sidecar
  istio-iptables       Set up iptables rules for Istio Sidecar
  proxy                XDS proxy agent
  request              Makes an HTTP request to the Envoy admin API
  version              Prints out build version information
  wait                 Waits until the Envoy proxy is ready

Flags:
  -h, --help                          help for pilot-agent
      --log_as_json                   Whether to format output as JSON or in plain console-friendly format
      --log_caller string             Comma-separated list of scopes for which to include caller information, scopes can be any of [ads, all, authn, authorization, ca, cache, citadelclient, controllers, default, delta, dns, gcecred, googleca, googlecas, grpc, healthcheck, iptables, klog, mockcred, model, monitoring, sds, security, spiffe, stsclient, stsserver, token, trustBundle, validation, wasm, wle, xdsproxy]
      --log_output_level string       Comma-separated minimum per-scope logging level of messages to output, in the form of <scope>:<level>,<scope>:<level>,... where scope can be one of [ads, all, authn, authorization, ca, cache, citadelclient, controllers, default, delta, dns, gcecred, googleca, googlecas, grpc, healthcheck, iptables, klog, mockcred, model, monitoring, sds, security, spiffe, stsclient, stsserver, token, trustBundle, validation, wasm, wle, xdsproxy] and level can be one of [debug, info, warn, error, fatal, none]
      --log_rotate string             The path for the optional rotating log file
      --log_rotate_max_age int        The maximum age in days of a log file beyond which the file is rotated (0 indicates no limit) (default 30)
      --log_rotate_max_backups int    The maximum number of log file backups to keep before older files are deleted (0 indicates no limit) (default 1000)
      --log_rotate_max_size int       The maximum size in megabytes of a log file beyond which the file is rotated (default 104857600)
      --log_stacktrace_level string   Comma-separated minimum per-scope logging level at which stack traces are captured, in the form of <scope>:<level>,<scope:level>,... where scope can be one of [ads, all, authn, authorization, ca, cache, citadelclient, controllers, default, delta, dns, gcecred, googleca, googlecas, grpc, healthcheck, iptables, klog, mockcred, model, monitoring, sds, security, spiffe, stsclient, stsserver, token, trustBundle, validation, wasm, wle, xdsproxy] and level can be one of [debug, info, warn, error, fatal, none] (default "default:none")
      --log_target stringArray        The set of paths where to output the log. This can be any path as well as the special values stdout and stderr (default [stdout])
      --vklog Level                   number for the log level verbosity. Like -v flag. ex: --vklog=9

Use "pilot-agent [command] --help" for more information about a command.
Options (11)
OptionDescriptionSource
-h, --helphelp for pilot-agenthelp
--log_as_jsonWhether to format output as JSON or in plain console-friendly formathelp
--log_caller stringComma-separated list of scopes for which to include caller information, scopes can be any of [ads, all, authn, authorization, ca, cache, citadelclient, controllers, default, delta, dns, gcecred,…help
--log_output_level stringComma-separated minimum per-scope logging level of messages to output, in the form of <scope>:<level>,<scope>:<level>,...help
--log_rotate stringThe path for the optional rotating log filehelp
--log_rotate_max_age intThe maximum age in days of a log file beyond which the file is rotated (0 indicates no limit) (default 30)help
--log_rotate_max_backups intThe maximum number of log file backups to keep before older files are deleted (0 indicates no limit) (default 1000)help
--log_rotate_max_size intThe maximum size in megabytes of a log file beyond which the file is rotated (default 104857600)help
--log_stacktrace_level stringComma-separated minimum per-scope logging level at which stack traces are captured, in the form of <scope>:<level>,<scope:level>,...help
--log_target stringArrayThe set of paths where to output the log.help
--vklog Levelnumber for the log level verbosity.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.