Skip to main content

Approvals and Needs you

Scout plans steps, but in Guide and Collaborator it asks before it runs anything that matters. On this page you approve Scout's plan, approve or reject the steps it proposes, decide checkpoints, use Needs you to clear what the hunt is waiting on, and run the whole hunt from Run ▾.

What Scout stops for​

How much Scout asks depends on the hunt's Scout mode, shown in the header as Scout: Guide, Scout: Collaborator or Scout: Operator:

ModeWhat waits for you
GuideEvery finding. You drive each step, and nothing in a plan runs until you approve its checkpoint.
CollaboratorThe plan and actions. Nothing in Scout's plan runs until you approve its checkpoint; after that Scout runs the plan's queries itself, and actions, tasks and live endpoint sessions still wait for you.
OperatorLittle. Scout runs the investigation and you review the report.

Only the hunt's owner and contributors can approve or reject. Anyone else sees Review in place of the buttons.

Approve the plan​

When Scout plans a hunt, the Plan block at the top of the notebook reads Waiting for you and lists the steps, each with a risk tag (read-only, asks first, action, your decision). Read them, then click Approve plan. It approves the plan's checkpoint and every step that can be approved together, and the line beside it says what that means at the hunt's Scout mode. Steps that touch endpoints, and actions, still ask in their own cell.

Approve a step Scout proposed​

Steps Scout proposes. When Scout plans a task, query, collection, watcher or action that needs a go-ahead, the cell says Scout proposed this step — waiting for approval. and has its own buttons. Approve & run approves and runs a query or collection, and Approve approves a task or watcher. Reject turns the step down. An action shows Review instead, which opens its panel, because approving some actions needs a confirmation note. If you can't edit the hunt, you only see Review.

If you rewrite the query of a step Scout proposed, it becomes your step: it no longer waits for approval, you run it like any of your cells, and it reads ran by you. Its ✦ Scout tag goes, and values Scout set for parameters your query no longer uses are dropped.

To decide a proposed step:

  1. Find it in the notebook, or click it under Needs you in the details pane.
  2. Read what it will do: the query text, the task, or the action and its target.
  3. Click Approve & run (a query or collection) or Approve (a task or watcher) to go ahead, or Reject to turn it down.

An approved query runs straight away. An approved task becomes work for your team: mark it done with Mark done when it's finished. A step you reject reads Rejected — not run: it never ran, and it doesn't count as a failure.

In the Flow view, select a waiting node and press Shift+A to approve it or Shift+R to reject it.

Decide a checkpoint​

A Checkpoint cell stops the plan until a person decides. When Scout plans a hunt in Guide or Collaborator, one checkpoint approves the whole plan, and nothing in it runs until you do. Under Your approval is needed the checkpoint offers:

ButtonWhat it does
Approve stepApproves the checkpoint. The next steps start.
RefineOpens Refine the hunt: steer the hypothesis or add context, and Scout replans from the checkpoint.
AbortAsks first (Abort this hunt?), then stops the hunt and closes it.

Checkpoints can also be approved from Needs you, and Scout's chat shows the same choice on an Approval required — auto-hunt card. See Chatting with Scout.

Endpoint actions and watches​

An Endpoint action or Endpoint watch is approved on its own approval card, which checks your organization's approval rules first. By default someone other than the person who asked has to approve it, and a proposal lapses if nobody approves it in time. See Approve an action or a watch.

Work through Needs you​

The details pane's Outline tab has a Flow · Outline switch. On Flow, a line under the minimap counts what is waiting, for example 2 cells need you · Show in Outline. On Outline, the list ends with Needs you: everything the hunt is waiting on, in notebook order.

ItemWhat to do
A failed cellOpen it and run it again or fix it. See What a cell found.
A checkpointApprove step from the list, or open the cell to refine or abort.
A step Scout proposedApprove it from the list with the same button as on the cell.
A query that needs parametersListed as Waiting for parameter values. Fill in parameters takes you to the cell's inputs. Fill them in and run the cell; the steps after it wait until then.
An action or endpoint proposalReview takes you to the cell and its approval card.
The verdictAlways last. It appears once the hunt's steps have settled: nothing running or waiting for approval, no planned step left to run, and at least one step that returned rows. Sample hunts never ask for one. See Conclude a hunt.

To clear the list:

  1. Open the details pane's Outline tab and switch to Outline (or click Show in Outline under the minimap). If the pane is hidden, click Show details in the notebook header.
  2. Click Next under Needs you to jump to the first item.
  3. Act on it, from the list or in its cell, then click Next again.

Hunts waiting on you, and the approvals in them, are also listed in the Inbox, under Needs you. In the classic layout, the hunt's needs-you count also shows beside it in the dock's Workspace tree and in Activity.

Run the whole hunt​

Run ▾ › Run all (N) in the hunt header runs every step that hasn't run. When some steps will stop for approval, the item says how many, for example 2 need approval · 1 will wait for approval. While the run goes, the button becomes Cancel with its progress and the step in progress, or Cancel paused run while it waits on you. Its tooltip says what it is waiting for: approve or reject the waiting steps, or fill in their parameter values, to continue. See Run ▾.

A step whose query has a {{parameter}} with no value doesn't fail: it waits for input, and the steps after it wait with it. The run pauses there, and Needs you lists the step until you fill in its values and run it.

Endpoint cells and telemetry view cells never run as part of Run all.

Concluding a hunt settles what's still waiting: steps waiting for approval are marked Not run (hunt closed) and running queries stop. After you reopen it, you can run them again. See What concluding does.

Next steps​