Praktik terbaik terkait penelusuran

Didukung di:

Dokumen ini menjelaskan praktik terbaik yang direkomendasikan Google untuk menggunakan fitur Penelusuran di Google Security Operations. Penelusuran dapat memerlukan resource komputasi yang besar jika tidak dibuat dengan cermat. Performa juga bervariasi bergantung pada ukuran dan kompleksitas data di instance Google SecOps Anda.

Menggunakan filter tertentu dalam kueri untuk kecepatan dan performa maksimum

Satu-satunya cara paling efektif untuk meningkatkan performa penelusuran adalah dengan membuat kueri menggunakan kolom Unified Data Model (UDM) yang spesifik dan dioptimalkan. Kolom ini dioptimalkan untuk pengambilan cepat, sehingga memastikan penelusuran Anda berjalan cepat dan menggunakan lebih sedikit resource komputasi.

Bagian berikut mencantumkan kolom UDM berperforma tinggi yang dapat digunakan sebagai filter dalam kueri Anda.

Kolom metadata

  • metadata.event_timestamp.seconds
  • metadata.event_type
  • metadata.log_type
  • metadata.product_event_type
  • metadata.product_name
  • metadata.vendor_name

Kolom utama

  • principal.application
  • principal.asset_id
  • principal.file.md5
  • principal.file.sha1
  • principal.file.sha256
  • principal.hostname
  • principal.ip
  • principal.mac
  • principal.process.file.md5
  • principal.process.file.sha1
  • principal.process.file.sha256
  • principal.process.pid
  • principal.user.email_addresses
  • principal.user.userid

Kolom sumber

  • src.asset_id
  • src.hostname
  • src.ip
  • src.mac
  • src.user.userid

Kolom target

  • target.application
  • target.asset_id
  • target.file.md5
  • target.file.sha1
  • target.file.sha256
  • target.hostname
  • target.ip
  • target.mac
  • target.process.file.md5
  • target.process.file.sha1
  • target.process.file.sha256
  • target.user.email_addresses
  • target.user.employee_id
  • target.user.userid
  • target.user.windows_sid

Kolom jaringan

  • network.dhcp.chaddr
  • network.dhcp.ciaddr
  • network.dhcp.client_hostname
  • network.dhcp.yiaddr
  • network.dns.answers.class
  • network.dns.answers.name
  • network.dns.answers.type
  • network.dns.questions.class
  • network.dns.questions.name
  • network.dns.questions.type
  • network.email.from
  • network.email.to
  • network.http.method

Kolom hasil keamanan

  • security_result.action
  • security_result.category
  • security_result.rule_name

Cara membuat kueri data entity dan konteks

Jika Anda menelusuri jenis log entity atau konteks (seperti AZURE_AD_CONTEXT atau WORKSPACE_USERS) menggunakan metadata.log_type = "<LOG_TYPE>", penelusuran tidak akan menampilkan hasil meskipun log mentah terlihat di Penelusuran Log Mentah. Hal ini karena penelusuran UDM hanya mengkueri data peristiwa UDM.

Untuk menelusuri data entity dan konteks, gunakan sintaksis graph:

  • Untuk menelusuri jenis log entitas atau konteks, buat kueri kolom metadata graph. Contoh:

    graph.metadata.event_metadata.log_type = "<LOG_TYPE>"

  • Untuk menelusuri kolom entity, gunakan awalan graph.entity.noun.field. Contoh:

    graph.entity.user.email_addresses = "foo_email"

Untuk mengetahui informasi selengkapnya, lihat Melakukan penelusuran untuk data konteks entity.

Membuat kueri penelusuran yang efektif untuk performa

Menulis kueri yang dioptimalkan adalah kunci untuk memaksimalkan kecepatan dan meminimalkan konsumsi resource di seluruh data keamanan Anda. Semua kondisi kueri harus benar-benar mematuhi struktur dasar ini:

udm-field operator value

Contoh: principal.hostname = "win-server"

Karena Google SecOps dapat menyerap data dalam jumlah besar selama penelusuran, meminimalkan rentang waktu dan mempersempit cakupan kueri Anda dapat meningkatkan performa penelusuran.

Menggunakan ekspresi reguler dalam kueri penelusuran

Anda dapat menggunakan operator logis dan perbandingan standar saat membuat kueri penelusuran UDM untuk membuat ekspresi yang kompleks:

  • Operator logis: Gunakan AND, OR, dan NOT untuk menggabungkan kondisi. AND diasumsikan jika Anda menghilangkan operator di antara dua kondisi.
  • Prioritas operator: Gunakan tanda kurung () untuk mengganti urutan prioritas default. Ada batas maksimum 169 operator logika (OR, AND, NOT) yang dapat Anda gunakan dalam tanda kurung.
  • Operator perbandingan: Bergantung pada jenis kolom UDM (string, bilangan bulat, stempel waktu), operator kolom dapat mencakup: =, !=, >=, >, <, <=

Google SecOps menggunakan mesin ekspresi reguler RE2.

Atau, untuk penelusuran yang efisien dari sekumpulan besar nilai, Anda dapat menggunakan daftar referensi.

Menggunakan nocase sebagai pengubah penelusuran

Anda dapat menambahkan pengubah nocase ke kondisi perbandingan string untuk membuat penelusuran tidak peka huruf besar/kecil, yang mengabaikan kapitalisasi.

Misalnya, penelusuran berikut mengabaikan huruf besar/kecil dan mencocokkan semua kombinasi yang berisi tim.smith, terlepas dari huruf besar/kecilnya:

