사용되지 않는 리소스 메타데이터 라벨

Cloud Monitoring의 모니터링 리소스에는 모니터링 리소스 유형의 특정 인스턴스를 식별하는 데 사용되는 라벨 집합이 포함됩니다. 이러한 라벨은 모니터링 리소스 목록의 각 모니터링 리소스 유형에 대해 문서화되어 있습니다.

또한 Monitoring에서 모니터링 리소스에 대한 메타데이터를 캡처하는 추가 라벨을 만들 수 있습니다. 이러한 시스템 메타데이터 라벨은 사용자에게 읽기 전용 값으로 제공됩니다. 사용자는 자체 리소스 메타데이터 라벨을 만들 수도 있습니다. 자세한 내용은 리소스 메타데이터 라벨을 참조하세요.

모니터링 리소스 메타데이터 라벨 그룹의 지원이 중단되었습니다. 세트의 라벨은 중복되고 기존 동일 라벨로 대체되거나 Cloud Monitoring 알림 정책, 차트, 스코어카드, 리소스 그룹에서 더 이상 지원되지 않고 사용되지 않는 개념을 나타냅니다.

지원 중단의 영향

대체 라벨을 확인할 수 있는 메타데이터 라벨을 사용하고 모니터링 리소스를 지정하는 모든 알림 정책, 차트, 스코어카드, 리소스 그룹은 자동으로 마이그레이션되어 2020년 7월 31일에 대체 라벨을 사용할 수 있습니다. 그 외 사용 중인 지원 중단된 라벨은 모두 수동으로 마이그레이션해야 합니다. 이 페이지에서는 이를 마이그레이션하는 방법에 대한 정보를 제공합니다.

2020년 7월 31일까지 자동 또는 수동으로 마이그레이션되지 않은 메타데이터 라벨을 사용하는 모든 알림 정책, 차트, 스코어카드, 리소스 그룹은 더 이상 지원되지 않으며 작동이 중지될 수 있습니다.

필요한 작업

지원 중단된 메타데이터 라벨로 인해 작동이 중지된 알림 정책, 차트, 스코어카드, 리소스 그룹을 복구하려면 몇 가지 조치를 취해야 합니다. 알림 정책, 차트, 스코어카드 또는 그룹을 삭제하거나 지원이 중단된 라벨을 사용하는 모든 필터를 수정하여 비슷한 동작을 제공하는 라벨을 사용할 수 있습니다.

마찬가지로 메타데이터 라벨을 사용하지만 모니터링 리소스를 지정하지 않는 필터가 있는 경우 이러한 라벨이 지원 중단되었는지 자동으로 확인할 수 없으며, 직접 평가하고 처리해야 합니다.

이 페이지에는 지원 중단된 메타데이터 라벨의 사용을 식별하는 데 도움이 되는 스크립트가 포함되어 있습니다.

지원 중단된 메타데이터 라벨

다음 표에는 지원 중단된 리소스 메타데이터 라벨과 대체 라벨(있는 경우)이 나열되어 있습니다.

모니터링 리소스 유형	지원 중단된 라벨	동일 라벨
모든 Google Cloud 유형	`metadata.system_labels.cloud_account`^*	`resource.labels.project_id`
`cloud_tasks_queue`	`metadata.system_labels.name` `metadata.system_labels.state`	`resource.labels.queue_id` 없음
`dataflow_job`	`metadata.system_labels.name` `metadata.system_labels.state`	`resource.labels.job_name` 없음
`gae_app`	`metadata.system_labels.gaeapp` `metadata.system_labels.gaemodule` `metadata.system_labels.gaeversion`	없음 ^† 고려 `resource.labels.project_id` 없음^† 고려 `resource.labels.module_id` 없음^† 고려 `resource.labels.version_id`
`gce_disk`	`metadata.user_labels.name`^‡	`metadata.system_labels.name`
`gce_instance`	`metadata.user_labels.name`^‡	`metadata.system_labels.name`
`l7_lb_rule`	`metadata.system_labels.state`	없음
`pubsub_topic`	`metadata.system_labels.name`^#	`metadata.system_labels.name`
`pubsub_subscription`	`metadata.system_labels.name`^#	`metadata.system_labels.name`
`vpn_gateway`	`metadata.system_labels.region`	`resource.labels.region`

