LogoLogo
API DocsDeveloper PortalSystem StatusTry for Free
  • Quickstart Guide
    • Introduction
    • Get started as an Account Owner
    • Get started as a User
    • Glossary
    • FAQs
  • Manage Users
    • Types of Users
    • Add and Delete Users
    • Import Users
    • User Permissions - Access Controls
    • Manage Your Profile
    • Notification Rules
    • On-Call Reminder Rules
    • Change Account Owner
  • Manage Teams
    • Understanding Teams
    • Role Based Access Control
    • Owner Based Access Control
    • Create and Delete Teams
    • Add and Remove Team Members
    • Squads
    • Stakeholder Groups
  • Services
    • Adding a Service
    • Service Overview
    • Service Graph
    • Maintenance Mode
    • Alert Deduplication Rules
      • Alert Deduplication Rules
      • Incident Status Based Deduplication
      • Service Dependency Based Deduplication
      • Key Based Deduplication
    • Event Tagging
    • Alert Routing
    • Alert Suppression
    • Custom Content Templates
    • Intelligent Alert Grouping (IAG)
    • Auto Pause Transient Alerts (APTA)
    • Delayed Notifications
  • Schedules
    • Schedules
      • Adding a Schedule
      • Schedules Overview
      • Who is On-Call?
      • My On-Call Shifts
      • Overrides
      • Videos: How to set up common use cases?
  • Escalation Policies
    • Create and Manage Escalation Policy
    • Round Robin & Advanced Escalations
    • Reassign an Incident
  • Notifications
    • Understanding Incident Notifications
  • Dashboards
    • Incident Management Dashboard
    • Dashboard Metrics
    • Take Bulk Actions
    • Squadcast Search
  • Incident List
    • Incident List View
    • Incident Priorities
    • Filter Incidents
    • Save Filter View
    • Merge Incidents
    • Snooze Incidents
  • Incidents Page
    • Incidents Details
    • Incident Activity Timeline
    • Communication Channels
    • Create Incident Manually
    • Incident Notes
    • Incident Watchers
    • Past Incidents
    • Additional Responders
    • Incident Summaries
    • Incident Suggestions
  • Runbooks
    • Runbooks
  • Postmortems
    • Postmortem Templates
    • Create Postmortems
    • Accessing Postmortem
  • Status Page
    • Status Page
    • Status Page Overview
    • Components and Groups
    • Issues
    • Subscribers
    • Maintenance
  • SLO Tracker
    • SLO Basics
    • Configure and Monitor your SLOs
  • Webforms
    • Webforms
  • Global Event Rulesets
    • Global Event Rulesets
  • Workflows
    • Workflows
    • Workflows Overview
    • Actions
  • Live Call Routing
    • Live Call Routing
  • Analytics
    • Analytics (New)
    • Organization Level Analytics
    • On Call Hours Per User
    • Weekly Reports
  • Integrations
    • Incident Webhook (Incident Webhook/API)
    • Outgoing Webhooks
    • ServiceNow Extension
    • Extensions
      • Jira Cloud Integration
      • Jira DC (Data Center)
      • CircleCI
      • Google Chat
      • Freshdesk
      • Freshservice
      • Asana
      • ClickUp
      • Trello
      • Zendesk
      • Hubspot
    • Alert Source Integrations (Native)
      • Admin Labs
      • Airbrake
      • Amazon EventBridge
      • Amazon GuardDuty
      • Amazon Opensearch
      • APImetrics
      • AppDynamics
      • AppSignal
      • Auvik
      • AWS CloudTrail Logs
      • AWS CloudTrail via CloudWatch
      • Amazon Cloudwatch (AWS) Integration
      • AWS CloudWatch Event Rules
      • AWS Elastic Beanstalk via CloudWatch
      • Amazon RDS (AWS)
      • Amazon SNS (AWS)
      • Azure Monitor
      • Better Uptime
      • Bitbucket
      • Bitrix 24
      • Blue Matador
      • Bugsnag
      • Buildkite
      • Checkly
      • Checkmk
      • CircleCI Integration
      • Cisco DNAC
      • Cisco Meraki
      • ClickUp Integration
      • CloudAMQP
      • Cloudflare
      • Conviva
      • CopperEgg
      • Coralogix
      • Cronitor
      • Crowdstrike Falcon
      • Datadog
      • Databricks
      • Dead Man's Snitch
      • Domotz
      • Dotcom Monitor
      • Dynatrace
      • ElastAlert
      • Elastic
      • Elecard Boro
      • Email Integration
      • Endtest
      • Errorception
      • Freshdesk Integration
      • Freshping
      • Freshservice
      • Ghost Inspector
      • GitHub Integration
      • GitLab
      • Grafana 8
      • Grafana
      • Graylog v4
      • Graylog
      • HaloPSA
      • Healthchecks
      • Heroku
      • HetrixTools
      • Honeybadger
      • Honeycomb
      • Humio
      • Hund
      • Hydrozen
      • Hyperping
      • Icinga2
      • InsightOps (LogEntries)
      • Instana
      • Intercom
      • Jenkins Integration
      • Jira Cloud Alert Source
      • Jira Server Alert Source
      • Kapacitor
      • Kentik
      • Komodor
      • Kibana
      • LibreNMS
      • Linear
      • Loggly
      • Logstash
      • Logz.io
      • ManageEngine Application Manager
      • ManageEngine Opmanager
      • Mezmo (formerly LogDNA)
      • MongoDB Atlas / Cloud Manager
      • Nagios
      • New Relic
      • Nixstats
      • NodePing
      • Observium
      • Oh Dear
      • Oracle Cloud Infrastructure
      • OSNexus QuantaStor
      • OverOps
      • Papertrail
      • Pingdom
      • Plesk 360
      • Postman
      • Postmark
      • Powercode
      • Progress WhatsUp Gold
      • Prometheus
      • PRTG Network Monitor
      • Rapid7 InsightIDR
      • RapidSpike
      • Redash
      • Redgate SQL Monitor
      • Rollbar
      • Rundeck
      • Runscope
      • Salesforce Cloud
      • Scout APM
      • Sematext
      • Sensu Go
      • Sensu
      • Sentry.io
      • Server Density
      • ServerGuard24
      • ServiceNow Integration
      • Shortcut (Clubhouse)
      • SignalFx
      • SigNoz
      • Site24x7
      • Slack
      • SolarWinds AppOptics
      • SolarWinds Observability SaaS (SWO)
      • SolarWinds Observability Self Hosted
      • Sonar
      • Splunk
      • Sqreen
      • Stackdriver
      • Stackify Retrace
      • StatHat
      • StatusCake
      • ServiceDesk Plus OD
      • Sumo Logic
      • Sysdig Monitor
      • Threat Stack
      • Trello
      • Twilio
      • Uptime
      • Uptime Robot
      • Uptrends
      • Wavefront
      • Zabbix 5.0
      • Zabbix 6.2
      • Zabbix
      • Zendesk Integration
      • Zoho Desk
      • Zoho Desk via Zoho Flow
      • LogicMonitor
  • ChatOps
    • Google Chat
    • Microsoft Teams
    • Slack for Incident Management
      • Using the Integration
  • Single Sign-On (SSO)
    • AWS SSO
    • Azure Active Directory SSO
    • Google SSO
    • Microsoft ADFS SSO
    • Okta SSO Integration
    • SAML 2.0 based SSO
  • Mobile App
    • Using the Mobile App
  • Terraform & API Documentation
    • Terraform Provider
    • Public API - Refresh Token
    • API Documentation
    • Getting Started with Squadcast GraphQL
      • Schedules
        • Create Schedule
        • Update Schedule
        • Delete Schedule
        • Pause Schedule
        • Get Schedules
        • Get Schedule by ID
        • Resume Schedule
        • Clone Schedule
        • Get Gaps
      • Rotations
        • Create Rotation
        • Update Rotation
        • Delete Rotation
        • Get Rotation by ID
        • Get Rotation Events by ID
      • Overrides
        • Create Override
        • Update Override
        • Delete Override
        • Get Override by ID
      • Calendar URLs
      • Who is On-Call
    • Developer Portal
    • Incident Rate Limiting
  • Managing your Squadcast Account
    • Audit Logs
    • Organizations
    • Billing FAQs
    • Deactivate your Squadcast Account
    • Delete your Squadcast Account
