gitlab-org--gitlab-foss/doc/user/operations_dashboard/index.md

---
stage: none
group: unassigned
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
---

# Operations Dashboard **(PREMIUM)**

The Operations Dashboard provides a summary of each project's operational health,
including pipeline and alert status.

To access the dashboard, on the top bar, select **Menu > Operations**.

## Adding a project to the dashboard

NOTE:
For GitLab.com, you can add your project to the Operations Dashboard for free if
your project is public. If your project is private, the group it belongs to must
have a [GitLab Premium](https://about.gitlab.com/pricing/) plan.

To add a project to the dashboard:

1. Ensure your alerts
   [populate the `gitlab_environment_name` field](../../operations/metrics/alerts.md#external-prometheus-instances).
   In GitLab 13.9, you can display alerts for the `production` environment only.
1. Click the **Add projects** button in the home screen of the dashboard.
1. Search and add one or more projects using the **Search your projects** field.
1. Click the **Add projects** button.

Once added, the dashboard displays the project's number of active alerts,
last commit, pipeline status, and when it was last deployed.

The Operations and [Environments](../../ci/environments/environments_dashboard.md) dashboards share the same list of projects. Adding or removing a project from one adds or removes the project from the other.

![Operations Dashboard with projects](img/index_operations_dashboard_with_projects.png)

## Arranging projects on a dashboard

You can drag project cards to change their order. The card order is currently only saved to your browser, so it doesn't change the dashboard for other people.

## Making it the default dashboard when you sign in

The Operations Dashboard can also be made the default GitLab dashboard shown when
you sign in. To make it the default, visit your [profile preferences](../profile/preferences.md).
Add latest changes from gitlab-org/gitlab@master 2020-10-29 17:08:54 -04:00			`---`
			`stage: none`
			`group: unassigned`
Add latest changes from gitlab-org/gitlab@master 2020-11-26 01:09:20 -05:00			`info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments`
Add latest changes from gitlab-org/gitlab@master 2020-10-29 17:08:54 -04:00			`---`

Changing badges to use parentheses not brackets Previously, we used brackets to denote the tier badges, but this made Kramdown, the docs site Markdown renderer, show many warnings when building the site. This is now fixed by using parentheses instead of square brackets. This was caused by [PREMIUM] looking like a link to Kramdown, which couldn't find a URL there. See: - https://gitlab.com/gitlab-com/gitlab-docs/merge_requests/484 - https://gitlab.com/gitlab-org/gitlab-ce/issues/63800 2019-07-08 04:50:38 -04:00			`# Operations Dashboard (PREMIUM)`
Docs: Merge EE doc/user to CE 2019-05-05 09:07:20 -04:00
			`The Operations Dashboard provides a summary of each project's operational health,`
			`including pipeline and alert status.`

Add latest changes from gitlab-org/gitlab@master 2021-06-10 11:10:14 -04:00			`To access the dashboard, on the top bar, select Menu > Operations.`
Docs: Merge EE doc/user to CE 2019-05-05 09:07:20 -04:00
			`## Adding a project to the dashboard`

Add latest changes from gitlab-org/gitlab@master 2020-12-04 16:09:29 -05:00			`NOTE:`
Clarify permissions for Operations dashboard 2019-06-25 11:04:28 -04:00			`For GitLab.com, you can add your project to the Operations Dashboard for free if`
			`your project is public. If your project is private, the group it belongs to must`
Add latest changes from gitlab-org/gitlab@master 2021-01-28 13:09:27 -05:00			`have a [GitLab Premium](https://about.gitlab.com/pricing/) plan.`
Docs: Merge EE doc/user to CE 2019-05-05 09:07:20 -04:00
			`To add a project to the dashboard:`

Add latest changes from gitlab-org/gitlab@master 2021-01-25 07:09:07 -05:00			`1. Ensure your alerts`
			[populate the `gitlab_environment_name` field](../../operations/metrics/alerts.md#external-prometheus-instances).
			In GitLab 13.9, you can display alerts for the `production` environment only.
			`1. Click the Add projects button in the home screen of the dashboard.`
Docs: Merge EE doc/user to CE 2019-05-05 09:07:20 -04:00			`1. Search and add one or more projects using the Search your projects field.`
			`1. Click the Add projects button.`

Add latest changes from gitlab-org/gitlab@master 2020-11-19 22:09:15 -05:00			`Once added, the dashboard displays the project's number of active alerts,`
Docs: Merge EE doc/user to CE 2019-05-05 09:07:20 -04:00			`last commit, pipeline status, and when it was last deployed.`

Add latest changes from gitlab-org/gitlab@master 2019-11-19 16:06:22 -05:00			`The Operations and [Environments](../../ci/environments/environments_dashboard.md) dashboards share the same list of projects. Adding or removing a project from one adds or removes the project from the other.`

Docs: Merge EE doc/user to CE 2019-05-05 09:07:20 -04:00			`![Operations Dashboard with projects](img/index_operations_dashboard_with_projects.png)`

Add latest changes from gitlab-org/gitlab@master 2019-11-11 13:06:27 -05:00			`## Arranging projects on a dashboard`

Add latest changes from gitlab-org/gitlab@master 2020-11-19 22:09:15 -05:00			`You can drag project cards to change their order. The card order is currently only saved to your browser, so it doesn't change the dashboard for other people.`
Add latest changes from gitlab-org/gitlab@master 2019-11-11 13:06:27 -05:00
Docs: Merge EE doc/user to CE 2019-05-05 09:07:20 -04:00			`## Making it the default dashboard when you sign in`

			`The Operations Dashboard can also be made the default GitLab dashboard shown when`
			`you sign in. To make it the default, visit your [profile preferences](../profile/preferences.md).`