Inside Atlassian: How IT & SRE use ChatOps to run incident management

| February 08, 2016

Any team that slings code for a living deals with service issues. They know all too well the hated red alert… the dreaded text in the middle of the night… the loathsome ping from a coworker telling them that $#!π just hit the fan. But what separates good services from great services is the ability to recover swiftly with minimal affect on users. And a big factor in swift recovery is ChatOps.

All teams that build and run software should have a process for dealing with incident management – it’s part of the job. The more the software community shares these best practices, the better everyone is at dealing with them. So we wanted to share some of the ways we deal with incidents here at Atlassian using ChatOps.


We use our own products, as well as many others, to run incident management when a service is in trouble. With new developments in HipChat’s API, Atlassian site reliability engineering (SRE) teams are taking their ChatOps practice to a new level. Here’s how they do it.

A bit about our SRE team

Following a continuous delivery model, our engineering teams push code to production several times a day. Our products run in the cloud and rely on a matrix of other cloud tools working together. So we rely on our SRE teams (yes, plural: most products and a handful of web properties have dedicated SREs) to monitor production health at the macro level so we can resolve incidents promptly. And they, in turn, rely on JIRA Service Desk as their ticketing system. As soon as an incident arises, they create an issue to track the status, the work being done, and, ultimately, the resolution.

Our SRE teams use HipChat as the base of operations for all reliability issues: bugs, site crash, alerts, asteroid, whatever. Because they use a wide range of tools – JIRA Software, JIRA Service Desk, Datadog, PagerDuty, StatusPage, and more – having HipChat as the hub keeps our SRE teams focused on the task at hand.

While the particulars of each incident are different, the ChatOps approach to incident management follows the same basic steps each time.

Step 1: Determine there is an issue

Usually issues start to appear in the teams’ chat rooms as alerts from integrated tools like Datadog, PagerDuty, JIRA Service Desk, or StatusPage. Without chat, this process is much slower and harder. It might take several minutes (or an hour) for the right people to realize something is amiss and come together to discuss. Even then, the team can’t easily share what they are doing to diagnose the issue, which drags things down even further.

We measured this internally and found a 5x improvement in the speed of response when using chat to resolve the incident, versus before we adopted ChatOps.

Resources to Get Started

New to HipChat? Sign your team up for free.

Then, install add-ons in team rooms:

Step 2. Evaluate the severity of issue in your chat room

As alerts and tickets start to show up, everyone on the team sees them, and immediately starts discussing – transparency and information flow is a major benefit of chat-driven incident response.

As a group, they verify whether the incident is being handled appropriately, or needs escalation. They often share charts, graphs, and tickets in their chat room to lend more context to the discussion.

Pro Tip

Make sure every team has their own HipChat room. Set notifications to “normal” so you’re always alerted when a teammate mentions your name or the entire room.

Note: Per-room notifications are available in HipChat for Web and Windows. They will be available in Mac and Linux soon.

Step 3: Create a “hot room” or an incident-specific chat room

All Atlassian teams’ HipChat rooms are connected to JIRA Service Desk. Anytime a ticket is filed against a critical component, an automated process kicks off – tight integration for the win!

HipChat creates a new room with the name of the JIRA Service Desk issue, and everyone watching the issue is invited to the room. We call this a “hot room”.

Incident-specific rooms can also be created manually by clicking a button on the JIRA Service Desk issue, as shown below.

HipChat for ChatOps. Incident management for IT Teams

From here, the SRE responder goes into incident-management mode, paging the necessary developers through PagerDuty. The broader team is then invited into the “hot room” where everyone can see in real-time what is happening, who is doing what, and how the incident is being resolved.

Hot rooms typically include a cross-functional group – SRE, engineering, support, IT leadership, product management, product marketing, social media support – each playing a different role in the resolution process. Some are very active in the room, while others are more passive and simply use the room to monitor the state of the incident.

What makes ChatOps so effective is that everyone knows what everyone else is doing – transparent communication leads to faster resolution.

Once inside the room, everyone can reference details about the incident, pulled straight from the JIRA Service Desk issue, in HipChat’s sidebar. They can even move an issue from Open to In Progress to Resolved, or add comments to it, right from HipChat.

Important Reminder

When an incident occurs, your teammates will get alerts with the exact name of the issue (i.e. HOT-330). When a “hot room” is created through JIRA Service Desk, any teammate can search for the issue key to find that room.

Step 4: Make the information come to you & automate routine tasks

It’s hard to work in real-time to solve a problem if the information and reports you need to make a decision aren’t visible inside your chat room. The Bitbucket SRE team, for example, connects Datadog to their team chat room to receive warnings (complete with graphs!) anytime their support site shows signs of trouble. ChatOps helps reduce the endless alt-tabbing needed to work with multiple tools.

HipChat for ChatOps. Incident management for IT Teams

In this sense, their HipChat room is more than a destination – it’s the canary in their coal mine. The sooner they can respond to incidents, the fewer support tickets relating to production help are raised and the more time they can spend making Bitbucket better and better.

Words of Wisdom

This HipChat room becomes your source of truth for information about the incident. ChatOps is not just about automating tasks, but about bringing the info your team needs to make swift decisions straight to you. This way, you’ve bridged the gap between automation and the need for human decision making.

Step 5: Enjoy the historical record you’ve just created

No one wants incidents to happen, but everyone wants them resolved ever-faster. That’s where the chat log comes in. It’s a ready-made transcript of the entire incident, perfect for post-incident review and root cause analysis.

Like all great teams, our SREs know that those who do not understand history are doomed to repeat it. Once an incident is resolved, our team immediately creates a Confluence page that explains exactly what happened, how we responded, and how we could improve next time.

For SREs, ChatOps is about making sure all communication about an incident – graphs, reports, and data analysis – are centralized in a single stream.

By defining a room and using the corresponding JIRA Service Desk issue’s key as the name, they get a single source of truth for incident communications, and get the right people talking about the right issue in real-time. They also have a place to invite internal stakeholders (*ahem* the boss) or other engineers in so they can see all the updates, too.

Best Practice

Once an incident is resolved, our team immediately creates a Confluence page that explains exactly what happened, how we responded, and how we could improve next time. This is shared with the entire company, increasing transparency yet again, and helping other teams learn from the experience.

The next big thing in collaboration

ChatOps keeps teams more productive, and customers happier. And this is just the beginning. Using tools like HipChat, ChatOps’ potential applications stretch far and wide – beyond IT, and into development, support, and even business teams like PR.

The process I’ve described here didn’t pop into existence overnight – our SREs have iterated on this over many months. But it’s not rocket science either.

My hope is that your team can use our current state as your starting point. Keep experimenting, and keep improving. And drop us a line to let us know how it goes.

Share with your team!

Download or share this quick-reference sheet on using ChatOps for incident management, 5 Steps to Resolve Incident 5 Times Faster with ChatOps:

HipChat guide for ChatOps Incident Management

Sign up! If you’re interested in learning how Atlassian’s IT and support teams use ChatOps to provide legendary service, join our webinar and fireside chat with CEO Mike Cannon-Brookes on February 18th. It’s free and open to all!

Special! Hear Atlassian co-CEO, Mike Cannon-Brookes, share his thoughts on ChatOps: