Contoh investigasi

Contoh-contoh ini menunjukkan cara menjawab pertanyaan umum dengan Catatan Audit. Setiap contoh memuat pertanyaannya, filter dan klik yang digunakan, serta apa yang perlu diperhatikan. Langkah yang sama berlaku di jenis lokasi apa pun, jadi sesuaikan filter dengan pertanyaan Anda sendiri.

Referensi cepat

Lokasi: Settings (ikon roda gigi, kiri bawah) → Catatan Audit

Siapa yang dapat menggunakannya: Anda memerlukan peran yang mencakup Catatan Audit dan Identity & Access Management di organisasi Anda, seperti Organisation Administrator. Lihat Siapa yang dapat menggunakan Catatan Audit.

Tujuan: Beralih dari sebuah pertanyaan ke permintaan yang menjawabnya

Siapa yang membuka kunci pintu masuk depan?

Gym atau pusat rekreasi: kunci pintu masuk depan dibuka dari jarak jauh, dan manajer jaga ingin tahu siapa yang melakukannya dan mengapa.

1. Di tab Logs, klik Endpoint, ketik /api/door-gate-access/*, lalu klik Apply. Daftar hanya menampilkan permintaan Door & Gate Access.
2. Atur Range agar mencakup waktu pembukaan kunci.
3. Klik permintaan yang endpoint-nya diakhiri dengan /front-entrance/unlock.

Gambar 1: Setiap permintaan pintu, dengan pembukaan kunci pintu masuk depan terbuka

Yang perlu diperhatikan: User menunjukkan siapa yang membuka kunci pintu, di sini oscar.tran@example.com. Request POST Body menunjukkan alasan yang diberikan, "Member forgot access card", dan Response Body menunjukkan bahwa kunci pintu terbuka.

Selanjutnya: periksa rekaman pintu itu sendiri di Access Logs Door & Gate Access, yang mencatat setiap upaya membuka kunci di pintu tersebut, termasuk dari aplikasi seluler.

Mengapa seorang staf tidak dapat mengubah peran seseorang?

Klinik fisioterapi: seorang koordinator mencoba memberikan peran baru kepada rekan kerja, tetapi tidak berhasil.

1. Di tab Logs, klik Status lalu pilih 403 Forbidden.
2. Klik permintaan 403 Forbidden dari waktu perubahan peran.
3. Di AI Error Summary, klik Generate summary.

Gambar 2: Ringkasan menjelaskan mengapa perubahan peran ditolak

Yang perlu diperhatikan: ringkasan menyatakan bahwa orang tersebut "does not have permission to assign that role". Bandingkan dengan Response Body, yang menyatakan "You don't have permission to assign this role." Request POST Body menunjukkan peran mana yang coba mereka berikan.

Selanjutnya: minta Organisation Administrator untuk melakukan perubahan, atau tinjau peran orang tersebut. Lihat Mengubah peran pengguna dan Templat peran.

Integrasi pemesanan kami berhenti menyinkronkan semalam

Pusat akuatik atau fasilitas pemerintah daerah: check-in dari sistem pemesanan berhenti muncul semalam.

1. Di tab Logs, klik Endpoint, ketik /partner/v1/*, lalu klik Apply.
2. Atur Range ke Last 24 hours.
3. Lihat status di awal setiap baris, lalu klik permintaan yang gagal untuk membaca Response Body-nya.

Yang perlu diperhatikan: permintaan dengan lencana api-key dari integrations@example.org. Di sini daftar menampilkan 429 Too Many Requests, saat integrasi mengirim terlalu banyak permintaan dalam waktu singkat, dan 503 Service Unavailable. Catat kapan kegagalan dimulai dan apakah ada permintaan yang berhasil setelahnya.

Selanjutnya: klik Ekspor CSV dan kirim file ke mitra integrasi agar mereka dapat memeriksa dari sisi mereka. Lihat Mengekspor log dan halaman Errors Partner API.

Webhook tidak tersimpan

Kafe, toko, atau tempat perhotelan: seorang manajer menyiapkan webhook untuk mengirim detail pengunjung ke sistem lain, tetapi webhook tidak tersimpan.

1. Di tab Logs, klik Email dan ketik alamat email lengkap manajer, di sini leo.hargreaves@example.com.
2. Temukan dua permintaan POST dari saat manajer menyimpan webhook: 400 Bad Request dan 201 Created pada endpoint yang sama.
3. Klik 400 Bad Request, lalu 201 Created beberapa menit kemudian, dan bandingkan keduanya.

Yang perlu diperhatikan: Response Body dari 400 menyatakan "url must start with https://". Di Request POST Body-nya, alamat tidak diawali dengan https://. Pada 201, manajer telah menambahkan https://, dan webhook tersimpan.

Selanjutnya: untuk permintaan yang gagal, klik Generate summary untuk mendapatkan penjelasan dalam bahasa yang mudah dipahami. Lihat AI Error Summary.

Apa yang dilakukan staf yang akan keluar minggu lalu?

Kantor atau lokasi co-working: sebelum seorang staf keluar, manajernya menginginkan rekaman aktivitas terbarunya.

1. Di tab Logs, klik Email dan ketik alamat email lengkap orang tersebut.
2. Atur Range ke Last 7 days.
3. Gulir ke bagian bawah daftar agar setiap permintaan dimuat. Ekspor hanya menyertakan baris yang telah dimuat.
4. Klik Ekspor CSV, lalu Export.

Yang perlu diperhatikan: perubahan, bukan pembacaan. Atur Method ke POST, PUT, PATCH, atau DELETE secara bergantian untuk melihat permintaan yang membuat, mengubah, atau menghapus sesuatu. Untuk hal yang tidak terduga, buka permintaan dan baca Request POST Body-nya.

Selanjutnya: saat mereka keluar, hapus akses mereka. Lihat Menghapus pengguna. Simpan file CSV sesuai dengan kebijakan organisasi Anda.

Lokasi mana yang memiliki permintaan gagal terbanyak?

Operator multi-lokasi: beberapa lokasi melaporkan masalah kemarin, dan kantor pusat ingin tahu harus mulai dari mana.

1. Di tab Dasbor, atur Window agar mencakup hari tersebut.
2. Di Errors Over Time, klik bucket dengan kesalahan tertinggi. Tab Logs terbuka dengan permintaan gagal dari waktu tersebut.
3. Klik Fasilitas dan pilih setiap lokasi secara bergantian, lalu bandingkan berapa banyak permintaan gagal yang dimiliki masing-masing.

Yang perlu diperhatikan: lokasi dengan kegagalan yang jauh lebih banyak daripada yang lain, atau kegagalan pada satu endpoint. Buka beberapa permintaannya dan baca Response Body atau klik Generate summary.

Selanjutnya: lihat Dasbor untuk grafik lainnya, dan Fasilitas untuk lokasi di organisasi Anda.

Halaman terkait

• Mencari permintaan: setiap filter
• Membaca entri log: kolom, isi, dan kode status
• Mengekspor log: ekspor CSV