このドキュメントでは、Unified Maintenance の設定方法と使用方法について説明します。 Unified Maintenance API を有効にする方法、API に直接クエリを実行する方法、Cloud Logging に自動的に送信されるメンテナンス イベントログを管理する方法について説明します。
Unified Maintenance API を有効にする
Unified Maintenance API に直接クエリを実行するには、プロジェクトで API を有効にする必要があります。Google Cloud App Hub アプリケーションのメンテナンス アクティビティを表示する場合は、 管理プロジェクトで API を有効にします。
API を有効にすると、GKE Fleet の [Unified Maintenance] セクションで Unified Maintenance イベントを表示できます。
Maintenance API を有効にします。
API を有効にするために必要なロール
API を有効にするには、serviceusage.services.enable 権限が必要です。プロジェクトを作成した場合は、オーナーロール（roles/owner）を通じてこの権限が付与されている可能性があります。それ以外の場合は、Service Usage 管理者ロール（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 ドキュメントの指標しきい値のアラート ポリシーを作成するをご覧ください。
次のステップ
- メンテナンス アクティビティを表示する
- ログスキーマの概要
- アラートと通知を構成する
- 一般的なアラート ポリシーを実装する