Logo Performance HubPerformance Hub
Bagian situs: Dokumentasi

Catatan Audit

Di halaman ini

Catatan Audit adalah rekaman permintaan yang dibuat ke Performance Hub di organisasi Anda. Rekaman ini mencakup permintaan dari orang yang menggunakan Performance Hub di browser atau aplikasi, serta dari alat yang terhubung seperti kunci API, agen AI yang terhubung melalui MCP, dan Model Router. Gunakan untuk menjawab pertanyaan seperti siapa yang membuka kunci pintu, mengapa suatu perubahan tidak tersimpan, atau kapan suatu integrasi berhenti berfungsi, baik lokasi Anda berupa kantor, toko, kafe, tempat acara, klinik, kampus, maupun gym.

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: Melihat siapa melakukan apa di Performance Hub, dan mencari tahu mengapa suatu permintaan gagal

Dasbor Catatan Audit, dengan tombol Window, lima angka utama, dan grafik Request TimelineDasbor Catatan Audit, dengan tombol Window, lima angka utama, dan grafik Request Timeline

Gambar 1: Dasbor Catatan Audit: rentang waktu, angka utama, dan linimasa permintaan

Apa yang dicatat

Setiap entri log adalah satu permintaan yang dibuat ke Performance Hub. Entri ini menampilkan:

  • Siapa yang membuat permintaan: alamat email pengguna.
  • Dari mana: alamat IP, serta browser atau alat yang mengirimkannya.
  • Apa yang dipanggil: metode (misalnya GET untuk membaca atau POST untuk membuat) dan endpoint, yaitu bagian Performance Hub yang menjadi tujuan permintaan, seperti /api/door-gate-access/doors/front-entrance/unlock.
  • Hasilnya: status respons, misalnya 200 untuk berhasil atau 403 saat orang tersebut tidak memiliki izin.
  • Berapa lama waktunya, dalam milidetik.
  • Asalnya: lencana sumber, seperti web untuk orang yang menggunakan Performance Hub atau api-key untuk integrasi. Lihat Lencana sumber.

Untuk permintaan terbaru, entri log juga menyimpan apa yang dikirim dan apa yang dikembalikan. Lihat Membaca entri log.

Dua tab

TabKegunaannya
DasborTotal, tingkat kesalahan, dan grafik untuk rentang waktu tertentu, dengan endpoint dan pengguna tersibuk. Klik grafik atau baris untuk membuka log yang sesuai.
LogsPermintaan itu sendiri. Filter dan cari daftar, buka entri log untuk melihat detailnya, dan ekspor ke CSV.

Siapa yang dapat menggunakan Catatan Audit

Anda memerlukan peran yang mencakup Catatan Audit dan Identity & Access Management di organisasi Anda, seperti Organisation Administrator. Jika Anda tidak melihat Catatan Audit di menu pengaturan, peran Anda tidak mencakupnya.

  • Organisasi yang Anda lihat: organisasi tempat peran Anda mencakup Catatan Audit dan Identity & Access Management. Tab Logs menunjukkan jumlahnya, misalnya "Viewing logs for 1 organisation".
  • Templat peran: templat Organisation Administrator menyertakan Catatan Audit. Templat Site Manager dan Site Owner tidak menyertakannya. Lihat Templat peran.
  • Peran kustom: agar peran kustom dapat menggunakan Catatan Audit, sertakan Catatan Audit dan Identity & Access Management dalam akses modulnya. Lihat Ruang lingkup akses & akses modul.

Catatan Audit menampilkan alamat email, alamat IP, dan apa yang dikirim orang, jadi berikan hanya kepada orang yang membutuhkannya.

Berapa lama log disimpan

Retensi catatan audit menentukan berapa lama catatan audit disimpan: 90 hari untuk setiap entri log, dan 7 hari untuk payload permintaan dan respons lengkapnya.

Menu Range di tab Logs menyatakan:

"Catatan audit disimpan selama 90 hari. Payload permintaan dan respons lengkap disimpan selama 7 hari, setelah itu hanya pratinjau singkat yang tersimpan. Butuh riwayat yang lebih lama? Hubungi Dukungan (dikenakan biaya tambahan)."

Jadi, Anda dapat melihat kembali hingga 90 hari. Selama 7 hari pertama, entri log menyimpan permintaan dan respons lengkap. Setelah itu, isi yang lebih panjang dipotong menjadi pratinjau singkat. Lihat Setelah 7 hari: pratinjau.

Yang dapat Anda lakukan

  • Membaca dasbor: melihat volume permintaan, tingkat kesalahan, serta endpoint dan pengguna tersibuk untuk rentang waktu tertentu.
  • Mencari permintaan: memfilter berdasarkan rentang waktu, alamat email, alamat IP, endpoint, organisasi, fasilitas, metode, dan status, serta membagikan tampilan yang difilter.
  • Membaca entri log: melihat siapa yang membuat permintaan, dari mana, serta apa yang dikirim dan dikembalikan. Untuk permintaan yang gagal, dapatkan ringkasan kesalahan dalam bahasa yang mudah dipahami.
  • Mengekspor log: mengunduh log yang dimuat sebagai file CSV.
  • Mengikuti contoh investigasi: jawaban langkah demi langkah untuk pertanyaan umum, seperti siapa yang membuka kunci pintu atau mengapa suatu integrasi berhenti menyinkronkan.
  • Pertanyaan umum