VM 확장 프로그램 모니터링

이 문서에서는 Cloud Monitoring을 사용하여 Compute Engine 인스턴스에서 VM 확장 프로그램 관리자로 관리되는 VM 확장 프로그램을 모니터링하는 방법을 설명합니다. 확장 프로그램 상태 및 리소스 소비를 모니터링하면 CPU 및 메모리 사용량을 추적하고 VM Fleet 전체에서 설치 또는 런타임 오류를 감지할 수 있습니다.

이 문서에서는 다음 작업을 완료하는 방법을 알아봅니다.

시작하기 전에

  • 아직 인증을 설정하지 않았다면 설정합니다. 인증은 Google Cloud 서비스 및 API에 액세스하기 위해 ID를 확인합니다. 로컬 개발 환경에서 코드 또는 샘플을 실행하려면 다음 옵션 중 하나를 선택하여 Compute Engine에 인증하면 됩니다.

    이 페이지의 샘플 사용 방법에 대한 탭을 선택하세요.

    콘솔

    Google Cloud 콘솔을 사용하여 Google Cloud 서비스 및 API에 액세스하는 경우 인증을 설정할 필요가 없습니다.

    gcloud

    1. Google Cloud CLI를 설치한 후 제휴 ID로 gcloud CLI에 로그인합니다. 로그인한 후 다음 명령어를 실행하여 Google Cloud CLI를 초기화합니다. 

      gcloud init
  • 기본 리전 및 영역을 설정합니다.

    • REST

    로컬 개발 환경에서 이 페이지의 REST API 샘플을 사용하려면 gcloud CLI에 제공한 사용자 인증 정보를 사용합니다.

      Google Cloud CLI를 설치한 후 제휴 ID로 gcloud CLI에 로그인합니다.

    자세한 내용은 Google Cloud 인증 문서의 REST 사용을 위한 인증을 참조하세요.

시작하기 전에

확장 프로그램을 모니터링하기 전에 다음 기본 요건을 완료하세요.

필수 IAM 권한

측정항목을 모니터링하고, 대시보드를 빌드하고, 알림 정책을 구성하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

측정항목을 모니터링하고, 대시보드를 빌드하고, 알림 정책을 구성하는 데 필요한 권한을 얻으려면 관리자에게 다음 IAM 역할을 부여해 달라고 요청하세요.

  • 측정항목 및 대시보드 보기: 프로젝트에 대한 모니터링 뷰어(roles/monitoring.viewer)
  • 대시보드 및 알림 정책을 만들고 관리하려면 프로젝트에 대한 모니터링 편집자(roles/monitoring.editor) 역할이 필요합니다.

역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이러한 사전 정의된 역할에는 측정항목을 모니터링하고, 대시보드를 빌드하고, 알림 정책을 구성하는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

필수 권한

측정항목을 모니터링하고, 대시보드를 빌드하고, 알림 정책을 구성하려면 다음 권한이 필요합니다.

  • 대시보드 보기: 프로젝트에 대한 monitoring.dashboards.get 권한
  • 대시보드 만들기: 프로젝트에 대한 monitoring.dashboards.create
  • 알림 설정: 프로젝트에 대한 monitoring.alertPolicies.create

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

VM 확장 프로그램에 사용할 수 있는 측정항목

Monitoring에서 VM 확장 프로그램을 모니터링하는 데 사용할 수 있는 측정항목은 다음과 같습니다.

측정항목 이름 측정항목 유형 설명
VM 확장 프로그램 시행 상태 compute.googleapis.com/vm_extensions/extension/enforcement_status Compute Engine VM 확장 프로그램의 시행 상태입니다. 라벨에는 extension_name 및 status가 포함됩니다.

확장 프로그램 이름 목록은 지원되는 확장 프로그램을 참조하세요.

status에 가능한 값은 다음과 같습니다.

  • ENFORCEMENT_STATE_UNSPECIFIED
  • INSTALLING
  • INSTALL_FAILED
  • INSTALLED
  • ROLLING_BACK
  • ROLLBACK_FAILED
  • ROLLED_BACK
  • INCOMPATIBLE
  • REMOVING
  • SERVICE_DISABLED
  • APPLYING_CONFIG
