Skip to main content

Start a hunt

Start a hunt when a question turns into an investigation, so the question, the steps, the evidence and the verdict stay together. On this page you pick where to start from, set up the empty notebook, choose how much Scout does on its own, and add work you did elsewhere.

Ways to start a hunt​

FromWhat to doWhat you get
A Scout answer in a chatOpen Add to hunt ▾ under the answer and choose New hunt from this, or click Start hunt on a Hypothesis Draft card.A hunt named after your question, linked to the chat, with what the chat already ran as cells. See Start from a chat.
The ask box on Explorer or in a new tabType what you suspect. Press Enter when the line says it will start a hunt, or pick Treat as ▾ › Hunt first.A hunt that Scout plans from your question, or an empty hunt if you typed nothing. See Start one from the ask box.
The header's New (new navigation)New › Hunt, or New › Hunt from playbook….The hunt shape of the ask box, or the playbook launcher.
A threat in IntelligenceClick Hunt this in the threat's drawer, or beside a threat under Relevant threats.A hunt titled after the threat (…: were we hit?), whose first cell is a note linking back to the threat with its indicators and the techniques you don't watch for. See Threats.
A threat reportClick Hunt this on the report's card.A hunt that starts from the report, linked to it in the hunt's header.
A look backIn the look back's results, click Open as hunt, or Add results to hunt ▾ for a recent hunt.A note cell with the window, what was sighted and the results.
A detection waiting in the InboxClick Hunt this (or press H) on the item.A hunt from the detection. See Inbox.
A follow-up in a hunt reportClick Hunt this beside a suggested follow-up hunt.A hunt with the suggestion's title and hypothesis.
An entitySelect the entity to open the Inspector, then choose Add to hunt ▾ › New hunt from this….A conversation seeded with that entity; Scout drafts the hunt with you.
A hunt playbookIn the Content library, open a playbook and click Launch, then Launch hunt.A fresh hunt with the playbook's steps copied in. See Hunt playbooks.
Work in another tabAdd to hunt ▾ › New hunt from this on query results, a search or a graph node.A hunt that starts with that work as its first step. See Add work to a hunt.
Activity (classic layout)Click New and choose New hunt, or New hunt (the +) in the dock's Workspace header.A blank hunt.
Explorer, with sample data onClick Start this hunt on a card under Try a hunt on Example Corp.A hunt of your own with the card's question and its suggested queries as query cells. Once you have started one, the card offers Resume instead.
Query resultsIn a query tab, click Start hunt in the title row, or right-click rows and choose Start hunt from this row / Start hunt from N rows.A hunt seeded with those results.
An event in a searchExpand an event in Search and click Start a hunt.A hunt named after the event, with a telemetry view cell covering the 5 minutes either side of it.

A new hunt opens in front of whatever you were doing. It begins as a Draft: until it has any steps, the owner can remove it with ⋯ › Delete draft….

Start from a chat​

New hunt from this is the first item in a Scout answer's Add to hunt ▾ menu. The hunt it makes:

  • is named after the question you asked, not Scout's answer, and uses your question as its hypothesis;
  • is linked to the chat, which becomes one of the hunt's chats, and later turns in the chat carry the hunt;
  • gets the queries the chat already ran as cells;
  • keeps the chat's Scout autonomy.

The message Hunt created confirms it, and the hunt opens.

Start one from the ask box​

  1. On Explorer, or in a new tab, type what you suspect, for example a service account is logging in from new countries. To force a hunt, choose Treat as ▾ › Hunt.
  2. Choose the Scout autonomy (see Choose how much Scout does), or Start from a playbook.
  3. Press Enter, or click Start hunt. The hunt opens with Scout already planning it from your question. With nothing typed the button reads Start empty hunt.

No hunt exists until you press Enter or click the button.

The empty notebook​

A new hunt's notebook opens with its Plan block (type a host, user, IOC or a full hypothesis there; Scout reads it to plan) and three doors under How do you want to start?:

DoorWhat happens
Have Scout plan itScout reads the question and proposes a section of query cells, behind one checkpoint that approves the plan. In Guide and Collaborator, nothing in the plan runs until you approve it.
Write a queryAdds one blank query cell and opens it for editing.
Add from LibraryOpens the template picker; templates land as cells you can edit.

Under the doors, Or just ask Scout a question in the Scout panel. opens the Scout panel beside the hunt (the same as the Scout icon in the header, ⌘J). Ask there; every question you run becomes a cell in the notebook. An empty Flow view says the same: Ask Scout in the Scout panel — every question you run becomes a cell here.

You can mix these at any time: add a query of your own after Scout's plan, or pull in a template halfway through.

While Scout works, a banner above the cells says what it's doing, from what Scout is actually doing rather than a timer: Scout is planning this hunt…, Scout is waiting for you: answer or pick a next step in the Scout panel., or, once it has finished without a plan, Scout didn't draft any steps. Add a step, or ask Scout for one in the Scout panel.

Choose how much Scout does​

The Scout mode chip in the hunt header (Scout: Guide, Scout: Collaborator or Scout: Operator) sets how much Scout runs on its own. It is not anyone's access to the hunt.

ModeWhat Scout does
GuidePauses at every finding. You drive each step.
CollaboratorYou approve Scout's plan first. Then Scout runs its queries itself and asks before any action.
OperatorRuns the full investigation. You review the report.

You pick the mode when you start a hunt from the ask box. A new hunt starts on your last Guide or Collaborator choice; Operator is never carried over, so you pick it for each hunt. When Scout finishes an Operator hunt and drafts its verdict, you get a notification, Scout finished: Confirmed (draft) — review, that opens the hunt. Click the chip to change it while the hunt is active; the change applies at the next checkpoint, and switching to Operator asks you to confirm. A hunt made from a chat keeps the chat's mode. Hunts started by a watcher default to Collaborator unless the trigger says otherwise. To stop Scout changing the hunt for a while, pause Scout.

Where a hunt came from​

The Plan block's byline and the line under the hunt header say where the hunt started, with a link: from report with the report's title, from threat, written by Scout from report…, or by the person who wrote the question. The details pane's Provenance tab says the same, for example Started from report. See Hunt views and the details pane.

Add work to a hunt​

Work you do elsewhere goes into a hunt only when you add it. Add to hunt appears in these places:

WhereWhat it adds
The results header of a query tabThe query, as a step pinned to the run you're looking at.
Under a Scout answer in a chatThe answer, as a note with a link back to the chat.
A graph node's detail panel, or an entity's actionsThe entity.
Next to Save view in a search of your telemetryThe search, as a query step.

Click Add to hunt to add to the default hunt, which is the hunt the tab belongs to. Open its ▾ for New hunt from this (first), then Open hunts and Recent. A message confirms the add, with Show in notebook.

In the classic layout, a source that belongs to no tab, such as an entity in a panel, goes to the hunt picked in the tab bar's Add to hunt goes to selector.

A query tab you add is linked to its step. Its results header shows Step with the step's title and Show in notebook, and every later run in that tab updates the step.

Next steps​