› › ›

Процессор Fail

Выбрасывает исключение. Это полезно в тех случаях, когда ожидается, что конвейер завершится ошибкой, и вы хотите передать конкретное сообщение запрошивающему.

Таблица 18. Параметры Fail

Имя	Обязательно	По умолчанию	Описание
`message`	да	-	Сообщение об ошибке, выдаваемое процессором. Поддерживает фрагменты шаблонов.
`description`	нет	-	Описание процессора. Полезно для описания цели процессора или его конфигурации.
`if`	нет	-	Условное выполнение процессора. См. Условное выполнение процессора.
`ignore_failure`	нет	`false`	Игнорировать ошибки для процессора. См. Обработка сбоев конвейера.
`on_failure`	нет	-	Обрабатывать ошибки для процессора. См. Обработка сбоев конвейера.
`tag`	нет	-	Идентификатор процессора. Полезен для отладки и метрик.

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

© 2023-2025 Elasticsearch
As of September 2024, Elasticsearch is available under a choice of three licenses: the Server Side Public License (SSPL), the Elastic License, or the AGPLv3 (OSI approved).
Elasticsearch and the Elasticsearch logo are trademarks of Elasticsearch B.V., registered in the U.S. and in other countries.
https://www.elastic.co/guide/en/elasticsearch/reference/8.17/fail-processor.html