Microsoft Sentinel
Hunting and detection

Update workbooks to use Advanced Hunting data - Microsoft Defender XDR | Microsoft Learn

In brief

Adds guidance for creating or updating workbooks to query Microsoft Defender XDR data through Advanced Hunting, including prerequisites, permissions, schema differences, and cross-workspace behavior.

What Defender admins need to know

Administrators can reduce workspace ingestion dependencies, but must review workbook queries and data access when changing ingestion or schemas.

Summaries are generated from the documentation change itself.

Documentation change

The comparison below shows only the changed extract. Use the full-page view for complete context.

new file mode 100644

layout: Conceptual title: Update workbooks to use Advanced Hunting data - Microsoft Defender XDR | Microsoft Learn canonicalUrl: https://learn.microsoft.com/en-us/azure/sentinel/update-workbooks-advanced-hunting-data breadcrumb_path: breadcrumb/toc.json feedback_help_link_url: https://learn.microsoft.com/answers/tags/423/microsoft-sentinel/ feedback_help_link_type: get-help-at-qna feedback_product_url: https://feedback.azure.com/d365community/forum/79b1327d-d925-ec11-b6e6-000d3a4f06a4 feedback_system: Standard learn_banner_products:


Update workbooks to use Advanced Hunting data - Microsoft Defender XDR | Microsoft Learn

Workbooks can query Microsoft Defender XDR data directly by using Advanced Hunting, without requiring the same data to be ingested into a workspace.

You can update existing workbooks to use Advanced Hunting data or create new workbooks that query Microsoft Defender XDR data directly.

Prerequisites

Before you begin, make sure you have:

  • Your tenant is eligible for ISOC.
  • To create and edit workbooks, either the Workbooks Unified RBAC permission with Manage access or the Security Administrator role.
  • Access to the scopes and workloads used by the workbook queries.

Workbook permissions don't grant access to the underlying data. Data access and scoping are enforced when the query runs.

For example, a user can open a workbook that contains Defender for Endpoint data, but the workbook tile returns an error if the user doesn't have access to that data.

For more information, see Update permissions and roles with Unified RBAC.

Create a workbook using Advanced Hunting data

The Workbooks page includes example workbooks that use Microsoft Defender XDR data.

To create your own workbook:

  1. Sign in to the Microsoft Defender portal.
  2. Select Dashboards & reports > Workbooks.
  3. Select + Add workbook.
  4. Select Edit.
  5. In the query section, select Advanced Hunting as the data source.
  6. Add or update the query for the workbook tile.
  7. Save the workbook.

Update an existing workbook

When you stop ingesting a supported Microsoft Defender XDR table into a workspace, update any workbooks that query that table.

  1. Sign in to the Microsoft Defender portal.
  2. Select Dashboards & reports > Workbooks and open the workbook you want to update.
  3. Select Edit.
  4. Change the query data source to Advanced Hunting.
  5. Review the query and confirm that the table names are available in Advanced Hunting. Most table names remain the same.
  6. Update any table or column references that differ in the Advanced Hunting schema.
  7. Validate the workbook tiles, filters, and parameters.

For information about schema and data-type differences, see Update Microsoft Sentinel content to use Advanced Hunting tables.

Work with workbooks across workspaces

When one or more workspaces are connected, the Workbooks page includes a Workspace column that shows where each workbook is saved.

  • A workspace name indicates that the workbook is saved to that workspace.
  • None indicates that the workbook is saved at the tenant level.

You can filter the workbook list by workspace directly from the Workbooks page.

When you save a workbook, choose whether to save it to a specific workspace or at the tenant level. \ No newline at end of file