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:
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.
The quickest way to get a Workspace that monitors this project is to do the following:
- Select Create a new Workspace.
- Select your GCP project.
my-project-12345should already appear in the text box.
- Click Create Workspace.
- Skip through the following dialog pages; you don't have to do anything.
- 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
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:
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:
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
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.
The Manage Workspaces page of the Stackdriver Monitoring console shows all your Workspaces. To go there, click this button:
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.
- See Managing Workspaces for step-by-step instructions to create Workspaces and add monitored projects.
- See the Qwiklab on Workspaces. You have to sign up for an account with Qwiklab in order to see the content.
- See Quickstart for Compute Engine or Quickstart for Amazon EC2 to try out Stackdriver Monitoring.