VM 확장 프로그램 모니터링

VM 확장 프로그램의 상태와 성능을 모니터링하면 리소스 사용량을 관리하고 Compute Engine 인스턴스 전체에서 문제를 해결하는 데 도움이 됩니다. Cloud Monitoring 대시보드를 사용하여 CPU 또는 메모리 소비와 같은 리소스 사용량을 시각화하고, 설치 실패와 같은 이벤트가 발생할 때 알림을 수신하도록 알림 정책을 구성할 수 있습니다.

이 문서에서는 Cloud Monitoring을 사용하여 Compute Engine 인스턴스에서 VM 확장 프로그램 관리자가 관리하는 VM 확장 프로그램을 모니터링하는 방법을 설명하고 다음 작업을 수행하는 데 도움을 줍니다.

시작하기 전에

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

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

    콘솔

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

    gcloud

    1. Google Cloud CLI를 설치합니다. 설치 후 다음 명령어를 실행하여 Google Cloud CLI를 초기화합니다. 

      gcloud init

      외부 ID 공급업체(IdP)를 사용하는 경우 먼저 제휴 ID로 gcloud CLI에 로그인해야 합니다.

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

    • REST

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

      Google Cloud CLI를 설치합니다.

      외부 ID 공급업체(IdP)를 사용하는 경우 먼저 제휴 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. 정책 만들기를 클릭합니다.

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

다음 단계