Overview

Linear is an issue tracking and project management tool. It helps teams plan, track, and ship work. The Datadog integration for Linear enables you to create issues from monitors.

Setup

Installation

1. Navigate to the Datadog Linear integration tile and click Add Account.
2. On the Linear authorization page, click Authorize.

Configuration

To create Linear issues from Datadog monitor alerts, see Configure an issue template.

To configure automated Linear issue creation with bidirectional syncing in Case Management, see the instructions for Configuring a Linear webhook and the Case Management documentation.

Configure an Issue Template

Issue templates define how issues are created in Linear from Datadog alert events.

To create an issue template:

1. In Datadog, click New Issue Template in the Create Linear issues from Datadog section.
2. Enter a name for your issue template. This name, prefixed with linear-, becomes the handle you can use in your monitor to send notifications to (for example, linear-my-issue-template-name).
3. Select a Linear account.
4. Select the team.

Configure a Linear webhook

Enable cases created in Case Management to automatically create issues in Linear and keep both resources synced through Linear webhooks.

To create a Linear webhook:

1. In your Linear workspace, navigate to Settings.
2. In the left-hand menu, select API.
3. Under the Webhooks section, click the + icon.
4. Enter Datadog Webhook as the webhook name.
5. Navigate to the Datadog Linear integration tile.
6. Under the Accounts tab, click on the Linear account you want to set up the webhook for and copy the webhook URL.
7. Navigate back to Linear and paste the webhook URL under URL.
8. Enable the following data change events.
9. Leave everything else unchecked.
10. Copy the Signing Secret to clipboard.
11. Click the Create Webhook button at the bottom of the page.
12. Go back to Datadog, paste the signing secret into the account’s Webhook signing secret field, and click Save.

Configure Issue Fields

Issue template fields define the data that is included when creating issues in Linear. For example, you can configure your template to create issues with a default assignee or specific labels.

Validation

1. Create an issue template.
2. Configure a monitor to with the Linear handle (for example, @linear-my-issue-template-name).
3. Send a test notification from the monitor and an issue should be created in Linear.

Data Collected

Metrics

Linear does not include any metrics.

Service Checks

Linear does not include any service checks.

Events

All created Linear issues appear as events within Datadog.

Troubleshooting

Misconfigured Account

If you encounter errors when loading your issue templates, or receive 401 status codes from Linear in your event stream, reconnect your account following the steps below.

Do not delete the account in the Linear integration tile.

1. Navigate to your Linear workspace and go to Settings.
2. If the Datadog app is installed in your workspace, revoke access in Applications.
3. Go back to the Datadog Linear integration tile and reauthorize the account by clicking Add Account.

The existing account in the integration tile should then be updated, and this can be verified by creating a new issue template for the account.

Need help? Contact Datadog support.