Logo Performance HubPerformance Hub
Bahagian laman: Dokumentasi

Log Audit

Pada halaman ini

Log Audit ialah rekod permintaan yang dibuat kepada Performance Hub dalam organisasi anda. Ia merangkumi permintaan daripada orang yang menggunakan Performance Hub dalam pelayar atau aplikasi, dan daripada alat yang bersambung seperti kunci API, ejen AI yang bersambung melalui MCP dan Model Router. Gunakannya untuk menjawab soalan seperti siapa yang membuka kunci pintu, mengapa sesuatu perubahan tidak disimpan atau bila sesuatu integrasi berhenti berfungsi, sama ada lokasi anda ialah pejabat, kedai, kafe, venue, klinik, kampus atau gimnasium.

Rujukan pantas

Tempat untuk mencarinya: Settings (ikon gear, di bahagian bawah sebelah kiri) → Log Audit

Siapa yang boleh menggunakannya: Anda memerlukan peranan yang merangkumi Log Audit dan Identity & Access Management dalam organisasi anda, seperti Organisation Administrator. Lihat Siapa yang boleh menggunakan Log Audit.

Tujuan: Melihat siapa yang melakukan apa dalam Performance Hub, dan mengetahui mengapa sesuatu permintaan gagal

Papan pemuka Log Audit, dengan butang Window, lima angka utama dan carta Request TimelinePapan pemuka Log Audit, dengan butang Window, lima angka utama dan carta Request Timeline

Rajah 1: Papan pemuka Log Audit: tetingkap masa, angka utama dan garis masa permintaan

Perkara yang dilog

Setiap entri log ialah satu permintaan yang dibuat kepada Performance Hub. Ia menunjukkan:

  • Siapa yang membuat permintaan: alamat e-mel pengguna.
  • Dari mana: alamat IP, dan pelayar atau alat yang menghantarnya.
  • Apa yang dipanggil: kaedah (contohnya GET untuk membaca atau POST untuk mencipta) dan titik akhir, iaitu bahagian Performance Hub yang menjadi sasaran permintaan, seperti /api/door-gate-access/doors/front-entrance/unlock.
  • Hasilnya: status respons, contohnya 200 untuk berjaya atau 403 apabila orang tersebut tidak mempunyai kebenaran.
  • Berapa lama masa yang diambil, dalam milisaat.
  • Asal usulnya: lencana sumber, seperti web bagi orang yang menggunakan Performance Hub atau api-key bagi integrasi. Lihat Lencana sumber.

Untuk permintaan terkini, entri log juga menyimpan apa yang dihantar dan apa yang dikembalikan. Lihat Membaca entri log.

Dua tab

TabKegunaannya
Papan pemukaJumlah, kadar ralat dan carta bagi sesuatu tetingkap masa, dengan titik akhir dan pengguna yang paling sibuk. Klik carta atau baris untuk membuka log yang sepadan.
LogsPermintaan itu sendiri. Tapis dan cari dalam senarai, buka entri log untuk melihat butirannya, dan eksport ke CSV.

Siapa yang boleh menggunakan Log Audit

Anda memerlukan peranan yang merangkumi Log Audit dan Identity & Access Management dalam organisasi anda, seperti Organisation Administrator. Jika anda tidak dapat melihat Log Audit dalam menu tetapan, peranan anda tidak merangkuminya.

  • Organisasi yang anda lihat: organisasi di mana peranan anda merangkumi kedua-dua Log Audit dan Identity & Access Management. Tab Logs menunjukkan bilangannya, contohnya "Viewing logs for 1 organisation".
  • Templat peranan: templat Organisation Administrator merangkumi Log Audit. Templat Site Manager dan Site Owner tidak merangkuminya. Lihat Templat peranan.
  • Peranan tersuai: untuk membolehkan peranan tersuai menggunakan Log Audit, sertakan kedua-dua Log Audit dan Identity & Access Management dalam akses modulnya. Lihat Skop akses & akses modul.

Log Audit menunjukkan alamat e-mel orang, alamat IP dan apa yang mereka hantar, jadi berikannya hanya kepada orang yang memerlukannya.

Tempoh log disimpan

Pengekalan log audit menetapkan tempoh log audit disimpan: 90 hari bagi setiap entri log, dan 7 hari bagi muatan permintaan dan respons penuhnya.

Menu Range pada tab Logs menyatakan:

"Log audit disimpan selama 90 hari. Muatan penuh permintaan dan respons disimpan selama 7 hari, selepas itu pratonton ringkas kekal. Perlukan sejarah yang lebih panjang? Hubungi Sokongan (caj tambahan dikenakan)."

Jadi anda boleh melihat kembali sehingga 90 hari. Untuk 7 hari pertama, entri log menyimpan permintaan dan respons penuh. Selepas itu, kandungan yang lebih panjang dipotong kepada pratonton ringkas. Lihat Selepas 7 hari: pratonton.

Perkara yang boleh anda lakukan

  • Baca papan pemuka: lihat jumlah permintaan, kadar ralat serta titik akhir dan pengguna yang paling sibuk bagi sesuatu tetingkap masa.
  • Cari permintaan: tapis mengikut julat masa, alamat e-mel, alamat IP, titik akhir, organisasi, premis, kaedah dan status, dan kongsi paparan yang ditapis.
  • Baca entri log: lihat siapa yang membuat permintaan, dari mana, dan apa yang dihantar serta dikembalikan. Bagi permintaan yang gagal, dapatkan ringkasan ralat dalam bahasa yang mudah difahami.
  • Eksport log: muat turun log yang dimuatkan sebagai fail CSV.
  • Ikuti contoh siasatan: jawapan langkah demi langkah kepada soalan lazim, seperti siapa yang membuka kunci pintu atau mengapa integrasi berhenti menyegerak.
  • Soalan lazim