Feb 21, 2024: Announcing Linkerd 2.15 with support for VM workloads, native sidecars, and SPIFFE! Read more »


This is not the latest version of Linkerd!
This documentation is for an older version of Linkerd. You may want the Linkerd 2.15 (current) documentation instead.

Proxy Log Level

The Linkerd proxy’s log level can be configured via the:

  • LINKERD_PROXY_LOG environment variable
  • --proxy-log-level CLI flag of the install, inject and upgrade commands
  • config.linkerd.io/proxy-log-level annotation (see Proxy Configuration) which sets LINKERD_PROXY_LOG environment-variable on the injected sidecar
  • an endpoint on the admin port of a running proxy.

The log level is a comma-separated list of log directives, which is based on the logging syntax of the env_logger crate.

A log directive consists of either:

  • A level (e.g. info), which sets the global log level, or
  • A module path (e.g. foo or foo::bar::baz), or
  • A module path followed by an equals sign and a level (e.g. foo=warn or foo::bar::baz=debug), which sets the log level for that module

A level is one of:

  • trace
  • debug
  • info
  • warn
  • error

A module path represents the path to a Rust module. It consists of one or more module names, separated by ::.

A module name starts with a letter, and consists of alphanumeric characters and _.

The proxy’s default log level is set to warn,linkerd2_proxy=info.