{
  "id": "aws/stepfunctions-state-machine-execution-limit-exceeded",
  "signature": "States.ExecutionFailed: The execution of state machine exceeded the maximum execution history size of 25000 entries",
  "signature_zh": "States.ExecutionFailed：状态机的执行超过了最大执行历史记录大小 25000 条",
  "regex": "States\\.ExecutionFailed: The execution of state machine exceeded the maximum execution history size of 25000 entries",
  "domain": "aws",
  "category": "resource_error",
  "subcategory": null,
  "root_cause": "Step Functions state machine execution has generated more than 25,000 history entries (e.g., due to long-running loops or large input/output payloads), which exceeds the service limit.",
  "root_cause_type": "generic",
  "root_cause_zh": "Step Functions 状态机执行生成了超过 25,000 条历史记录（例如，由于长时间运行的循环或大型输入/输出负载），超出了服务限制。",
  "versions": [
    {
      "version": "Step Functions 2024-08-01",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "AWS SDK v2",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "Lambda 2023-11-01",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    }
  ],
  "os_specific": {},
  "dead_ends": [
    {
      "action": "",
      "why_fails": "The 25,000 history entry limit is a hard limit that cannot be increased by AWS support.",
      "fail_rate": 0.95,
      "condition": "",
      "sources": []
    },
    {
      "action": "",
      "why_fails": "This may reduce history entries but can make the state machine less maintainable and might not solve the root cause if loops are the issue.",
      "fail_rate": 0.5,
      "condition": "",
      "sources": []
    },
    {
      "action": "",
      "why_fails": "The limit is on history entries, not time; increasing timeout does not reduce history entries.",
      "fail_rate": 0.8,
      "condition": "",
      "sources": []
    }
  ],
  "workarounds": [
    {
      "action": "Refactor the state machine to use a nested workflow or a callback pattern to break long-running executions into smaller chunks. Example: Use a Map state with a max concurrency to process items in parallel, reducing the number of steps.",
      "success_rate": 0.8,
      "how": "Refactor the state machine to use a nested workflow or a callback pattern to break long-running executions into smaller chunks. Example: Use a Map state with a max concurrency to process items in parallel, reducing the number of steps.",
      "condition": "",
      "sources": []
    },
    {
      "action": "Reduce input/output payload sizes by filtering or truncating data between states. Use a Pass state with ResultPath to trim unnecessary fields.",
      "success_rate": 0.75,
      "how": "Reduce input/output payload sizes by filtering or truncating data between states. Use a Pass state with ResultPath to trim unnecessary fields.",
      "condition": "",
      "sources": []
    },
    {
      "action": "Implement a loop with a counter and a maximum iteration limit to prevent infinite loops from generating too many history entries.",
      "success_rate": 0.85,
      "how": "Implement a loop with a counter and a maximum iteration limit to prevent infinite loops from generating too many history entries.",
      "condition": "",
      "sources": []
    }
  ],
  "workarounds_zh": [
    "Refactor the state machine to use a nested workflow or a callback pattern to break long-running executions into smaller chunks. Example: Use a Map state with a max concurrency to process items in parallel, reducing the number of steps.",
    "Reduce input/output payload sizes by filtering or truncating data between states. Use a Pass state with ResultPath to trim unnecessary fields.",
    "Implement a loop with a counter and a maximum iteration limit to prevent infinite loops from generating too many history entries."
  ],
  "transition_graph": {
    "leads_to": [],
    "preceded_by": [],
    "frequently_confused_with": []
  },
  "official_doc_url": "https://docs.aws.amazon.com/step-functions/latest/dg/limits.html",
  "official_doc_section": null,
  "error_code": "States.ExecutionFailed",
  "verification_tier": "ai_generated",
  "confidence": 0.84,
  "fix_success_rate": 0.8,
  "resolvable": "true",
  "first_seen": "2024-04-18",
  "last_confirmed": "2024-06-01",
  "last_updated": "2024-06-01",
  "evidence_count": 1,
  "tags": [],
  "locale": "en",
  "aliases": []
}