^* Cloud Monitoring 필터 구문은 metadata.system_labels.cloud_account 라벨을 사용할 때처럼 resources.labels.project_id 라벨을 유연하게 사용할 수 없습니다. 예를 들어 다음과 같은 작업은 허용되지 않습니다.

OR을 사용하여 project_id 라벨을 사용하는 표현식과 메타데이터 라벨을 사용하는 표현식 결합

!= 작업을 project_id 라벨과 함께 사용

starts_with 또는 has_substring 함수를 project_id 라벨과 함께 사용

^† gae_app 리소스의 경우 표시된 리소스 라벨은 지원 중단된 메타데이터 라벨과 비슷하므로 좋은 대체가 될 수 있습니다. 하지만 비슷하기만 하므로 자동으로 마이그레이션되지는 않았습니다.

^‡ gce_disk 및 gce_instance 리소스의 경우: metadata.user_labels.name을 설정하지 않으면 metadata.system_labels.name의 값으로 자동으로 입력되지 않았습니다. 이 자동 입력 또한 2020년 7월 31일에 종료되었습니다. 자동으로 입력된 metadata.user_labels.name 값을 필터링하는 알림 정책, 차트, 스코어카드, 리소스 그룹은 metadata.system_labels.name을 대신 사용하도록 마이그레이션되었습니다.

^# pubsub_topic 및 pubsub_subscription 리소스의 경우 metadata.system_labels.name이 소문자로 변환되는(예: "My-Subscription"은 "my-subscription"이 됨) 오래된 버그를 수정했습니다. 그 결과 사용자에게 소문자 이름이 동일한 여러 리소스가 있는 경우 예상치 못한 동작이 발생했습니다. 이 동작 또한 2020년 7월 31일에 종료되었습니다. 이 날짜 이후에는 메타데이터 시스템 라벨 name에 주제 또는 구독의 실제 이름(예: "My-Subscription")이 반영됩니다.

어떤 조치를 취해야 하나요?

간략하게 두 단계로 진행됩니다.

이 지원 중단의 영향을 받는 메타데이터 라벨을 사용하고 있는지 확인합니다. 제공된 검사 프로그램 스크립트 실행에 대한 자세한 내용은 지원 중단된 메타데이터 라벨 찾기를 참조하세요.
영향을 받는 메타데이터 라벨을 사용하는 경우 업데이트하거나 삭제하세요. 자세한 단계는 필터 업데이트를 참조하세요.

지원 중단된 메타데이터 라벨 찾기

이 Python 스크립트를 사용하여 지원 중단된 메타데이터 라벨(metadata_label_detection.py)에 대한 참조를 식별할 수 있습니다.

구문 요약: python3 metadata_label_detection.py PROJECT_ID_OR_NUMBER

PROJECT_ID_OR_NUMBER는 프로젝트 ID(예: my-project)이거나 프로젝트 번호(예: 123456789)일 수 있습니다. projects/ 프리픽스를 포함하지 마세요.

다음 단계에서는 스크립트를 사용하는 방법을 설명합니다.

Google Cloud 콘솔로 이동합니다.

Google Cloud 콘솔로 이동
프로젝트의 Google Cloud 콘솔 페이지 상단에 있는 Cloud Shell 활성화를 클릭합니다.
Cloud Shell 툴바에서 편집기 열기를 클릭합니다. 홈 디렉터리의 작업공간이 아직 열려 있지 않으면 파일을 선택한 후 작업공간 열기를 선택하여 엽니다. 사용자 이름의 작업공간을 선택합니다.
파일을 선택하고 새 파일을 선택하여 metadata_label_detection.py라는 새 파일을 만듭니다. metadata_label_detection.py의 텍스트를 편집기에 붙여넣습니다. 파일을 선택한 후 저장을 선택하여 파일을 저장합니다.
Cloud Shell 툴바에서 터미널 열기를 클릭하여 터미널로 돌아갑니다.
Cloud Shell의 명령줄 프롬프트에서 다음 명령어를 실행하여 스크립트 종속 항목을 설치합니다.
```
sudo pip3 install google-cloud-monitoring=="1.*" google-cloud-monitoring-dashboards
```
종속 항목을 설치한 후 감지기 스크립트를 실행합니다.
```
python3 metadata_label_detection.py $GOOGLE_CLOUD_PROJECT
```

