이 문서에서는 여러 프로젝트에 저장된 시계열 데이터를 차트로 표시하고 모니터링할 수 있도록 Google Cloud 콘솔을 사용하여 Google Cloud 프로젝트를 구성하는 방법을 설명합니다. 이 문서는 서로 다른 프로젝트와 연결된 서비스와 리소스의 시계열 데이터를 관리해야 하는 개발자와 시스템 관리자를 대상으로 합니다.
Google Cloud 에서는 측정항목 범위 할당량이 소진되어 측정항목 범위에 프로젝트를 추가할 수 없는 경우를 제외하고 앱 지원 폴더에 대한 측정항목 범위를 관리합니다. 이 경우 할당량 증가를 요청한 후 앱 지원 폴더의 관리 프로젝트 측정항목 범위에 프로젝트를 수동으로 추가할 수 있습니다. 자세한 내용은 앱 지원 폴더의 측정항목 범위를 참조하세요.
시작하기 전에
측정항목 범위 및 범위 지정 프로젝트라는 용어에 익숙하지 않다면 측정항목 범위 개요를 참조하세요.
측정항목 범위를 구성하는 데 필요한 권한을 얻으려면 관리자에게 범위 지정 프로젝트와 측정항목 범위에 추가하려는 각 프로젝트에 대한 모니터링 관리자(roles/monitoring.admin) IAM 역할을 부여해 달라고 요청하세요.
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
VPC 서비스 제어를 사용하는 경우 측정항목 범위와 VPC 경계를 구성하는 순서를 고려해야 합니다. Cloud Monitoring은 프로젝트가 측정항목 범위에 추가될 때 VPC 경계 검사를 수행합니다.
먼저 VPC 경계를 만든 후에 측정항목 범위에 프로젝트를 추가하려고 하면 경계 검사 프로세스가 실행됩니다. 이 프로세스에서는 추가된 컨테이너가 범위 지정 프로젝트와 동일한 경계에 있거나 경계 브리지를 통해 범위 지정 프로젝트에 연결되었는지 확인합니다.
경계 검사가 실패하면 측정항목 범위에 프로젝트가 추가되지 않습니다.
먼저 측정항목 범위를 구성한 후 경계를 만들면 경계 유효성 검사 프로세스가 실행되지 않습니다.
이 방법을 사용하면 서로 다른 경계에 있는 프로젝트의 시계열 데이터에 액세스할 수 있습니다.
IAM 역할을 구성하거나 프로젝트에 대한 액세스 권한을 부여하는 경우 측정항목 범위에 범위 지정 프로젝트 이외의 프로젝트가 포함된 프로젝트에 대한 권한이 미치는 영향을 고려하세요.
범위 지정 프로젝트에서 Monitoring에 읽기 권한을 부여하는 역할을 통해 주 구성원은 측정항목 범위에 포함된 프로젝트에서 저장하는 데이터를 표시할 수 있는 차트와 알림 정책을 볼 수 있습니다.
검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.
Google Cloud 콘솔에서 Google Cloud 프로젝트를 선택합니다. App Hub 호스트 프로젝트 구성의 경우 호스트 프로젝트를 선택합니다.
측정항목 범위를 선택합니다.
측정항목 범위 탭에는 현재 Google Cloud 프로젝트에서 모니터링하는 리소스가 나열됩니다. 또한 측정항목 범위에 현재 Google Cloud 프로젝트가 포함된 Google Cloud 프로젝트가 나열됩니다.
Google Cloud 프로젝트를 측정항목 범위에 추가하려면 다음 단계를 따르세요.
Google Cloud 프로젝트 창에서 프로젝트 추가를 클릭합니다.
Google Cloud 프로젝트 추가 대화상자에서 프로젝트 선택을 클릭한 후 항목을 선택합니다. 변경사항을 저장하려면 프로젝트 추가를 클릭합니다.
설정 페이지로 돌아갑니다. 그러면 해당 페이지의 테이블이 업데이트되어 선택한 항목이 나열됩니다. 목록에서 Google Cloud 프로젝트를 삭제하려면 cancel프로젝트 삭제를 클릭합니다.
프로젝트를 측정항목 범위에 추가한 뒤 변경사항이 모든 Monitoring 시스템에 전파되는 데 약 60초가 걸립니다.
차트 또는 알림 정책을 만들기 전에 최소 60초 이상 기다리세요.
새 측정항목이 표시되려면 Google Cloud 콘솔 페이지를 새로고침해야 할 수 있습니다.
선택한 프로젝트의 측정항목 범위가 선택한 Google Cloud 프로젝트를 포함하도록 업데이트되었습니다.
측정항목 범위에서 프로젝트 삭제
성능을 개선하거나 다른 프로젝트를 추가할 수 있도록 할당량을 확보하기 위해 메트릭 범위에서 프로젝트를 제거할 수 있습니다.
예를 들어, 기본적으로 측정항목 범위에는 375개의 Google Cloud 프로젝트가 포함될 수 있습니다. 이 할당량을 모두 사용한 경우 다른 프로젝트를 추가할 수 있도록 프로젝트 하나를 삭제할 수 있습니다.
측정항목 범위에서 프로젝트를 삭제한 후에는 해당 프로젝트에 저장된 시계열 데이터를 범위 지정 프로젝트에서 차트로 표시하거나 모니터링할 수 없습니다. 측정항목 범위에서 프로젝트를 삭제해도 정의한 차트, 대시보드, 알림 정책, 업타임 체크, 그룹 구성은 변경되지 않습니다.
그러나 차트에 표시되는 시계열과 알림 정책에서 모니터링하는 시계열은 변경될 수 있습니다.
검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.
Google Cloud 콘솔에서 Google Cloud 프로젝트를 선택합니다. App Hub 호스트 프로젝트 구성의 경우 호스트 프로젝트를 선택합니다.
측정항목 범위를 선택합니다.
측정항목 범위 탭에는 현재 Google Cloud 프로젝트에서 모니터링하는 리소스가 나열됩니다. 또한 측정항목 범위에 현재 Google Cloud 프로젝트가 포함된 Google Cloud 프로젝트가 나열됩니다.
할당량 상향 조정 요청
기본적으로 측정항목 범위에는 375개의 Google Cloud 프로젝트가 포함될 수 있습니다. 하지만 "모니터링 프로젝트/모니터링 측정항목 범위" 할당량 증가를 요청할 수 있습니다.
할당량을 기본값인 375개의 Google Cloud 프로젝트 이상으로 늘리면 성능 문제가 발생할 수 있습니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-04(UTC)"],[],[],null,["# Configure a metrics scope\n\nThis document describes how to use the Google Cloud console to configure a\nGoogle Cloud project so that you can chart and monitor time-series data stored in\nmultiple projects. This document is\nintended for developers and system administrators who need to manage\ntime-series data for services and resources that are\nassociated with different projects.\n\nFor information about configuring a Google Cloud project\nprogrammatically, see\n[Configure a metrics scope by using the API](/monitoring/settings/manage-api).\n\nThe metrics scope of a Google Cloud project determines the\ntime-series data that the project can chart or monitor with alerting policies.\n\nApp Hub applications and metrics scopes\n---------------------------------------\n\n|\n| **Preview**\n|\n|\n| This product or feature is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section\n| of the [Service Specific Terms](/terms/service-terms#1).\n|\n| Pre-GA products and features are available \"as is\" and might have limited support.\n|\n| For more information, see the\n| [launch stage descriptions](/products#product-launch-stages).\n\nYou manage the metrics scope for [App Hub](/app-hub/docs/overview)\nhost projects. You can manage this scope either by using the\n[Google Cloud console](/monitoring/settings/multiple-projects) or the\n[Cloud Monitoring API](/monitoring/settings/manage-api).\n\nGoogle Cloud manages the metrics scope for app-enabled folders, unless\nadding a project to the metrics scope fails due to exhaustion of the\nmetrics scope quota. In this case, you can request a quota increase and\nthen manually add projects to the metrics scope of the\nmanagement project for the app-enabled folder. To learn more, see\n[Metrics scopes for app-enabled folders](/monitoring/settings/metrics-scope-app-enabled-folders).\n\nBefore you begin\n----------------\n\n- If you aren't familiar with the terms *metrics scope* and *scoping project* , then see [Metrics scopes overview](/monitoring/settings).\n\n\u003c!-- --\u003e\n\n-\n\n To get the permissions that\n you need to configure a metrics scope,\n\n ask your administrator to grant you the\n\n\n [Monitoring Admin](/iam/docs/roles-permissions/monitoring#monitoring.admin) (`roles/monitoring.admin`)\n IAM role on the scoping project and on each project\n that you want to add to, or remove from, the metrics scope.\n\n\n For more information about granting roles, see [Manage access to projects, folders, and organizations](/iam/docs/granting-changing-revoking-access).\n\n\n You might also be able to get\n the required permissions through [custom\n roles](/iam/docs/creating-custom-roles) or other [predefined\n roles](/iam/docs/roles-overview#predefined).\n- If you use [VPC Service Controls](/vpc-service-controls/docs/overview), then you need to consider\n the order in which you configure a metrics scope and\n your VPC perimeters. Cloud Monitoring performs the VPC perimeter check\n when a project is *added* to a metrics scope:\n\n - When you create the VPC perimeter first and then try to add a\n project to\n the metrics scope, the perimeter validation process runs. This\n process verifies that the added container is in the same perimeter as the\n scoping project, or that it is connected to the\n scoping project by a [perimeter bridge](/vpc-service-controls/docs/share-across-perimeters).\n If the perimeter validation fails, then the addition of the\n project to the metrics scope also fails.\n\n - When you configure the metrics scope first and then\n create your perimeters, the perimeter validation process doesn't run.\n This approach lets you access time-series data for projects\n that are in different perimeters.\n\n- If you configure IAM roles or grant access to projects,\n then consider the implications of permissions on a project\n whose metrics scope includes projects other than the\n scoping project.\n A role that grants read permission to Monitoring on the\n scoping project lets the principal view charts and alerting policies\n that might display data that is stored by a project included\n in the metrics scope.\n\nAdd projects to a metrics scope\n-------------------------------\n\nTo add projects to a metrics scope, do the following:\n\n1. In the Google Cloud console, go to the\n *settings* **Settings** page:\n\n [Go to **Settings**](https://console.cloud.google.com/monitoring/settings)\n\n \u003cbr /\u003e\n\n If you use the search bar to find this page, then select the result whose subheading is\n **Monitoring**.\n2. In the Google Cloud console, select your Google Cloud project. For [App Hub](/app-hub/docs/overview) host project configurations, select the host project.\n3. Select **Metric Scope**.\n\n The **Metric Scope** tab lists the resources monitored by the current\n Google Cloud project. It also lists the Google Cloud projects whose\n metrics scope includes the current Google Cloud project.\n4. To add Google Cloud projects to the metrics scope:\n\n 1. In the **Google Cloud Projects** pane, click **Add Projects**.\n 2. In the **Add Google Cloud projects** dialog, click **Select Projects** ,\n and then make your selections. To save your changes, click\n **Add Projects**.\n\n \u003cbr /\u003e\n\n You are returned to the **Settings** page, and the table on that page\n is updated to list your selections. If you want to remove a\n Google Cloud project from the list,\n click *cancel* **Remove project**.\n\n\n After you add projects to a metrics scope, it takes about 60 seconds for\n changes to propagate through all Monitoring systems.\n\n Before you create a chart or alerting policy, wait at least 60 seconds.\n You might need to refresh the Google Cloud console page for the new metrics to be visible.\n\n The metrics scope of your selected project has been updated to include\n the Google Cloud projects you selected.\n\nRemove projects from a metrics scope\n------------------------------------\n\nYou might want to remove projects from a metrics scope to improve\nperformance or to free up quota so that you can add a different project.\nFor example, by default, a metrics scope can include\n375 Google Cloud projects. If you've exhausted this quota,\nthen you might remove one project so that you can add another.\n\nAfter you remove a project from a metrics scope, the time-series\ndata stored in that project can't be charted or monitored by the\nscoping project. Removing a project from a metrics scope doesn't\nchange the configuration of charts,\ndashboards, alerting policies, uptime checks, or groups that you defined.\nHowever, the time series displayed on charts and the time series monitored by\nalerting policies might change.\n\nTo remove projects from a metrics scope, do the following:\n\n1. In the Google Cloud console, go to the\n *settings* **Settings** page:\n\n [Go to **Settings**](https://console.cloud.google.com/monitoring/settings)\n\n \u003cbr /\u003e\n\n If you use the search bar to find this page, then select the result whose subheading is\n **Monitoring**.\n2. In the Google Cloud console, select your Google Cloud project. For [App Hub](/app-hub/docs/overview) host project configurations, select the host project.\n3. Select **Metric Scope**.\n4. In the **Google Cloud Projects** pane, select the projects that you want to remove, click **Remove project**, and then complete the confirmation dialog.\n\nList projects in a metrics scope\n--------------------------------\n\nTo list the resources in a metrics scope, do the following:\n\n1. In the Google Cloud console, go to the\n *settings* **Settings** page:\n\n [Go to **Settings**](https://console.cloud.google.com/monitoring/settings)\n\n \u003cbr /\u003e\n\n If you use the search bar to find this page, then select the result whose subheading is\n **Monitoring**.\n2. In the Google Cloud console, select your Google Cloud project. For [App Hub](/app-hub/docs/overview) host project configurations, select the host project.\n3. Select **Metric Scope**.\n\n The **Metric Scope** tab lists the resources monitored by the current\n Google Cloud project. It also lists the Google Cloud projects whose\n metrics scope includes the current Google Cloud project.\n\nRequest a quota increase\n------------------------\n\nBy default, a metrics scope can include\n375 Google Cloud projects. However, you can request\nan increase of the \"Monitored Projects / Monitoring Metrics Scope\" quota.\nIncreasing your quota beyond the default value of\n375 Google Cloud projects might cause performance issues.\n\nFor instructions about how to request a quota increase, see\n[Request a quota adjustment](/docs/quotas/view-manage#requesting_higher_quota).\n\nSelect a different metrics scope\n--------------------------------\n\nThe project selected in the Google Cloud console project picker is the\nscoping project of the current metrics scope. There is a one-to-one\nrelationship between a scoping project and a metrics scope.\n\nTo select a different metrics scope, select a different project with the\nGoogle Cloud console project picker.\n\nWhat's next\n-----------\n\n- [Quotas and limits](/monitoring/quotas)"]]
