IT Documentation Template สอนเขียน SOP Runbook สำหรับ IT Team 2026

ทำไม IT Documentation สำคัญ?

IT Documentation คือหัวใจของ IT Operations ที่มีประสิทธิภาพ ถ้าไม่มี Documentation จะเกิดปัญหา Bus Factor คือเมื่อคนที่รู้ลาออก ความรู้ทั้งหมดหายไปด้วย ทำให้ระบบกลายเป็น Black Box ที่ไม่มีใครกล้าแตะ

ประเภทของ IT Documentation

# =============================================
# IT Documentation Types:
# =============================================
#
# 1. SOP (Standard Operating Procedure):
#    → ขั้นตอนการทำงานมาตรฐาน
#    → ทำตามได้ทุกคน ไม่ต้องตีความ
#    → ตัวอย่าง: SOP การเพิ่ม User ใน AD
#
# 2. Runbook:
#    → ขั้นตอนแก้ปัญหาเฉพาะเรื่อง
#    → ใช้ตอนเกิด Incident
#    → ตัวอย่าง: Runbook เมื่อ Database ล่ม
#
# 3. Network Diagram:
#    → แผนผังเครือข่าย
#    → IP, VLAN, อุปกรณ์, Connection
#
# 4. System Inventory:
#    → รายการ Server, อุปกรณ์ทั้งหมด
#    → IP, OS, Specs, Location, Owner
#
# 5. Change Log:
#    → บันทึกการเปลี่ยนแปลงทุกครั้ง
#    → ใคร ทำอะไร เมื่อไหร่ ทำไม
#
# 6. Knowledge Base (KB):
#    → ฐานความรู้ทั่วไป
#    → วิธีตั้งค่า, Tips, Best Practices

Template: SOP (Standard Operating Procedure)

# =============================================
# SOP TEMPLATE
# =============================================
#
# SOP-XXX: [ชื่อ SOP]
# Version: 1.0
# Created: YYYY-MM-DD
# Updated: YYYY-MM-DD
# Author: [ชื่อ]
# Approved by: [ชื่อ Manager]
# Review Date: YYYY-MM-DD (ทุก 6 เดือน)
#
# =============================================
# 1. PURPOSE (วัตถุประสงค์):
# =============================================
# อธิบายว่า SOP นี้มีไว้ทำอะไร
#
# 2. SCOPE (ขอบเขต):
# =============================================
# ใช้กับอะไร ใช้เมื่อไหร่ ไม่ใช้เมื่อไหร่
#
# 3. PREREQUISITES (สิ่งที่ต้องมีก่อน):
# =============================================
# □ Access ที่ต้องมี (Admin, VPN)
# □ Tools ที่ต้องใช้
# □ Approval ที่ต้องได้
#
# 4. PROCEDURE (ขั้นตอน):
# =============================================
# Step 1: _______________
#   1.1: _______________
#   1.2: _______________
#   Expected Result: _______________
#
# Step 2: _______________
#   2.1: _______________
#   Expected Result: _______________
#
# Step 3: _______________
#   ...
#
# 5. VERIFICATION (การตรวจสอบ):
# =============================================
# □ ตรวจสอบว่าทำสำเร็จ
# □ ทดสอบผลลัพธ์
#
# 6. ROLLBACK (ถ้าผิดพลาด):
# =============================================
# ขั้นตอนย้อนกลับถ้าทำแล้วผิดพลาด
#
# 7. REFERENCES (เอกสารอ้างอิง):
# =============================================
# ลิงก์ไปยัง Doc อื่นที่เกี่ยวข้อง

ตัวอย่าง SOP: การเพิ่ม User ใน Active Directory

