github.com/Jeffail/benthos/v3@v3.65.0/website/docs/components/outputs/drop_on_error.md (about) 1 --- 2 title: drop_on_error 3 type: output 4 status: deprecated 5 --- 6 7 <!-- 8 THIS FILE IS AUTOGENERATED! 9 10 To make changes please edit the contents of: 11 lib/output/drop_on_error.go 12 --> 13 14 import Tabs from '@theme/Tabs'; 15 import TabItem from '@theme/TabItem'; 16 17 :::warning DEPRECATED 18 This component is deprecated and will be removed in the next major version release. Please consider moving onto [alternative components](#alternatives). 19 ::: 20 21 Attempts to write messages to a child output and if the write fails for any 22 reason the message is dropped instead of being reattempted. 23 24 ```yaml 25 # Config fields, showing default values 26 output: 27 label: "" 28 drop_on_error: {} 29 ``` 30 31 ## Alternatives 32 33 This output has been replaced with the more explicit and configurable [`drop_on`](/docs/components/outputs/drop_on) output. 34 35 This output can be combined with a child [`retry`](/docs/components/outputs/retry) 36 output in order to set an explicit number of retry attempts before dropping a 37 message. 38 39 For example, the following configuration attempts to send to a hypothetical 40 output type `foo` three times, but if all three attempts fail the 41 message is dropped entirely: 42 43 ```yaml 44 output: 45 drop_on_error: 46 retry: 47 max_retries: 2 48 output: 49 type: foo 50 ``` 51 52