原英文版地址: https://www.elastic.co/guide/en/elasticsearch/reference/7.7/fail-processor.html, 原文档版权归 www.elastic.co 所有
本地英文版地址: ../en/fail-processor.html

Fail Processoredit

Raises an exception. This is useful for when you expect a pipeline to fail and want to relay a specific message to the requester.

Table 45. Fail Options

Name Required Default Description

message

yes

-

The error message thrown by the processor. Supports template snippets.

if

no

-

Conditionally execute this processor.

on_failure

no

-

Handle failures for this processor. See Handling Failures in Pipelines.

ignore_failure

no

false

Ignore failures for this processor. See Handling Failures in Pipelines.

tag

no

-

An identifier for this processor. Useful for debugging and metrics.

{
  "fail": {
    "if" : "ctx.tags.contains('production') != true",
    "message": "The production tag is not present, found tags: {{tags}}"
  }
}