Run a correlation
This guide shows how to use the Correlations page to answer “who else is involved?” For what every control means, see Correlations.
You need
- Any role: admin, member or viewer.
- Any plan.
- At least one connected tenant that sends events.
Run one from scratch
Section titled “Run one from scratch”- Open Correlations under Security & monitoring. A query runs at once for the first scope and the last 24 hours.
- In Scope, choose a tenant, or a group shown as “
<name>(group, N tenants)”. The query runs again when you change the scope. - Under Time Range, set Start Date & Time and End Date & Time.
- Set Event Sample Size: 100 events, 200 events, 500 events or 1000 events.
- Optional: choose Add filter. Choose a field, choose an operator (Equals, Contains or Not equals) and type a Value. Use one row for each field.
- Choose Run Correlation.
- Read Findings first, then the Entity graph, then the Event Timeline.
It worked when the Entity graph shows a counter such as “42 nodes, 67 links” and the Event Timeline reads “Showing <n> of <total> events.”
Get there from an event
Section titled “Get there from an event”- On Dashboard, in Real-time events, choose View on the event.
- In Event Details, choose Explore correlations.
- The page opens with the tenant’s scope selected. The graph is focused on the event’s identity, and the event’s row is highlighted in the Event Timeline.
- If nothing is highlighted, the event is older than 24 hours or outside the 500 most recent events. Set Time Range to cover the event time, set Event Sample Size to 1000 events and choose Run Correlation.
It worked when one row in the Event Timeline is highlighted and part of the graph is dimmed.
Start from an incident
Section titled “Start from an incident”An incident page has no link to Correlations. Set the query by hand.
- On the incident, note the identity, the tenant and the time of the event marked Trigger.
- Open Correlations from the sidebar.
- In Scope, choose the tenant, or its group if it is in one.
- Set Time Range around the time of the incident.
- Choose Add filter, then Actor Alternate ID, Equals, and the user’s sign-in name. To follow an address instead, use Client IP, Equals, and the address.
- Choose Run Correlation.
- Look at Related incidents at the top of Findings. If your incident is listed, you are looking at the same activity.
A filter on one identity loads only that identity’s events. To see who else used the same address, filter on Client IP instead, or remove the filter and run again.
Focus an identity or an address
Section titled “Focus an identity or an address”Use this to find who else used the same IP address.
- Run a correlation, or arrive from an event.
- In the graph, select the IP address node connected to the identity. IP addresses are rounded squares, identities are circles and targets are diamonds.
- In the panel under Findings, read Events, Failures, Connections and Countries.
- Choose Focus. Everything except that address and its neighbours is dimmed. The circles that stay bright are the identities that used the address.
- Choose Show events. The Event Timeline lists only that address’s events.
- Choose Inspect on a row. The Event focus card under the table shows the event with its Raw payload.
- To return to the full view, choose Clear focus in the graph and Clear in the timeline.
It worked when the timeline reads “Filtered to <label>.” and the graph shows Clear focus.
Work the findings
Section titled “Work the findings”- In Findings, start with the rows marked
high. - Select a finding. The graph highlights its nodes, and the Event Timeline reads “Filtered to
<finding title>.” - Read the explanation and the line that starts Next step:.
- Choose Inspect on the evidence rows to check the detail.
- If Related incidents lists an incident, open it. Close or escalate the incident there. See Manage incidents.
- Select the finding again to deselect it.
Findings do not have a status. You cannot close or dismiss a finding. It is recalculated each time the query runs. To act on an event, use the event feed. See Dismiss events and Raise a ticket.
For the rule behind each finding and its severity, see The seven findings.
Tidy a crowded graph
Section titled “Tidy a crowded graph”These controls change the drawing only. You do not need to run the query again.
- Raise Minimum shared events to hide weak links.
- Tick Failures only to keep failed activity.
- Untick Targets, IPs or Identities to hide one type of node.
- Leave Show common apps unticked. Applications that most people use add many links and little information.
- Use Zoom in, Zoom out and Reset zoom. You can also scroll to zoom, drag the background to move the view, and drag a node to move it.
- Choose Reset to clear the filter rows, the selection and the focus. Reset does not change the scope, the time range or the sample size.
If the graph is still crowded, shorten Time Range or add a filter, then choose Run Correlation.
Share a view with a colleague
Section titled “Share a view with a colleague”- Select a node and choose Focus.
- Copy the address from the browser. It now holds the scope and the focused node.
- Send it to your colleague.
Your colleague must be a member of the workspace. The link opens the same scope and focus for the last 24 hours. The time range, the sample size and the filters are not in the link, so send those as text if you changed them.
If it does not work
Section titled “If it does not work”| What you see | Why | What to do |
|---|---|---|
| “No tenants are configured for this workspace yet. Add a tenant to start exploring correlations.” | The workspace has no tenants. | Connect a tenant first. See Quickstart. |
| The results did not change after you edited a filter or a date | The query has not run again. | Choose Run Correlation. |
| “You have no events to correlate yet.” | No events were found for the scope and time range. | Check that the tenant sends events. Widen Time Range and run again. |
| A tenant is missing from Scope | It belongs to a correlation group. | Choose the group. |
| You arrived from Explore correlations and nothing is highlighted | The event is older than 24 hours or outside the 500 most recent events. | Set Time Range around the event, raise Event Sample Size and run again. |
| “⚠️ Showing up to N most recent events. Apply filters or shorten the time range for more focused results.” | More events exist than the sample size. | Shorten the range, add filters or raise Event Sample Size. |
| “Nothing to draw with these filters.” | The graph controls removed every link. | Lower Minimum shared events, untick Failures only, and tick the node type boxes. |
| “No findings in this window.” | No pattern reached its threshold. | This is not an error. Widen the range if you expected a finding. |
| “No events match the current filter.” | The finding or node filter on the timeline matches nothing. | Choose Clear. |
For every message on the page, see Correlations troubleshooting.