Jira

Step 1: Generate Credentials

1. Generate API Token

   • Go to Atlassian API Token Management

     • Click Create Token

     • Label it (e.g., “Alert Integration”) and copy the token

   

   Create API Token

   • Note down the admin email address and Jira base URL (e.g., https://your-domain.atlassian.net)

2. Assign Necessary Permission Scopes

   • Go to Select App

     • Select Jira app

   

   Select JIRA App

   • Go to Select Scopes

     • Select write:jira-work

   

   Assign Permission Scopes

   • Review the settings

---

Step 2: Define JIRA Issue Ticket Fields

1. Each alert will be converted into a Jira issue with the following fields

   Field	Description
   project	Key or ID of the Jira project (e.g., "OPS", "ALERTS" or "10034", "2000")
   issuetype	Key or ID of type of issue (e.g., "Bug", "Task", "Incident" or "10040", "10000")
   reporter	Atlassian account ID of the reporter (not email)
   labels	Optional: tags like "automated", "alert", "monitoring"
   customfields	Optional: map alert metadata to custom Jira fields

   • Please use the following to gather more info about the custom fields, if necessary:

     • Get custom field IDs for Jira

     • Please note down the Custom Field Name and the text value that should be assigned to the custom field.

---

Deliverables

Please email the following to [e-mail]:

1. API Credentials

   • Please make sure the following credentials are noted in the email.

     • JIRA_EMAIL : admin email address

     • JIRA_API_TOKEN : generated API token

     • JIRA_BASE_URL : Jira base URL noted above

2. Jira issue ticket fields

   • Please note the fields needs to be set for the Jira issue ticket

     • project

     • issuetype

     • reporter

     • labels

     • customfields (names & values)