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