이 문서에서는 Unified Maintenance를 설정하고 사용하는 방법을 설명합니다. 통합 유지보수 API를 사용 설정하고, 직접 쿼리하고, Cloud Logging으로 자동 전송되는 유지보수 이벤트 로그를 관리하는 방법을 설명합니다.
통합 유지관리 API 사용 설정
Unified Maintenance API를 직접 쿼리하려면Google Cloud 프로젝트에서 API를 사용 설정해야 합니다. App Hub 애플리케이션의 유지보수 활동을 보려면 관리 프로젝트에서 API를 사용 설정하세요.
API를 사용 설정하면 GKE Fleet의 Unified Maintenance 섹션에서 Unified Maintenance 이벤트를 볼 수 있습니다.
Maintenance API를 사용 설정합니다.
API 사용 설정에 필요한 역할
API를 사용 설정하려면 serviceusage.services.enable 권한이 필요합니다. 프로젝트를 만든 경우 소유자 역할 (roles/owner)을 통해 이 권한이 이미 있을 수 있습니다. 그렇지 않으면 서비스 사용량 관리자 역할 (roles/serviceusage.serviceUsageAdmin)을 통해 이 권한을 얻을 수 있습니다. 역할을 부여하는 방법 알아보기
gcloud services enable maintenance.googleapis.com
Cloud Logging에서 유지관리 활동 로그 수신
Unified Maintenance 서비스는 Unified Maintenance API가 사용 설정되었는지 여부와 관계없이 유지보수 로그를 자동으로 전송합니다. 프로젝트의 Cloud Logging에 기본 역할 (뷰어, 편집자 또는 소유자) 중 하나가 부여된 경우 Unified Maintenance 로그에 액세스하는 데 필요한 권한이 있는 것입니다.
필요한 권한에 대해 자세히 알아보려면 IAM으로 액세스 제어를 참고하세요.
Unified Maintenance는 비활성화할 수 없지만 로그 저장은 선택 해제할 수 있습니다. 선택 해제하려면 유지보수 로그 사용 중지를 참고하세요.
프로젝트에서 Unified Maintenance 로그의 리소스 사용량을 모니터링하려면 측정항목 임곗값 알림 정책을 만들면 됩니다. 자세한 내용은 Google Cloud Observability 문서의 측정항목 기준점 알림 정책 만들기를 참고하세요.
다음 단계
- 유지보수 활동 보기
- 로그 스키마 개요
- 알림 및 알림 구성
- 일반적인 알림 정책 구현