{
  "id": "elasticsearch/missing-pipeline-field",
  "signature": "ElasticsearchParseException: Pipeline [my_pipeline] processor [set] requires field [field] but it is not defined in the pipeline configuration",
  "signature_zh": "ElasticsearchParseException: 管道 [my_pipeline] 处理器 [set] 需要字段 [field]，但管道配置中未定义",
  "regex": "ElasticsearchParseException: Pipeline \\[.*\\] processor \\[.*\\] requires field \\[.*\\] but it is not defined in the pipeline configuration",
  "domain": "elasticsearch",
  "category": "config_error",
  "subcategory": null,
  "root_cause": "A pipeline processor references a field that is not defined in the pipeline configuration, causing parse failure.",
  "root_cause_type": "generic",
  "root_cause_zh": "管道处理器引用了管道配置中未定义的字段，导致解析失败。",
  "versions": [
    {
      "version": "7.17.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "8.11.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "8.12.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    }
  ],
  "os_specific": {},
  "dead_ends": [
    {
      "action": "",
      "why_fails": "Field definition errors will persist unless the pipeline configuration is corrected properly.",
      "fail_rate": 0.9,
      "condition": "",
      "sources": []
    },
    {
      "action": "",
      "why_fails": "Restarting does not fix configuration errors; the pipeline will still fail to parse.",
      "fail_rate": 0.95,
      "condition": "",
      "sources": []
    },
    {
      "action": "",
      "why_fails": "The original pipeline remains broken and cannot be used for indexing.",
      "fail_rate": 0.85,
      "condition": "",
      "sources": []
    }
  ],
  "workarounds": [
    {
      "action": "Update the pipeline to define the missing field using the `set` processor with a default value: `PUT _ingest/pipeline/my_pipeline { \"processors\": [{\"set\": {\"field\": \"my_field\", \"value\": \"default\"}}] }`.",
      "success_rate": 0.92,
      "how": "Update the pipeline to define the missing field using the `set` processor with a default value: `PUT _ingest/pipeline/my_pipeline { \"processors\": [{\"set\": {\"field\": \"my_field\", \"value\": \"default\"}}] }`.",
      "condition": "",
      "sources": []
    },
    {
      "action": "Remove the processor that requires the undefined field if it is not needed: `PUT _ingest/pipeline/my_pipeline { \"processors\": [] }`.",
      "success_rate": 0.88,
      "how": "Remove the processor that requires the undefined field if it is not needed: `PUT _ingest/pipeline/my_pipeline { \"processors\": [] }`.",
      "condition": "",
      "sources": []
    },
    {
      "action": "Use the `_simulate` API to test the pipeline with sample documents before applying: `POST _ingest/pipeline/my_pipeline/_simulate { \"docs\": [{\"_source\": {\"field\": \"test\"}}] }`.",
      "success_rate": 0.95,
      "how": "Use the `_simulate` API to test the pipeline with sample documents before applying: `POST _ingest/pipeline/my_pipeline/_simulate { \"docs\": [{\"_source\": {\"field\": \"test\"}}] }`.",
      "condition": "",
      "sources": []
    }
  ],
  "workarounds_zh": [
    "更新管道以使用 `set` 处理器定义缺失字段并设置默认值：`PUT _ingest/pipeline/my_pipeline { \"processors\": [{\"set\": {\"field\": \"my_field\", \"value\": \"default\"}}] }`。",
    "如果不需要该处理器，则将其从管道配置中移除：`PUT _ingest/pipeline/my_pipeline { \"processors\": [] }`。",
    "使用 `_simulate` API 在应用前测试管道：`POST _ingest/pipeline/my_pipeline/_simulate { \"docs\": [{\"_source\": {\"field\": \"test\"}}] }`。"
  ],
  "transition_graph": {
    "leads_to": [],
    "preceded_by": [],
    "frequently_confused_with": []
  },
  "official_doc_url": "https://www.elastic.co/guide/en/elasticsearch/reference/current/ingest.html",
  "official_doc_section": null,
  "error_code": null,
  "verification_tier": "ai_generated",
  "confidence": 0.88,
  "fix_success_rate": 0.92,
  "resolvable": "true",
  "first_seen": "2024-03-15",
  "last_confirmed": "2024-06-01",
  "last_updated": "2024-06-01",
  "evidence_count": 1,
  "tags": [],
  "locale": "en",
  "aliases": []
}