VM 확장 프로그램 상태 compute.googleapis.com/vm_extensions/extension/health_status VM 확장 프로그램의 상태입니다. 라벨에는 extension_name 및 status가 포함됩니다.

확장 프로그램 이름 목록은 지원되는 확장 프로그램을 참조하세요.

status에 가능한 값은 다음과 같습니다.

  • HEALTH_STATUS_UNSPECIFIED
  • STARTING
  • RUNNING
  • STOPPING
  • STOPPED
  • CRASHED
VM 확장 프로그램 CPU 최대 사용량 compute.googleapis.com/vm_extensions/extension/cpu/max_usage VM 확장 프로그램에서 사용하는 최대 CPU 시간으로, 백분율로 표시됩니다.
VM 확장 프로그램 메모리 최대 사용 바이트 compute.googleapis.com/vm_extensions/extension/memory/used_bytes VM 확장 프로그램에서 사용하는 최대 메모리(바이트)입니다.

커스텀 모니터링 대시보드 빌드

사용 사례에 가장 관련성이 높은 VM 확장 프로그램 차트를 사용하여 Monitoring 대시보드를 빌드할 수 있습니다. 대시보드에 차트를 추가하려면 다음 단계를 완료합니다.

  1. Google Cloud 콘솔에서 Monitoring을 선택합니다.

    Monitoring으로 이동

  2. 탐색창에서 대시보드를 선택합니다.
  3. 대시보드 만들기를 클릭합니다.
  4. 위젯 추가를 클릭합니다.
  5. 위젯 추가 창의 데이터에 측정항목을 선택합니다.
  6. 측정항목을 선택하려면 측정항목 선택 메뉴를 펼치고 다음 단계를 완료합니다.
    1. 활성 리소스에서 VM 인스턴스를 선택합니다.
    2. 측정항목 카테고리에서 Vm_extensions를 선택합니다.
    3. 측정항목에서 VM 확장 프로그램 상태와 같은 측정항목을 선택합니다. 사용 가능한 측정항목 목록은 VM 확장 프로그램에 사용 가능한 측정항목을 참조하세요.
    4. 적용을 클릭합니다.

대시보드에 원하는 만큼 차트를 추가할 수 있습니다. 자세한 내용은 커스텀 대시보드 만들기 및 관리를 참조하세요.

알림 정책 설정

Monitoring을 사용하면 알림을 만들고 측정항목이 지정된 기준점을 초과할 때 알림을 받을 수 있습니다. 예를 들어 확장 프로그램의 상태가 CRASHED로 변경되면 알림을 받을 수 있습니다.

알림 정책을 만들려면 다음 단계를 완료합니다.

  1. Google Cloud 콘솔에서 Monitoring을 선택합니다.

    Monitoring으로 이동

  2. 탐색 창에서 알림을 선택합니다.
  3. 정책 만들기를 클릭합니다.
  4. 알림 정책 만들기 페이지에서 다음 단계를 완료하여 알림 조건을 구성합니다.
    1. 측정항목을 선택하려면 측정항목 선택 메뉴를 펼치고 다음 단계를 완료합니다.
      1. 활성 리소스에서 VM 인스턴스를 선택합니다.
      2. 측정항목 카테고리에서 Vm_extensions를 선택합니다.
      3. 측정항목에서 VM 확장 프로그램 시행 상태와 같은 측정항목을 선택합니다. 사용 가능한 측정항목 목록은 VM 확장 프로그램에 사용할 수 있는 측정항목을 참조하세요.
      4. 적용을 클릭합니다.
    2. status 라벨이 INSTALL_FAILED와 같은지 여부와 같은 트리거 조건을 구성합니다.
  5. 안내에 따라 알림 채널을 추가하고 정책 이름을 지정합니다.
  6. 정책 만들기를 클릭합니다.

자세한 내용은 알림 정책 만들기를 참조하세요.

다음 단계