Workspaces organize monitoring information in Stackdriver Monitoring. A workspace represents a "single pane of glass" through which you can monitor resources important to you, regardless of where they are. In the Stackdriver Monitoring console you see the current Workspace at the top of each page:

Workspace name in console page

Getting a Workspace quickly

You must have a Workspace to use Stackdriver Monitoring. That's why you might see the following dialog when you come to the Stackdriver Monitoring console from the Google Cloud Platform Console. If you do not see the dialog, then you are already using a Workspace.

my-project-12345 is not a Workspace

The quickest way to get a Workspace that monitors this project is to do the following:

  1. Select Create a new Workspace.
  2. Select your GCP project. my-project-12345 should already appear in the text box.
  3. Click Create Workspace.
  4. Skip through the following dialog pages; you don't have to do anything.
  5. Click Launch Monitoring when it appears on the last dialog page.

Your new Workspace, my-project-1234, is ready to use. For detailed instructions, see Creating a single-project workspace.

What is a Workspace?

A Workspace is a tool for monitoring resources contained in one or more GCP projects or AWS accounts. Each Workspace can have between 1 and 100 monitored projects, including one or more GCP projects and any number of AWS accounts. You can have as many Workspaces as you wish, but GCP projects and AWS accounts cannot be monitored by more than one Workspace.

A Workspace contains the custom dashboards, alerting policies, uptime checks, notification channels, and group definitions that you use with your monitored projects. A Workspace can access metric data from its monitored projects, but the metric data and log entries remain in the individual projects.

The hosting project

The first monitored GCP project in a Workspace is called the hosting project and it must be specified when you create the Workspace. The name of that project becomes the name of your Workspace. The following diagram shows a Workspace A that monitors just its hosting project, A:

Single-project Workspace

Monitored projects

After you have a Workspace, you can add more GCP projects and AWS accounts to it. For instructions, see Adding monitored projects.

If you plan to monitor more than just your hosting project, then the best practice is to use a new, empty GCP project to host the Workspace and then to add the projects and AWS accounts you want to monitor to your Workspace. This lets you choose a good name for your hosting project and Workspace, and gives you a little more flexibility in moving monitored projects between Workspaces. The following diagram shows a Workspace W monitoring GCP projects A and B, and AWS account D:

Multi-project Workspace

AWS Connector projects

You see in the preceding diagram that there is a GCP project that connects your monitored AWS account to the Workspace. Monitoring creates this AWS connector project when you add an AWS account to a Workspace. The connector project has a name beginning AWS Link, and it has the same parent organization as the Workspace. To get the name and details about your AWS connector projects, see Inspecting Workspaces on this page.

The billing account associated with the AWS Connector project is used for Stackdriver Monitoring and Stackdriver Logging charges for the AWS account. For more information, see Billing on this page.

In the GCP Console, AWS connector projects appear as regular GCP projects. Do not use connector projects for any other purpose, and do not delete them while your Workspace is still connected to their AWS account.

Inspecting Workspaces

The Manage Workspaces page of the Stackdriver Monitoring console shows all your Workspaces. To go there, click this button:

Go to the Manage Workspace page

By clicking a Workspace's name on that page, you make that the current Workspace. By clicking Edit, you can see detailed information about any Workspace and its monitored projects.

Outside of Stackdriver Monitoring, you cannot see Workspaces. You only see a Workspace' hosting project, which has the same name.


There is no charge for creating Workspaces. Logging and metric data are ingested by the individual monitored projects, so any charges are associated with the billing accounts of the monitored projects. For AWS accounts, this means the billing accounts of the AWS connector projects.

For more information, see Stackdriver Pricing.

Next steps

Was this page helpful? Let us know how we did:

Send feedback about...

Stackdriver Monitoring