Volume 16 · Operational Runbooks
เล่มนี้แปลงข้อค้นพบจาก Vol 3-14 เป็นขั้นตอนปฏิบัติงานสำหรับทีม on-call — ไม่ re-derive สถาปัตยกรรมใหม่ (อยู่ใน Vol 3-14 แล้ว) แต่ตอบคำถามตอนเกิดเหตุจริง: อาการแบบนี้เกิดจากอะไร ต้องดูที่ไฟล์/service ไหน แก้ยังไง
เอกสารนี้ต่างจาก docs-v1-archive/volume-13-runbooks ที่ครอบคลุมแค่ legacy 5 services ด้วยคำสั่ง SSH/docker ตรง ๆ — เล่มนี้ครอบคลุมทั้ง 25 repo ที่มีโค้ด และเน้นการวินิจฉัย (diagnosis) มากกว่าคำสั่งเฉพาะเจาะจงที่ผูกกับ server ปัจจุบัน เพราะ workspace นี้ไม่มีสิทธิ์เข้าถึง production server จริง — ทุก runbook อ้างอิง finding ที่ verify แล้วใน Vol 3-14 เป็นหลักฐาน
เล่มนี้คืออะไร
| บท | หัวข้อ | คำถามที่ตอบ |
|---|---|---|
| 16.1 | Common incidents | อาการที่พบบ่อย 10 แบบ — สาเหตุที่เป็นไปได้ วิธีตรวจ วิธีแก้ |
| 16.2 | Debugging cross-service issues | วิธี trace ปัญหาที่ข้าม repo ในระบบที่ไม่มี correlation ID |
ตัวเลขที่ควรจำ
| ตัวเลข | ค่า | ที่มา |
|---|---|---|
| Runbook entry ที่เขียนไว้ | 10 | ดู 16.1 |
| Correlation ID ข้าม service ที่ยืนยันว่ามีอยู่จริง | 0 | ดู 16.2 |
| Log aggregation กลาง (Loki/ELK/Datadog) ที่ยืนยันว่ามี | 0 | ทุก repo เขียน log ลง local file หรือ stdout เท่านั้น |
| Service ที่ log request/response ระดับ field (ไม่ใช่แค่ access log) | 1 | vtrc-api เท่านั้น (vtrc-api/09-cross-cutting) |
คำเตือนที่สำคัญ
Runbook ในเล่มนี้เขียนจากการอ่านโค้ดที่ commit ไว้ ณ วันที่ตรวจสอบ (2026-07-13) ไม่ใช่จากการสังเกต incident จริงที่เกิดขึ้น — ก่อนใช้งานจริงต้อง verify กับทีมที่ดูแล service นั้นว่า production ปัจจุบันตรงกับโค้ดที่ตรวจสอบหรือไม่ (เช่น hotfix ที่ deploy ไปแล้วแต่ไม่ commit)