Powered by GitBook
On this page
  • Prerequisites
  • Configuring the Extension
  • Usage of the Automatic and Manual Modes
  • Automatic mode
  • Manual mode
  • Using Tags to Configure Jira Project and Issue Priority

Was this helpful?

  1. Integrations
  2. Extensions

Jira DC (Data Center)

Jira incident management - Automatically create and manage incidents through the Jira Data Center, using Squadcast.

PreviousJira Cloud IntegrationNextCircleCI

Last updated 11 months ago

Was this helpful?

You can use this extension guide to install and configure the Squadcast extension in JIRA Data Center in order to automatically create issues in JIRA projects from Squadcast and vice versa. The status of the issues on JIRA and incidents in Squadcast will automatically be in sync.

Important:

Jira DC extension will not be supported in the EU data center.

Prerequisites

  1. A valid Squadcast cloud subscription or a trial account (in the Pro, Premium or Enterprise )

  2. You should have JIRA DC version installed on your machine with a publicly accessible URL

  3. A user account in JIRA DC with Administrator privileges

  4. Base URL must be set in JIRA settings and it must be publicly accessible as mentioned above

  5. Only the Account Owner and Users with the Manage Extensions permission will be able to enable, disable and manage Extensions in Squadcast

  6. Install the Squadcast Plugin from the

