Memantau penggunaan dasbor

Penting

Fitur ini ada di Pratinjau Umum.

Halaman ini memiliki sampel kueri yang dapat digunakan admin untuk memantau aktivitas yang terkait dengan dasbor. Semua kueri mengakses tabel log audit, yang merupakan tabel sistem yang menyimpan rekaman untuk semua peristiwa audit dari ruang kerja di wilayah Anda.

Admin akun memiliki akses ke tabel sistem secara default. Untuk memberikan akses ke pengguna lain, lihat Memberikan akses ke tabel sistem.

Lihat Memantau aktivitas akun dengan tabel sistem. Untuk referensi komprehensif tentang layanan dan peristiwa log audit yang tersedia, lihat Referensi log diagnostik.

Memantau draf dan dasbor terbit

Contoh di bagian ini menunjukkan cara mengambil log audit untuk menjawab pertanyaan umum mengenai aktivitas di dasbor.

Berapa banyak dasbor yang dibuat dalam seminggu terakhir?

Kueri berikut mengembalikan jumlah dasbor yang dibuat di ruang kerja Anda selama seminggu terakhir.

SELECT
  action_name,
  COUNT(action_name) as num_dashboards
FROM
  system.access.audit
WHERE
  action_name = "createDashboard"
  AND event_date >= current_date() - interval 7 days
GROUP BY
  action_name

Gambar berikut menunjukkan contoh hasil kueri:

Apa ID dasbor yang terkait dengan dasbor paling populer?

Sebagian besar contoh dalam artikel ini berfokus pada aktivitas audit pada dasbor tertentu. Anda dapat menggunakan log audit untuk memperoleh ID dasbor tertentu. Kueri berikut menampilkan dasbor dengan jumlah tampilan terbanyak dengan menghitung tindakan getDashboard dan getPublishedDashboard yang terkait dengan ID.

SELECT
  request_params.dashboard_id as dashboard_id,
  COUNT(*) AS view_count
FROM
  system.access.audit
WHERE
  action_name in ("getDashboard", "getPublishedDashboard")
GROUP BY
  dashboard_id
ORDER BY
  view_count DESC

Gambar berikut menunjukkan contoh hasil kueri:

Berapa kali dasbor ini dilihat dalam seminggu terakhir?

Kueri berikut menggunakan khusus dashboard_id untuk memperlihatkan berapa kali dasbor ditampilkan dalam seminggu terakhir. Kolom action_name menunjukkan apakah draf atau dasbor yang diterbitkan telah diakses. getPublishedDashboard mengacu pada tampilan halaman dasbor yang diterbitkan. getDashboard mengacu pada tampilan dasbor draf.

Untuk kueri ini, ID dasbor disediakan sebagai parameter. Untuk mempelajari selengkapnya tentang menggunakan parameter dasbor, lihat Bekerja dengan parameter dasbor. Untuk mendapatkan dashboard_id dari dasbor yang tertentu, lihat URL Dasbor dan ID.

SELECT
  action_name,
  COUNT(action_name) as view_count
FROM
  system.access.audit
WHERE
  request_params.dashboard_id = :dashboard_id
  AND event_date >= current_date() - interval 7 days
  AND action_name in ("getDashboard", "getPublishedDashboard")
GROUP BY action_name

Gambar berikut menunjukkan contoh hasil kueri:

Berapa jumlah tampilan menurut pengguna dalam sehari terakhir?

Kueri berikut mengidentifikasi berapa kali penampil mengakses dasbor dalam sehari terakhir. Hasilnya mencakup apakah pengguna mengakses dasbor yang diterbitkan (getPublishedDashboard) atau dasbor draf (getDashboard).

SELECT
  user_identity.email as username,
  COUNT(user_identity.email) as num_views,
  action_name
FROM
  system.access.audit
WHERE
  service_name = 'dashboards'
AND action_name in ('getDashboard', 'getPublishedDashboard')
AND event_time > now() - interval '1 day'
GROUP BY username, action_name

Gambar berikut menunjukkan contoh hasil kueri:

Siapa penonton teratas dalam seminggu terakhir?

Kueri berikut mengidentifikasi pengguna yang paling sering menampilkan dasbor tertentu dalam seminggu terakhir. Ini juga menunjukkan apakah pandangan tersebut ada di dasbor draf atau yang diterbitkan. Untuk kueri ini, ID dasbor disediakan sebagai parameter. Untuk mempelajari selengkapnya tentang menggunakan parameter dasbor, lihat Bekerja dengan parameter dasbor.

SELECT
  user_identity.email as user_email,
  action_name,
  COUNT(action_name) as view_count
FROM
  system.access.audit
WHERE
  request_params.dashboard_id = :dashboard_id
  AND event_date >= current_date() - interval 7 days
  AND action_name in ("getDashboard", "getPublishedDashboard")
GROUP BY action_name, user_email

Gambar berikut menunjukkan contoh hasil kueri:

Memantau dasbor yang disematkan

Anda dapat memantau aktivitas di dasbor yang disematkan menggunakan log audit untuk peristiwa ruang kerja. Untuk mempelajari tentang peristiwa ruang kerja lain yang muncul di log audit, lihat Peristiwa ruang kerja.

Kueri berikut mengambil detail untuk dasbor yang telah disematkan di situs web atau aplikasi eksternal.

SELECT
  request_params.settingTypeName,
  source_ip_address,
  user_identity.email,
  action_name,
  request_params
FROM
  system.access.audit
WHERE
  request_params.settingTypeName ilike "aibi%"

Gambar berikut menunjukkan contoh hasil kueri:

Menyiapkan pemberitahuan

Anda dapat mengatur pemberitahuan untuk mengotomatiskan jenis pemantauan ini. Lihat Membuat pemberitahuan untuk mempelajari cara mengatur pemberitahuan pada ambang tertentu.