이 문서에서는 관리 프로젝트의 측정항목 범위가 구성되는 방식을 설명합니다. 관리 프로젝트는 Google Cloud 애플리케이션 모니터링을 위해 폴더를 사용 설정할 때 생성됩니다. 관리 프로젝트는 Google Cloud Observability 서비스에 필요한 구성 정보를 저장하며, 애플리케이션의 원격 분석을 보려는 경우 이 프로젝트를 사용합니다.
앱 지원 폴더를 사용하지 않는 경우 이 문서는 적용되지 않습니다. 대신 측정항목 범위 구성을 참고하세요.
이 페이지에서는 측정항목 범위 할당량 사용량을 확인하는 방법, 할당량 업데이트를 요청하는 방법, 관리 프로젝트의 측정항목 범위를 수동으로 업데이트하는 방법을 설명합니다.
관리 프로젝트의 측정항목 범위 관리 방법
앱이 사용 설정된 폴더의 경우 Google Cloud Observability는 앱이 사용 설정된 폴더의 프로젝트 목록을 측정항목 범위의 프로젝트 목록과 동기화하려고 시도합니다. 예를 들어 앱 지원 폴더에 프로젝트를 추가하면 해당 프로젝트를 측정항목 범위에 추가하는 명령어가 실행됩니다.
앱 지원 폴더의 프로젝트 수가 측정항목 범위 할당량(기본값: 측정항목 범위당 프로젝트 375개)을 초과하지 않으면 Google Cloud Observability에서 측정항목 범위의 프로젝트 목록을 앱 지원 폴더의 프로젝트 목록과 동기화할 수 있습니다. 예를 들어 측정항목 범위당 할당량이 375개라고 가정해 보겠습니다. 앱 사용 설정 폴더에 프로젝트가 100개 포함되어 있으면 측정항목 범위에 앱 사용 설정 폴더의 모든 프로젝트가 표시됩니다. 앱 지원 폴더에 프로젝트를 추가하면 측정항목 범위에도 추가됩니다.
앱 지원 폴더의 프로젝트 수가 측정항목 범위 할당량을 초과하면 측정항목 범위의 프로젝트 목록에 앱 지원 폴더의 모든 프로젝트가 포함되지 않습니다. 예를 들어 할당량이 측정항목 범위당 375개 프로젝트이고 앱 지원 폴더에 380개 프로젝트가 있다고 가정해 보겠습니다. 측정항목 범위에 프로젝트 375개가 추가된 후 할당량이 소진되어 나머지 5개 프로젝트를 추가하려고 하면 실패합니다. 따라서 일부 애플리케이션 데이터는 관리 프로젝트에서 사용할 수 없습니다.
측정항목 범위 할당량이 소진된 경우 다음 중 하나를 실행할 수 있습니다.
측정항목 범위에 나열된 프로젝트를 변경합니다. 예를 들어 다른 프로젝트를 추가할 수 있도록 측정항목 범위에서 일부 프로젝트를 삭제할 수 있습니다.
할당량 증액을 요청한 후 자동으로 추가되지 않은 프로젝트를 수동으로 추가합니다. 위 예시에서는 측정항목 범위에 추가할 수 없었던 5개 프로젝트를 수동으로 추가해야 합니다. Google Cloud Observability는 프로젝트의 초기 시도가 실패하면 측정항목 범위에 프로젝트를 추가하는 작업을 다시 시도하지 않습니다.
두 경우 모두 측정항목 범위를 수동으로 수정해야 합니다.
시작하기 전에
- 측정항목 범위라는 용어가 익숙하지 않다면 측정항목 범위 개요를 참고하세요.
-
측정항목 범위를 구성하는 데 필요한 권한을 얻으려면 관리자에게 앱 지원 폴더의 관리 프로젝트와 측정항목 범위에 추가하려는 각 프로젝트에 대한 Monitoring 관리자 (
roles/monitoring.admin) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
할당량 사용량 보기
관리 프로젝트의 측정항목 범위를 수동으로 관리하지 않아도 되도록 하려면 앱 지원 폴더에 프로젝트를 추가하기 전에 사용 가능한 할당량이 있는지 확인하세요. 이 섹션에서는 현재 할당량 사용량을 확인하는 방법을 설명합니다.
측정항목 범위 할당량 사용량을 보려면 다음 단계를 따르세요.
-
Google Cloud 콘솔에서 settings 설정 페이지로 이동합니다.
검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.
- Google Cloud 콘솔에서 관리 프로젝트를 선택합니다.
측정항목 범위를 선택합니다.
측정항목 범위 할당량 창에는 할당량 사용량과 할당량이 표시됩니다. 측정항목 범위 탭의 아이콘은 다음과 같은 의미를 갖습니다.
오류 아이콘 error은 할당량의 90% 이상이 사용되었음을 나타냅니다.
경고 아이콘 warning은 할당량의 70~90%가 사용되었음을 나타냅니다.
할당량 상향 조정 요청
프로젝트의 측정항목 범위 할당량 사용량이 70%를 초과하면 측정항목 범위 탭에 경고 아이콘 warning 또는 오류 아이콘 error이 표시됩니다. 기본적으로 측정항목 범위에는 Google Cloud 프로젝트 375개가 포함될 수 있습니다. 할당량을 늘리고 측정항목 범위에 375개가 넘는 Google Cloud 프로젝트를 추가하면 성능 문제가 발생할 수 있습니다.
할당량 상향을 요청하려면 다음 단계를 따르세요.
-
Google Cloud 콘솔에서 settings 설정 페이지로 이동합니다.
검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.
- Google Cloud 콘솔에서 관리 프로젝트를 선택합니다.
- 측정항목 범위를 선택합니다.
측정항목 범위 할당량 창에서 할당량 상향 조정 요청을 선택하고 대화상자를 완료합니다.
'모니터링 프로젝트 / 모니터링 측정항목 범위'라는 할당량의 증가를 요청해야 합니다. 이 작업에 관한 자세한 내용은 Google Cloud 콘솔을 사용하여 할당량 관리 문서를 참고하세요.
할당량이 늘어난 후 측정항목 범위에 프로젝트를 추가할 수 있습니다.
측정항목 범위에 프로젝트 추가
프로젝트를 측정항목 범위에 추가하려면 다음 안내를 따르세요.
-
Google Cloud 콘솔에서 settings 설정 페이지로 이동합니다.
검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.
- Google Cloud 콘솔에서 관리 프로젝트를 선택합니다.
측정항목 범위를 선택합니다.
측정항목 범위 탭에는 현재 Google Cloud 프로젝트에서 모니터링하는 리소스가 나열됩니다. 또한 측정항목 범위에 현재 Google Cloud 프로젝트가 포함된 Google Cloud 프로젝트가 나열됩니다.
Google Cloud 프로젝트를 측정항목 범위에 추가하려면 다음 단계를 따르세요.
- Google Cloud 프로젝트 창에서 프로젝트 추가를 클릭합니다.
Google Cloud 프로젝트 추가 대화상자에서 프로젝트 선택을 클릭한 후 항목을 선택합니다. 변경사항을 저장하려면 프로젝트 추가를 클릭합니다.
설정 페이지로 돌아갑니다. 그러면 해당 페이지의 테이블이 업데이트되어 선택한 항목이 나열됩니다. 목록에서 Google Cloud 프로젝트를 삭제하려면 cancel 프로젝트 삭제를 클릭합니다.
프로젝트를 측정항목 범위에 추가한 뒤 변경사항이 모든 Monitoring 시스템에 전파되는 데 약 60초가 걸립니다. 차트 또는 알림 정책을 만들기 전에 최소 60초 이상 기다리세요. 새 측정항목이 표시되려면 Google Cloud 콘솔 페이지를 새로고침해야 할 수 있습니다.
선택한 프로젝트의 측정항목 범위가 선택한 Google Cloud 프로젝트를 포함하도록 업데이트되었습니다.
측정항목 범위에서 프로젝트 삭제
측정항목 범위에서 프로젝트를 삭제하여 성능을 개선하거나 다른 프로젝트를 추가할 수 있도록 할당량을 확보할 수 있습니다. 예를 들어 기본적으로 측정항목 범위에는 Google Cloud 프로젝트 375개가 포함될 수 있습니다. 이 할당량을 모두 사용했다면 프로젝트 하나를 삭제하여 다른 프로젝트를 추가할 수 있습니다.
측정항목 범위에서 프로젝트를 삭제한 후에는 범위 지정 프로젝트에서 해당 프로젝트에 저장된 시계열 데이터를 차트로 표시하거나 모니터링할 수 없습니다. 측정항목 범위에서 프로젝트를 삭제해도 정의한 차트, 대시보드, 알림 정책, 업타임 체크, 그룹 구성은 변경되지 않습니다. 그러나 차트에 표시되는 시계열과 알림 정책에서 모니터링하는 시계열은 변경될 수 있습니다.
측정항목 범위에서 프로젝트를 삭제하려면 다음 안내를 따르세요.
-
Google Cloud 콘솔에서 settings 설정 페이지로 이동합니다.
검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.
- Google Cloud 콘솔에서 관리 프로젝트를 선택합니다.
- 측정항목 범위를 선택합니다.
- Google Cloud 프로젝트 창에서 삭제하려는 프로젝트를 선택하고 프로젝트 삭제를 클릭한 후 확인 대화상자를 완료합니다.
측정항목 범위의 프로젝트 나열
측정항목 범위에 리소스를 나열하려면 다음을 수행합니다.
-
Google Cloud 콘솔에서 settings 설정 페이지로 이동합니다.
검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.
- Google Cloud 콘솔에서 관리 프로젝트를 선택합니다.
측정항목 범위를 선택합니다.
측정항목 범위 탭에는 현재 Google Cloud 프로젝트에서 모니터링하는 리소스가 나열됩니다. 또한 측정항목 범위에 현재 Google Cloud 프로젝트가 포함된 Google Cloud 프로젝트가 나열됩니다.