Praktik terbaik terkait penelusuran
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.secondsmetadata.event_typemetadata.log_typemetadata.product_event_typemetadata.product_namemetadata.vendor_name
Kolom utama
principal.applicationprincipal.asset_idprincipal.file.md5principal.file.sha1principal.file.sha256principal.hostnameprincipal.ipprincipal.macprincipal.process.file.md5principal.process.file.sha1principal.process.file.sha256principal.process.pidprincipal.user.email_addressesprincipal.user.userid
Kolom sumber
src.asset_idsrc.hostnamesrc.ipsrc.macsrc.user.userid
Kolom target
target.applicationtarget.asset_idtarget.file.md5target.file.sha1target.file.sha256target.hostnametarget.iptarget.mactarget.process.file.md5target.process.file.sha1target.process.file.sha256target.user.email_addressestarget.user.employee_idtarget.user.useridtarget.user.windows_sid
Kolom jaringan
network.dhcp.chaddrnetwork.dhcp.ciaddrnetwork.dhcp.client_hostnamenetwork.dhcp.yiaddrnetwork.dns.answers.classnetwork.dns.answers.namenetwork.dns.answers.typenetwork.dns.questions.classnetwork.dns.questions.namenetwork.dns.questions.typenetwork.email.fromnetwork.email.tonetwork.http.method
Kolom hasil keamanan
security_result.actionsecurity_result.categorysecurity_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"
Persempit rentang waktu untuk penelusuran Anda
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, danNOTuntuk menggabungkan kondisi.ANDdiasumsikan 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.idmetadata.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.