Configuring the Extension

  1. In Squadcast, navigate to Settings and select the Extensions tab from the left navigation sidebar. Move over to the JIRA Cloud extension and click on Integrate

  1. Now click on Configure to receive a token

  1. Copy the displayed token

  2. Go to the Manage Apps page on your JIRA DC Account from the Settings drop-down

  1. Select the Squadcast Plugin from the User-installed apps and Click Configure

  2. In the configuration page, paste the Squadcast token in the JIRA Integration Key text box. Then click Integrate

  1. Move over to Squadcast and click on Test Connection. You will then receive a success message right below the text box. Post this, click on Next

  1. Select the Jira project in which the issue needs to be created and select the issue type and click Next

  1. Then map the Jira issue status to the available Squadcast statuses and click Next

  1. Then select the mode in which you want to add an incident to Jira: Manually or Automatically

Now, there are 2 sections:

  • Add Services to Jira

  • JQL - Service Mapping

Add Services to Jira: If an incident is created for any service selected in this section, a corresponding Jira ticket would be created in the configured project having the configured issue type.

JQL - Service Mapping: If a ticket is created in Jira, then the mappings defined in this section would be iterated one by one and an incident would be created for the service corresponding to the first JQL that is evaluated to be true for that Jira ticket. If none of the JQL matched, then no incident would be created in Squadcast.

Note:

Make sure that the issue priority is enabled for issues in Jira in order to create incidents in Squadcast.

So, to summarize:

Add Services to Jira: Handles Jira ticket creation corresponding to incident creation in Squadcast.

JQL - Service Mapping: Handles Squadcast incident creation corresponding to ticket creation in Jira.

That’s it! Your JIRA DC Integration is good to go.

The statuses of the Squadcast Incident and JIRA Issue will be automatically synced as per the mapping configured.

Note:

Incidents in Squadcast created for issues in Jira using the Jira plugin will not have a status sync.

Note:

If the Squadcast incident reaches either Resolved or Suppressed status, the bidirectional status syncing will stop even if the issue is re-opened in JIRA, as these both are end states in Squadcast.

Note:

The default directory for user creation should be Jira Internal Directory. If the squadcast user gets created in any other directory apart from Jira Internal Directory, you will have to move the user to the Jira Internal Directory by following the steps below:

Usage of the Automatic and Manual Modes

Automatic mode

If you have chosen the Automatic mode while configuring Jira DC then you need not do anything. Any incident triggered for the selected service will automatically create an issue in the selected Jira project with the configured issue type.

Manual mode

If the chosen mode is Manual, follow the below steps to create an issue in Jira.

  1. Open the incident in Squadcast and click on the More Actions button

  1. Select Jira DC action and click on the Create a new ticket in Jira button

An issue will be created in the selected Jira project with the configured issue type and this action will be recorded in the incident timeline with a hyperlink to the created Jira issue.

Similarly, if there was an error in creating a ticket in Jira, it will be reflected in the Incident Timeline.

Note

Ensure to check the permissions associated with Squadcast user. To do this, go to System > Admin Helper > Permission Helper. Choose Squadcast in the User drop-down and validate if permissions - Browse Project, Create Issue, Transition Issue, Resolve Issue exist. If not, then add these permissions to the user group that Squadcast user is a part of. This information can be checked under System > User Management.

Using Tags to Configure Jira Project and Issue Priority

Note

Currently to use multiple Jira projects your status mappings need to be the same for all your Jira projects. We will be using the status mapping you configured in the `Map Status` section of the configuration.

(1) Create a tagging rule that helps you set the priority and configure the Jira project for an incident in Squadcast by using the tags:

  • priority- Jira Priority

  • issuetype - Issue Type Name

  • project- Project Key

Now the Jira ticket will be created based on the tag values

Tags are Case Sensitive

The values of all the tags are case-sensitive. Use the same case which has been used in Jira.

Example of configuring the Tags using Tagging Rules

Note

Setting project and issuetype for your configured service will override your mapped project and issuetype configuration for that particular service.

Also, make sure to use both project and issuetype tags for creating your issue in a project different from the mapped one.

The issue must be in the same Jira project and be the same Jira Issue type. If you are using the Jira Service Desk, incidents are created from JQL before are applied.

1. Delete the squadcast user that was created post the integration. 2. Then, add a new user. The username should be squadcast and the password should be the token that is available in . 3. Kindly ensure that you have selected Jira Internal Directory from the dropdown while creating the user.

You can use to map your issue priority and project by following the steps below :

Have any questions? .

automation rules
step 2 here
Tagging Rules
Ask the community
plans
Atlassian App Store
Select manage apps option on JIRA server account