Framework Troubleshooting — Deep Dive per Langkah

Execution Log: Petunjuk Pertama

Execution log memberikan visibilitas instan tentang apa yang terjadi. Ini selalu menjadi langkah pertama.

┌─────────────────────────────────────────┐
│        MEMBACA EXECUTION LOG            │
├─────────────────────────────────────────┤
│                                         │
│  ✅ Node hijau = berhasil               │
│  ❌ Node merah = gagal di sini          │
│                                         │
│  TAPI HATI-HATI:                        │
│  Node merah belum tentu sumber masalah! │
│  Error bisa propagasi dari node lain.   │
│                                         │
└─────────────────────────────────────────┘

Apa yang Harus Dicek?

Informasi	Penjelasan
Node mana yang gagal	Identifikasi titik kegagalan
Error message	Baca pesan error dengan teliti
Internal vs External	Masalah di workflow atau di layanan luar?
Output AI	Jika pakai agent/LLM, output bisa tidak terduga

AI Itu Unreliable

Jika workflow menggunakan AI agent, output bisa sangat bervariasi. Contoh: kamu minta cari tiket Delhi → Dubai, tapi AI malah mencari "India" → "Dub". Selalu pertimbangkan ketidakpastian output AI saat debugging.

---

Test Credentials: Penyebab Tersembunyi

Credentials adalah penyebab error yang sering terlewat:

Jenis Masalah	Contoh Nyata
OAuth token expired	Token Google/Dropbox kadaluarsa setelah beberapa waktu
API key dicabut	Seseorang menghapus key tanpa sengaja
Permission berubah	Client mengubah permission di Dropbox Developer Console
Bot dihapus	Membersihkan bot di Telegram BotFather tanpa sadar

Studi Kasus: Permission Dropbox

Skenario:
├── Development: Butuh WRITE permission untuk backup
├── Setelah development: Client "bersih-bersih" permission
├── Tidak sengaja menghapus READ permission juga
└── Hasil: Workflow restore tiba-tiba gagal!

Selalu cek: Error code 401 Unauthorized atau 403 Forbidden = masalah credential.

---

Validasi Entry Point / Webhook

Mayoritas workflow client menggunakan webhook sebagai entry point. Masalah yang sering terjadi:

┌──────────────────────────────────────────────┐
│      CHECKLIST ENTRY POINT                   │
├──────────────────────────────────────────────┤
│                                              │
│  ☐ URL webhook benar? (test vs production)   │
│  ☐ HTTP method sesuai? (GET/POST)            │
│  ☐ Authentication header ada?                │
│  ☐ Path tidak berubah?                       │
│  ☐ Trigger aktif dan terpublish?             │
│                                              │
│  Contoh trigger lain:                        │
│  ☐ Gmail: email tidak masuk spam?            │
│  ☐ Telegram: bot masih aktif?                │
│  ☐ Scheduler: timezone benar?               │
│                                              │
└──────────────────────────────────────────────┘

Pengalaman Nyata: Gmail Trigger

Client memblokir pengirim email tertentu di Gmail → email yang tadinya masuk ke tab "Social" sekarang terfilter sebagai spam → trigger Gmail berhenti bekerja.

Perubahan kecil oleh client bisa meruntuhkan seluruh workflow.

---

Network & Connectivity

Masalah jaringan biasanya terdeteksi lewat Uptime Robot atau monitoring dashboard:

Cek	Cara
VPS aktif?	Lihat Uptime Robot dashboard
Domain expired?	Cek tanggal expiry hosting
Response time?	Curl atau Postman untuk tes konektivitas
n8n accessible?	Akses URL n8n instance langsung

Praktik Terbaik

• Lakukan update/maintenance di jam sepi (malam hari)
• Pisahkan VPS production dan development
• Informasikan client jika ada maintenance terencana

---

Isolasi: Trigger vs Logic Workflow

Ketika semua langkah di atas belum menemukan masalah, saatnya memecah workflow:

Trigger berfungsi?
     │
     ├── YA → Masalah ada di LOGIC WORKFLOW
     │         ├── Cek setiap node satu per satu
     │         ├── Cek conditional branching
     │         ├── Cek data transformation
     │         └── Cek edge case yang terlewat
     │
     └── TIDAK → Masalah ada di TRIGGER
               ├── Webhook URL salah?
               ├── Authentication gagal?
               └── External service down?

Kapan Masalah Ada di Logic?

Contoh: Client bilang chatbot e-commerce hanya boleh menjawab pertanyaan elektronik, tapi customer bertanya tentang pakaian:

"Kamu bilang chatbot hanya untuk elektronik. Kenapa dia jawab soal baju?"

→ Ini bukan bug teknis, tapi use case yang belum dihandle. Komunikasikan ke client.

---

Error Trigger Terpusat

Pastikan Universal Error Logger selalu terhubung:

Workflow A ──┐
Workflow B ──┤──▶ Universal Error Logger
Workflow C ──┘         │
                       ├── Telegram Notification
                       ├── Google Sheet Log
                       └── Email Alert

"Saat menyerahkan workflow ke client, minta akses ke error logger juga — agar kamu tetap tahu kapan workflow gagal meskipun sudah dipindah ke server client."

---

Ringkasan Framework

Langkah	Target	Success Rate
1. Execution Log	Identifikasi node & error	Mengarahkan 90% kasus
2. Test Credentials	OAuth, API key, permission	Penyebab 30% error
3. Entry Point	Webhook, trigger, URL	Penyebab 20% error
4. Network	VPS, DNS, firewall	Penyebab 10% error
5. Isolasi Logic	Branching, data, edge case	Sisanya

Framework ini menyelesaikan 80% masalah. Sisanya adalah kasus logika bisnis yang perlu didiskusikan dengan client.