# KV Processor（KV 處理器） 原文鏈接 : [https://www.elastic.co/guide/en/elasticsearch/reference/5.3/kv-processor.html](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/kv-processor.html) 譯文鏈接 : [http://www.apache.wiki/pages/viewpage.action?pageId=10028238](http://www.apache.wiki/pages/viewpage.action?pageId=10028238) 貢獻者 : [那伊抹微笑](/display/~wangyangting)，[ApacheCN](/display/~apachecn)，[Apache中文網](/display/~apachechina) 該 **processor**（處理器）有助于自動解析那些 **foo**=**bar** 樣式的消息（或者指定事件字段）。 例如，如果您有一個包含?**ip=1.2.3.4 error=REFUSED** 的日志消息，您可以通過如下配置來自動的解析它們 :? ``` { "kv": { "field": "message", "field_split": " ", "value_split": "=" } } ``` ## Table?24.?Kv Options（表 24\. Kv 選項） | Name（名稱） | Required（必要的） | Default（默認值） | Description（描述） | | --- | --- | --- | --- | | **`field`** | **yes** | **-** | 要解析的 **field**（字段） | | **`field_split`** | **yes** | **-** | 用于拆分 **key-value** 格式的 **Regex pattern**（正則表達式模式） | | **`value_split`** | **yes** | **-** | 用于拆分來自 **key-value** 對中 **value** 的 **key** 的 **Regex pattern**（正則表達式模式） | | **`target_field`** | **no** | **`null`** | 提取所抽取的 **key** 要插入的 **field**（字段）。默認為 **document**（文檔）的 **root**（根部） | | **`include_keys`** | **no** | **`null`** | 過濾出要插入到 **document**（文檔）中 **key** 的列表。默認為包括所有的 key。 | | **`ignore_missing`** | **no** | **`false`** | 如果該值為 **true** 并且 **field**（字段）不存在或為 **null**，則該 **processor**（處理器）靜默退出且不修改 **document**（文檔） |