Add Tags Transform

The Vector add_tags transform accepts metric events and allows you to add one or more metric tags.

Configuration

vector.toml

[transforms.my_transform_id]
  # REQUIRED - General
  type = "add_tags" # example, must be: "add_tags"
  inputs = ["my-source-id"] # example
  
  # REQUIRED - Tags
  [transforms.my_transform_id.tags]
    my_tag = "my value"

Options

commontablerequired

tags

A table of key/value pairs representing the tags to be added to the metric.

commonstringrequired

[tag-name]

The name of the tag to add. Due to the nature of metric tags, the value must be a string.

No default

View examples

How It Works

Environment Variables

Environment variables are supported through all of Vector's configuration. Simply add ${MY_ENV_VAR} in your Vector configuration file and the variable will be replaced before being evaluated.

You can learn more in the Environment Variables section.