Stay organized with collections Save and categorize content based on your preferences.
This document describes how Cloud Monitoring determines what time-series data your Google Cloud project can chart and monitor. If you only want to chart and monitor the time-series data collected by your Google Cloud project, then you don't need to perform any configuration. We recommend completing the Compute Engine quickstart. However, if you want to chart and monitor the time-series data collected by multiple Google Cloud projects, then some configuration is required. This document introduces the data model and best practices. For configuration information, see the documents listed in the What's next section.
Data modelThis section introduces the concepts of a resource container, a metrics scope, and a scoping project.
Preview
This product or feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA products and features are available "as is" and might have limited support. For more information, see the launch stage descriptions.
You manage the metrics scope for App Hub host projects. You can manage this scope either by using the Google Cloud console or the Cloud Monitoring API.
Google Cloud manages the metrics scope for app-enabled folders, unless adding a project to the metrics scope fails due to exhaustion of the metrics scope quota. In this case, you can request a quota increase and then manually add projects to the metrics scope of the management project for the app-enabled folder. To learn more, see Metrics scopes for app-enabled folders.
Example metrics scope configurationAssume that you have two projects, named Staging and Production, that contain Compute Engine virtual machine (VM) instances. To view the metrics for all of your VMs in a single view, you create another project, AllEnvironments, and then add the Staging and Production projects to the metrics scope of the project named AllEnvironments.
With this configuration, to create a chart that displays time-series data stored in the Staging project, your first step is to open the Google Cloud console and select a project with the Google Cloud console project picker:
If you select AllEnvironments, then your chart can display time-series data stored by the Staging project along with time-series data stored by the Production and AllEnvironments projects. To view time-series data that is stored by the Staging project, you can add a filter.
The dashed line in the following diagram shows the projects whose time-series data can be charted and monitored by the AllEnvironments project:
If you select Staging, then your chart displays time-series data stored by the Staging project.
When you want to chart or monitor time-series data stored in multiple resource containers, we recommend that you use a new Google Cloud project or one without resources as the scoping project, because these projects don't store any time-series data.
Consider a scenario where your scoping project contains resources such as VMs. To chart or monitor only the time-series data for the VMs in the scoping project, you must specify filters to exclude the time series from VMs stored in monitored resource containers. The requirement to use filters increases the complexity of configuring a chart and an alerting policy, and it increases the possibility of a configuration error.
Consider using multiple scoping projects to control which teams have access to the time-series data stored in your projects. The following table illustrates a possible configuration:
Scope A Scope B Scope C Scoping project scoping-project-A scoping-project-B scoping-project-C Monitored projects Project 1To view the time-series data that can be charted or monitored by a project, your Identity and Access Management (IAM) role on the project must include all the permissions in the Monitoring Viewer (roles/monitoring.viewer) role. You don't need any other permissions. For example, suppose the metrics scope of a scoping project monitors three Google Cloud projects and that you have a role of Monitoring Viewer on the scoping project. When you access the scoping project by using the Google Cloud console, you can view the time-series data stored in that project and the time-series data stored in the other three Google Cloud projects.
To modify a metrics scope, your IAM roles on the scoping project and on each resource container that you want to add must include all permissions in the Monitoring Admin (roles/monitoring.admin) role.
For more information, see Control access with Identity and Access Management.
PricingIn general, Cloud Monitoring system metrics are free, and metrics from external systems, agents, or applications are not. Billable metrics are billed by either the number of bytes or the number of samples ingested.
For more information about Cloud Monitoring pricing, see the following documents:
What's nextExcept as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-07-02 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-02 UTC."],[],[]]
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4