Ikhtisar Chapter 6 — Troubleshooting & Komunikasi

Gambaran Besar

Chapter ini membahas bagaimana menangani masalah workflow secara profesional — bukan hanya secara teknis, tetapi juga dalam berkomunikasi dengan client. Karena di dunia nyata, client tidak mengirim stack trace — mereka mengirim "Hei, ini gak jalan."

---

Framework Troubleshooting 6 Langkah

┌─────────────────────────────────────────────────────────┐
│                                                         │
│  1. EXECUTION LOG ──▶ Identifikasi node & error message│
│         │                                               │
│  2. CREDENTIALS ──▶ OAuth expired? Key dicabut?         │
│         │              Permission berubah?              │
│         │                                               │
│  3. ENTRY POINT ──▶ Webhook URL benar? Method sesuai?  │
│         │              Trigger aktif?                   │
│         │                                               │
│  4. NETWORK ──▶ VPS up? Domain valid? Firewall?        │
│         │                                               │
│  5. ISOLASI ──▶ Trigger OK? → Masalah di logic         │
│         │       Trigger fail? → Masalah di trigger      │
│         │                                               │
│  6. FIX & KOMUNIKASI ──▶ Perbaiki + update client      │
│                                                         │
│  ✅ Framework ini menyelesaikan 80% masalah             │
└─────────────────────────────────────────────────────────┘

---

Tiga Pilar Troubleshooting Profesional

Pilar	Inti	Video
Investigasi	Jangan panik, jangan tebak. Kumpulkan konteks, ikuti framework	Video 1 & 2
Teknis	Execution log → Credentials → Entry point → Network → Isolasi	Video 2
Komunikasi	Update berkala, RCA report, runbook, jangan menyalahkan	Video 3

---

Pelajaran Kunci dari Pengalaman

Dari Video 1 — Troubleshooting Dasar

"Saya pernah langsung fix tanpa cari root cause. 'Nanti' saya cek, dan nanti itu tidak pernah datang."

• Selalu catat to-do untuk investigasi lanjutan
• Cek apakah error menyebar ke workflow lain (shared credentials)

Dari Video 2 — Framework Mendalam

"Jangan langsung percaya node merah = sumber masalah. Error bisa propagasi dari node sebelumnya."

• AI output unreliable — pertimbangkan ketidakpastian saat debugging
• Perubahan kecil oleh client (spam filter, permission) bisa meruntuhkan workflow

Dari Video 3 — Komunikasi

"Diam menciptakan kecemasan. Update menciptakan kepercayaan."

• Million dollar advice: Hubungi client duluan sebelum mereka tahu ada error
• Eskalasi bukan kegagalan, eskalasi adalah profesionalisme

---

Alur Komplit: Error Terjadi → Resolusi

Error Terdeteksi (monitoring / client lapor)
         │
         ▼
  ┌─────────────────┐
  │ ACKNOWLEDGMENT   │──▶ "Saya sedang cek, update
  │ (< 15 menit)    │     dalam 30 menit"
  └────────┬────────┘
           │
           ▼
  ┌─────────────────┐
  │ INVESTIGASI      │──▶ Ikuti framework 6 langkah
  │ (framework)      │
  └────────┬────────┘
           │
           ▼
  ┌─────────────────┐
  │ UPDATE           │──▶ "Masalahnya credential expired,
  │                  │     sedang diperbaiki"
  └────────┬────────┘
           │
           ▼
  ┌─────────────────┐
  │ FIX & VERIFIKASI │──▶ Perbaiki + test 3 execution
  └────────┬────────┘
           │
           ▼
  ┌─────────────────┐
  │ KONFIRMASI       │──▶ "Workflow normal. Ini RCA nya."
  └────────┬────────┘
           │
           ▼
  ┌─────────────────┐
  │ PENCEGAHAN       │──▶ Runbook + monitoring tambahan
  └─────────────────┘

---

Deliverable yang Harus Ada

Deliverable	Kapan	Untuk Siapa
Monitoring Dashboard	Setup awal	Kamu + Client
Universal Error Logger	Setup awal	Kamu
RCA Report	Setelah incident	Client
Runbook	Jika error bisa terulang	Client + Tim Client
Update Berkala	Selama troubleshooting	Client

---

Satu Kalimat yang Merangkum Semuanya

Troubleshooting bukan hanya pekerjaan teknis — ini adalah pekerjaan client-facing yang membangun atau menghancurkan kepercayaan.