Creating an Alert for Jira Tickets

Atlassian created Jira software as a suite of agile work management solutions that powers collaboration across all teams.

You can configure Observe to send you notifications when someone creates a Jira ticket. This may be useful to track code changes or if someone finds an issue that needs resolution. Whatever the reason may be, you can receive notifications for Jira tickets using the following instructions to create the alert.

Prerequisites

Before you begin configuring an alert in Observe, you must have the following information available:

  • A registered Jira Webhook - if you don’t have a registered Webhook, go to Jira Webhooks and register for one. You may need your Jira administrator or someone with administrator privileges to perform this action.

  • A Jira API token - create a Jira API token for your account by going to Account Settings>Security Settings>API tokens in Jira.

  • Your Jira account ID - Log into Jira, and click People. Then click on your name. The account ID appears in the URL for your profile:

https://yourcompany.atlassian.net/jira/people/123abc4567d8e901f2g3h4i5

Once you have a Webhook and an API token, you can generate a test ticket using the following curl:

curl -X POST 
	--user [email protected]:abCDeF1gHij2kLmN3oPQRST4 
	--data-binary '...' 
	-H "Content-Type: application/json" 
	'https://yourcompany.atlassian.net/rest/api/2/issue'

You need an example of a data-binary for your Jira instance such as the following:

{
    "fields":
    {
        "summary": "Test (autobug) Your company alert to Jira ticket test",
        "issuetype":
        {
            "id": "00000"
        },
        "project":
        {
            "id": "00000"
        },
        "assignee":
        {
            "id": "123abc4567d8e901f2g3h4i5"
        },
        "priority":
        {
            "id": "2"
        },
        "description": "Describe event"
    },
    "update":
    {
        "customfield_00000":
        [
            {
                "add":
                {
                    "id": "00000"
                }
            }
        ]
    }

Use values from your Jira instance to fill in the fields. You may need to ask your Jira administrator for this information. Alternatively, you can retrieve the field values by querying for an existing Jira ticket through the API by replacing the ticket ID example with your ticket ID:

curl -X GET --user [email protected]:abCDeF1gHij2kLmN3oPQRST4 'https://yourcompany.atlassian.net/rest/api/latest/issue/ID-12345'

To test the final command to create a ticket from the terminal, use the following format:

curl -X POST --user [email protected]:abCDeF1gHij2kLmN3oPQRST4 --data-binary '{"fields": {"summary": “Bug Description”, "issuetype": {"id": “00000”}, "project": {"id": “00000”}, "assignee": {"id": "123abc4567d8e901f2g3h4i5"}, "priority": {"id": "2"}, "description": “Bug Details "}, "update": {"customfield_00000”: [{"add": {"id": “00000”}}]}}’ -H "Content-Type: application/json" 'https://yourcompany.atlassian.net/rest/api/2/issue'

Note

Observe highly recommends testing your Webhook and fields before you begin configuring an alert to ensure that your sample works as expected.

Before you begin the next task, you need to convert your token into a Basic base64 key. Do this, for example, by using Python to run the following code:

>>>import base64
>>>print(base64.b64encode(b'[email protected]:abCDeF1gHij2kLmN3oPQRST4'))
b'eW91QHlvdXJjb21wYW55OmFiQ0RlRjFnSGlqMmtMbU4zb1BRUlNUNA=='

You need the text between the single quotes for the authorization token.

Creating the Observe Channel Action

Configure your Channel Action using the following steps:

  1. From the left navigation panel, click Other icon Other, and then click Channel Actions.

Channel Action Name

2. For the Channel Action Name, enter a suitable name such as Jira Tickets.

Content

3. In the Content section, select Webhook.

4. Enter your URL in the URL field, in this example, https://yourcompany.atlassian.net/rest/api/2/issue.

5. Select Post as the Method.

6. In the Headers section, enter Authorization = Basic eW91QHlvdXJjb21wYW55OmFiQ0RlRjFnSGlqMmtMbU4zb1BRUlNUNA==.

7. Click Add Key-Value Pair.

8. Enter Content-Type = application/json.

Content section of creating a channel action

Figure 1 - Channel Action Content

9. In the Body field, paste your data-binary code. For example:

{
    "fields":
    {
        "summary": "{{notification.title}} Observe alert to Jira ticket test",
        "issuetype":
        {
            "id": "00000"
        },
        "project":
        {
            "id": "00000"
        },
        "assignee":
        {
            "id": "61080c8bfc68c10069d0adab"
        },
        "priority":
        {
            "id": "2"
        },
        "description": "{{notification.description}}"
    },
    "update":
    {
        "customfield_00000":
        [
            {
                "add":
                {
                    "id": "00000"
                }
            }
        ]
    }
}

Note

{{notification.title}} and {{notification.description}} are customizable variables. Notification variables contain details of the notification, such as when the alert triggered and the resources or values that triggered it.

10. In the Sample Data and Preview section, click Send Test New Notification. If there are no errors, you see No errors detected which means your code works for the Channel Action. You should also check Jira to ensure the ticket was created.

Body section of creating a channel action

Figure 2 - Channel Action Body

Delivery

11. In the Send Notifications From the Following Channels section, click Add Channel and then Create New Channel. Enter, for example, Test Jira as the Channel Name.

12. In the Delivery Frequency, configure the notification frequency to every 30 minutes.

13. Click Save.

Delivery section of creating a channel action

Figure 2 - Channel Action Delivery

Creating the Jira Ticket Monitor and Alert

After you create a Channel and the Channel Action, you create a Monitor and an Alert for your Jira tickets. Use the following steps to create a Monitor:

  1. From the left navigation panel, click Other icon Other, and then click Monitor.

  2. Click Create New Monitor.

  3. Click on Promotion to create a Promotion monitor.

  4. From the list of available datasets, select a dataset that you want to monitor.

  5. Run the following OPAL to create the fields description and title:

filter msg = "important problem that needs a Jira ticket"
make_col
    title:strcat("A problem occurred in ", node),
    description:strcat(
      "Example Problem\n\n",
      "Account: ", account, "\n",
      "Node: ", node, "\n",
      "NodeID: ", string(nodeID), "\n",
      "Time (UTC): ", format_time(timestamp, 'YYYY-MM-DD"T"HH24:MI:SSTZH:TZM'), "\n\n",
      // mention someone in the ticket 
      "CC [~accountid:123abc4567d8e901f2g3h4i5]")

7. In the Monitor section under Description, select description as the field to identify the Notification.

8. Select title as the Notification Kind.

9. In the Primary Key field, select description and title.

10. In the Notification section under Grouping, select Informational.

11. From the list of Channels, select the Channel you previously created, Test Jira.

12. For the Monitor Name, enter Jira Tickets.

13. Click Save.