Fitur Log Aplikasi — Monitoring & Troubleshooting
Fitur log aplikasi mencatat seluruh aktivitas sistem secara otomatis, mulai dari panggilan API, perubahan status perangkat, hingga kegagalan pengiriman webhook. Log digunakan untuk memantau kondisi sistem dan mengidentifikasi sumber masalah saat terjadi error.
Prasyarat
- Sudah login ke dashboard Whapi
- Fitur log sudah diaktifkan di pengaturan aplikasi
Mengaktifkan Fitur Log
Sebelum log mulai mencatat aktivitas, aktifkan fitur ini terlebih dahulu:
- Masuk ke menu Tentang di dashboard
- Buka Pengaturan Aplikasi
- Aktifkan jenis log yang dibutuhkan: Log API, Log Perangkat, atau Log Error Webhook
Jenis Log yang Tersedia
| Jenis Log | Lokasi di Dashboard | Yang Dicatat |
|---|---|---|
| Log API | Perangkat > Log Perangkat API | Setiap request API yang masuk: endpoint, status, tipe, dan waktu |
| Log Perangkat | Perangkat > Log Perangkat | Perubahan status koneksi perangkat secara real-time |
| Log Error Webhook | Perangkat > Report Webhook | Kegagalan pengiriman webhook beserta detail error-nya |
Log API
Log API mencatat seluruh request API yang dikirim oleh whapi.
Cara Membaca Log API
- Masuk ke Perangkat > Log Perangkat API
- Pilih perangkat yang ingin dipantau
- Klik Terapkan untuk menampilkan data log
- Gunakan filter Status dan Tipe untuk mempersempit pencarian
- Klik Hapus Semua Log untuk membersihkan data log lama jika diperlukan
Kolom yang Ditampilkan
| Kolom | Keterangan |
|---|---|
| Penerima | Nomor penerima |
| Status | Status pesan yang dikirim |
| Waktu | Waktu saat request dikirim oleh whapi |
| Aksi | Melihat detail API yang dikirim |
Log Perangkat
Log perangkat mencatat setiap perubahan status koneksi secara otomatis. Berguna untuk melacak kapan perangkat terputus atau kembali terhubung.
Cara Membaca Log Perangkat
- Masuk ke Perangkat > Log Perangkat
- Pilih perangkat yang ingin dilihat riwayatnya
- Gunakan filter Status untuk mencari perubahan status tertentu
- Klik Hapus Semua Log untuk membersihkan data lama
Status yang Dicatat
| Status | Artinya |
|---|---|
| CONNECTED | Perangkat berhasil terhubung |
| DISCONNECTED | Koneksi terputus |
| SERVICE_SCAN | Menunggu scan QR |
| SERVICE_OFF | Layanan dimatikan |
| PAIRING | Sedang dalam proses koneksi |
Log Error Webhook
Log error webhook mencatat kegagalan pengiriman data ke endpoint server. Saat pengiriman webhook gagal, sistem mencoba mengirim ulang hingga 3 kali sebelum mencatat error ke log.
Cara Membaca Log Error Webhook
- Masuk ke Perangkat > Report Webhook
- Sistem otomatis mencatat setiap kegagalan pengiriman
- Baca detail error untuk mengetahui penyebab kegagalan
Penyebab Error Webhook yang Umum
| Kode Error | Penyebab | Solusi |
|---|---|---|
| Connection refused | Server endpoint tidak berjalan | Periksa apakah server webhook aktif dan port terbuka |
| Timeout | Server tidak merespons dalam waktu yang ditentukan | Periksa performa server dan pastikan endpoint merespons dalam waktu wajar |
| 404 Not Found | URL webhook salah atau endpoint tidak ada | Verifikasi URL webhook di pengaturan perangkat |
| 401 Unauthorized | Endpoint membutuhkan autentikasi | Tambahkan token atau header autentikasi yang sesuai di server |
| 500 Internal Server Error | Error di sisi server penerima | Periksa log server untuk menemukan sumber error |
Cara Membersihkan Log
Log yang menumpuk dapat dibersihkan melalui dashboard atau API:
Via Dashboard
Gunakan tombol Hapus Semua Log di halaman Log API atau Log Perangkat
Error Umum dan Solusinya
| Kondisi | Penyebab | Solusi |
|---|---|---|
| Log tidak menampilkan data | Fitur log belum diaktifkan | Aktifkan log di menu Tentang > Pengaturan Aplikasi |
| Log API kosong meski ada request | Perangkat yang dipilih salah | Pastikan memilih perangkat yang benar di filter |
| Log error webhook tidak muncul | Webhook belum dikonfigurasi | Pastikan URL webhook sudah diisi dan fitur webhook aktif |