리소스 메타데이터 라벨

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
없음
없음
없음
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

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

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

어떻게 해야 하나요?

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

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

  2. 해당 메타데이터 라벨을 사용 중이면 업데이트하거나 삭제합니다. 자세한 단계는 필터 업데이트를 참조하세요.

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

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

구문 요약 python3 metadata_label_detection.py [PROJECT_ID_OR_NUMBER]

PROJECT_ID_OR_NUMBER는 프로젝트 ID(예: my-project) 또는 프로젝트 번호(예: 123456789)일 수 있습니다.

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

  1. Google Cloud Console로 이동합니다.

    Cloud Console로 이동

  2. 프로젝트의 Google Cloud Console 페이지 상단에서 Cloud Shell 활성화를 클릭합니다.

  3. Cloud Shell 툴바에서 편집기 열기를 클릭합니다. 홈 디렉터리의 작업공간이 아직 열려 있지 않은 경우 파일작업공간 열기를 차례로 선택하여 엽니다. 사용자 이름이 있는 작업공간을 선택합니다.

  4. 파일새 파일을 차례로 선택하여 metadata_label_detection.py라는 새 파일을 만듭니다. metadata_label_detection.py의 텍스트를 편집기에 붙여넣습니다. 파일저장을 차례로 선택하여 파일을 저장합니다.

  5. Cloud Shell 툴바에서 터미널 열기를 클릭하여 터미널로 돌아갑니다.

  6. Cloud Shell의 명령줄 프롬프트에서 다음 명령어를 실행하여 스크립트 종속 항목을 설치합니다.

    sudo pip3 install google-cloud-monitoring google-cloud-monitoring-dashboards
    
  7. 종속 항목을 설치한 후 감지기 스크립트를 실행합니다.

    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. This reference will be auto-migrated to resource.labels.project_id.

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 migrate to resource.labels.queue_id if this group is used for cloud_tasks_queue resources.

Xy_chart "Test chart" in dashboard "Demo dashboard" (projects/[PROJECT_NUM]/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. This
reference will be auto-migrated to metadata.system_labels.name.

필터 업데이트

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

  1. Google Cloud Console에 로그인합니다.

  2. 지원 중단된 라벨 찾기에 설명된 대로 검사 프로그램 스크립트를 실행합니다.

  3. 각 알림 정책, 차트, 리소스 그룹을 검사하여 검색 중인 값이 스크립트로 식별된 지원 중단된 라벨 중 하나의 것인지 확인합니다.

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

    지원 중단된 각 라벨에 대해 다음 중 하나를 수행합니다.

    • 대체 라벨이 있으면 라벨 사용을 삭제하거나 알림 정책, 차트 또는 리소스 그룹을 삭제합니다.

      아무 조치도 취하지 않으면 2020년 7월 31일 이후에 라벨을 사용하는 필터가 작동하지 않습니다.

    • 대체 라벨이 있으면 지원이 중단된 라벨을 바꿉니다.

      아무 조치도 취하지 않으면 2020년 7월 31일에 교체가 이루어집니다.

    업데이트에 대한 추가 도움말은 수정에 나열된 리소스를 참조하세요.

  4. 검사 프로그램 스크립트를 다시 실행하여 지원 중단된 라벨이 없는지 확인합니다.

추가 정보

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

수정

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