opensearch-docs-cn/_data-prepper/pipelines/configuration/processors/drop-events.md

1.1 KiB

layout title parent grand_parent nav_order
default drop_events Processors Pipelines 53

drop_events

The drop_events processor drops all the events that are passed into it. The following table describes when events are dropped and how exceptions for dropping events are handled.

Option Required Type Description
drop_when Yes String Accepts a Data Prepper expression string following the Data Prepper Expression Syntax. Configuring drop_events with drop_when: true drops all the events received.
handle_failed_events No Enum Specifies how exceptions are handled when an exception occurs while evaluating an event. Default value is drop, which drops the event so that it is not sent to OpenSearch. Available options are drop, drop_silently, skip, and skip_silently. For more information, see handle_failed_events.