Skip to main content

Destination Reference

Destination definitions declare an analytics provider configuration — the credentials, batching settings, and other parameters for a specific backend.

File location

destinations/<destination_name>.yaml

Fields

FieldTypeRequiredDescription
namestringYesMachine-readable destination name. Referenced in source destinations lists.
typestringYesProvider type: amplitude | noop | (future providers)
configobjectNoProvider-specific configuration. Keys depend on type.

Amplitude config

destinations/amplitude.yaml
name: amplitude
type: amplitude
config:
api_key: "${AMPLITUDE_API_KEY}"
batch_size: 100
flush_interval: "5s"
max_queue_size: 10000
proxy_url: "https://analytics.yourcompany.com/amp"
Config keyTypeDescription
api_keystringAmplitude API key or ${ENV_VAR} reference
batch_sizeintegerMax events per batch HTTP request
flush_intervaldurationHow often to flush the event queue
max_queue_sizeintegerMax buffered events before overflow policy kicks in
proxy_urlstringOptional reverse proxy URL

Environment variable expansion

Any config value of the form ${VAR_NAME} is expanded from the environment at runtime. Never store raw API keys in destination YAML files.