Canvas Connectors

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

​

Available connectors

To start and follow investigations from Slack, visit Ask Canvas in Slack.

​

Opening the Connectors page

• Navigate to Canvas > Connectors.
• In a Canvas chat, select the plus (+) button, choose Connectors, then select Manage Connectors.

​

Connecting a tool

1. Navigate to 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 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 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. 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 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.