このページでは、 Google Cloud コンソールのログ エクスプローラを使用して、Backup and DR バックアップ/リカバリ アプライアンスのログベースのアラートを構成する方法について説明します。
ログ エクスプローラのインターフェースでは、次の手順でログベースのアラートの作成、編集が可能です。
- アラートの名前と説明を入力します。
- 通知を受け取るログを選択します。
- 通知の間隔を設定します。
- インシデントの自動クローズまでの時間を設定します。
- 通知先のユーザーを指定します。
ログ エクスプローラの詳細については、 ログの表示と分析をご覧ください。
権限とロール
ログ エクスプローラでログベースのアラートを作成して管理するには、 Identity and Access Management(IAM)ロールに、 ログベースのアラートの権限で説明されている権限セットが含まれている必要があります。
バックアップ/リカバリ アプライアンスのログベースのアラートを作成する
アラートをトリガーするには、 通知チャンネルが必要です。通知チャンネルは、アラートを作成する前またはアラートの作成中に作成できます。
ログベースのアラートを作成する手順は次のとおりです。
- Google Cloud コンソールで [Logging] を選択し、[ログ エクスプローラ] を選択します。
[クエリ] ペインを使用して、通知を受け取るイベントを定義します。 クエリペインの サンプルクエリ に示されているクエリの例を使用して、アラートを構成できます。
特定のイベント ID を持つイベントの通知を受け取るサンプルクエリは次のとおりです。
logName="projects/PROJECT_ID/logs/backupdr.googleapis.com%2Fbackup_recovery_appliance_events" jsonPayload.eventId=10046[クエリ結果] ペインの上部にある、[アラートを作成] をクリックします。ウィンドウが狭すぎる場合は、[アラートを作成] オプションが [アクション] メニューに表示されます。
[アラートの詳細] ペインで、アラートの名前と説明を入力します。
- [アラート ポリシー名] フィールドにアラートの名前を入力します。この名前は通知ヘッダーに表示されます。
- [ドキュメント] フィールドに、アラートの説明を入力します。このフィールドの内容のフォーマットと調整の詳細については、 ドキュメント テンプレートでマークダウンと変数を使用するをご覧ください。 アプライアンス管理コンソールの URL をドキュメント フィールドに含めます。イベントを解決するための回避策を追加することもできます。
[次へ] をクリックします。
[アラートに含めるログを選択] ペインで、次の操作を行います。
- [ログをプレビュー] をクリックして、クエリと結果を確認します。必要に応じて、このペインでクエリを編集することもできます。
ラベルを追加して通知をカスタマイズし、より多くの情報を提供できます。[ラベルを追加] をクリックして、次の操作を行います。
- ラベルの表示名 を入力します。
- リストから [ログフィールド名] を選択します。これらのフィールドは、選択したクエリ結果に基づいて表示されます。
- 正規表現グループが 1 つだけ含まれているフィールドから値を抽出する正規表現 を入力します。
[次へ] をクリックします。
通知間の最小時間を選択します。この値を使用すると、アラートが複数回トリガーされた場合に、このアラートから受け取る通知の数を制御できます。たとえば、オプションから [5 分] を選択すると、通知を 5 分ごとに制限できます。必要に応じて、メニューからオプションを選択して、インシデントの自動クローズ期間を調整できます。
[次へ] をクリックします。
アラートの通知チャンネルを 1 つ以上選択します。たとえば、メール通知チャンネルを選択します。すでにメール通知チャンネルを構成している場合は、リストからそれを選択できます。そうでない場合は、[通知チャンネルを管理] をクリックしてメール チャンネルを追加します。通知チャンネルの作成については、 通知チャンネルの作成と管理をご覧ください。
[保存] をクリックします。
重要な イベント ID のアラートを構成することをおすすめします。
ログベースのアラートをテストする
作成したログベースのアラートをテストするには、クエリに一致するログエントリを手動で記述します。ログエントリを記述する手順は次のとおりです。
logEntries.writeリファレンス ページに移動するか、次のボタンをクリックします。PROJECT_ID PROJECT_ID 変数をプロジェクト ID に変更して、次のログエントリを構成します。アラート ポリシーに特定のイベント ID が含まれている場合や除外されている場合は、イベント ID も変更する必要があります。
"entries": [ { "jsonPayload": { "eventId": 10046, "errorMessage": "this is a manually generated error message created for testing" }, "resource": { "type": "backupdr.googleapis.com/BackupRecoveryAppliance", }, "severity": "ERROR", "logName": "projects/PROJECT_ID/logs/backupdr.googleapis.com%2Fbackup_recovery_appliance_events", } ]構成したログエントリをコピーします。
[この API を試す] ペインで、次の操作を行います。
- [APIs Explorer] の [リクエスト本文] フィールドの内容を、前の手順でコピーしたログエントリに置き換えます。
- [実行] をクリックします。入力を求めるメッセージが表示されたら、認証フローに従います。
logEntries.write の呼び出しが成功すると、HTTP 200 レスポンス コードと空のレスポンス本文 {} が返されます。API Explorer の詳細については、 API Explorer の使用をご覧ください。API Explorer の動作は Cloud Logging API と同じです。
ログエントリは、次の方法でアラートに指定されたフィルタと一致します。
- logName 値は、クラウド プロジェクトのバックアップ/リカバリ アプライアンス イベントのログインを指定します。
- このログエントリの重大度値は ERROR です。
- jsonPayload には、10046 プールがいっぱいのイベントが含まれています。
ログエントリを書き込むと、次のシーケンスが発生します。
- 新しいログエントリがログ エクスプローラに表示され、アラートがトリガーされます。
- インシデントが Cloud Monitoring で開かれます。
- インシデントの通知が届きます。メール通知チャンネルを構成した場合、通知が表示されます。
メール内の [インシデントを表示] をクリックすると、Cloud Monitoring でインシデントを確認できます。インシデントの確認とクローズの方法など、インシデントの詳細については、 ログベースのアラートのインシデントを管理するをご覧ください。
複数のアラート ポリシーを作成する
イベントの優先度と緊急度に基づいてアラート ポリシーを作成できます。 アラートの観点から見ると、イベントは次のカテゴリに大別できます。
緊急に対応する必要があるため、通知頻度を高くする必要があるイベント。たとえば、イベント ID 43901(スナップショット ジョブの失敗)は 30 分ごとに報告する必要があります。次のクエリを使用してアラートを作成します。
Policyname = 'Snapshot job has failed' Notification rate limit = 30 min logName="projects/PROJECT_ID/logs/backupdr.googleapis.com%2Fbackup_recovery_appliance_events" AND jsonPayload.eventId=43901緊急度が低いため、通知頻度を低くする必要があるイベント。 たとえば、イベント ID 10085(バックアップ プランの違反)は 1 日に 1 回だけ報告する必要があります。次のクエリを使用してアラートを作成します。
Policyname = 'Backup Plan Violation has occurred' Notification rate limit = 1 day logName="projects/PROJECT_ID/logs/backupdr.googleapis.com%2Fbackup_recovery_appliance_events" AND jsonPayload.eventId=10085影響がなく、無視できるイベント。たとえば、イベント ID 10229(ストレージ エラー超過)と 42356(ファイルの変更が検出されました)は、誤検出であるため無視できます。次のクエリを使用してアラートを作成します。
Policyname = 'Backup/DR event has occurred' Notification rate limit = 6 hr logName="projects/PROJECT_ID/logs/backupdr.googleapis.com%2Fbackup_recovery_appliance_events" AND NOT jsonPayload.eventId=(10085 OR 10229 OR 42356 OR 43901)