Managing accounts

This guide explains how to create and manage Stackdriver accounts to monitor your Google Cloud Platform (GCP) projects and your Amazon Web Service (AWS) accounts.

You can create any number of Stackdriver accounts. Associating a GCP project or an AWS account with a Stackdriver account lets you use Stackdriver with that project or AWS account. The Stackdriver account holds configuration and billing information for Stackdriver.

Creating a Stackdriver account

To enable a Cloud Platform Console project to use Stackdriver, create a Stackdriver account hosted by that project. Your project can be empty or it can contain resources such as VM instances or databases.

  1. Go to the Google Cloud Platform Console by clicking the following button:

    Go to the Cloud Platform Console

  2. Select the project you want to enable for Stackdriver in the drop-down menu at the top of the page. Alternatively, create a new Cloud Platform Console project to enable.

  3. In the Cloud Platform Console navigation menu, select Stackdriver > Monitoring to go to the Stackdriver Monitoring Console. You should see the following dialog, with your project's name inserted:

    Your project is not in a Stackdriver account

    If you do not see this dialog and instead see the Stackdriver home page for your project, then your project has already been enabled for Stackdriver and you are finished.

  4. Select Create a new Stackdriver account and click Continue. You see the following dialog:

    Create Stackdriver account

  5. Verify that the project in the text box—your-project-000—is the one you want to enable. Alternatively, select another project by clicking the Close icon in the text box and then using the drop-down project menu.

    Optional: You can also get to the Create a Stackdriver Account page by selecting Create Stackdriver account from the account drop-down menu at the top of the Stackdriver Monitoring Console.

  6. When the correct project is selected, click Create Account in the Create a Stackdriver account page.

  7. In the Add Google Cloud Platform projects page, click Continue. To add GCP projects later, see Monitoring multiple projects.

  8. In the Add AWS accounts page, click Done. To add AWS accounts later, see Add an AWS account to a Stackdriver account.

  9. You are given instructions for setting up the Stackdriver Monitoring agent on your VM instances.

  10. You are asked to select an option for email reporting. You can change this setting in Account Settings page in the Stackdriver Monitoring Console.

  11. You see a page that says Gathering Information. When this operation completes, click Launch Monitoring.

  12. You see the Stackdriver Monitoring home page for your project.

Viewing your Stackdriver accounts

To see what Stackdriver accounts you have and how they are configured, select Manage accounts from the accounts drop-down menu at the top of the Stackdriver Monitoring Console, or click this button:

Go to the Manage Accounts page

Clicking Edit next to a Stackdriver account will take you to the Account Settings page for that account.

Deleting a Stackdriver account

To delete a Stackdriver account, delete the account's hosting project in the Cloud Platform Console. The hosting project has the same name as the account. It is not possible to separate the Stackdriver account from the hosting project without deleting the hosting project.

Stackdriver removes any additional monitored GCP projects or AWS accounts associated with the deleted Stackdriver account. To avoid the loss of monitoring data and logs from these projects, see the sections on Moving projects to a different Stackdriver account, and Merging Stackdriver accounts.

Adding an AWS account

To monitor an AWS account, create a new Stackdriver account and add the AWS account to the Stackdriver account. Alternatively, instead of creating a Stackdriver account you can use an existing Stackdriver account that is monitoring other GCP projects or AWS accounts. For more information, see Best practices.

To monitor an AWS account, do the following:

  1. Create an Stackdriver account by following the instructions in Creating a Stackdriver account.

  2. Go to the Manage accounts page in Stackdriver Monitoring Console.

    Go to the Manage Accounts page

    Click Edit next to your Stackdriver account.

  3. On the Account Settings page for your Stackdriver account, click Monitored accounts. You see your project information in a page like the following:

    Monitored accounts

  4. Click Add AWS account. You see instructions for connecting to your AWS account:

    Authorize AWS

  5. Follow the instructions for connecting your AWS account.

  6. Click Add AWS account. Stackdriver Monitoring connects to your AWS account.

As part of this process, you should know that Stackdriver Monitoring creates a new GCP project for your AWS account, called an AWS connector project. It has a name that begins AWS Link. For most purposes in Stackdriver, this GCP project represents the resources in your AWS account. For more information, see AWS connector projects.

Next steps:

Adding users to a Stackdriver account

You can share your Stackdriver account with other users by adding them as members to your Stackdriver account hosting project, which has the same name as your account. You must have Project > Owner permission to the project to add more users:

Go to the IAM console

Do the following:

  1. Select your Stackdriver account from the list of projects.

  2. Click Add at the top of the page.

  3. Add a user, group, service account, or domain.

  4. Assign a Project role to the new member: Owner, Editor, Viewer, or Browser.

Restricting access to AWS accounts

If you want to limit the AWS account resources that Stackdriver Monitoring can access, see the following documents:

If you want to revoke Stackdriver Monitoring's access to your AWS account, remove the Stackdriver IAM role from your AWS account.

Monitoring multiple projects

You can use a single Stackdriver account to monitor multiple GCP projects and AWS accounts. The Stackdriver account acts as a workspace in which you can monitor the activity in all your included GCP projects and AWS accounts.

To add GCP projects or AWS accounts to a single Stackdriver account, do the following:

  1. See Creating a Stackdriver account to create a new Stackdriver account to hold your multiple projects. You should use a new, empty GCP project to host your Stackdriver account.

    Alternatively, choose an existing Stackdriver account.

  2. Go to the Manage accounts page in Stackdriver Monitoring Console and click Edit next to your Stackdriver account.

    Go to the Manage Accounts page

  3. On the Account Settings page for your Stackdriver account, click Monitored accounts. You see your project information in a page like the following:

    Monitored accounts

  4. To add GCP projects, click Add Google Cloud Platform projects and follow the instructions.

  5. To add AWS accounts, click Add AWS account and follow the instructions.

Combining two Stackdriver accounts

You can combine two Stackdriver accounts by merging one account into another account. This deletes the first account. See Merge accounts.

Moving a project from one Stackdriver account to another

You can move monitored projects from one Stackdriver account to another account. You cannot presently move AWS connector projects to another account. You can move the hosting project only by merging accounts.

To move a monitored project to another Stackdriver account, do the following:

  1. Open the Stackdriver Monitoring console.

    Go to the Stackdriver Monitoring Console

  2. Select the Stackdriver account that contains the project from the drop-down menu at the top-right of the Stackdriver Monitoring console.

  3. Select Account Settings from the same menu.
  4. On the "Settings" page, click Monitored accounts. You see the following page:

    Monitored accounts

  5. Locate the project you want to move and click Move to another account from the menu to the right of the project's name.

  6. In the Move to dialog box, choose one of the Stackdriver Monitoring accounts to receive the project.
  7. Click Done.

Removing a project from a Stackdriver account

  1. Open the Stackdriver Monitoring console.

    Go to the Stackdriver Monitoring Console

  2. Select the Stackdriver account that contains the project or AWS connector from the drop-down menu at the top-right of the Stackdriver Monitoring console.

  3. Select Account Settings from the same menu.
  4. On the "Settings" page, click Monitored accounts. You see the following page:

    Monitored accounts

  5. Locate the project or AWS connector you want to remove and select Remove from account from the menu to the right of the project's name.

When you remove a project from its account, Stackdriver Monitoring no longer receives monitoring data from the project. If you use Stackdriver Logging with your project, then logs continue to flow into your project even after it has been removed from its account. Monitored projects that have been removed can be added to a Stackdriver account later. AWS connector projects that have been removed do not maintain their previous monitoring connections if they are added to a different Stackdriver account.

Merging Stackdriver accounts

Merging Stackdriver account A into Stackdriver account B moves all the GCP projects except AWS connector projects from account A to account B. Specifically, here is the effect of merging A into B:

  • All monitored projects in account A become monitored projects in account B.
  • The hosting project for account A becomes a monitored project in account B.
  • The AWS connector projects in account A are removed from A as specified in the remove operation.
  • All the monitoring and other configuration information in account A is deleted. This includes dashboards, alerting policies, uptime checks, and so on. Account A no longer exists.

To merge accounts, do the following:

  1. Open the Stackdriver Monitoring console.

    Go to the Stackdriver Monitoring Console

  2. Select the Stackdriver account that is to be kept ("B" in the previous example) from the drop-down menu at the top-right of the Stackdriver Monitoring console.

  3. Select Account Settings from the same menu.
  4. Click Monitored accounts from the left-side menu.
  5. Click Merge another Stackdriver account into this one.
  6. Select the account that is to be removed ("A" in the previous example).
  7. Read about what information is lost during the merge.
  8. Click Merge.

Troubleshooting

Project resources are missing from Stackdriver Monitoring

It can take ten minutes or so before Stackdriver Monitoring notices new or removed resources in your projects.

If you start a service such as Compute Engine in a project that is associated with a Stackdriver account, it can take a hour or more for Stackdriver Monitoring to notice the new service. Until that time, the service's resource types do not appear in any Stackdriver Monitoring menus.

I can't add a project to an account because it's already in another account

Projects can be associated with only one account at a time:

Unsupported email addresses

Stackdriver Monitoring does not accept email addresses containing an apostrophe, although Google Cloud Platform does. Users with such email addresses are unrecognized when they attempt to use Stackdriver Monitoring.

Issues with service tiers

For more information about pricing and service tiers, see Service Tiers.

Monitor your resources on the go

Get the Google Cloud Console app to help you manage your projects.

Send feedback about...

Stackdriver Monitoring