Pyroscope Agent Configuration

There are 3 ways to configure Pyroscope Agent. Configuration precedence is evaluated in the following order:

  • command line arguments
  • environment variables
  • configuration files

Configuration options are different depending on how Pyroscope Agent is running:

Configuration files

Configuration files are stored in YAML format. You can specify configuration file location with -config <path> argument, for example:

pyroscope agent -config /tmp/my-config.yml {args}

Or an environment variable, for example:

PYROSCOPE_CONFIG=/tmp/my-config.yml pyroscope exec {args}

Environment variables

Environment variables MUST have PYROSCOPE_ prefix and be in UPPER_SNAKE_CASE format, for example:

PYROSCOPE_API_BIND_ADDR=:9999 pyroscope server