target.user.userid = "TIM.SMITH" nocase

Menghindari penggunaan ekspresi reguler di kolom yang dienumerasi

Anda tidak dapat menggunakan ekspresi reguler saat menelusuri kolom yang dihitung (kolom dengan rentang nilai yang telah ditentukan) seperti metadata.event_type atau network.ip_protocol

Contoh berikut adalah penelusuran yang tidak valid: metadata.event_type = /NETWORK_*/

Sedangkan, contoh berikut adalah penelusuran yang valid: (metadata.event_type = "NETWORK_CONNECTION" atau metadata.event_type = "NETWORK_DHCP")

Menggunakan operator apa pun dan semua operator di kolom Peristiwa

Di Penelusuran, beberapa kolom UDM (seperti principal.ip atau target.file.md5) diberi label sebagai berulang, karena dapat menyimpan daftar nilai atau jenis pesan dalam satu peristiwa. Kolom berulang selalu diperlakukan dengan operator any secara default (tidak ada opsi untuk menentukan all).

Jika operator any digunakan, predikat akan dievaluasi sebagai true jika ada nilai dalam kolom berulang yang memenuhi kondisi. Misalnya, jika Anda menelusuri principal.ip != "1.2.3.4" dan peristiwa dalam penelusuran Anda mencakup principal.ip = "1.2.3.4" dan principal.ip = "5.6.7.8", kecocokan akan dibuat. Tindakan ini akan memperluas penelusuran Anda untuk menyertakan hasil yang cocok dengan salah satu operator, bukan mencocokkan semuanya.

Setiap elemen di kolom berulang diperlakukan secara individual. Jika kolom berulang ditemukan dalam peristiwa dalam penelusuran, peristiwa tersebut akan dievaluasi untuk setiap elemen dalam kolom. Hal ini dapat menyebabkan perilaku yang tidak terduga, terutama saat melakukan penelusuran menggunakan operator !=.

Saat menggunakan operator any, predikat dievaluasi sebagai true jika ada nilai dalam kolom berulang yang memenuhi kondisi.

Menggunakan waktu epoch Unix untuk stempel waktu atau menggunakan fungsi YARA-L untuk konversi tanggal

Kolom stempel waktu dicocokkan menggunakan waktu epoch Unix (jumlah total detik yang telah berlalu sejak Kamis, 1 Januari 1970 00:00:00 UTC), atau Anda dapat menggunakan fungsi YARA-L untuk konversi tanggal.

Saat menelusuri stempel waktu tertentu, hal berikut (dalam waktu epoch) valid:

metadata.ingested_timestamp.seconds = 1660784400

Stempel waktu berikut tidak valid:

metadata.ingested_timestamp = "2022-08-18T01:00:00Z"

Saat menelusuri stempel waktu tertentu, hal berikut (menggunakan fungsi YARA-L untuk konversi tanggal) valid:

metadata.event_type = "NETWORK_CONNECTION"
timestamp.get_date(metadata.ingested_timestamp.seconds) = "2026-03-15"

Contoh YARA-L berikut menggunakan fungsi timestamp untuk memeriksa rentang waktu penyerapan:

metadata.event_type = "NETWORK_CONNECTION"
$date = timestamp.get_date(metadata.ingested_timestamp.seconds)
$date > "2026-03-15" AND $date < "2026-03-17"

Cara membuat kueri data yang baru diserap dengan stempel waktu yang lebih lama

Anda tidak dapat menelusuri peristiwa yang baru diserap dan memiliki stempel waktu yang lebih lama, kecuali jika Anda menentukan rentang waktu peristiwa yang akan dikueri. Hal ini karena rentang waktu didasarkan pada stempel waktu peristiwa yang diurai, bukan stempel waktu penyerapan peristiwa log mentah.

Untuk menelusuri peristiwa UDM untuk log yang diserap dengan stempel waktu peristiwa yang lebih lama, Anda dapat menggunakan opsi All time untuk menelusuri dan membuat kueri di metadata.ingested_timestamp.

Kolom yang dikecualikan dari filter

Kolom berikut sengaja dikecualikan dari filter penelusuran:

  • metadata.id
  • metadata.product_log_id
  • *.timestamp

Meskipun kolom ini berisi metadata penting, nilai uniknya menyebabkan kardinalitas dan varians yang tinggi dalam statistik, sehingga berdampak negatif pada performa penelusuran.

Pemecahan masalah

Jika Anda menerima pesan error umum, seperti "Error: Penelusuran mengalami error dan tidak dapat memuat data", lakukan langkah-langkah berikut untuk menyelesaikan masalah tersebut. Jika error tetap berlanjut, hubungi Dukungan Pelanggan.

  • Hubungkan ke Google SecOps dari jaringan lain. Misalnya, gunakan VM cloud untuk membantu mengidentifikasi masalah jaringan.
  • Pastikan panggilan Chronicle API diizinkan oleh konfigurasi atau kebijakan firewall atau proxy organisasi Anda.
  • Pastikan tidak ada batas data yang dikonfigurasi untuk panggilan Search API, karena penelusuran dapat menampilkan set data yang besar.
  • Kueri penelusuran dapat berjalan secara asinkron dan mungkin memerlukan lebih banyak waktu untuk menampilkan data. Anda dapat melihat penelusuran yang dijalankan sebelumnya di histori penelusuran dan memilihnya untuk melihat hasilnya nanti.

Perlu bantuan lain? Dapatkan jawaban dari anggota Komunitas dan profesional Google SecOps.