> For the complete documentation index, see [llms.txt](https://cortex-docs.paloaltonetworks.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cortex-docs.paloaltonetworks.com/xsoar-6-administrator-guide/6.13/learn-about-cortex-xsoar/day-to-day-tasks-in-cortex-xsoar/incident-management/investigate-an-incident-using-the-canvas.md).

# Investigate an Incident Using the Canvas

The Investigation Canvas enables you to visually map an incident, its elements, and progression path, combining analyst intelligence with machine learning.

To access the investigation canvas, click **Canvas** from the incident you want to investigate. The incident appears on the canvas display. In the **Add entity to canvas** section, DBot provides suggested indicators and incidents that might be connected or relevant to the current incident for you to add to the canvas.

Searches are server side searches.

![canvas.png](/files/71jaDjR28gloUxqtb24P)

**Incident Suggestions**

The incidents are calculated according to the related incidents algorithm, which are based on several factors:

* Common labels
* Common indicators
* Common incident custom fields

You can add the incidents by dragging and dropping the incident onto the canvas.

**Indicator Suggestions**

The indicators are determined according to the following factors (in this order):

1. Indicators with a malicious verdict from the original incident (the incident that initiated the investigation).
2. Indicators that are shared between incidents that you added to the canvas.
3. The malicious ratio, which is the ratio between the indicators that appear in incidents with a malicious verdict, compared to the total number of incidents in Cortex XSOAR.

You can add the indicators by dragging and dropping the indicators onto the canvas.

{% hint style="info" %}

### Note

You can [Edit Dbot Incident and Indicator Suggestions](/xsoar-6-administrator-guide/6.13/learn-about-cortex-xsoar/day-to-day-tasks-in-cortex-xsoar/incident-management/investigate-an-incident-using-the-canvas/edit-dbot-incident-and-indicator-suggestions.md) in the Entity Library.
{% endhint %}

**Key Features**

You can do the following:

* [Auto Populate the Canvas](/xsoar-6-administrator-guide/6.13/learn-about-cortex-xsoar/day-to-day-tasks-in-cortex-xsoar/incident-management/investigate-an-incident-using-the-canvas/auto-populate-the-canvas.md) with related incidents, suspicious URLs and so on by using machine learning.

  The closer an entity appears to the center, the more closely related it is to the investigated incident.
* **View an incident and indicator**: view details of incident and indicator, including various actions in the [Dbot Suggestions: Quick View Window](/xsoar-6-administrator-guide/6.13/learn-about-cortex-xsoar/day-to-day-tasks-in-cortex-xsoar/incident-management/investigate-an-incident-using-the-canvas/dbot-suggestions-quick-view-window.md).
* **Connect incidents**: connect each incident by linking each incident and use comments on entity connections to communicate important information with team members by adding notes to connectors between entities.

  ![link\_incident.png](/files/EyHdcfYb5EJRjcniCMMT)
* **Dynamic Connections**: when you rearrange entities on the canvas, the connections dynamically move with the entities. Connections that are dotted lines indicate that the indicator is part of the investigation, or two incidents are defined as related incidents. These connections are dynamic, which means if one entity is an IP address and you add that IP address to the allow list after it was added to the canvas, the dotted-lined connection is automatically removed.
* **Capture the Canvas as an image**: capture and study the incident by clicking **Export to PNG**.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://cortex-docs.paloaltonetworks.com/xsoar-6-administrator-guide/6.13/learn-about-cortex-xsoar/day-to-day-tasks-in-cortex-xsoar/incident-management/investigate-an-incident-using-the-canvas.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.