스크립트는 다음 발췌문과 같은 보고서를 생성합니다.

Alert "Test alert" (projects/PROJECT_ID/alertPolicies/8401129027900817186) is affected.
URL: https://console.cloud.google.com/monitoring/alerting/policies/8401129027900817186?project=PROJECT_ID
        metadata.system_labels.cloud_account is deprecated for non-AWS resource
types. Please manually remove the reference.

Group "Test group" (projects/PROJECT_ID/groups/4518177785663978371) might be affected,
depending on the type of resources it is used for.
URL: https://console.cloud.google.com/monitoring/groups/4518177785663978371?project=PROJECT_ID
        metadata.system_labels.name is deprecated for dataflow_job. Please
manually remove the reference if this group is used for dataflow_job resources.
        metadata.system_labels.name is deprecated for cloud_tasks_queue. Please
manually remove the reference if this group is used for cloud_tasks_queue resources.

Xy_chart "Test chart" in dashboard "Demo dashboard" (projects/PROJECT_ID/dashboards/2826428163455705326) is affected.
URL: https://console.cloud.google.com/monitoring/dashboards/custom/2826428163455705326?project=PROJECT_ID
        metadata.user_labels.name is deprecated for gce_instance. Please
manually remove the reference.

필터 업데이트

알림 정책, 차트, 스코어카드, 리소스 그룹을 업데이트하려면 다음 단계를 따르세요.

Google Cloud Console에 로그인합니다.
지원 중단된 라벨 찾기에 설명된 대로 검사 프로그램 스크립트를 실행합니다.
각 알림 정책, 차트, 리소스 그룹을 검사하여 검색 중인 값이 스크립트로 식별된 지원 중단된 라벨 중 하나의 것인지 확인합니다.

모든 차트를 확인하려면 정의한 각 커스텀 대시보드에서 각 차트를 확인해야 합니다.

필터에는 metadata.system_labels 대신 resource.metadata 프리픽스가 사용됩니다.

참고: API를 사용하여 스코어카드가 포함된 대시보드를 만든 경우 API를 사용하여 대시보드를 확인해야 합니다. Google Cloud 콘솔에서 스코어카드를 수정할 수 없습니다.

지원 중단된 각 라벨에 대해 다음 중 하나를 수행합니다.
- 대체 라벨이 있으면 라벨 사용을 삭제하거나 알림 정책, 차트 또는 리소스 그룹을 삭제합니다.
- 대체 라벨이 있으면 지원이 중단된 라벨을 바꿉니다.
아무 조치도 취하지 않으면 영향을 받는 알림 정책, 차트 또는 리소스 그룹이 작동하지 않습니다.

Google Cloud Console을 사용하여 업데이트하는 방법에 대한 추가 도움말은 수정에 나열된 리소스를 참조하세요.

경우에 따라 Google Cloud 콘솔이 아닌 Cloud Monitoring API를 사용해야 할 수 있습니다. API는 생성할 수 없는 일부 쿼리를 표현할 수 있습니다.
검사 프로그램 스크립트를 다시 실행하여 지원 중단된 라벨이 없는지 확인합니다.

추가 정보

리소스 메타데이터 라벨, 필터 또는 특정 모니터링 리소스 유형에 대한 자세한 내용은 다음을 참조하세요.

라벨: 리소스 메타데이터 라벨
필터: Monitoring 필터
특정 모니터링 리소스 유형: 모니터링 리소스 목록

수정

알림 정책, 차트, 대시보드, 리소스 그룹 업데이트에 대한 자세한 내용은 다음을 참조하세요.

알림 정책: 정책 관리
대시보드 및 차트(Google Cloud Console 사용): 대시보드 관리
대시보드(Monitoring API 사용): 대시보드 업데이트
리소스 그룹: 그룹 수정