이 페이지는 Cloud Translation API를 통해 번역되었습니다.

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

Linux Windows

각 가상 머신 (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. Install the Google Cloud CLI, then initialize it by running the following command:
  gcloud init
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. Set a default region and zone.

필요한 역할

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

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

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

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

필수 권한

인스턴스를 만들고 인스턴스 유지보수를 관리하려면 다음 권한이 필요합니다.

메타데이터를 포함한 인스턴스에 대한 정보를 가져오려면 다음을 실행합니다. compute.instances.get

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

제한사항

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

가속기 최적화 머신 제품군:
- 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"
    "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: 유지보수 기간을 이동할 수 있는 가장 늦은 시간입니다.
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

인스턴스에 예정된 유지보수 기간을 보려면 gcloud compute instances describe 명령어를 사용합니다.

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

다음을 바꿉니다.

INSTANCE_NAME: 컴퓨팅 인스턴스의 이름입니다.
ZONE_NAME: 인스턴스가 있는 영역입니다.

예정된 유지보수 이벤트가 있는 경우 응답에 다음과 유사한 섹션이 포함됩니다.

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

이 응답에서:

유지보수는 windowStartTime에 표시된 날짜 및 시간에 예약됩니다.
canReschedule는 True로 설정되고 maintenanceStatus는 PENDING로 설정됩니다. 이러한 설정은 latestWindowStartTime에 표시된 날짜 이전에 예약된 유지보수 이벤트를 수동으로 시작할 수 있음을 나타냅니다.

REST

인스턴스에 예정된 유지보수가 있는지 확인하려면 instances.get 메서드를 사용하여 GET 요청을 생성합니다.

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

다음을 바꿉니다.

PROJECT_NAME: 컴퓨팅 인스턴스가 포함된 프로젝트의 이름입니다.
ZONE: 인스턴스가 있는 영역입니다.
INSTANCE_NAME: 인스턴스 이름입니다.

예정된 유지보수 이벤트가 있는 경우 응답에 다음과 유사한 섹션이 포함됩니다.

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

이 응답에서:

유지보수는 windowStartTime에 표시된 날짜 및 시간에 예약됩니다.
canReschedule는 True로 설정되고 maintenanceStatus는 PENDING로 설정됩니다. 이러한 설정은 latestWindowStartTime에 표시된 날짜 이전에 예약된 유지보수 이벤트를 수동으로 시작할 수 있음을 나타냅니다.

메타데이터 서버

게스트 OS에서 메타데이터 서버에 쿼리를 수행하여 다음 유지보수 이벤트를 확인합니다.

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

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

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

콘솔

인스턴스의 유지보수 알림에 관한 감사 로그를 쿼리하려면 다음 단계를 완료하세요.

VM 인스턴스 페이지로 이동합니다.

VM 인스턴스로 이동
유지보수 알림을 확인하려는 인스턴스의 이름을 클릭합니다.

인스턴스 세부정보 페이지가 열립니다.
로그 섹션에서 로깅 링크를 클릭합니다.

로그 탐색기 쿼리 편집기 페이지가 열립니다. 쿼리 창에 인스턴스의 resource.type 및 인스턴스 ID가 이미 채워져 있습니다.

쿼리 창에서 쿼리에 다음 줄을 추가합니다.

operation.producer="compute.instances.upcomingMaintenance" OR
"compute.instances.terminateOnHostMaintenance" OR
"compute.instances.migrateOnHostMaintenance"

쿼리 실행을 클릭합니다. 일치하는 유지보수 알림 이벤트가 쿼리 결과 창에 표시됩니다.

쿼리 결과 창에서 시간 수정을 클릭하여 검색 기간을 넓히거나 특정 날짜 또는 시간으로 결과를 좁힐 수 있습니다.
로그 항목을 클릭하여 유지보수 알림 세부정보를 확인합니다.
1. 예정된 유지보수 알림의 경우 metadata 제목을 펼쳐 현재 상태, 유형, 예약된 유지보수 기간 시작 및 종료 시간과 같은 정보를 확인합니다.
2. status 제목을 펼쳐 알림에 관한 설명 메시지를 확인합니다.

유지보수 알림의 예

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

methodName: "compute.instances.upcomingMaintenance"
metadata:
- maintenanceStatus: "PENDING"
- windowStartTime: "2024-07-23T20:00:00Z"

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

methodName: "compute.instances.upcomingMaintenance"
metadata:
- maintenanceStatus: "ONGOING"
- 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." }

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

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

콘솔

인스턴스의 유지보수 이벤트에 대한 알림을 만들려면 다음 단계를 완료하세요.

VM 인스턴스 페이지로 이동합니다.

VM 인스턴스로 이동
유지보수 이벤트 알림을 만들 인스턴스의 이름을 클릭합니다.

인스턴스 세부정보 페이지가 열립니다.
로그 섹션에서 로깅 링크를 클릭합니다.

로그 탐색기 쿼리 편집기 페이지가 열립니다. 쿼리 창에 인스턴스의 resource.type 및 인스턴스 ID가 이미 채워져 있습니다.

쿼리 창에서 쿼리에 다음 줄을 추가합니다.

operation.producer="compute.instances.upcomingMaintenance"

쿼리 실행을 클릭합니다. 일치하는 유지보수 알림 이벤트가 쿼리 결과 창에 표시됩니다.
쿼리 결과 창에서 시간 수정을 클릭합니다.
1. 수정 창 왼쪽의 상대 시간 필드에 1d을 입력하여 지난주 로그 항목을 확인합니다.
2. 적용을 클릭합니다.
쿼리 결과 창의 헤더에서 알림 만들기를 클릭합니다. 보기 창이 좁으면 작업 메뉴에 알림 만들기 옵션이 대신 표시될 수 있습니다.
로그 기반 알림 정책 만들기 창의 알림 세부정보 섹션에서 다음을 수행합니다.
1. 알림 정책의 이름을 입력합니다(예: Upcoming maintenance for my-c3d-vm@us-central1-b).
2. 정책 심각도 수준 메뉴에서 심각도 없음을 선택합니다.
3. 문서 필드에 알림 정책에 대한 설명을 입력할 수 있습니다. 알림 수신자가 문제를 진단하는 데 도움이 되는 정보를 포함할 수도 있습니다. 다음 문자열은 알림이 표시된 이유를 요약해서 보여줍니다.
```
Log-based alerting policy in project ${project} to monitor upcoming
maintenance notifications. See also "Host maintenance alerts" and
"onHostMaintenance actions" alerting policies.
```
  이 필드의 콘텐츠 형식 지정 및 맞춤설정 방법에 대한 상세 내용은 문서 템플릿에서 마크다운 및 변수 사용을 참조하세요.
4. 다음 단계로 이동하려면 다음을 클릭하세요.
알림에 포함할 로그 선택 섹션에서 로그 미리보기를 클릭하여 쿼리와 결과를 확인합니다.

쿼리 창에서 빌드한 쿼리도 이 창에 표시됩니다. 먼저 로그 탐색기 쿼리 창에서 쿼리를 빌드하는 것이 좋습니다.

필요한 경우 이 창에서 쿼리를 수정할 수 있습니다. 쿼리를 수정하는 경우 로그 미리보기를 클릭하여 결과를 확인합니다.
다음을 클릭합니다.
알림 빈도 및 자동 종료 기간 설정 창에서 다음을 수행합니다.
1. 알림 사이의 최소 시간을 선택합니다. 이 값을 사용하면 이 조건이 여러 번 충족될 때 모니터링에서 받는 알림 수를 컨트롤할 수 있습니다. 이 예시에서는 옵션에서 1일을 선택합니다.
2. Incident autoclose duration(Incident autoclose duration)의 경우 최대 값인 7일을 사용합니다.
3. 다음을 클릭합니다.
이메일 알림 채널이 이미 구성되어 있으면 목록에서 선택할 수 있습니다. 그렇지 않으면 알림 채널 관리를 클릭하고 이메일 채널을 추가합니다. 알림 채널 만들기에 대한 자세한 내용은 알림 채널 만들기 및 관리를 참고하세요.
저장을 클릭합니다.

이제 예시 로그 기반 알림 정책 테스트에 설명된 대로 로그 기반 알림 정책을 테스트할 수 있습니다.

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

다음 단계

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

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

시작하기 전에

Console

gcloud

REST

필요한 역할

필수 권한

제한사항

유지보수 알림 개요

유지보수 상태 정의

유지보수 상태 동작

유지보수 알림 보기

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

gcloud

REST

메타데이터 서버

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

콘솔

유지보수 알림의 예

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

콘솔

다음 단계