1개월에 한 번씩 Looker(Google Cloud 핵심 서비스)에서 인스턴스를 업그레이드할 유지보수 기간을 예약합니다. 유지보수 기간 동안 인스턴스가 다시 시작되며 일시적으로 인스턴스에 액세스할 수 없습니다. 유지보수를 수행할 요일과 시간 형식으로 인스턴스의 유지보수 기간을 지정할 수 있습니다. 기본 유지보수 기간을 지정하지 않으면 새로운 Looker (Google Cloud 핵심 서비스) 버전이 출시된 후 2주 이내에 업그레이드가 수행됩니다. 또한 유지보수 거부 기간 을 지정하여 지정한 시간 동안 유지보수가 수행되지 않도록 차단할 수 있습니다.
Looker (Google Cloud 핵심 서비스) 인스턴스가 다음 지원되는 Looker 버전으로 업그레이드되는 동안 유지보수 거부 기간을 지정하면 Looker (Google Cloud 핵심 서비스) 인스턴스에서 사용할 수 있는 기능이 Google Cloud 콘솔에서 업그레이드된 출시 버전에서 사용할 수 있다고 명시된 설정과 다를 수 있습니다.
이 문서 페이지에서는 예약된 유지보수에 대한 정보 찾기, 유지보수 선호 기간 설정, 유지보수 거부 기간 지정, Looker (Google Cloud 핵심 서비스) 인스턴스의 예정된 유지보수 업데이트에 대한 알림 구성을 설명합니다.
출시 채널 및 유지보수 정책
Looker (Google Cloud 핵심 서비스) 인스턴스가 출시 채널에 등록된 경우 구성할 수 있는 유지보수 설정은 인스턴스의 출시 채널에 따라 다릅니다.
- 신속 채널: 유지보수 기간 및 유지보수 거부 기간은 지원되지 않습니다. 신속 채널에 등록하면 이전에 인스턴스에 설정된 유지보수 기간 또는 유지보수 거부 기간이 삭제됩니다.
- 일반 채널: 기본 유지보수 기간과 유지보수 거부 기간을 지정할 수 있습니다.
- 채널 없음: 기본 유지보수 기간과 유지보수 거부 기간을 지정할 수 있습니다.
필요한 역할
Looker (Google Cloud 핵심 서비스) 인스턴스의 유지보수 설정을 구성하는 데 필요한 권한을 얻으려면 관리자에게 인스턴스가 생성된 프로젝트에 대한Looker 관리자 (roles/looker.admin) IAM 역할을 부여해 달라고 요청하세요.
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.
유지보수 설정
Looker(Google Cloud 핵심 서비스)를 사용하여 유지보수 설정을 통해 유지보수 업데이트를 구성할 수 있습니다.
짧은 다운타임으로 인스턴스에 미치는 영향이 가장 적은 시간에 유지보수를 예약하도록 구성할 수 있습니다. 다음 항목을 구성할 수 있습니다.
유지보수 기간: Looker(Google Cloud 핵심 서비스)가 유지보수를 예약하는 요일과 시간입니다. 유지보수 기간은 1시간 동안 지속됩니다.
유지보수 거부 기간: Looker(Google Cloud 핵심 서비스)가 유지보수를 예약하지 않는 기간(일 수)입니다. 유지보수 거부 기간은 최대 60일까지 설정할 수 있습니다. 유지보수 거부 기간 2개 사이에는 유지보수가 가능한 날이 14일 이상 있어야 합니다.
Looker(Google Cloud 핵심 서비스) 인스턴스를 만들 때 또는 기존 인스턴스의 구성을 수정하여 유지보수 정책을 업데이트할 수 있습니다.
선호 유지보수 기간 설정
Looker (Google Cloud 핵심 서비스)가 유지보수를 예약할 선호 기간을 지정하려면 다음 옵션 중 하나를 선택합니다.
콘솔
Google Cloud 콘솔에서 Looker (Google Cloud 핵심 서비스) 인스턴스를 만들거나 기존 Looker (Google Cloud 핵심 서비스) 인스턴스의 구성을 수정합니다.
유지보수 기간의 선호 유지보수 섹션에서 유지보수 기간에 대해 다음 설정을 구성합니다.
일: 인스턴스가 업데이트되는 요일입니다.
기간: 인스턴스 유지보수가 시작될 대략적인 시간입니다.
저장 을 클릭합니다.
인스턴스를 신속 출시 채널에 등록한 경우 이 옵션은 Google Cloud 콘솔에서 사용할 수 없습니다.
gcloud
인스턴스를 만드는 경우 gcloud looker instances create 명령어를 사용하고 인스턴스를 업데이트하는 경우에는 gcloud looker instances update 명령어를 사용하며 다음 매개변수를 포함합니다.
--maintenance-window-day=MAINTENANCE_WINDOW_DAY --maintenance-window-time=MAINTENANCE_WINDOW_TIME
다음을 바꿉니다.
MAINTENANCE_WINDOW_DAY: 인스턴스가 업데이트되는 요일입니다.friday,monday,saturday,sunday,thursday,tuesday,wednesday중 하나여야 합니다.MAINTENANCE_WINDOW_TIME: UTC 24시간 형식의 유지보수 기간 시작 시간입니다 (예:13:00,17:45).
출시 채널 미리보기 기능의 신속 채널에 Looker (Google Cloud 핵심 서비스) 인스턴스를 등록한 경우 해당 인스턴스의 유지보수 기간을 설정할 수 없습니다.
유지보수 기간을 지정하면 설정 변경사항이 적용되는 데 최대 일주일이 걸립니다.
유지보수 거부 기간 구성
예약된 유지보수를 나중에 연기하려면 인스턴스의 유지보수 거부 기간을 변경하면 됩니다. 유지보수 거부 기간은 최대 60일까지 설정할 수 있습니다.
유지보수 거부 기간 2개 사이에는 유지보수가 가능한 날이 14일 이상 있어야 합니다.
Looker (Google Cloud 핵심 서비스)가 유지보수를 수행하지 않기를 원하는 기간을 지정하려면 다음 옵션 중 하나를 선택합니다.
콘솔
Google Cloud 콘솔에서 Looker (Google Cloud 핵심 서비스) 인스턴스를 만들거나 기존 Looker (Google Cloud 핵심 서비스) 인스턴스의 구성을 수정합니다.
유지보수 거부 기간 섹션에서 유지보수 거부 기간에 대해 다음 설정을 구성합니다.
시작일: 유지보수를 수행하지 않을 기간의 시작일을 선택합니다.
종료일: 유지보수를 수행하지 않을 기간의 종료일을 선택합니다.
시작/종료 시간: 유지보수 거부 기간이 시작되고 (시작일에 지정한 날짜) 종료되는 (종료일에 지정한 날짜) 특정 시간을 정의합니다.
- 저장 을 클릭합니다.
인스턴스를 신속 출시 채널에 등록한 경우 이 옵션은 Google Cloud 콘솔에서 사용할 수 없습니다.
gcloud
인스턴스를 만드는 경우 gcloud looker instances create 명령어를 사용하고 인스턴스를 업데이트하는 경우에는 gcloud looker instances update 명령어를 사용하며 다음 매개변수를 포함합니다.
--deny-maintenance-period-end-date=DENY_MAINTENANCE_PERIOD_END_DATE
--deny-maintenance-period-start-date=DENY_MAINTENANCE_PERIOD_START_DATE
--deny-maintenance-period-time=DENY_MAINTENANCE_PERIOD_TIME
다음을 바꿉니다.
DENY_MAINTENANCE_PERIOD_START_DATE:YYYY-MM-DD형식의 거부 기간 시작일입니다.DENY_MAINTENANCE_PERIOD_END_DATE:YYYY-MM-DD형식의 거부 기간 종료일입니다.DENY_MAINTENANCE_PERIOD_TIME: UTC 24시간 형식의 시작 및 종료 시간입니다 (예:13:00,17:45).
출시 채널 미리보기 기능의 신속 채널에 Looker (Google Cloud 핵심 서비스) 인스턴스를 등록한 경우 해당 인스턴스의 유지보수 거부 기간을 설정할 수 없습니다.
유지보수 예시
예를 들어 다음과 같이 프로덕션 인스턴스의 유지보수 설정을 지정할 수 있습니다.
- 유지보수 기간: 동부시간 기준 매주 일요일 오전 12시부터 오전 1시까지
- 유지보수 거부 기간: 12월 1일 오후 10시~1월 15일 오후 10시
예정된 유지보수 알림
유지보수 예정 최대 1주일 전 예정된 유지보수에 대한 알림이 이메일로 전송되도록 설정할 수 있습니다. 알림에 대한 이메일 필터를 설정하고 싶다면 이메일 제목은 [Looker (Google Cloud 핵심 서비스) 고급 유지보수 알림] 인스턴스가 유지보수 예약됨 입니다.
기본적으로 유지보수 알림은 전송되지 않습니다. 예정된 유지보수 업데이트에 대한 알림을 받으려면 다음 두 단계를 모두 완료해야 합니다.
- 유지보수 기간 설정.
- 프로젝트 수준에서 유지보수 알림을 수신 동의하거나 로그 기반 알림을 설정합니다.
- 예약된 유지보수에 대한 알림을 받으려면 Looker (Google Cloud 핵심 서비스) 인스턴스에 대해 다음 예약된 유지보수 업데이트 최소 7일 전에 두 단계를 모두 완료해야 합니다.
콘솔 Google Cloud 을 통해 구성된 알림은 Google 계정과 연결된 이메일 주소로 전송됩니다. 커스텀 이메일 별칭 (예: 팀 이메일 별칭)을 사용할 수 있습니다.
Looker (Google Cloud 핵심 서비스) 인스턴스에서 인증에 SAML 또는 OpenID Connect (OIDC) 를 사용하거나 Slack, PagerDuty, 커스텀 웹훅과 같은 서드 파티 커뮤니케이션 채널로 알림을 라우팅하려면 로그 기반 알림을 설정하면 됩니다.
특정 프로젝트에서 유지보수 기간이 있는 모든 Looker (Google Cloud 핵심 서비스) 인스턴스에 대해 유지보수 알림을 선택할 수 있습니다. 사용자는 인스턴스당 하나의 알림을 받습니다.
유지보수 알림 수신 동의
Google Cloud 콘솔에서 유지보수 알림을 사용 설정하려면 다음 단계를 따르세요.
콘솔 Google Cloud 에서 커뮤니케이션 페이지로 이동합니다.
제품 알림 탭을 선택합니다.
드롭다운 메뉴에서 프로젝트를 선택합니다.
Looker (Google Cloud 핵심 서비스) 행에서 이메일 전환 버튼을 사용 으로 설정합니다.
유지보수 이벤트에 대한 로그 기반 알림 설정
직원 ID 제휴를 사용하여 인증하는 경우 Google Cloud 콘솔에서 Google Cloud 제휴 계정으로 유지보수 알림을 보낼 수 없습니다. 또한 Slack, PagerDuty, 커스텀 웹훅과 같은 서비스로 알림을 라우팅할 수도 있습니다. 이러한 시나리오에서 알림을 받으려면 Cloud Logging에서 로그 기반 알림 정책 을 구성하면 됩니다.
Looker (Google Cloud 핵심 서비스)가 유지보수 업데이트를 예약, 시작, 완료 또는 취소하면 활동 로그 항목을 Logging에 씁니다. 이러한 로그 항목과 일치하는 알림 정책을 만들고 구성된 알림 채널로 알림을 보낼 수 있습니다.
유지보수 이벤트에 대한 로그 기반 알림을 만들려면 로그 탐색기를 사용하여 로그 기반 알림 정책 만들기 문서의 안내에 따라 알림 정책을 만드세요. 정책에서 사용할 쿼리의 예시는 유지보수 로그 쿼리를 참고하세요.
유지보수 로그 쿼리
다음 쿼리를 사용하여 유지보수 수명 주기의 여러 단계에 대한 로그 기반 알림을 만듭니다.
LOOKER_INSTANCE_NAME을 Looker (Google Cloud 핵심 서비스) 인스턴스의 이름으로 바꿉니다.
사전 알림 (예약됨): 인스턴스에 유지보수가 예약되면 알림을 보냅니다.
log_id("maintenance.googleapis.com/activity_log") AND resource.type = "gce_instance" AND labels.activity_type_name = "LookerRolloutAdvanced" AND labels.instance_id = "LOOKER_INSTANCE_NAME"시작된 알림: 인스턴스에서 유지보수가 시작되면 알림을 보냅니다.
log_id("maintenance.googleapis.com/activity_log") AND resource.type = "gce_instance" AND labels.activity_type_name = "LookerRolloutInProgress" AND labels.is_completed = "false" AND labels.is_failed = "false" AND labels.instance_id = "LOOKER_INSTANCE_NAME"완료된 알림 (성공): 유지보수가 성공적으로 완료되면 알림을 보냅니다.
log_id("maintenance.googleapis.com/activity_log") AND resource.type = "gce_instance" AND labels.activity_type_name = "LookerRolloutInProgress" AND labels.is_completed = "true" AND labels.is_failed = "false" AND labels.instance_id = "LOOKER_INSTANCE_NAME"실패 또는 취소된 알림: 유지보수가 실패하거나 취소되면 알림을 보냅니다.
log_id("maintenance.googleapis.com/activity_log") AND resource.type = "gce_instance" AND (labels.is_failed = "true" OR labels.activity_type_name = "LookerRolloutCanceled") AND labels.instance_id = "LOOKER_INSTANCE_NAME"
예약된 유지보수 찾기
인스턴스에 유지보수가 예약된 경우 다음 단계에 따라 유지보수를 확인할 수 있습니다.
콘솔에서 Looker (Google Cloud 핵심 서비스) 페이지로 이동합니다. Google Cloud
예약된 유지보수를 확인할 인스턴스의 이름을 선택합니다.
인스턴스의 구성 세부정보를 볼 때 세부정보 페이지에서 다음 정보를 볼 수 있습니다.