Gitlab hero border pattern left svg Gitlab hero border pattern right svg

GitLab Support On-Call Guide

For the customers that have Priority Support, the Support Engineering Team is on-call and available to assist with emergencies. What constitutes an emergency is defined in our definitions of support impact.

We take on-call seriously. There are escalation policies in place so that if a first responder does not respond fast enough another team member or members is/are alerted. Such policies aren't expected to ever be triggered, but they cover extreme and unforeseeable circumstances.

Expectations for on-call

Be alert and available

When you are on call you are expected to be available and ready to respond to PagerDuty pings as soon as possible, but certainly within the emergency response time set by our Service Level Agreements.

If you have plans outside of your work space while being on call, then being available may require bringing a laptop and reliable internet connection with you.

You should not be chained to your desk, but you should be equipped to acknowledge and action on PD alerts in a timely manner.

Be proactive in communicating your availability. Sometimes you can't be immediately available for every minute of your on-call shift. If you expect to be unavailable for a short period of time, send an FYI in Slack.


When you get an alert, you should immediately start a Slack thread and take notes within. Tag the Technical Account Manager (TAM) - something like "cc @user" is good enough - if the customer has one. This creates visibility around the situation and opens the door to let the team join in.

Good notes in Slack will help people follow along and will help you with your follow-up email after the call.

Try to communicate complete ideas rather than snippets of thought. Something like "that's not good" as a response to something happening within the call isn't as helpful as "their gitaly timings are really high".

Take and share screenshots of useful info the customer is showing you. Make sure you're not sharing anything sensitive. Let the customer know that you're doing that. "Could you pause there? I'm gonna screenshot this little bit and share it with my team".

Assume good intent

If the nature of the problem mentioned in the emergency ticket doesn't meet its definition of support impact, inform the customer's technical account manager (if they have one) or a support manager. Unless they ask you to do otherwise, however, continue to treat the ticket with the emergency SLA.

We like to assume good intent by the customer. Even though we may not think a particular ticket qualifies for emergency support, we'll treat all emergency pages from customers with priority support as if they qualify. During any crisis, the customer may be incredibly stressed and have immense pressure on them. We should be helpful when we can and, if we determine that their ticket doesn't qualify as an emergency after the call is over, the customer's technical account manager or a support manager can discuss it with them afterwards.

Ask for help when needed

Rest assured that escalation is okay, and that other GitLabbers are happy to help. The care of the customers is a shared responsibility. Tag the support team if you haven't started getting help in your Slack thread. Tag the support managers if you need to escalate further.

If another support engineer joins your emergency call, feel free to assign them a role to divide up the labor.

So and so would you please (take notes, reach out to this product team and ask for help, look up the code for this and see what you can find)?

Take care of yourself

Make an effort to actively de-stress during your on-call shift. After being on-call you should consider taking time off, as noted in the main handbook. Being available for issues and outages will wear on you even if there were no pages. Resting is critical for proper functioning. Just let your team know.

When you're in a call, don't feel too much pressure to have immediate answers. You're allowed to pause for a few minutes for researching, asking for help, etc. A five minute reply is still much better than waiting for SLA email replies. Make sure to communicate and let the customer know what you're doing. Example: "I'm gonna take a few minutes to work through the code here and make sense of it".

How it works


We do 7 days of 8-hour shifts in a follow-the-sun style, based on your location.

You can view the schedule and the escalation policy on PagerDuty. You can also opt to subscribe to your on-call schedule, which is updated daily.

Your first on-call

For new team members approaching their first on-call schedule, the Support onboarding issue already includes a section suggesting that you shadow a current on-call period to gain familiarity with the process. After completing this, consider your preferred approach to on-call and discuss with your manager how you feel about it and if you'd like to work with a partner during on-call weeks. For the first week we recommend asking your buddy / trainer to be available as a secondary to help if an emergency comes in.

Make the schedule work for you (working with a partner)

