Investigate an entity using SIEM Search

Supported in:

During an investigation, you can write a UDM search query to display details about one or more entities (for example, an IP address, user, or asset) in addition to the events and alerts that match the search query terms.

On systems that use data RBAC, you can only see data that matches your scopes. For more information, see data RBAC impact on Search.

When a search query includes a condition that identifies a specific entity (for example, principal.ip="10.0.31.20"), the search results include details about the entity (if present in your enterprise) in addition to UDM events that match the entire search query.

The search results pane includes the following tabs:

  • Overview: Details about one or more specific entities.
  • Results: Search results that match the entire search query and search time range.
  • Alerts & Detections: Alerts generated by events that match the entire search query.

UDM search query conditions can include both UDM fields (principal.hostname="alice") and grouped fields (hostname="alice").

The UDM search query can include multiple conditions, each specifying a different entity identifier. Example queries include the following:

  • principal.hostname="alicehost" and user="alice"
  • principal.hostname="alicehost" and (user="kai" or user="alice")
  • principal.hostname="alicehost" and target.hostname="altostrat.com"
  • principal.hostname="alicehost" and hash="40a80612aaa8a8a36aa82a1278aaa02a"
  • hostname="alicehost" and domain=/altostrat.com/ nocase
  • user="alice" and domain=/altostrat.com/ nocase

The following table includes example UDM search queries for one or more entities and the type of information displayed:

Information type Example UDM search queries
Asset
  • hostname="laptop-kai"
  • principal.hostname="laptop-kai"
  • principal.ip="10.0.0.76" //(private IP address)
  • principal.mac="c5:0c:9c:aa:bb:c4"
  • principal.hostname="laptop-kai" and metadata.event_type = "NETWORK_CONNECTION"
  • hostname="laptop-kai" or hostname="desktop-kai"
Domain
  • domain="example.com"
  • target.hostname="example.com"
File
  • hash="44a88612faa8a8f36ae82a1278aaa02a"
  • principal.process.file.md5="a00000a75f2a35130aa7a7aaa09aaa7a"
IP
  • ip="8.8.8.8"
  • target.ip="203.0.113.204" //(public IP address)
User
  • user="alice"
  • target.user.email_address="smitha@example.com"
  • principal.user.userid="alice" or target.user.userid = "smitha"
  • email="john@altostrat.com" or email="alice@example.com"
  • principal.user.userid="smitha"

Overview tab

The Overview tab displays entity information in one of the following predefined information types. The information presented varies depending on the information type:

Asset details

When the UDM search query includes a condition that returns a specific asset, for example principal.hostname="laptop-will" or principal.ip="10.0.0.76", the Overview tab displays asset details with information in the following panels:

  • Entity summary: Displays the following information:
    • Details about the entity, including the IP address and MAC address associated with the asset during the search time range. You can also click the IP address or MAC address to display additional information in the Entity context panel. It also displays the first time the asset was seen in your enterprise and when it was last seen. You can click either timestamp to run a new search using that time.
    • Details about alerts, including a graph showing the number of alerts that involved the entity within the search time range. The panel also lists a subset of rules with the highest number of alerts.
    • Click Open Alerts & IOCs to see all alerts generated during the same search time range.
    • Click View in Alerts Tab to switch to the Alerts & Detections tab on this page and start a new search against the selected entity.
    • Click one of the bars on the chart to switch to the Alerts & Detections tab on this page and start a new search against the selected entity, using the time range of the clicked bar.
    • Click View More to open the entity fields viewer dialog and display all of the entity fields associated with the asset. To copy an entity field to the clipboard, select the checkbox next to the entity field, and then click Copy (or click View actions > Copy entity). Select the header checkbox to select all of the entity fields.
  • Relevant IOCs: Displays IOCs associated with the asset. IOCs assigned a higher severity are displayed first. Clicking the IOC name opens the Entity context panel.
  • Associated Entities: Displays other entities that this asset is related to, such as users who signed in to the asset. The panel displays the type of entity, when it was first seen in the environment, and when it was last seen. It also displays any namespaces associated with an asset. Click an entity to open the Entity context panel. Click Show all time to display the associated entities over the entire available time period as opposed to the time range specified in SIEM Search.
  • Entity context: Displays details about the entity you selected in the Associated Entities panel. This panel displays different information depending on the type of entity you selected in the Associated Entities panel, such as a user or domain.

Domain details

