> ## 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.

# Canvas Connectors

> Connect your incident response, documentation, and analytics tools so the Canvas Agent can use them during an investigation.

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",
    "send-test": "EnvelopeSimple.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"
  }} />;
};

<Badge className="hny-badge-beta" stroke>Beta</Badge>

Connectors bring the tools you already use into Canvas.
Once you connect a tool, the Canvas Agent can use it during an investigation alongside your Honeycomb telemetry.

For example, the Canvas Agent can review an incident.io timeline, check who is on-call in PagerDuty, or read your runbooks in Notion.

<Note>
  Connectors are in beta and new Connectors will be added gradually.
  Functionality may change as we refine this feature.
  If you don't see the **Connectors** page or a specific connector, it is not yet enabled for your Team.
</Note>

<Tip>
  Connectors work on a per-user basis.
  You connect your own account and the Canvas Agent uses the connected tool as your account.
  Connecting a tool does not connect it for anyone else on your Honeycomb Team.
  There are no Team-level connector controls yet.
</Tip>

## Available connectors

| Connector                                                  | What the Canvas Agent can do                           |
| ---------------------------------------------------------- | ------------------------------------------------------ |
| [Amplitude](/investigate/canvas/connectors/amplitude/)     | Read and update analytics charts, events, and cohorts. |
| [Atlassian](/investigate/canvas/connectors/atlassian/)     | Search Jira issues and Confluence pages.               |
| [Braintrust](/investigate/canvas/connectors/braintrust/)   | Read eval results, logs, and traces.                   |
| [Checkly](/investigate/canvas/connectors/checkly/)         | Read checks, results, and status pages.                |
| [GitHub](/investigate/canvas/github/)                      | Access repositories, pull requests, and issues.        |
| [incident.io](/investigate/canvas/connectors/incident-io/) | Read incidents, alerts, and on-call schedules.         |
| [Linear](/investigate/canvas/connectors/linear/)           | Read and update issues, projects, and comments.        |
| [Notion](/investigate/canvas/connectors/notion/)           | Read and update runbooks and documentation.            |
| [PagerDuty](/investigate/canvas/connectors/pagerduty/)     | Read incidents, services, and on-call schedules.       |
| [Pylon](/investigate/canvas/connectors/pylon/)             | Read and manage support issues and accounts.           |
| [Sentry](/investigate/canvas/connectors/sentry/)           | Read issues, events, and stack traces.                 |

To start and follow investigations from Slack, visit [Ask Canvas in Slack](/investigate/canvas/slack-app/).

## Opening the Connectors page

* Navigate to <HnyIcon alias="canvas" /> **Canvas** > **Connectors**.
* In a Canvas chat, select the <HnyIcon alias="add" /> plus (`+`) button, choose **Connectors**, then select <HnyIcon alias="show-settings" /> **Manage Connectors**.

## Connecting a tool

1. Navigate to <HnyIcon alias="canvas" /> **Canvas** > **Connectors**.
2. Find the tool in the connector list.
   Select its name to read what the Canvas Agent can do with it and what access it needs.
3. Select **Connect**.
4. Review the access you are granting on the tool's authorization page, then approve it.

The connector shows a **Connected** badge once the connection succeeds.

## Enabling/disabling tools per investigation

Use the chat menu to control which tools the Canvas Agent can use during an investigation:

1. In a Canvas chat, select the <HnyIcon alias="add" /> plus (`+`) button.
2. Choose **Connectors**.
3. Use the toggle beside a tool to turn it on or off for this investigation.

The menu lists only the tools you already connected.

## Reconnecting a tool

When an authorization expires or someone revokes it, the connector's row shows a warning and its action changes to **Reconnect**.
Select **Reconnect** and authorize Honeycomb again.

## Disconnecting a tool

1. Navigate to <HnyIcon alias="canvas" /> **Canvas** > **Connectors**.
2. Find the connected tool and select **Manage**.
3. Select **Disconnect**.

Disconnecting revokes Honeycomb's access to that tool and removes it from your chat menu.

## What the Canvas Agent can access

The Canvas Agent authenticates to a connected tool with your account.
It reads only the content your own account can see in that tool.
The same restrictions apply to what it can write or change.

Each connector's page describes the access its authorization covers.

## Approving write actions

The Canvas Agent reads from a connected tool without asking.
For write actions, you will be prompted to approve each specific call.

When the Canvas Agent wants to perform a write action:

1. An approval prompt will appear in your Canvas chat, naming the tool the Canvas Agent wants to run.
2. Select **Approve** to let the call run, or **Deny** to stop it.
   1. (Optional) If you deny the action, you can provide a reason and tell the Canvas Agent what to do instead.

Approval covers one call, so the Canvas Agent asks again the next time it wants to write.
If a connected tool adds an action Honeycomb has not classified yet, the Canvas Agent asks before it runs that action.

Some investigations run without a person to ask, such as an [automatic investigation](/investigate/canvas/auto-investigate/).
The Canvas Agent cannot write to a connected tool in those investigations.
It continues with the reads it can do.

## Requesting a connector

1. Navigate to <HnyIcon alias="canvas" /> **Canvas** > **Connectors**.
2. Select **Request a connector**.
3. Name the service, and describe what the Canvas Agent would need from it during an investigation.
4. Select **Send Request**.