Supervisor

Configuration for the Varnish Supervisor itself.

Example:

supervisor:
  log_level: error

log_output

supervisor:
  log_output: stderr

Type: String

Default: stdout

Where to write Supervisor (control plane) logs.

Options:

• stdout: Log to stdout
• stderr: Log to stderr
• discard: Discard logs
• file path: Write logs to a file

A change takes effect on a reload or a SIGHUP, for every component rather than the config manager alone. Records already on their way into the previous file are waited for before it is closed.

log_level

supervisor:
  log_level: warn

Type: String

Default: info

Change the log level of the Supervisor (control plane) logs.

Options:

• info: Log at info level.
• warn: Log at warning level.
• error: Log at error level.
• debug: Log at debug level.

At info the Supervisor records what it is running as it starts: its own version and revision, the varnishd and add-on versions, the configuration files it read, and the configuration itself as every setting that differs from its default. A log therefore says what a Supervisor was running without its files having to be found.

INFO is reserved for state changes, so a reload names the settings that changed rather than bracketing the work with a line on either side.

work_dir

supervisor:
  work_dir: /tmp/varnish-supervisor

Type: String

Default: /var/lib/varnish-supervisor

The working directory for storing state, logs, and other runtime files.

config_watch

supervisor:
  config_watch:
    enabled: true
    interval: 15

Automatic reload of the configuration when its files change on disk. Can also be forced on or off with the SUPERVISOR_CONFIG_WATCH environment variable (on or off), which takes precedence over this setting.

enabled

supervisor:
  config_watch:
    enabled: false

Type: Boolean

Default: true

Reload the configuration automatically when its files change on disk. When disabled, a reload has to be triggered with SIGHUP.

interval

supervisor:
  config_watch:
    interval: 30

Type: Integer

Default: 15

How often to check the configuration files for changes, in seconds. Only takes effect while the watcher is enabled.