When the UDM search query includes a condition that specifies a specific domain, for example target.hostname="example.com", the Overview tab displays domain details with information in the following panels:

  • Entity summary: Displays the following information:
    • Details about the domain, including the WHOIS information associated with the registered domain, the first time it was seen in your enterprise, and the last time it was seen. Click VT Context to view information about the domain from VirusTotal.
    • Details about alerts, including a graph showing the number of alerts that involved the entity within the search time range. The panel also lists a subset of rules with the highest number of alerts.
    • Click Open Alerts & IOCs to see all alerts generated during the same search time range.
    • Click View in Alerts Tab to switch to the Alerts & Detections tab on this page and start a new search against the selected entity.
    • Click one of the bars on the chart to switch to the Alerts & Detections tab on this page and start a new search against the selected entity, using the time range of the clicked bar.
    • Click View More to open the entity fields viewer dialog and display all of the entity fields associated with the domain. To copy an entity field to the clipboard, select the checkbox next to the entity field, and then click Copy (or click View actions > Copy entity). Select the header checkbox to select all of the entity fields.
  • Resolved IPs: Displays all resolved IP addresses that have been seen in your enterprise for the fully qualified domain name (FQDN). For example, if you search for target.hostname="test.altostrat.com", the search results might display two resolved IP addresses, such as 198.51.100.81 and 203.0.113.81.
  • Sub-domains and sibling domains: Displays all associated subdomains that have been seen in your enterprise for a given FQDN. Many adversaries use the same domain and subdomain for their attacks. For example, if you search for target.hostname="sandbox.altostrat.com", this panel displays two subdomains, test.sandbox.altostrat.com and staging.sandbox.altostrat.com.
  • Prevalence of Assets: Shows the number of assets in your enterprise that have connected to the domain for the entire time period of the data stored in your Google SecOps account. Each bar of the graph represents the number of unique assets in your enterprise that have connected to the domain on a UTC day. Holding the pointer over a bar displays the related entities on the UTC day represented by the bar. Click the entity name to see the entity summary and overview in the Entity context panel. Click View events to see the events related to the selected entity in the search Results tab.
  • Associated Entities: Displays other entities that this domain is related to, such as assets that have contacted this domain. The list includes the type of entity, when it was first seen in your enterprise, and when it was last seen. Click an entity to open the Entity context panel.
  • Entity context: Displays details about the entity you selected in the Associated Entities panel. This panel displays different information depending on the type of entity you selected in the Associated Entities panel, such as an IP address or domain.

File details

When the UDM search query includes a condition that returns a single file, for example principal.process.file.md5="a00000a75f2a35130aa7a7aaa09aaa7a", the Overview tab displays file details with information in the following panels:

  • Entity summary: Displays the following information:
    • Details about the file, including hash values, file size, the first time it was seen in your enterprise, and the last time it was seen. Click VT Context to view information about the file from VirusTotal.
    • Details about alerts, including a graph showing the number of alerts that involved the entity within the search time range. The panel also lists a subset of rules with the highest number of alerts.
    • Click Open Alerts & IOCs to see all alerts generated during the same search time range.
    • Click View in Alerts Tab to switch to the Alerts & Detections tab on this page and start a new search against the selected entity.
    • Click one of the bars on the chart to switch to the Alerts & Detections tab on this page and start a new search against the selected entity, using the time range of the clicked bar.
    • Click View More to open the entity fields viewer dialog and display all of the entity fields associated with the file. To copy an entity field to the clipboard, select the checkbox next to the entity field, and then click Copy (or click View actions > Copy entity). Select the header checkbox to select all of the entity fields.
  • Relevant IOCs: Displays IOCs associated with the file. IOCs assigned a higher severity are displayed first. Clicking the IOC name opens the Entity context panel.
  • Prevalence of Assets: Shows the number of assets in your enterprise associated with the file for the entire time period of the data stored in your Google SecOps account.
  • VirusTotal Properties & Metadata: Displays information about the file from the VirusTotal database. Click View More to open a VirusTotal dialog and display additional information about the file.
  • Associated Entities: Displays other entities that this file is related to, such as an asset where this file was executed or users who accessed the file. The list includes the type of entity, when it was first seen in your enterprise, and when it was last seen. Click an entity to open the Entity context panel.
  • Entity context: Displays details about the entity you selected in the Associated Entities panel. This panel displays different information depending on the type of entity you selected in the Associated Entities panel, such as a user or asset.

IP details

