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

Working with Tickets

Working with tickets

Services and support

For an overview of the support we provide to customers and users, please see the general support page. What follows is a more detailed description of the levels of service.

Response time indicates the maximum first reply wait time.

We strive to answer tickets faster than the SLA requires. The higher in the list a channel is, the sooner it should be answered.

The SLAs described in GitLab Support Service Levels are based on ticket priority which can be set manually by support agents. See setting ticket priority

Slack premium high priority notification

We use a webhook to get Slack notifications when a high priority premium ticket arrives. It is posted on the #support_self-managed or #support_gitlab-com Slack channel. If you answer the ticket put either a :eyes: or :heavy_check_mark: emoji to let other support engineers know if you're reading or have responded to the ticket.

If you're not sure how to answer the ticket start a thread under the ticket and tag other support engineers to join the discussion.

Handling large files

Zendesk has a maximum attachment size of 20MB per file. Zendesk will not allow us to increase this limit any further.

If you need a customer to share a larger file than this, then see Provide large files to GitLab support for more info on how.

Filling out fields on tickets

Depending on the queue you are working on and the form the ticket belongs to, you might need to fill out some ticket fields manually. Those fields help us capture important data that will help us improve the customer experience. As a high percentage of our tickets are solved/closed automatically through our workflows, it is important to make sure that before you submit your response to a ticket, you check that all required (*) fields and relevant non-required fields have been filled out.

SLA Workflow

Our SLA workflow relies on end-users who submit tickets belonging to an organization and that organization having a GitLab Plan. Organization information is automatically added to Zendesk via a Salesforce Integration. We sync all records with Account Type equal to Customer from Salesforce to Zendesk. The information we get from Salesforce includes but it is not limited to: Account Owner, Technical Account Manager, GitLab Plan and Salesforce ID. Organizations should never be created manually in Zendesk as that can cause our sync to be ineffective. If you think an Account in Salesforce doesn't have an equivalent Organization in Zendesk, please let the Support Operations Specialist know so a manual sync can be run. & GitHost Views Support team members should work on tickets following these views in order:

  1. GitHost (Support Engineers only)
  2. views (Subscribers, Free)

Within a view, tickets should be prioritized based on the SLA time until breach.

Self-Managed Views

Tickets should be picked up in the following order to make sure that SLAs are not breached (maximum SLA wait time exceeded) or (if breached) are addressed as soon as possible, and customers receive the proper level of service:

  1. About to breach Premium tickets (breaches within 2 hours)
  2. About to breach Starter tickets (breaches within 2 hours)
  3. Breached Premium tickets
  4. Breached Starter tickets
  5. High priority Premium tickets
  6. High priority Starter tickets
  7. Medium priority Premium tickets
  8. Medium priority Starter tickets
  9. Low priority Premium tickets
  10. Low priority Starter tickets

This would not apply to those working specialized roles, such as FRT Hawk or SLA Hawk.

Non-Support Views

  1. Security
  2. Upgrades, Renewals & AR (refunds)

Hot Queue: How GitLab Manages Ticket Assignments

Traditional Support teams often use an "assignment" model, where an agent is assigned a ticket and guides the ticket through to completion. If they are stuck, they can re-assign this ticket to another agent to pick up and try and complete. At GitLab though, we take advantage of our global support team and use a system dubbed "Hot Queuing". This system means that we all work from one global queue and it's expected that multiple agents will work together on most issues. This allows us to do the following:

When Should Tickets be Assigned?

There are times in the support process that an agent may need to assign the ticket to themselves:

What if I Can't Answer a Ticket?

If you see a ticket in the queue that you are not able to answer, you should:

With the hot queue, we all work together and no one should be scared to start a ticket.

What if Someone is Working on a Ticket that I’d Like to Work On?

If another agent is looking at a ticket that you’re interested in working on, keep in mind:

If another agent is looking at a ticket that you would like to work on:

If you are working on a ticket, and need some time to research, indicate your involvement by:

Zendesk SLA settings and Breach Alerts

SLAs are set as Business Rules within Zendesk. For more information, please refer to the specific Zendesk page.

We have a slack integration that will notify us for self-managed, if a Premium ticket will breach within an hour, and for, if a Premium ticket will breach within 2 hours. If you see one of these, start a thread and consider this a small emergency. If you need help, draw the attention of other support engineers by tagging them, and work to move the ticket forward.

If a customer's reply is the last one in the ticket, do not set it to any status silently (except for Solved), because the breach clock will continue to run and the ticket may breach silently.

Instead, send a confirmation, greeting, or other message, while also changing the status.

Using on-hold status

You should use the On-hold status when it is necessary to do some internal work, e.g. reproduce a complex bug, discuss something with developers or wait for a session scheduled with a customer. When setting the status to On-hold it will be automatically assigned to you by the trigger Automatically assign on-hold ticket to an agent who put it to the on-hold status. If you think that it should be assigned to someone else (e.g. session is scheduled for another engineer), feel free to re-assign it. Tickets without assignee will be automatically reopened by the trigger Automatically reopen on-hold tickets without assignee. Tickets in on-hold status with an assignee will be automatically reopened in 4 days by the automation Reopen on-hold tickets after 4 days.

If a customer's reply is the last one in the ticket, do not set it to the On-hold status silently due to the same reasons as stated above in the Zendesk SLA settings and Breach Alerts section. Instead, reply to the ticket while also changing the status.

Merging tickets

If you're merging two customer tickets that are related and it's not 100% obvious to the customer, be sure to send a message letting them know why you're merging them. If you don't, it often causes confusion and they open follow ups asking why it was closed without comment.

Additionally, when merging tickets, leave Requester can see this comment unchecked in the ticket that's being merged into (the second ticket from the top) in order to maintain the SLA. If the merge comment is made public it, Zendesk will consider it a response and will remove the SLA.