Logo Performance HubPerformance Hub
Bagian situs: Dokumentasi

Mencari permintaan

Di halaman ini

Tab Logs mencantumkan permintaan yang dibuat di organisasi Anda, dari yang terbaru. Gunakan filter di bagian atas untuk mempersempit daftar ke satu orang, satu alamat IP, satu bagian Performance Hub, atau satu jenis hasil, lalu klik permintaan untuk melihat detailnya.

Referensi cepat

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

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: Menemukan permintaan di balik suatu pertanyaan, seperti siapa yang mengubah sesuatu atau mengapa sesuatu gagal

Tab Logs, dengan bilah filter di bagian atas, daftar permintaan di sebelah kiri, dan detail permintaan yang dipilih di sebelah kananTab Logs, dengan bilah filter di bagian atas, daftar permintaan di sebelah kiri, dan detail permintaan yang dipilih di sebelah kanan

Gambar 1: Tab Logs: filter di bagian atas, permintaan yang cocok di sebelah kiri, dan permintaan yang dipilih di sebelah kanan

Tab Logs

  • Bilah filter: filter di bagian atas, dengan Live, tombol muat ulang, dan Ekspor CSV di sebelah kanan.
  • Daftar: permintaan yang cocok, dari yang terbaru. Di atasnya tertulis "Viewing logs for 1 organisation" (atau jumlah organisasi yang dapat Anda lihat). Setiap baris menampilkan kode status, metode, lencana sumber, tanggal dan waktu, endpoint, alamat email pengguna, dan waktu respons dalam milidetik.
  • Detail: permintaan yang Anda pilih. Lihat Membaca entri log.

Daftar memuat lebih banyak permintaan saat Anda menggulir. Di akhir daftar ditampilkan berapa banyak permintaan yang cocok, misalnya "End of results · 5 logs".