When the UDM search query includes a condition that returns a specific external IP address, for example target.ip="203.0.113.254", the Overview tab displays IP address details with information in the following panels:

  • Entity summary: Displays the following information:
    • Details about the IP address, including the first time it was seen in your enterprise and the last time it was seen. Click VT Context to view information available about this IP address from VirusTotal.
    • Details about alerts, including a graph showing the number of alerts that involved the entity within the search time range. The panel also lists a subset of rules with the highest number of alerts.
    • Click Open Alerts & IOCs to see all alerts generated during the same search time range.
    • Click View in Alerts Tab to switch to the Alerts & Detections tab on this page and start a new search against the selected entity.
    • Click one of the bars on the chart to switch to the Alerts & Detections tab on this page and start a new search against the selected entity, using the time range of the clicked bar.
    • Click View More to open the entity fields viewer dialog and display all of the entity fields associated with the IP address. To copy an entity field to the clipboard, select the checkbox next to the entity field, and then click Copy (or click View actions > Copy entity). Select the header checkbox to select all of the entity fields.
  • Relevant IOCs: Displays IOCs associated with the IP address. IOCs assigned a higher severity are displayed first. Clicking the IOC name opens the Entity context panel.
  • Prevalence of Assets: Shows the number of assets in your enterprise that have connected to the IP address over the time period specified in SIEM Search.
  • Associated Entities: Displays other entities that this IP address is related to, such as domains the IP address is registered to. The list includes the type of entity, when it was first seen in your enterprise, and when it was last seen. Click an entity to open the Entity context panel.
  • Entity context: Displays details about the entity you selected in the Associated Entities panel. This panel displays different information depending on the type of entity you selected in the Associated Entities panel, such as a domain or asset. If the link is displayed, click VT Context to view information about the entity from VirusTotal.

User details

When the UDM search query includes a condition that returns a specific user, for example principal.user.userid="alice", the Overview tab displays user details with information in the following panels:

  • Entity summary: Displays the following information:
    • Details about the entity, including the full name, first time seen in your enterprise and the last time seen, title, and email address.
    • Details about alerts, including a graph showing the number of alerts that involved the entity within the search time range. The panel also lists a subset of rules with the highest number of alerts.
    • Click Open Alerts & IOCs to see all alerts generated during the same search time range.
    • Click View in Alerts Tab to switch to the Alerts & Detections tab on this page and start a new search against the selected entity.
    • Click one of the bars on the chart to switch to the Alerts & Detections tab on this page and start a new search against the selected entity, using the time range of the clicked bar.
    • Click View More to open the entity fields viewer dialog and display all of the entity fields associated with the user. To copy an entity field to the clipboard, select the checkbox next to the entity field, and then click Copy (or click View actions > Copy entity). Select the header checkbox to select all of the entity fields.
  • Associated Entities: Displays entities that this user is related to, such as domains the user contacted or assets the user accessed. The list includes the type of entity, when it was first seen in your enterprise, and when it was last seen. Click an entity to open the Entity context panel.
  • Entity context: Displays details about the entity you selected in the Associated Entities panel. This panel displays different information depending on the type of entity you selected in the Associated Entities panel, such as an asset or domain.

Results tab

The Results tab displays the events connected to your UDM search over the given time range in the Events table. Click an event to open the Event Viewer, which includes the Event Fields, Raw Log, Alerts, Entities, and Tags tabs, and click any associated entity to open the Entity context panel.

You can also do the following on the Results tab:

For complete details about the Results tab and Event Viewer, see View and manage information in the Results tab. For information about UDM events, see Structure of a UDM Event.

Activity Over Time

The Activity Over Time chart displays events and alerts over the time period specified in SIEM Search. Click a bar to narrow the focus of the Results tab and Events table to that time slot. For more information, see Use the Activity Over Time chart.

Prevalence

When your UDM search includes a domain, the Prevalence tab displays a list of low-prevalence domains (Prevalence ≤ 10) alongside an interactive chart so you can identify uncommon domains in your enterprise and filter events to a specific domain. For more information, see Use the Prevalence tab.

Activity heatmap

The Activity heatmap tab displays event density in a date-by-hour timeline grid (00:00 to 23:00) so you can identify when activity for an entity is most concentrated. For more information, see Use the Activity heatmap tab.

Alerts & Detections tab

The Alerts & Detections tab displays rule detections and alerts that match your UDM search query:

  • Trend over time chart: Displays detection volume over the search time range and lets you filter to a specific time bar.
  • Aggregations panel: Lets you filter detections by attributes such as Severity, Status, or Verdict.
  • Detections panel: Lists matching alerts and detections. Click a row to open the Alert Viewer, or click View details to open the Alert view.

For complete details about using these panels, see View and manage information in the Alerts & Detections tab.

Need more help? Get answers from Community members and Google SecOps professionals.