Configuration

vey-statsd uses YAML for configuration.

The main configuration file is specified with the -c command-line option. If a directory is set, the main configuration file is loaded automatically from it based on the executable binary name. Its top-level keys are listed below.

At a high level, vey-statsd is organized as a metrics-processing pipeline:

• importer receives metrics from upstream senders

• collector aggregates or rewrites incoming metrics

• exporter emits the resulting metrics to downstream systems

Process-level settings such as runtime and worker define how the daemon runs, while the pipeline objects define how metrics flow through the service.

Key	Type	Reload	Description
runtime	Map	no	Runtime configuration, see Runtime
worker	Map [2]	no	Starts unaided worker runtimes if present
controller	Seq	no	Controller configuration
importer	Mix [1]	yes	Importer configuration, see Importer
collector	Mix [1]	yes	Collector configuration, see Collector
exporter	Mix [1]	yes	Exporter configuration, see Exporter

Read the pipeline sections listed in the hidden toctree below when you need the exact keys supported by each importer, collector, or exporter type.

Footnotes

[1] (1,2,3)

See hybrid map for the actual format.

[2]

See unaided runtime config.