Memfilter daftar

  1. Klik filter di bilah filter, misalnya Endpoint.
  2. Pilih opsi, atau ketik nilai. Misalnya, ketik /api/door-gate-access/* di Endpoint lalu klik Apply.
  3. Filter menampilkan nilai yang Anda pilih, dan daftar diperbarui. Tambahkan filter lain untuk mempersempitnya lebih lanjut: permintaan harus cocok dengan setiap filter agar muncul.
  4. Untuk menghapus satu filter, klik × pada filter tersebut. Untuk menghapus semuanya, klik Clear, yang muncul setelah ada filter yang ditetapkan.

Bilah filter: Range, Email, IP, Endpoint, Org, Fasilitas, Method, dan Status, lalu Live, muat ulang, dan Ekspor CSVBilah filter: Range, Email, IP, Endpoint, Org, Fasilitas, Method, dan Status, lalu Live, muat ulang, dan Ekspor CSV

Gambar 2: Bilah filter: Range, Email, IP, Endpoint, Org, Fasilitas, Method, dan Status, lalu Live, muat ulang, dan Ekspor CSV

FilterYang dicocokkan
RangeWaktu permintaan dibuat. Defaultnya adalah Last 24 hours. Lihat Range.
EmailAlamat email lengkap pengguna, misalnya priya.shah@example.com. Filter ini dapat menyarankan alamat saat Anda mengetik.
IPAlamat IP lengkap asal permintaan, misalnya 203.0.113.140
EndpointBagian Performance Hub yang menjadi tujuan permintaan. Bagian mana pun dari jalur akan cocok, dan Anda dapat menggunakan wildcard *. Lihat Endpoint dan wildcard.
OrgSatu organisasi, atau Any org. Ditampilkan jika Anda memiliki akses ke setidaknya satu organisasi.
FasilitasSatu fasilitas, atau Fasilitas mana pun. Ditampilkan jika Anda memiliki akses ke setidaknya satu fasilitas.
MethodGET, POST, PUT, PATCH, atau DELETE
StatusStatus respons. Lihat Status.

Email dan IP memerlukan nilai lengkap

Email dan IP hanya menemukan kecocokan persis. Ketik alamat email lengkap, seperti ruby.castellano@example.com, atau alamat IP lengkap. Sebagian alamat, seperti ruby atau 203.0.113, tidak menemukan apa pun.

Untuk menemukan seseorang tanpa alamat lengkapnya, gunakan Top Users di dasbor, atau buka salah satu permintaannya dan salin alamat dari kolom User.

Rentang

Klik Range untuk memilih seberapa jauh ke belakang Anda ingin melihat.

  • Preset: Last 15 minutes, Last hour, Last 12 hours, Last 24 hours, Last 7 days, Last 30 days, dan Last 90 days.
  • Tanggal: pilih tanggal mulai dan tanggal akhir di kalender dua bulan, lalu klik Apply. Klik Cancel untuk menutup menu tanpa mengubah rentang. Tanggal yang lebih dari 90 hari yang lalu tidak dapat dipilih.

Catatan di bagian bawah menu menyatakan berapa lama log disimpan: "Audit logs are kept for 90 days. Full request and response payloads are kept for 7 days, after which a short preview remains. Need a longer history? Contact Support (additional charges apply)."

Menu Range terbuka, dengan preset dari Last 15 minutes hingga Last 90 days, kalender dua bulan, dan catatan tentang berapa lama log disimpanMenu Range terbuka, dengan preset dari Last 15 minutes hingga Last 90 days, kalender dua bulan, dan catatan tentang berapa lama log disimpan

Gambar 3: Range: pilih preset atau tanggal di kalender. Catatan menunjukkan berapa lama log disimpan

Endpoint dan wildcard

Endpoint adalah jalur tujuan pengiriman permintaan, seperti /api/door-gate-access/doors/front-entrance/unlock. Endpoint memberi tahu Anda bagian Performance Hub mana yang menjadi tujuan permintaan.

  • Tanpa *, bagian mana pun dari jalur akan cocok. Misalnya, unlock menemukan setiap permintaan yang jalurnya mengandung "unlock".
  • Dengan *, setiap bagian di antara tanda bintang harus muncul di jalur. Misalnya, /api/door-gate-access/* menemukan setiap permintaan Door & Gate Access, dan /partner/v1/* menemukan setiap permintaan dari integrasi yang menggunakan Partner API.

Filter Endpoint terbuka, dengan /api/door-gate-access/* yang diketik serta tombol Cancel dan ApplyFilter Endpoint terbuka, dengan /api/door-gate-access/* yang diketik serta tombol Cancel dan Apply

Gambar 4: Endpoint menerima wildcard *, misalnya untuk setiap permintaan pintu

Tab Logs yang difilter ke /api/door-gate-access/*, mencantumkan lima permintaan pintu dengan yang pertama terbukaTab Logs yang difilter ke /api/door-gate-access/*, mencantumkan lima permintaan pintu dengan yang pertama terbuka

Gambar 5: Daftar setelah difilter berdasarkan pola endpoint

Tidak yakin endpoint mana yang harus digunakan? Buka permintaan yang Anda ketahui, seperti pintu yang Anda buka kuncinya sendiri, lalu salin awal endpoint-nya dari detail.

Status

Klik Status untuk memfilter berdasarkan status respons. Ketik di Search… untuk menemukan status dengan cepat, misalnya "403". Pilih Any untuk menampilkan setiap status.

Status dicantumkan beserta namanya, seperti 200 OK, 201 Created, 400 Bad Request, 401 Unauthorised, 403 Forbidden, 404 Not Found, 409 Conflict, 429 Too Many Requests, 500 Server Error, dan 503 Service Unavailable. Lihat Kode status untuk artinya.

Menu Status terbuka, dengan kotak pencarian, Any, dan status dari 200 OK hingga 401 UnauthorisedMenu Status terbuka, dengan kotak pencarian, Any, dan status dari 200 OK hingga 401 Unauthorised

Gambar 6: Memfilter berdasarkan status respons

Live dan muat ulang

Di tab Logs, Live secara default dalam keadaan Off, sehingga daftar tidak berubah saat Anda menyelidiki. Aktifkan dan pilih seberapa sering daftar dimuat ulang untuk melihat permintaan baru masuk. Klik tombol muat ulang (panah melingkar) untuk memuat ulang daftar satu kali.

Membagikan atau menandai tampilan yang difilter

Filter Anda disimpan di alamat halaman. Tandai halaman untuk kembali ke tampilan yang sama, atau kirim alamatnya ke rekan kerja. Mereka melihat daftar terfilter yang sama jika memiliki akses ke Catatan Audit dan ke organisasi yang sama.

Misalnya, alamat yang diakhiri dengan /audit-logs/logs?email=priya.shah%40example.com membuka daftar yang difilter ke orang tersebut, dan alamat yang diakhiri dengan /audit-logs/logs?endpoint=%2Fapi%2Fdoor-gate-access%2F* membuka setiap permintaan pintu.

Berpindah dalam daftar

  • Klik permintaan untuk membuka detailnya di sebelah kanan.
  • Gunakan tombol panah atas dan bawah untuk berpindah ke permintaan sebelumnya atau berikutnya dalam daftar.
  • Di layar yang sempit, detail terbuka di atas daftar. Klik tombol tutup untuk kembali ke daftar.

Tidak ada hasil

Jika tidak ada yang cocok, daftar menampilkan "No logs match these filters" dan "Try widening the time range or clearing a filter."

Tab Logs dengan filter Email yang ditetapkan, menampilkan No logs match these filtersTab Logs dengan filter Email yang ditetapkan, menampilkan No logs match these filters

Gambar 7: Tidak ada permintaan yang cocok: perluas rentang atau hapus filter

Untuk menemukan yang Anda cari:

  • Pilih Range yang lebih panjang, seperti Last 7 days.
  • Pastikan Email dan IP berisi alamat lengkap. Sebagian alamat tidak menemukan apa pun.
  • Hapus satu filter pada satu waktu dengan ×-nya, atau klik Clear.