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