doc/administration/dedicated/tenant_overview.md
{{< details >}}
{{< /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:
Switchboard displays a maintenance indicator when your instance is undergoing maintenance. Both maintenance types display the Under maintenance status.
| Maintenance type | When it appears |
|---|---|
| Scheduled maintenance | During your scheduled maintenance window. For more information, see access during maintenance. |
| Emergency maintenance | During 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 these details:
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.
On the Switchboard Health page, you can see the overall status of your instance and the availability of individual GitLab services included in your SLA.
| Status | Severity | Impact | Description |
|---|---|---|---|
| Normal | None | No active incidents. | No known issues with your GitLab instance. |
| Degraded performance | S2 | Core GitLab functionality is significantly impacted. | GitLab services may be slow or unresponsive. |
| Service disruption | S1 | One or more services required to run GitLab are fully down. | GitLab services may be unavailable. |
| Under maintenance | N/A | Maintenance is in progress. | GitLab services may be disrupted. |
The following incidents do not appear in Switchboard:
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.
In the Covered experiences section, you can see the current availability status, measured from user traffic, for the services defined as covered experiences in the GitLab SLA:
Availability data can differ from declared incidents. Each service shows one of the following states:
When availability data is present, you can also see when it was last updated.
If no availability data exists for your instance yet, the Covered experiences section displays No data yet instead of the list of services.
[!note] This page is informational only. It does not determine compliance with the SLA or your eligibility for service credits. To request service credits, follow the credit request process in the SLA for GitLab Dedicated.
You can retrieve your instance's SLA status programmatically with the Switchboard API. The API is available to Switchboard users with tenant administrator access, and returns data only for the instances you have access to.
The API has a single endpoint that returns the same instance health data the Switchboard Health page displays:
data_as_of timestamp that indicates when the data was last refreshed.You authenticate through Switchboard using an interactive browser sign-in. You can refresh the access token programmatically for up to 30 days without signing in again, after which you must sign in through the browser again.
[!note] API responses are point-in-time snapshots. The API does not return historical or aggregated availability data, and is not intended for alerting. The API does not determine compliance with the SLA or your eligibility for service credits.
The API reference, including an authentication walkthrough and a glossary of status values, is available only to authenticated Switchboard users.
To access the API reference: