호스트 유지보수 이벤트 모니터링 및 계획

각 가상 머신(VM) 인스턴스 또는 베어메탈 인스턴스는 호스트 유지보수 정책을 사용하여 유지보수 작업 중의 인스턴스 동작을 결정합니다. 일부 인스턴스에서는 사전에 유지보수 일정을 볼 수 있는 추가 옵션을 제공합니다.

이 페이지에서는 Compute Engine 인스턴스에서 호스트 유지보수 이벤트를 모니터링하고 계획하는 방법을 설명합니다.

시작하기 전에

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

  Select the tab for how you plan to use the samples on this page:

  Console

  When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

  gcloud

  1. After installing the Google Cloud CLI, initialize it by running the following command:

     gcloud init

     If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  2. Set a default region and zone.

  REST

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

  After installing the Google Cloud CLI, initialize it by running the following command:

  gcloud init

  If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

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

필요한 역할

인스턴스를 만들고 인스턴스 유지보수를 관리하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

• Compute 인스턴스 관리자(v1)(roles/compute.instanceAdmin.v1)
• 시스템 이벤트 감사 로그에 대한 읽기 전용 액세스의 경우: 로그 뷰어(roles/logging.viewer)

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

이러한 사전 정의된 역할에는 인스턴스를 만들고 인스턴스 유지보수를 관리하는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

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

제한사항

인스턴스가 다음 머신 계열 중 하나의 머신 유형을 사용하는 경우에만 인스턴스의 예정된 유지보수 이벤트에 대한 알림을 볼 수 있습니다.

• 가속기 최적화 머신 계열:

  • A3

  • A2

  • G2

• 범용 머신 계열:

  • C4A

  • C4

  • C3D

  • C3

• 메모리 최적화 머신 계열:

  • X4

  • M3

  • M2

  • M1

• 스토리지 최적화 머신 계열:

  • Z3

유지보수 알림 개요

Google은 여러 가지 방법으로 예정된 호스트 유지보수에 대한 알림을 보냅니다. 유지보수 기간이 시작되면 Google Cloud 에서 인스턴스 유지보수를 자동으로 수행합니다. 인스턴스의 예약된 유지보수 기간을 모니터링하면 중단을 최소화하면서 예정된 유지보수를 처리할 수 있도록 워크로드를 사전에 준비할 수 있습니다.

유지보수 이벤트 알림을 지원하는 컴퓨팅 인스턴스에는 다음과 같은 특성이 있습니다.

• 유지보수 이벤트 감소: 일반적으로 유지보수 간격이 반복되는 인스턴스에서는 유지보수 이벤트 수가 감소합니다.
• 유지보수 알림 기간 증가: 적절한 계획을 위해 빠른 시간 내에 유지보수 이벤트에 대한 알림이 제공됩니다.
• 모니터링 및 계획: Cloud Logging을 사용하여 유지보수 일정을 추적합니다. 이슈 및 알림을 사용해서 최신 정보를 확인합니다.
• 주문형 유지보수 제어: 알림 기간 중에 유지보수를 시작하여 일정에 맞게 인스턴스를 업데이트합니다.

예정된 알림 이벤트에 대한 정보는 다음과 유사한 방식으로 표시됩니다.

upcomingMaintenance:{
    "canReschedule":True
    "latestWindowStartTime": "2024-12-01T19:00:01Z"
    "machineType":"x4-megamem-960-metal"
    "maintenanceStatus":"PENDING"
    "type":"SCHEDULED"
    "windowEndTime": "2024-12-01T22:00:00Z"
    "windowStartTime": "2024-12-01T19:00:00Z"
}

예정된 유지보수 이벤트가 없는 경우에는 대신 다음과 유사한 메시지가 표시됩니다.

{ "error": "no notifications have been received yet, try again later" }

유지보수 상태 정의

다음 상태 정의는 인스턴스의 호스트 유지보수에 대한 쿼리의 응답을 설명합니다. 유지보수 이벤트와 관련된 정보를 제공합니다. Google Cloud CLI, REST, 메타데이터 서버는 다음과 같은 동일한 응답을 사용합니다.

• canReschedule: 이 인스턴스의 알림 기간 중에 유지보수를 수동으로 시작할 수 있는지 여부입니다.
  • TRUE: 알림 기간 중에 고객이 트리거하는 유지보수를 수행할 수 있습니다.
  • FALSE: 이 인스턴스에서 고객이 트리거하는 유지보수를 수행할 수 없습니다. 이는 인스턴스에서 유지보수가 진행 중인 기간 중에 또는 인스턴스 유형에서 주문형 유지보수를 지원하지 않는 경우에 자주 발생합니다.
• latestWindowStartTime: 유지보수 기간을 이동할 수 있는 가장 늦은 시간입니다.
• machineType: 인스턴스의 머신 유형입니다(예: x4-megamem-960-metal 또는 c4-highmem-192).
• maintenanceStatus: 유지보수 이벤트의 현재 상태입니다.
  • ONGOING: 유지보수 작업이 진행 중입니다.
  • PENDING: 유지보수 작업이 예약되었지만 아직 시작하지 않았습니다.
• type: 수행할 유지보수의 유형입니다.
  • NONE: 이 인스턴스에 예약된 유지보수가 없습니다.
  • SCHEDULED: 서비스를 중단시키는 유지보수의 경우 Compute Engine은 최소 7일 전에 대부분의 인스턴스에 알림을 제공합니다. X4 인스턴스의 경우 약 60일 전에 알림이 제공됩니다.
  • UNSCHEDULED: 유지보수가 중요한 업데이트를 나타내므로 Compute Engine은 최대한 많은 사전 알림을 제공하려고 하지만 일반적으로 예약된 유지보수 이벤트에 비해 훨씬 적습니다.
• windowEndTime: 유지보수가 수행되는 종료 시간입니다.
• windowStartTime: 유지보수가 수행되는 시작 시간입니다.

유지보수 상태 동작

유지보수 이벤트를 관리할 때는 canReschedule 및 maintenanceStatus의 값을 확인합니다. 이러한 필드를 함께 사용하면 유지보수 이벤트 일정 변경과 관련하여 취할 수 있는 작업과 취할 수 없는 작업을 나타낼 수 있습니다.

• canReschedule=True 및 maintenanceStatus=Pending: 예약 시작 시간 전에 인스턴스의 유지보수 이벤트를 수동으로 시작할 수 있습니다.
• canReschedule=False 및 maintenanceStatus=Ongoing: 유지보수가 진행 중이며 일정을 변경할 수 없습니다.
• canReschedule=False 및 maintenanceStatus=Pending: 인스턴스에서 수동으로 트리거된 유지보수 이벤트를 지원하지 않습니다.

유지보수 알림 보기

컴퓨팅 인스턴스, 메타데이터 서버를 쿼리하거나 Cloud Logging을 사용하여 유지보수 알림을 찾을 수 있습니다.

인스턴스 유지보수 이벤트 알림 확인

Google Cloud CLI, REST를 사용하거나 메타데이터 서버를 쿼리하여 인스턴스에 예정된 호스트 유지보수 이벤트가 있는지 확인합니다.

gcloud compute instances describe INSTANCE_NAME \
   --zone=ZONE_NAME --format="yaml(resourceStatus.upcomingMaintenance)"

  resourceStatus:
    upcomingMaintenance:
      canReschedule: true
      latestWindowStartTime: '2025-01-15T12:00:01Z'
      machineType: x4-megamem-960-metal
      maintenanceStatus: PENDING
      type: SCHEDULED
      windowEndTime: '2025-01-15T16:00:00Z'
      windowStartTime: '2025-01-15T12:00:00Z'

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_NAME/zones/ZONE/instances/INSTANCE_NAME

  upcomingMaintenance:{
    "canReschedule":True
    "latestWindowStartTime": "2023-12-01T19:00:01Z"
    "machineType": "x4-megamem-960-metal"
    "maintenanceStatus":"PENDING"
    "type":"SCHEDULED"
    "windowEndTime": "2023-12-01T22:00:00Z"
    "windowStartTime": "2023-12-01T19:00:00Z"
  }

$ curl http://metadata.google.internal/computeMetadata/v1/instance/upcoming-maintenance?alt=json -H "Metadata-Flavor: Google"

Cloud Logging의 유지보수 이벤트 알림 확인

Compute Engine은 Cloud 감사 로그에 인스턴스 유지보수 이벤트에 대한 시스템 이벤트를 만듭니다. Cloud Logging 및 로그 탐색기를 사용하여 유지보수 이벤트 전, 도중, 후에 이러한 이벤트를 볼 수 있습니다.

유지보수 알림 예시

인스턴스 유지보수 이벤트 알림이 로그 탐색기에 다음과 유사한 값으로 표시됩니다.

• methodName: "compute.instances.upcomingMaintenance"
• metadata:
  • maintenanceStatus: "PENDING"
  • machineType: "x4-megamem-960-metal"
  • windowStartTime: "2024-07-23T20:00:00Z"

유지보수 이벤트가 시작되면 다음과 유사한 값이 포함된 새 정보 이벤트가 로그에 표시됩니다.

• methodName: "compute.instances.upcomingMaintenance"
• metadata:
  • maintenanceStatus: "ONGOING"
  • machineType: "x4-megamem-960-metal"
  • windowStartTime: "2024-07-23T20:00:00Z"

인스턴스의 호스트 유지보수 정책 구성에 따라 유지보수 이벤트 중에 다음 시스템 이벤트 중 하나가 감사 로그에 로깅됩니다.

• 유지보수 이벤트 중에 라이브 마이그레이션을 사용하도록 구성된 인스턴스의 경우 methodName: "compute.instances.migrateOnHostMaintenance"가 포함된 시스템 이벤트
• 유지보수 이벤트 중에 종료되도록 구성된 인스턴스의 경우 methodName: "compute.instances.terminateOnHostMaintenance"가 포함된 시스템 이벤트

유지보수 이벤트가 종료되면 다음과 유사한 값이 포함된 새 정보 이벤트가 감사 로그에 표시됩니다.

• methodName: "compute.instances.upcomingMaintenance"
• status: { message: "Maintenance window has completed for this instance. All maintenance notifications on the instance have been removed." }

호스트 유지보수 알림에 대한 알림 구성

로그 기반 알림 정책을 설정하여 특정 유지보수 알림 이벤트를 검색하고 알림 채널을 사용하여 알림을 보낼 수 있습니다.

자세한 내용은 로그 기반 알림 구성 및 알림 채널 만들기 및 관리를 참조하세요.

다음 단계

• 호스트 유지보수 정책 설정 방법 알아보기
• 라이브 마이그레이션 알림 받기 방법 알아보기
• 수동으로 호스트 유지보수 이벤트 트리거 방법 알아보기
• Monitoring용 Google Cloud 콘솔이나 Monitoring API를 사용하여 로그 기반 알림 정책을 관리하는 방법 알아보기