Integrate with Rackspace Cloud Monitoring

This article highlights a new alerting feature that's natively available in Jira Service Management which is gradually rolling out to some Jira Service Management Cloud customers. It may not yet be visible or available on your site.

What does the integration offer?

With Rackspace Cloud Monitoring, customers easily monitor their infrastructure whether it’s hosted on-premise, off-premise, with any cloud provider, or any location across the globe.

Send Rackspace Cloud Monitoring alerts to Jira Service Management to leverage the full support of Jira Service Management's notification functionality. Receive Jira Service Management notifications through email, SMS, phone call, iPhone and Android push notifications, enrich alerts with extra information using attachment files, and keep track of the whole alert cycle.

How does the integration work?

When an alert is created in Rackspace, an alerted is automatically created in Jira Service Management through the integration.

Set up the integration

Rackspace is an API integration. Setting it up involves the following steps:

Add a Rackspace integration in Jira Service Management
Configure the integration in Rackspace

Add a Rackspace integration

Bidirectional integrations aren’t supported in Free and Standard plans. All the other integrations are supported at a team level in Free and Standard; however, for their outgoing part to work, you need to upgrade to a higher plan. To add any integration at a site level through Settings (gear icon) > Products (under JIRA SETTINGS) > OPERATIONS, you need to be either on Premium or Enterprise.

Adding an integration from your team’s operations page makes your team the owner of the integration. This means Jira Service Management only assigns the alerts received through this integration to your team.

To add a Rackspace integration in Jira Service Management, complete the following steps:

Go to your team’s operations page.
On the left navigation panel, select Integrations and then Add integration.
Run a search and select “Rackspace”.
On the next screen, enter a name for the integration.
Optional: Select a team in Assignee team if you want a specific team to receive alerts from the integration.
Select Continue.
The integration is saved at this point.
Expand the Steps to configure the integration section and copy the API key.
You will use this key while configuring the integration in Rackspace later.
Select Turn on integration.
The rules you create for the integration will work only if you turn on the integration.

Configure the integration in Rackspace

Rackspace supports email and webhook notification types. Although alerts can be sent via email, Jira Service Management provides a webhook API for Rackspace Cloud Monitoring to create alerts directly in Jira Service Management data centers. To configure the integration of Rackspace with Jira Service Management, complete the following steps:

1. Update the 'webhook_token' of your Rackspace account with the token you copied previously from Jira Service Management.

2. Use the webhook URL you copied previously from Jira Service Management for registering the webhook in Rackspace.

curl -i -X PUT \
-d '{ "webhook_token" : "your_api_integration_key" }' \
-H 'X-Auth-Token: rackspace_auth_token' \
-H 'Content-Type: application/json' \
'https://monitoring.api.rackspacecloud.com/v1.0/1234/account'

3. Create a webhook notification in Rackspace Cloud Monitoring using the https://api.atlassian.com/jsm/ops/integration/v1/json/rackspace URL provided by Jira Service Management API, and use this notification in your notification plans. Specify the users and/or group of users (comma separated) who are notified by Jira Service Management using the "recipients" URL parameter. If not provided, all users are notified.

curl -i -X POST \
-d '{ "details" : { "url" : "https://api.atlassian.com/jsm/ops/integration/v1/json/rackspace?    recipients=john.smith@mycompany.com,operationsgroup" },
  "label" : "jsm web hook",
  "type" : "webhook"
}' \
-H 'X-Auth-Token: rackspace_auth_token' \
-H 'Content-Type: application/json' \
'https://monitoring.api.rackspacecloud.com/v1.0/1234/notifications'

That's all. Now receive Rackspace alerts as SMS, phone calls, iPhone or Android push notifications thanks to Jira Service Management's powerful alerting system. Let's demonstrate the integration with the following simple scenario:

4. Create an entity in Rackspace Cloud Monitoring for a web server running on port 8080.

curl -i -X POST \
-d '{ "ip_addresses" : { "default" : "78.187.83.242" },
  "label" : "My Web Server"
}' \
-H 'X-Auth-Token: rackspace_auth_token' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
'https://monitoring.api.rackspacecloud.com/v1.0/1234/entities/'

5. Then create an http check

curl -i -X POST \
-d' { "details" : {"method" : "GET",
  "url" : "http://78.187.83.242:8080/"
},
  "label" : "web server status check",
  "monitoring_zones_poll" : [ "mzlon" ],
  "period" : "60",
  "target_alias" : "default",
  "type" : "remote.http"
}' \
-H 'X-Auth-Token: rackspace_auth_token' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
'https://monitoring.api.rackspacecloud.com/v1.0/1234/entities/en41F9wnvg/checks'

6. Create Jira Service Management webhook notification

curl -i -X POST \
-d '{ "details" : { "url" : "https://api.atlassian.com/jsm/ops/integration/v1/json/rackspace?recipients=all" },
  "label" : "jsm web hook",
  "type" : "webhook"
}' \
-H 'X-Auth-Token: rackspace_auth_token' \
-H 'Content-Type: application/json' \
'https://monitoring.api.rackspacecloud.com/v1.0/1234/notifications'

7. Create a notification plan using Jira Service Management web hook notification

Text

curl -i -X POST \
-d '{
  "label": "Notification Plan 1",
  "warning_state": [
    "ntWArqzcoK"
  ],
  "critical_state": [
    "ntWArqzcoK"
  ],
  "ok_state": [
    "ntWArqzcoK"
  ]
}' \
-H 'X-Auth-Token: rackspace_auth_token' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
'https://monitoring.api.rackspacecloud.com/v1.0/1234/notification_plans'

8. Create an alarm with a notification plan, for HTTP error codes coming from a web server.

curl -i -X POST \
-d '{ "check_id" : "chTfxuO8lm",
  "criteria" : "if (metric[\"code\"] regex \"^[23]..$\") { return OK } return WARNING",
  "notification_plan_id" : "npMuW2B1YL"
}' \
-H 'X-Auth-Token: rackspace_auth_token' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
'https://monitoring.api.rackspacecloud.com/v1.0/1234/entities/en41F9wnvg/alarms'

When the web server is shut down, Rackspace Cloud Monitoring detects the failure and creates an Jira Service Management alert.

Was this helpful?

It wasn't accurate

It wasn't clear

It wasn't relevant

Still need help?

The Atlassian Community is here for you.

Ask the Community