> ## Documentation Index
> Fetch the complete documentation index at: https://docs.honeycomb.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Investigating Alerts with Canvas

> Jump from a firing Trigger or SLO burn alert directly into an AI-powered Canvas investigation that automatically queries your data and surfaces the likely cause.

export const HnyIcon = ({alias, path, size = 16, iconColor}) => {
  const iconMap = {
    "home": "house.svg",
    "marker": "caretFilledDown.svg",
    "show-marker-options": "chatTextLeft.svg",
    "download": "arrowLineDown.svg",
    "trace-waterfall": "trace.svg",
    "show-query-details": "listDashes.svg",
    "table": "table.svg",
    "log-lines": "logLines.svg",
    "chart": "chartLine.svg",
    "show-settings": "gear.svg",
    "add": "plus.svg",
    "remove": "delete.svg",
    "persist": "caretDown.svg",
    "close": "close.svg",
    "copy": "copy.svg",
    "zoom-in": "magnifyingGlassPlus.svg",
    "zoom-out": "magnifyingGlassMinus.svg",
    "color-assignment": "drop.svg",
    "drag": "dots-six-vertical.svg",
    "drawer": "drawer.svg",
    "show-actions": "dotsThree.svg",
    "edit": "pencil.svg",
    "delete": "trash.svg",
    "move": "arrowsOutCardinal.svg",
    "show-legend": "circleInfo.svg",
    "usage-ok": "usageGood.svg",
    "usage-warning": "usageWarning.svg",
    "usage-danger": "usageDanger.svg",
    "open-query-builder": "query.svg",
    "home-menu": "house.svg",
    "query-menu": "query.svg",
    "boards-menu": "board.svg",
    "triggers-menu": "bell.svg",
    "slos-menu": "handshake.svg",
    "service-map-menu": "serviceMap.svg",
    "history-menu": "clockCounterClockwise.svg",
    "manage-data-menu": "cube.svg",
    "usage-menu": "usageGood.svg",
    "canvas-menu": "sparkle.svg",
    "anomalies-menu": "anomalies.svg",
    "show-details": "dotsThreeVertical.svg",
    "resize-handle": "board-panel-resize-handle.png",
    "standard-dataset": "cube.svg",
    "trace-dataset": "cubeChat.svg",
    "all-datasets": "linkedSquares.svg",
    "share": "arrowBentRight.svg",
    "run-in-query-builder": "arrowSquareUpRight.svg",
    "link": "link.svg",
    "text": "text.svg",
    "receive": "arrowLineDown.svg",
    "process": "lightning.svg",
    "sample": "drop.svg",
    "send": "arrowLineUp.svg",
    "submit": "arrowUp.svg",
    "canvas-menu": "sparkle.svg",
    "canvas": "sparkle.svg",
    "chat-about-this-page": "sparkle.svg",
    "private": "lockKey.svg",
    "shared": "people.svg",
    "expand": "caretDown.svg",
    "previous": "caretLeft.svg",
    "next": "caretRight.svg",
    "expand-chat": "caretLeft.svg",
    "minimize-chat": "caretRight.svg",
    "open-in-canvas": "arrowSquareUpRight.svg"
  };
  const iconBasePath = "/_assets/icons/";
  const iconPath = path || (alias ? `${iconBasePath}${iconMap[alias]}` : undefined);
  return <span className="hny-icon" style={{
    display: "inline-block",
    width: `${size}px`,
    height: `${size}px`,
    maskImage: `url(${iconPath})`,
    maskSize: "contain",
    maskRepeat: "no-repeat",
    maskPosition: "center",
    WebkitMaskImage: `url(${iconPath})`,
    WebkitMaskSize: "contain",
    WebkitMaskRepeat: "no-repeat",
    WebkitMaskPosition: "center",
    backgroundColor: iconColor || "var(--hny-icon-color)",
    verticalAlign: "middle"
  }} />;
};

When a Trigger or SLO Burn Alert fires, Honeycomb includes an **Investigate** link in your notification.
Selecting this link launches an AI-powered Canvas investigation scoped to that alert.

## How it works

When you select an Investigate link, Canvas doesn't just open a blank session; it arrives already working.
It pulls in everything Honeycomb knows about the alert and starts investigating immediately, so by the time you are looking at the screen, Canvas has already begun surfacing answers.

### How investigations launch

To start an investigation, select the **Investigate** (<HnyIcon alias="canvas" />) link in your notification.
Honeycomb:

1. Creates a new Canvas session scoped to the alert.
2. Gathers context about the alert, including:
   * Alert type
   * Timestamp
   * Threshold
   * Datasets
   * Environment
3. Runs an investigation into the cause, generating queries and surfacing hypotheses and recommendations.

You can interact with the investigation the same way you would any other Canvas investigation.

### Supported notification recipients

Investigate links appear in notifications sent to:

* Slack
* PagerDuty
* Email

<Note>
  **Investigate** links are only included in notifications when:

  * Honeycomb Intelligence is enabled for your team
  * Alerts are configured for a Honeycomb environment

  If you use Honeycomb Classic, we recommend [migrating to Environments](/troubleshoot/product-lifecycle/recommended-migrations/#migrate-from-honeycomb-classic-to-honeycomb-environments) to take advantage of this feature.
</Note>

## Returning to a previous investigation

Selecting an **Investigate** link always creates a new investigation.
To return to a previous one, select **Canvas** (<HnyIcon alias="canvas-menu" />) from the navigation menu and find it under **All Investigations**.

## Sharing investigations

You can share or set privacy on an alert investigation the same way you would any other Canvas investigation.
Select **Share** (<HnyIcon alias="share" />) to copy a shareable link.

## Learn more

* [Ask Questions with Canvas](/investigate/canvas/): Learn more about Canvas and its capabilities
* [Triggers](/notify/triggers/): Configure alerts based on data thresholds
* [SLOs and Burn Alerts](/notify/slos/): Set up Service Level Objectives and budget-based alerting
