Back to Gitlabhq

GitLab Dedicated instance details

doc/administration/dedicated/tenant_overview.md

19.0.03.9 KB
Original Source

{{< details >}}

  • Tier: Ultimate
  • Offering: GitLab Dedicated

{{< /details >}}

The Switchboard Overview page shows the current state of your GitLab Dedicated instance, including its status and maintenance schedule. Sign in to Switchboard to view your instance details.

The page displays:

  • Instance status
  • Tenant URL
  • GitLab version
  • Reference architecture
  • Total purchased storage
  • Maintenance window
  • Primary AWS region and availability zone IDs
  • Secondary AWS region and availability zone IDs
  • Backup AWS region
  • Tenant AWS account ID
  • Hosted runners (if configured)

Instance status indicators

StatusSeverityImpactDescription
NormalNoneNo active incidents.No known issues with your GitLab instance.
Degraded performanceS2Core GitLab functionality is significantly impacted.GitLab services may be slow or unresponsive.
Service disruptionS1One or more services required to run GitLab are fully down.GitLab services may be unavailable.
Under maintenanceN/AMaintenance is in progress.GitLab services may be disrupted.

Switchboard does not display:

  • S3 and S4 incidents, which have minimal impact on your instance.
  • Incidents in non-impacting lifecycle stages, such as incidents being reviewed, documented, or canceled.
  • Merged incidents, where only the primary incident displays when multiple alerts are consolidated.

Status indicators are informational only and are not factored into SLA calculations. Status updates typically appear within one to two minutes of an incident state change.

If you see a Degraded performance or Service disruption status, the GitLab team is already aware and working on the issue. You do not need to open a support ticket unless your workflows require specific assistance. Statuses automatically update as the incident progresses.

If you are experiencing issues but the status displays Normal, the issue might be specific to your configuration or usage patterns. Open a support ticket and include details about what you are experiencing and when the behavior started.

Maintenance

Switchboard displays a maintenance indicator when your instance is undergoing maintenance. Both maintenance types display the Under maintenance status.

Maintenance typeWhen it appears
Scheduled maintenanceDuring your scheduled maintenance window. For more information, see access during maintenance.
Emergency maintenanceDuring unplanned, urgent maintenance outside your scheduled window. For more information, see emergency maintenance.

If an incident occurs during maintenance, both the maintenance indicator and the instance status indicator appear.

The Overview page also displays the:

  • Next scheduled maintenance window and upcoming GitLab version upgrade
  • Most recent completed maintenance window
  • Most recent emergency maintenance window (if applicable)

Every Friday morning in UTC, Switchboard updates to display the planned GitLab version upgrades for the upcoming week's maintenance windows. For more information, see maintenance windows.