Vector

Send events to Vector.

Type: vector

Sample YAML

destinations:
  vector_example:
    type: vector
    address: 0.0.0.0:9000
    tls:
      tls.enabled: false
      tls.alpn_protocols: ''
      tls.ca_file: ''
      tls.crt_file: ''
      tls.key_file: ''
      tls.key_pass: ''
      tls.server_name: ''
      tls.verify_certificate: true
      tls.verify_hostname: true
  # optional:
  #   <key>: <value>

Fields Reference

Below are tables for Base, TLS, and Optional sections. Columns: Key, Label, Type, Default, Required, Depends on, Enum / Notes.

Base

Key

Label

Type

Default

Required

Enum / Notes

Depends on

address

Address

regex

0.0.0.0:9000

βœ…

The socket address to listen for connections on, or systemd{#N} to use the Nth socket passed by systemd socket activation.

β€”

TLS

Key

Label

Type

Default

Required

Enum / Notes

Depends on

tls.enabled

TLS Enabled

bool

false

β€”

Whether or not to require TLS for incoming or outgoing connections. When enabled and used for incoming connections, an identity certificate is also required. See tls.crt_file for more information.

β€”

tls.alpn_protocols

ALPN protocols

string

β€œβ€

β€”

Sets the list of supported ALPN protocols. Declare the supported ALPN protocols, which are used during negotiation with peer. They are prioritized in the order that they are defined.

β€”

tls.ca_file

Certificate Authority File

file_ca_file

β€œβ€

β€”

Absolute path to an additional CA certificate file.

β€”

tls.crt_file

Certificate File

file_crt_file

β€œβ€

β€”

Absolute path to a certificate file used to identify this server.

β€”

tls.key_file

Private Key

file_key_file

β€œβ€

β€”

Absolute path to a private key file used to identify this server.

β€”

tls.key_pass

Private Key Passphrase

string

β€œβ€

β€”

Passphrase used to unlock the encrypted key file.

β€”

tls.server_name

Server Name

string

β€œβ€

β€”

Server name to use when using Server Name Indication (SNI).

β€”

tls.verify_certificate

Verify Certificate

bool

true

β€”

Enables certificate verification. For components that create a server, this requires that the client connections have a valid client certificate. For components that initiate requests, this validates that the upstream has a valid certificate.

β€”

tls.verify_hostname

Verify Hostname

bool

true

β€”

Enables hostname verification. If enabled, the hostname used to connect to the remote host must be present in the TLS certificate presented by the remote host, either as the Common Name or as an entry in the Subject Alternative Name extension. Only relevant for outgoing connections.

β€”

Optional

Key

Label

Type

Default

Required

Enum / Notes

Depends on

description

Description

string

β€œβ€

β€”

The description of the entry.

β€”

acknowledgements.enabled

Acknowledgements Enabled

bool

false

β€”

Whether or not end-to-end acknowledgements are enabled.

β€”

batch.max_bytes

Batch Max Bytes

int

10000000

β€”

The maximum size of a batch that is processed by a sink.

β€”

batch.max_events

Batch Max Events

int

500

β€”

The maximum size of a batch before it is flushed.

β€”

batch.timeout_secs

Batch Timeout Secs

int

300

β€”

The maximum age of a batch before it is flushed.

β€”

buffer.type

Buffer Type

enum

memory

β€”

The type of buffer to use. Enum: [β€œdisk”, β€œmemory”]

β€”

buffer.max_events

Buffer Max Events

int

500

β€”

The maximum number of events allowed in the buffer.

buffer.type = memory

buffer.max_size

Buffer Max Size

int

268435488

β€”

The maximum size of the buffer on disk. Must be at least ~256 megabytes (268435488 bytes).

buffer.type = disk

buffer.when_full

Buffer When Full

enum

block

β€”

Event handling behavior when a buffer is full. Enum: [β€œblock”, β€œdrop_newest”]

β€”

compression

Compression

bool

false

β€”

Whether or not to compress requests.

β€”