---
title: Linear
description: Integrate Linear with Datadog
breadcrumbs: Docs > Integrations > Linear
---

# Linear
Integration version1.0.0
{% callout %}
# Important note for users on the following Datadog sites: app.ddog-gov.com

{% alert level="danger" %}
This product is not supported for your selected [Datadog site](https://docs.datadoghq.com/getting_started/site). ().
{% /alert %}

{% /callout %}

## Overview{% #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{% #setup %}

### Installation{% #installation %}

1. Navigate to the [Datadog Linear integration tile](https://app.datadoghq.com/integrations/linear) and click **Add Account**.
1. On the Linear authorization page, click **Authorize**.

## Configure an Issue Template{% #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.
1. 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`).
1. Select a Linear account.
1. Select the team.

### Configure Issue Fields{% #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{% #validation %}

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

## Data Collected{% #data-collected %}

### Metrics{% #metrics %}

Linear does not include any metrics.

### Service Checks{% #service-checks %}

Linear does not include any service checks.

### Events{% #events %}

All created Linear issues appear as events within Datadog.

## Troubleshooting{% #troubleshooting %}

### Misconfigured Account{% #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**.
1. If the Datadog app is installed in your workspace, revoke access in **Applications**.
1. Go back to the [Datadog Linear integration tile](https://app.datadoghq.com/integrations/linear) 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](https://docs.datadoghq.com/help/).