Issue Tracker Integration

Connect Provenance error tracking to your project management tool. When errors are detected, issues are automatically created and linked.

Supported Providers

Provider	API	Features
JIRA	REST API v3	Create bugs, add comments on re-occurrence, label-based linking
Linear	GraphQL API	Create issues, add comments, description-based linking
Monday.com	GraphQL API	Create items, add updates, name-based linking

Configure issue tracker integration per origin in the origin config:

{
  "issueTracker": {
    "provider": "jira",
    "project": "PROJ",
    "autoCreate": true
  }
}

Configure in Adapter Settings → JIRA:

Setting	Description
`baseUrl`	Your Jira instance URL (e.g. `https://yourorg.atlassian.net`)
`email`	Jira account email
`apiToken`	Jira API token (generate here)

Setting	Description
`apiKey`	Linear API key (generate here)
`teamId`	Default team ID for new issues

Setting	Description
`apiToken`	Monday.com API token
`boardId`	Default board ID for new items

Each adapter uses a unique tag to link Provenance error issues to external issues:

On subsequent occurrences of the same error, the adapter finds the existing linked issue and adds a comment/update instead of creating a duplicate.

Issue tracker adapters work like any other Provenance adapter. Create a subscription that triggers on error interactions:

Create a subscriber with ARN adapter:jira (or adapter:linear, adapter:monday)
Create a subscription matching your error resource type and action
Configure the subscription with project/board details

The subscription fires whenever a new error interaction is logged, creating or updating the linked issue.