{
  "id": "tensorflow/data-loss-corrupted-event-file",
  "signature": "DataLossError: corrupted record at 12345: checksum mismatch",
  "signature_zh": "数据丢失错误：记录在位置12345处损坏：校验和不匹配",
  "regex": "DataLossError: corrupted record at \\d+: checksum mismatch",
  "domain": "tensorflow",
  "category": "data_error",
  "subcategory": null,
  "root_cause": "TensorBoard event file or TFRecord file is corrupted, often due to incomplete write or disk failure.",
  "root_cause_type": "generic",
  "root_cause_zh": "TensorBoard事件文件或TFRecord文件损坏，通常由写入不完整或磁盘故障引起。",
  "versions": [
    {
      "version": "tensorflow 2.15.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "tensorboard 2.15.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    }
  ],
  "os_specific": {},
  "dead_ends": [
    {
      "action": "",
      "why_fails": "Does not address root cause of file corruption.",
      "fail_rate": 0.85,
      "condition": "",
      "sources": []
    },
    {
      "action": "",
      "why_fails": "Overly destructive; only the corrupted file needs removal.",
      "fail_rate": 0.95,
      "condition": "",
      "sources": []
    }
  ],
  "workarounds": [
    {
      "action": "Identify and remove the corrupted event file: locate the file (e.g., events.out.tfevents.12345), then delete it and restart TensorBoard. Example:\nrm /path/to/logs/events.out.tfevents.12345\ntensorboard --logdir /path/to/logs",
      "success_rate": 0.85,
      "how": "Identify and remove the corrupted event file: locate the file (e.g., events.out.tfevents.12345), then delete it and restart TensorBoard. Example:\nrm /path/to/logs/events.out.tfevents.12345\ntensorboard --logdir /path/to/logs",
      "condition": "",
      "sources": []
    },
    {
      "action": "Use tf.data to skip corrupted records during TFRecord reading:\nimport tensorflow as tf\nraw_dataset = tf.data.TFRecordDataset(['data.tfrecord'])\nfiltered_dataset = raw_dataset.ignore_errors()\nfor record in filtered_dataset:\n    # process record\n    pass",
      "success_rate": 0.75,
      "how": "Use tf.data to skip corrupted records during TFRecord reading:\nimport tensorflow as tf\nraw_dataset = tf.data.TFRecordDataset(['data.tfrecord'])\nfiltered_dataset = raw_dataset.ignore_errors()\nfor record in filtered_dataset:\n    # process record\n    pass",
      "condition": "",
      "sources": []
    }
  ],
  "workarounds_zh": [
    "Identify and remove the corrupted event file: locate the file (e.g., events.out.tfevents.12345), then delete it and restart TensorBoard. Example:\nrm /path/to/logs/events.out.tfevents.12345\ntensorboard --logdir /path/to/logs",
    "Use tf.data to skip corrupted records during TFRecord reading:\nimport tensorflow as tf\nraw_dataset = tf.data.TFRecordDataset(['data.tfrecord'])\nfiltered_dataset = raw_dataset.ignore_errors()\nfor record in filtered_dataset:\n    # process record\n    pass"
  ],
  "transition_graph": {
    "leads_to": [],
    "preceded_by": [],
    "frequently_confused_with": []
  },
  "official_doc_url": "https://www.tensorflow.org/api_docs/python/tf/data/TFRecordDataset",
  "official_doc_section": null,
  "error_code": "DLC",
  "verification_tier": "ai_generated",
  "confidence": 0.85,
  "fix_success_rate": 0.8,
  "resolvable": "partial",
  "first_seen": "2023-08-15",
  "last_confirmed": "2024-06-01",
  "last_updated": "2024-06-01",
  "evidence_count": 1,
  "tags": [],
  "locale": "en",
  "aliases": []
}