# =============================================
# SOP-001: การเพิ่ม User ใน Active Directory
# Version: 2.1
# Created: 2025-01-15
# Updated: 2026-04-01
# Author: IT Admin Team
# Review: ทุก 6 เดือน
# =============================================
#
# PURPOSE:
# ขั้นตอนมาตรฐานในการสร้าง User Account ใน Active Directory
# สำหรับพนักงานใหม่
#
# SCOPE:
# ใช้กับพนักงานใหม่ทุกคน (Full-Time, Part-Time, Contractor)
#
# PREREQUISITES:
# □ ได้รับ New Hire Form จาก HR (อนุมัติแล้ว)
# □ มี Domain Admin Access
# □ เปิด Active Directory Users and Computers
#
# PROCEDURE:
#
# Step 1: สร้าง User Account
# 1.1 เปิด ADUC (dsa.msc)
# 1.2 ไปที่ OU ตามแผนก:
#     OU=Users,OU=[Department],DC=company,DC=local
# 1.3 คลิกขวา → New → User
# 1.4 กรอกข้อมูล:
#     First Name: [ชื่อ]
#     Last Name: [นามสกุล]
#     User Logon Name: [firstname.lastname]
#     Display Name: [ชื่อ นามสกุล]
# 1.5 ตั้ง Password: TempPass2026! (ต้องเปลี่ยนครั้งแรก)
#     □ User must change password at next logon: ON
#     □ Password never expires: OFF
#
# Step 2: เพิ่มเข้า Security Groups
# 2.1 ตาม Department:
#     IT → SG-IT-Users, SG-VPN-Users
#     Sales → SG-Sales-Users, SG-CRM-Users
#     Finance → SG-Finance-Users
# 2.2 ทุกคน: SG-All-Users, SG-WiFi-Users
#
# Step 3: สร้าง Email (Microsoft 365)
# 3.1 เปิด admin.microsoft.com
# 3.2 Users → Active Users → Add a User
# 3.3 Assign License: Microsoft 365 Business
# 3.4 Email: [email protected]
#
# Step 4: แจ้ง User
# 4.1 ส่ง Email ไปที่ HR พร้อม:
#     - Username
#     - Temporary Password
#     - คู่มือเปลี่ยน Password
#     - คู่มือ VPN
#
# VERIFICATION:
# □ Login ด้วย User ใหม่ได้
# □ เข้า Email ได้
# □ เข้า Share Drive ตาม Group ได้
# □ VPN ทำงานได้ (ถ้าต้องการ)
#
# ROLLBACK:
# ถ้าสร้างผิด → Disable Account → แจ้ง Manager → สร้างใหม่
# ห้ามลบ Account ที่สร้างแล้ว (เก็บ Log)

Template: Runbook

# =============================================
# RUNBOOK TEMPLATE
# =============================================
#
# RB-XXX: [ชื่อ Incident/Problem]
# Severity: Critical / High / Medium / Low
# MTTR Target: XX minutes
# Last Tested: YYYY-MM-DD
#
# =============================================
# SYMPTOMS (อาการ):
# =============================================
# อาการที่จะเห็นเมื่อเกิดปัญหานี้:
# □ _________________
# □ _________________
#
# IMPACT (ผลกระทบ):
# =============================================
# ใครได้รับผลกระทบ? ระบบอะไรหยุดทำงาน?
#
# ROOT CAUSES (สาเหตุที่เป็นไปได้):
# =============================================
# 1. _________________
# 2. _________________
# 3. _________________
#
# DIAGNOSTIC STEPS (ขั้นตอนวินิจฉัย):
# =============================================
# Step 1: ตรวจสอบ _______________
#   Command: _______________
#   Expected: _______________
#   If NOT: → ไปข้อ ___
#
# RESOLUTION STEPS (ขั้นตอนแก้ไข):
# =============================================
# สำหรับ Cause 1:
#   1. _______________
#   2. _______________
#
# สำหรับ Cause 2:
#   1. _______________
#   2. _______________
#
# ESCALATION (ถ้าแก้ไม่ได้):
# =============================================
# Level 1 → Level 2: [ชื่อ/ทีม]
# Level 2 → Level 3: [ชื่อ/ทีม]
# Level 3 → Vendor: [ข้อมูลติดต่อ]
#
# POST-INCIDENT:
# =============================================
# □ เขียน Incident Report
# □ Root Cause Analysis
# □ Update Runbook ถ้าจำเป็น

ตัวอย่าง Runbook: Database Server Down

# =============================================
# RB-003: MySQL Database Server Down
# Severity: Critical | MTTR: 15 minutes
# =============================================
#
# SYMPTOMS:
# □ Application แสดง "Database Connection Error"
# □ Monitoring Alert: MySQL Down
# □ Port 3306 ไม่ตอบ
#
# IMPACT:
# ทุก Application ที่ใช้ DB นี้จะหยุดทำงาน
# ผู้ใช้: 500+ คน
#
# DIAGNOSTIC:
#
# Step 1: ตรวจสอบ MySQL Service
ssh db-server
sudo systemctl status mysql
# → Active (running) = OK → ไปข้อ 3
# → Inactive/Failed = ไปข้อ 2
#
# Step 2: Start MySQL
sudo systemctl start mysql
sudo systemctl status mysql
# → ถ้า Start ได้ → ดู Logs → ไปข้อ 5
# → ถ้า Start ไม่ได้ → ไปข้อ 2.1
#
# Step 2.1: ดู Error Log
sudo tail -100 /var/log/mysql/error.log
# → Disk Full? → ไปข้อ 4
# → Corrupted Table? → ไปข้อ 4.1
# → Permission Error? → ไปข้อ 4.2
#
# Step 3: ตรวจสอบ Connectivity
mysql -u root -p -e "SELECT 1"
# → OK = DB ทำงานปกติ ปัญหาอาจอยู่ที่ App
# → Error = ยังมีปัญหา
#
# Step 4: ตรวจสอบ Disk Space
df -h /var/lib/mysql
# → ถ้า > 90% → ลบ Log เก่า / ขยาย Disk
sudo find /var/log -name "*.log" -mtime +30 -delete
#
# Step 5: Verify Application
curl -s http://app-server/health
# → OK = กลับมาปกติ
# → Error = ยังมีปัญหา → Restart App
#
# ESCALATION:
# 15 นาทีแก้ไม่ได้ → แจ้ง Senior DBA: [ชื่อ] Tel: [เบอร์]
# 30 นาทีแก้ไม่ได้ → แจ้ง IT Manager: [ชื่อ]
# 60 นาทีแก้ไม่ได้ → แจ้ง Vendor

