Send Error to IT Support
Melaporkan error kegagalan permintaan ke server langsung dari notifikasi, tanpa perlu menghubungi IT support secara manual.
Fitur Send Error to IT Support memungkinkan pengguna melaporkan error yang terjadi langsung dari notifikasi yang muncul di aplikasi. Laporan akan otomatis dibuatkan tiket helpdesk sehingga tim IT support dapat menindaklanjutinya tanpa pengguna perlu menghubungi IT support secara manual.
Kapan tombol muncul
Tombol Send Error to IT Support hanya muncul pada notifikasi yang berasal dari kegagalan permintaan ke server (misalnya server tidak merespons, terjadi error internal, atau koneksi ke layanan backend gagal).
Notifikasi lain, seperti kesalahan validasi form atau kesalahan penggunaan (input tidak valid, field wajib belum diisi, dan sejenisnya), tidak menampilkan tombol ini. Hal ini disengaja karena error tersebut bukan disebabkan oleh masalah pada sistem, sehingga tidak perlu ditindaklanjuti oleh IT support.
Alur pelaporan
- Saat terjadi kegagalan permintaan ke server, notifikasi error akan muncul beserta tombol Send Error to IT Support.
- Klik tombol tersebut untuk mengirimkan laporan.
- Sistem akan otomatis membuat tiket helpdesk berdasarkan detail error yang terjadi.
Data yang ikut terkirim
Sebelum menekan tombol, penting untuk mengetahui data apa saja yang akan dikirimkan ke IT support. Informasi berikut disertakan secara otomatis pada setiap laporan:
- Endpoint — alamat API yang dipanggil saat error terjadi.
- Method — jenis HTTP method yang digunakan (misalnya
GET,POST,PUT,DELETE). - Status — kode status HTTP yang dikembalikan oleh server (misalnya
500,502,504). - Waktu — tanggal dan jam saat error terjadi.
- Nama proses dan task — proses bisnis dan task yang sedang dijalankan pengguna ketika error muncul.
- Workspace — workspace tempat error terjadi.
- Email pelapor — email pengguna yang mengirimkan laporan, digunakan sebagai kontak balik oleh IT support.
Data ini digunakan semata-mata untuk membantu IT support menelusuri dan menindaklanjuti penyebab error dengan cepat.
Deduplikasi 24 jam
Jika error yang sama dilaporkan berulang kali dalam rentang waktu 24 jam, sistem tidak akan membuat tiket baru. Laporan berikutnya akan digabungkan ke tiket yang sudah ada, sehingga nomor tiket yang ditampilkan tetap sama dan tidak bertambah.
Perilaku ini disengaja untuk mencegah duplikasi tiket akibat error berulang, bukan indikasi bahwa laporan gagal terkirim. Jika nomor tiket yang muncul sama seperti laporan sebelumnya, artinya laporan sudah berhasil tercatat pada tiket yang sudah ada.
Untuk administrator
Fitur ini dikendalikan melalui environment variable berikut pada sisi frontend:
| Environment Variable | Keterangan | Default |
|---|---|---|
VITE_FEATURE_ERROR_REPORT | Mengaktifkan/menonaktifkan fitur Send Error to IT Support | Nonaktif (false) |
VITE_ERROR_REPORT_BASEURL | Base URL endpoint helpdesk tempat tiket error dibuat | - |
VITE_ERROR_REPORT_ACCESS_KEY | Access key untuk otentikasi ke endpoint helpdesk | - |
Jika tombol Send Error to IT Support tidak muncul sama sekali pada notifikasi error, kemungkinan besar penyebabnya adalah VITE_FEATURE_ERROR_REPORT belum diaktifkan, atau VITE_ERROR_REPORT_BASEURL dan VITE_ERROR_REPORT_ACCESS_KEY belum dikonfigurasi dengan benar.