Your role is to make sure someone is available to respond to emergencies during the week you are scheduled. You should make this work for you by working with others, scheduling overrides etc. You don't have to be at your desk all week! It's OK to take a walk outside if you have your phone and reception. This way you can acknowledge the page and locate someone to help in Slack via your phone.

If you prefer to work with someone as a secondary, discuss with team members or your manager and find partners who like sharing the role. You can then work together during the week and update PagerDuty as you wish (e.g. split days into mornings and evenings, take alternate days, work as a primary and secondary etc). Your manager can play an active role in helping pair people who want to work like this.

Swapping On-Call Duty

To swap on-call duty with a fellow support engineer:

Starting on-call

Please double-check that your alerts are working. You can send a test page to make sure that you're being alerted appropriately.

When your on-call shift starts, you should get some sort of notification(s) that your shift is starting.

PagerDuty Alerts

  1. When an emergency is triggered, you'll receive an alert from PD. This will probably be a text, phone call, email, Slack message, and/or boot to the head (depending on your notification preferences).
  2. Typically, you can find the emergency ticket in Self-managed Premium and Ultimate queue, but in some cases the person raising the emergency may not be associated with an org. You can always use Zendesk search with the term priority: urgent to find the ticket.
  3. Acknowledge the alert in PagerDuty or Slack. This means that you are handling the emergency and are starting to look into it. After 10 minutes, if the alert has not been acknowledged, everyone on the customer on-call rotation is alerted. After a further 5 minutes, management is alerted.
  4. If you're currently an FRT Hawk, ask your team for someone to takeover your duties.
  5. Compare the customer's problem statement with our definitions of support impact. If you don't think that this is an actual emergency, then ask for a second opinion and kindly let the customer know if that's the decision we make.
  6. If the situation is actually an emergency, then please reply to the customer and offer a Zoom call.
  7. Click "resolve" after you've replied to the customer. This means that you are actively handling the emergency now and will see it through.
  8. Start a thread in #support_self-managed with the ticket link. "Thread for emergency ticket LINK HERE".

  9. After 30 minutes, if the customer has not responded to our initial contact with them, let them know that the emergency ticket will be closed and that you are opening a normal priority ticket on their behalf. Also let them know that they are welcome to open a new emergency ticket if necessary.

NOTE: If an emergency ticket comes in via email, successive responses by the client will re-page the on-call engineer. To cut down on this noise, consider opening a non-emergency ticket on behalf of the client and closing the emergency ticket.

Taking a call

Taking a call isn't significantly different from a normal call outside of two unique points:

It's recommended to find someone from the Support team to join the call with you. A second person on the call can take notes, search for solutions and raise additional help in Slack. They can also help you confirm ideas that you can discuss in Slack.

During the call, try to establish a rapport with the customer; empathizing with the situation and setting a communicative tone.

As early as possible, determine your options. In some cases, the best option may be rolling back a change or upgrade. The best option may also involve losing production data. If either of those is the case, it's okay to ask the customer if they see any other options before executing on that plan.


Before getting off the call, make sure that you let the customer know what to do if there is any follow-up and who will be available if any follow-up is required.

For example:

It seems like we've solved the root problem here, but if you need any help I'll be on-call for the next two hours. Feel free to open a new emergency ticket and I'll get back on a call with you right away. If it's after that, it's Francesca who will be responding. I'll make sure that she has the background of the situation before I leave for the day.

Once the call has ended, make sure you write up post-call notes relevant to the customer in a public reply, any internal notes as an internal notes on the ticket and note that you did so when you tag the next on-call engineer in the relevant Slack thread.

Manager On-call

Support Managers also have an on-call rotation. During their rotation, managers will:

Seeing which manager is on-call

To see who the current manager on-call is you can:

Paging the on-call manager

Phone Reimbursement

For the month you are on-call, we enable you to expense the cost of your phone service. This is limited to your service cost itself, not any costs relating to the device or additional services for those in your plan.

In cases where your on-call schedule overlaps between two months (as an example, starts March 30th, ends 5th), your expense should only be counted on one of those months.

Keep in mind, this does not mean you can expense the cost of your phone bill every month. This is only applicable on a month in which you are on-call.