Template: System Inventory

# =============================================
# SYSTEM INVENTORY TABLE
# =============================================
#
# | Hostname    | IP           | OS              | CPU/RAM      | Role         | Location  | Owner    | Warranty   |
# |-------------|-------------|-----------------|-------------|-------------|---------|---------|-----------|
# | web-01      | 192.168.1.10 | Ubuntu 22.04    | 4C/8GB      | Web Server   | DC-Rack1  | IT Team  | 2027-03   |
# | db-01       | 192.168.1.20 | Ubuntu 22.04    | 8C/32GB     | MySQL DB     | DC-Rack2  | DBA Team | 2027-06   |
# | fw-01       | 192.168.1.1  | FortiOS 7.4     | -           | Firewall     | DC-Rack1  | NetTeam  | 2028-01   |
# | sw-core     | 192.168.1.2  | Cisco IOS 17.x  | -           | Core Switch  | DC-Rack1  | NetTeam  | 2027-12   |
# | ap-floor1   | 192.168.2.10 | UniFi 7.x       | -           | WiFi AP      | Floor 1   | NetTeam  | 2027-06   |
#
# =============================================
# NETWORK DEVICE INVENTORY:
# =============================================
# | Device      | IP           | Model           | Serial      | Firmware    | Location  | SNMP     |
# | sw-core     | 192.168.1.2  | Cisco C9300     | FCW2345XXX  | 17.9.4     | DC-Rack1  | Yes      |
# | rt-main     | 192.168.1.1  | MikroTik CCR2004| HEP0981XXX | 7.14       | DC-Rack1  | Yes      |

Documentation Tools

Documentation Best Practices

# =============================================
# BEST PRACTICES:
# =============================================
#
# 1. Write for the NEW person:
#    → เขียนให้คนที่ไม่เคยทำเรื่องนี้ ทำตามได้
#    → อย่าสมมติว่าผู้อ่านรู้ Context
#
# 2. Keep it Updated:
#    → ตั้ง Review Date ทุก 3-6 เดือน
#    → Update ทุกครั้งที่มีการเปลี่ยนแปลง
#    → Doc ที่เก่า = Doc ที่อันตราย
#
# 3. Use Screenshots/Diagrams:
#    → รูปภาพ 1 รูป = คำอธิบาย 1,000 คำ
#    → ใช้เครื่องมือ: draw.io, Excalidraw, Mermaid
#
# 4. Version Control:
#    → ใส่ Version Number
#    → บันทึก Change Log
#    → ใช้ Git ถ้าเป็นไปได้
#
# 5. Searchable:
#    → ใช้ Title ที่ชัดเจน
#    → ใส่ Tags / Categories
#    → ใช้คำที่คนจะค้นหา
#
# 6. Test Your Docs:
#    → ให้คนอื่นลองทำตาม
#    → ถ้าทำตามไม่ได้ = Doc ยังไม่ดีพอ
#
# 7. Template Everything:
#    → สร้าง Template สำหรับทุกประเภท Doc
#    → ลดเวลาเขียน + มีมาตรฐาน
#
# 8. Link Related Docs:
#    → อ้างอิงไปยัง Doc ที่เกี่ยวข้อง
#    → สร้าง Index / Table of Contents

สรุป: IT Documentation สำหรับ IT Team

IT Documentation ไม่ใช่งานเสริม แต่เป็นส่วนสำคัญของ IT Operations ที่มีประสิทธิภาพ SOP ช่วยให้ทุกคนทำงานได้มาตรฐานเดียวกัน Runbook ช่วยให้แก้ปัญหาได้เร็วขึ้น 10 เท่า และ System Inventory ช่วยให้รู้ว่ามีอะไรอยู่ในระบบ เริ่มจาก Template ที่ให้ในบทความนี้ ปรับให้เหมาะกับองค์กร แล้วคุณจะเห็นว่า IT Team ทำงานได้ดีขึ้นอย่างชัดเจน