1---
2last_modified_on: "2020-07-13"
3component_title: "Remove Tags"
4description: "The Vector `remove_tags` transform accepts and outputs `metric` events, allowing you to remove one or more metric tags."
5event_types: ["metric"]
6function_category: "schema"
7issues_url: https://github.com/timberio/vector/issues?q=is%3Aopen+is%3Aissue+label%3A%22transform%3A+remove_tags%22
8operating_systems: ["Linux","MacOS","Windows"]
9sidebar_label: "remove_tags|[\"metric\"]"
10source_url: https://github.com/timberio/vector/tree/master/src/transforms/remove_tags.rs
11status: "prod-ready"
12title: "Remove Tags Transform"
13unsupported_operating_systems: []
14---
15
16import Fields from '@site/src/components/Fields';
17import Field from '@site/src/components/Field';
18import Tabs from '@theme/Tabs';
19import TabItem from '@theme/TabItem';
20
21The Vector `remove_tags` transform
22accepts and outputs [`metric`][docs.data-model.metric] events, allowing you to
23remove one or more metric tags.
24
25<!--
26     THIS FILE IS AUTOGENERATED!
27
28     To make changes please edit the template located at:
29
30     website/docs/reference/transforms/remove_tags.md.erb
31-->
32
33## Configuration
34
35<Tabs
36  block={true}
37  defaultValue="common"
38  values={[{"label":"Common","value":"common"},{"label":"Advanced","value":"advanced"}]}>
39<TabItem value="common">
40
41```toml title="vector.toml"
42[transforms.my_transform_id]
43  type = "remove_tags" # required
44  inputs = ["my-source-or-transform-id"] # required
45  tags = ["tag1", "tag2"] # required
46```
47
48</TabItem>
49<TabItem value="advanced">
50
51```toml title="vector.toml"
52[transforms.my_transform_id]
53  type = "remove_tags" # required
54  inputs = ["my-source-or-transform-id"] # required
55  tags = ["tag1", "tag2"] # required
56```
57
58</TabItem>
59</Tabs>
60
61<Fields filters={true}>
62<Field
63  common={true}
64  defaultValue={null}
65  enumValues={null}
66  examples={[["tag1","tag2"]]}
67  groups={[]}
68  name={"tags"}
69  path={null}
70  relevantWhen={null}
71  required={true}
72  templateable={false}
73  type={"[string]"}
74  unit={null}
75  warnings={[]}
76  >
77
78### tags
79
80The tag names to drop.
81
82
83
84</Field>
85</Fields>
86
87## How It Works
88
89### Complex Processing
90
91If you encounter limitations with the `remove_tags`
92transform then we recommend using a [runtime transform][urls.vector_programmable_transforms].
93These transforms are designed for complex processing and give you the power of
94full programming runtime.
95
96### Environment Variables
97
98Environment variables are supported through all of Vector's configuration.
99Simply add `${MY_ENV_VAR}` in your Vector configuration file and the variable
100will be replaced before being evaluated.
101
102You can learn more in the
103[Environment Variables][docs.configuration#environment-variables] section.
104
105[docs.configuration#environment-variables]: /docs/setup/configuration/#environment-variables
106[docs.data-model.metric]: /docs/about/data-model/metric/
107[urls.vector_programmable_transforms]: https://vector.dev/components/?functions%5B%5D=program
108