You are here: Diagnose Errors on GitLab.com On this page Overview
This guide provides resources for the diagnosing of
50x errors on GitLab.com. This is used when a user contacts support stating they're receiving an error on GitLab.com. Notes:
For reports of slowness, take a look at
GitLab Grafana Monitor, especially: Worker CPU -> Git CPU Percent Worker Load -> Git Worker Load
Check on the
#alerts, #production, and #incident-management Slack channels to ensure this isn't an outage or infrastructure issue. Workflow
Obtain the full URL the user was visiting when the error occurred.
Search Kibana Login to https://log.gitlab.net/app/kibana Select the correct time filter (top right) - e.g 30 minutes, 24 hours Use the search field to narrow down the results. For example you can search the
gitlab-ee project for any mention of
error using the query
"gitlab-ee" AND "error"
It's recommended to apply a Negative Filter to the logs below, these generate a large amount of noise and may not be relevant to your search.
Kibana guide for more information. Search Sentry Login to https://sentry.gitlap.com/gitlab/gitlabcom/ Use the search field to specify a relevant value. For example the following search would look for any errors with the URL shown that are unresolved.
You can also search by username example
user.username:MyUserName (this is case-sensitive)
You can also select filtering values by clicking the "filter" button . See the Sentry guide for more information. Escalation Gather as much information. Make an internal note on the ticket including links to the logs found in Kibana or Sentry. Search the GitLab-CE project for any related issue. Make a comment in the #Support slack channel with a link to the error or short description of the error. Confirm if the issue is known or unknown. Issue is known - Issue is unknown Response Issue is known If the issue is known it should have a corresponding GitLab project issue.
Respond to the user with information about the cause of the issue, linking to the related GitLab project issues.
Issue is unknown Issues found in Sentry Convert the issue to a GitLab project issue by using the "Create GitLab Issue" button on the issue page. Comment on the issue providing a link to the ZenDesk ticket. Respond to the user with a link to the GitLab project issue. Issues found in Kibana Get a "short url" to the Kibana logs. Create and label a new GitLab-CE issue. Comment on the issue providing a link to the ZenDesk ticket and the Kibana logs. Respond to the user with a link to the GitLab project issue.