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

How to Get Help

  1. You are here:
  2. Handbook
  3. Support Team Handbook
  4. Support Workflows
  5. How to Get Help

Getting Help on a Ticket

When working on tickets, collaboration is critical, especially when troubleshooting complex issues, or technical areas of focus that fall outside of your experience level. Asking for help means having a low level of shame, and also shows that you are putting the customer first because you are working towards resolving their problem.

How to Get Help Workflow

If you are stuck on a ticket, the following workflow seeks to help Support Engineers realize and utilize all of the resources available to progress a ticket to resolution. This workflow lists some common resources, you can lean on to get the help you need.

If you’re stuck on a ticket…..

Identify what's causing you to get stuck. Some examples are:

Then consider these options to help unblock you. And remember that escalating to unblock is an operating principle of Results.

  1. Ask in your group's Slack channel for help. You might get all the help you need in responses right there, or you might open up the group's Zoom room for an impromptu pairing session to work on the ticket. And remember:
    1. Be sure to provide a link to the ticket
    2. Be specific about the help you need
      • For example: "Kubernetes Runner help needed: user is running into X error, logs are saying Y, and we've tried Z. What else could it be?"
  2. Ask for help in one of the broader relevant Support Slack channels. In addition to the Slack reminders above, also:
    • Check the Skills by Subject Support page to see who might have the skills to assist. Mention those people in the thread and in the ticket to let them know you think they can help.
  3. Ask for help in the appropriate DevOps Stages Slack channel, or reach out to the Support Stable Counterpart for the appropriate product area. If you are unsure which product area it is, ask your group or a manager for guidance.
    • For example, if you need help with a runners issue, ask for development support in the runners Slack channel, or reach out to the Support stable counterpart(s) that are listed under the runner group section.
  4. Attend crush or help sessions such as those noted below (see the GitLab Support calendar for times):
    • AMER Senior SE Help Sessions
    • APAC/AMER or EMEA/AMER crush sessions
    • APAC or EMEA crush / collaboration sessions
    • Senior Support Office Hours (varying times)
  5. Initiate a Branch Out session
    • This is like a crush session, with the specific intention of helping 1 or 2 groups with FRTs
  6. If you're struggling to get help, reach out to your manager, the manager on-call, or any available manager. They will help you to determine next steps. Please know that there will always be somebody who can help, even if you're having a hard time finding them. Please do not let this deter you from asking for help any time you need it.

How to Use GitLab.com to Formally Request Help from the GitLab Development Team

Starting from 2022-06-13 the Support Team and the Development Team are rolling out a series of projects that will enable support engineers to request help from a GitLab Development group, for more information on this please review the associated proposal. The aim is to provide a formal and accountable workflow process for Support Engineers to request assistance from the various Development Sections for any technical issues which they are currently unable to progress. Please note that this is an iterative process, which aims to roll out the process for each of the 10 development sections at GitLab. If the Development Section that you require assistance from is not listed in the table below then please continue to use the existing methods for contacting the relevant Development Teams, such as Slack.

Development Section Section Product and Group Breakdown Link to the GitLab Project for requesting help
Ops Section Ops Section Breakdown Section Ops Request for Help
Dev Section Dev Section Breakdown Section Dev Request for Help
Sec Section Sec Section Breakdown Section Dev Request for Help

The steps for submitting a help request are as follows:

  1. Review the above table and click the link to open the corresponding GitLab.com Development Section Project that you require help from.
  2. Within each GitLab Project there is a ReadMe (displayed on the project page):
    1. Read the Support Engineer User Guidance section and follow the steps outlined.
    2. Read the Development groups and their corresponding templates section and use the Handbook links provided if you are unsure as to which Section Sub Group and corresponding template you should use.
  3. Before submitting a new issue search the existing issues to check if a similar request has been made before.
  4. If not, then submit a new issue to the project using the template you've identified.
    • The issue will be automatically assigned to the relevant developers for triaging.
  5. If you encounter any problems, such as obtaining a timely response from Development, then please make the corresponding Engineering Manager and John Lyttle aware. You can identify the relevant Engineering Manager by checking the Development Group Handbook Page from each Projects ReadMe Section which provides a section named Development Groups with their corresponding templates and labels
  6. Lastly, prior to closing the issue please review the information within to determine if any of it can be used to update the GitLab documentation, if any of the information is a candidate to be considered for updating the GitLab documentation then add the label documentation::candidate so that the issue can be identifiable for future use. If you have actually updated the GitLab documentation then please add a link to the MR to the issue and add the label documentation::created.
Open in Web IDE View source