Best Practices für Suchvorgänge
In diesem Dokument werden die von Google empfohlenen Best Practices für die Verwendung der Suchfunktion in Google Security Operations beschrieben. Suchvorgänge können erhebliche Rechenressourcen erfordern, wenn sie nicht sorgfältig erstellt werden. Die Leistung variiert auch je nach Größe und Komplexität der Daten in Ihrer Google SecOps-Instanz.
Verwenden Sie spezifische Filter in Abfragen, um die Geschwindigkeit und Leistung zu maximieren.
Die effektivste Methode zur Verbesserung der Suchleistung besteht darin, Abfragen mit bestimmten, optimierten UDM-Feldern (Unified Data Model) zu erstellen. Diese Felder sind für einen schnellen Abruf optimiert, sodass Ihre Suchanfragen schnell ausgeführt werden und weniger Rechenressourcen verbrauchen.
In den folgenden Abschnitten sind die leistungsstarken UDM-Felder aufgeführt, die Sie als Filter in Ihren Abfragen verwenden können.
Metadaten-Felder
metadata.event_timestamp.secondsmetadata.event_typemetadata.log_typemetadata.product_event_typemetadata.product_namemetadata.vendor_name
Hauptfelder
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
Quellfelder
src.asset_idsrc.hostnamesrc.ipsrc.macsrc.user.userid
Zielfelder
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
Netzwerkfelder
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
Felder für Sicherheitsergebnisse
security_result.actionsecurity_result.categorysecurity_result.rule_name
Entitäts- und Kontextdaten abfragen
Wenn Sie mit metadata.log_type = "<LOG_TYPE>" nach Entitäts- oder Kontextlogtypen wie AZURE_AD_CONTEXT oder WORKSPACE_USERS suchen, werden keine Ergebnisse zurückgegeben, auch wenn die Rohlogs in der Rohlogsuche sichtbar sind. Das liegt daran, dass bei der UDM-Suche nur UDM-Ereignisdatensätze abgefragt werden.
Verwenden Sie die Syntax graph, um nach Entitäts- und Kontextdaten zu suchen:
Wenn Sie nach dem Entitäts- oder Kontextlogtyp suchen möchten, fragen Sie die Metadatenfelder
graphab. Beispiel:graph.metadata.event_metadata.log_type = "<LOG_TYPE>"Verwenden Sie das Präfix
graph.entity.noun.field, um nach Entitätsfeldern zu suchen. Beispiel:graph.entity.user.email_addresses = "foo_email"
Weitere Informationen finden Sie unter Nach Kontextdaten für Entitäten suchen.
Effektive Suchanfragen für die Leistung erstellen
Das Schreiben optimierter Abfragen ist entscheidend, um die Geschwindigkeit zu maximieren und den Ressourcenverbrauch für Ihre Sicherheitsdaten zu minimieren. Alle Abfragebedingungen müssen sich strikt an diese grundlegende Struktur halten:
udm-field operator value
Beispiel: principal.hostname = "win-server"
Zeitraum für die Suche eingrenzen
Da Google SecOps bei einer Suche eine große Datenmenge aufnehmen kann, lässt sich die Suchleistung verbessern, wenn Sie den Zeitraum minimieren und den Umfang Ihrer Abfrage eingrenzen.
Reguläre Ausdrücke in Suchanfragen verwenden
Sie können beim Erstellen Ihrer UDM-Suchanfragen logische und Vergleichsoperatoren verwenden, um komplexe Ausdrücke zu erstellen:
- Logische Operatoren: Verwenden Sie
AND,ORundNOT, um Bedingungen zu kombinieren. Wenn Sie zwischen zwei Bedingungen keinen Operator angeben, wirdANDangenommen. - Operatorrangfolge: Verwenden Sie Klammern (), um die Standardrangfolge zu überschreiben. Sie können maximal 169 logische Operatoren (
OR,AND,NOT) innerhalb von Klammern verwenden. - Vergleichsoperatoren: Je nach UDM-Feldtyp (String, Ganzzahl, Zeitstempel) können Feldoperatoren Folgendes umfassen:
=,!=,>=,>,<,<=
Google SecOps verwendet die RE2-Engine für reguläre Ausdrücke.
Alternativ können Sie für die effiziente Suche in einer großen Anzahl von Werten die Referenzlisten verwenden.
nocase als Suchmodifikator verwenden
Sie können den Modifikator nocase an eine Bedingung für den Stringvergleich anhängen, um die Suche unabhängig von der Groß- und Kleinschreibung zu machen.
Bei der folgenden Suche wird beispielsweise die Groß-/Kleinschreibung ignoriert und alle Kombinationen, die tim.smith enthalten, werden unabhängig von der Groß-/Kleinschreibung berücksichtigt:
target.user.userid = "TIM.SMITH" nocase
Verwendung regulärer Ausdrücke in Aufzählungsfeldern vermeiden
Sie können keine regulären Ausdrücke verwenden, wenn Sie nach Aufzählungsfeldern (Feldern mit einem Bereich vordefinierter Werte) wie metadata.event_type oder network.ip_protocol suchen.
Das folgende Beispiel ist eine ungültige Suche:
metadata.event_type = /NETWORK_*/
Das folgende Beispiel ist dagegen eine gültige Suche:
(metadata.event_type = "NETWORK_CONNECTION" oder metadata.event_type = "NETWORK_DHCP")
Verwenden Sie beliebige Operatoren im Feld „Ereignisse“.
In der Suche sind einige UDM-Felder (z. B. die Felder principal.ip, target.file.md5 oder security_result) als wiederholt gekennzeichnet, da sie eine Liste von Werten oder Nachrichtentypen innerhalb eines einzelnen Ereignisses enthalten. Standardmäßig verwenden unveränderte Ausdrücke in wiederkehrenden Feldern den Operator any. Verwenden Sie explizit die Modifikatoren any oder all, um unerwartetes Abgleichverhalten bei der Auswertung eines wiederkehrenden Felds zu vermeiden.
Wenn der Operator any verwendet wird (oder wenn ein Ausdruck für ein wiederkehrendes Feld unverändert ist), wird das Prädikat als true ausgewertet, wenn ein Wert im wiederkehrenden Feld die Bedingung erfüllt. Jedes Element im wiederkehrenden Feld wird einzeln behandelt. Das kann zu unerwarteten Ergebnissen führen, wenn Sie nach leeren Werten suchen oder den Operator != verwenden:
- Wenn ein Ereignis sowohl
principal.ip = "192.0.2.1"als auchprincipal.ip = "192.0.2.2"enthält, stimmt eine Suche nachprincipal.ip != "192.0.2.1"mit dem Ereignis überein, da der Index1("192.0.2.2") die Bedingung erfüllt. - Wenn ein Ereignis mehrere
security_result-Elemente hat und nur ein Element das Feldrule_namefüllt, entspricht das Ereignis sowohlsecurity_result.rule_name = ""als auchsecurity_result.rule_name != "".
Wenn Sie prüfen möchten, ob jedes Element in einem wiederkehrenden Feld die Bedingung erfüllt, verwenden Sie den Operator all (z. B. all principal.ip != "192.0.2.1" oder all security_result.rule_name = ""). Weitere Informationen finden Sie unter Wiederkehrende Felder.
Unix-Epochenzeit für Zeitstempel oder YARA-L-Funktionen für die Datumskonvertierung verwenden
Zeitstempelfelder werden mithilfe der Unix-Epochenzeit (die Gesamtzahl der Sekunden, die seit Donnerstag, dem 1. Januar 1970, 00:00:00 Uhr UTC vergangen sind) abgeglichen. Sie können auch YARA-L-Funktionen für die Datumskonvertierung verwenden.
Wenn Sie nach einem bestimmten Zeitstempel suchen, ist Folgendes (in Epochenzeit) gültig:
metadata.ingested_timestamp.seconds = 1660784400
Der folgende Zeitstempel ist ungültig:
metadata.ingested_timestamp = "2022-08-18T01:00:00Z"
Wenn Sie nach einem bestimmten Zeitstempel suchen, ist Folgendes gültig (mit einer YARA-L-Funktion für die Datumskonvertierung):
metadata.event_type = "NETWORK_CONNECTION"
timestamp.get_date(metadata.ingested_timestamp.seconds) = "2026-03-15"
Im folgenden YARA-L-Beispiel werden timestamp-Funktionen verwendet, um nach Zeiträumen für die Aufnahme zu suchen:
metadata.event_type = "NETWORK_CONNECTION"
$date = timestamp.get_date(metadata.ingested_timestamp.seconds)
$date > "2026-03-15" AND $date < "2026-03-17"
Neu aufgenommene Daten mit älteren Zeitstempeln abfragen
Sie können nicht nach neu aufgenommenen Ereignissen mit einem älteren Zeitstempel suchen, es sei denn, Sie geben den Zeitraum für die Abfrage an. Das liegt daran, dass der Zeitraum auf dem Zeitstempel des geparsten Ereignisses basiert und nicht auf dem Zeitstempel der Aufnahme des Rohprotokollereignisses.
Wenn Sie in UDM-Ereignissen nach aufgenommenen Logs mit älteren Ereigniszeitstempeln suchen möchten, können Sie die Option Gesamte Zeit verwenden, um in metadata.ingested_timestamp zu suchen und Abfragen auszuführen.
Ausgeschlossene Felder aus Filtern
Die folgenden Felder werden absichtlich aus Suchfiltern ausgeschlossen:
metadata.idmetadata.product_log_id*.timestamp
Diese Felder enthalten zwar wichtige Metadaten, aber ihre eindeutigen Werte führen zu einer hohen Kardinalität und Varianz in den Statistiken, was sich negativ auf die Suchleistung auswirkt.
Fehlerbehebung
Wenn Sie eine allgemeine Fehlermeldung erhalten, z. B. „Fehler: Bei der Suche ist ein Fehler aufgetreten und die Daten konnten nicht geladen werden“, führen Sie die folgenden Schritte aus, um das Problem zu beheben. Wenn der Fehler weiterhin auftritt, wende dich an den Kundensupport.
- Stellen Sie über ein anderes Netzwerk eine Verbindung zu Google SecOps her. Sie können beispielsweise eine Cloud-VM verwenden, um Netzwerkprobleme zu identifizieren.
- Achten Sie darauf, dass Chronicle API-Aufrufe durch die Firewall- oder Proxy-Konfiguration oder die Richtlinie Ihrer Organisation zugelassen werden.
- Achten Sie darauf, dass für Search API-Aufrufe kein Datenlimit konfiguriert ist, da Suchanfragen große Datasets zurückgeben können.
- Suchanfragen können asynchron ausgeführt werden und es kann länger dauern, bis Daten zurückgegeben werden. Sie können sich zuvor ausgeführte Suchanfragen im Suchverlauf ansehen und auswählen, um die Ergebnisse später aufzurufen.
Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten