このページでは、ユーザー イベントの記録、予測、検索のアラートを作成する例など、小売業向け Vertex AI Search のアラートを作成する方法について説明します。
データ品質のアラートについては、データ品質のアラートをご覧ください。
エラーのトラブルシューティングとエラーログの表示については、データ アップロードに関する問題のトラブルシューティングをご覧ください。
はじめに
高品質な結果を取得するには、カタログを最新の状態に保ち、ユーザー イベントを正常に記録することが重要です。最初のインポートとイベントの記録が正常に行われた場合でも、ネットワーク接続障害などの予期しないネットワーク接続の問題のためにエラー率をモニタリングすることは依然として必要です。
ユーザー イベントの記録、予測、検索結果に問題が発生した場合に迅速に対応できるように、Cloud Monitoring アラートを設定する必要があります。また、最新のデータ統合エラー率は Google Cloud コンソールでいつでもモニタリングできます。
Cloud Monitoring アラートを設定する
多数のトリガーでアラートするように Cloud Monitoring を設定できます。アラートを設定する際に、小売業向け Vertex AI Search によっていくつかのアラートの設定が提案されます。設定するアラートがわからない場合は、予測エラー、検索エラー、ユーザー イベント記録の減少のアラートの設定から始めます。
予測エラーのアラートを設定する
一般に、predict メソッドを呼び出しても、エラーが返されることはほとんどありません。このアラートは、予測メソッドによって返されるエラーの数によって、エラー率が指定のしきい値を 5 分以上超える場合にトリガーされます。ご使用の環境に合うようにしきい値を調整できます。
小売向け検索コンソールからアラートを設定するには:
Search for Retail コンソールの [Monitoring] ページに移動します。
[Monitoring] ページに移動します。add[推奨アラート]をクリックします。
推奨アラート ポリシーパネルが右側に表示されます。プロジェクトに設定する推奨アラートのリストが表示されます。
[High predict error ratio] を有効にします。
必要に応じて、ご使用の環境に合うようにしきい値を調整します。
デフォルトの予測エラー率は 0.03 です。
アラートが発生したときに通知する通知チャネル（メールアドレス、モバイル デバイスなど）を選択します。
新しい通知チャンネルを設定するには、[通知チャンネル] > [refresh 通知チャンネルの管理] の順に選択します。チャンネルの作成と編集の詳細については、Cloud Monitoring のドキュメントをご覧ください。
[送信] ボタンをクリックして、アラートを作成します。
Cloud Monitoring を使用してカスタム アラートを作成することもできます。詳細については、Cloud Monitoring のドキュメントをご覧ください。
検索エラーのアラートを設定する
このアラートは、search メソッドによって返されたエラーの数によって、エラー率が指定のしきい値を 5 分間以上超える場合にトリガーされます。ご使用の環境に合うようにしきい値を調整できます。
小売向け検索コンソールからアラートを設定するには:
Search for Retail コンソールの [Monitoring] ページに移動します。
[Monitoring] ページに移動します。add[推奨アラート]をクリックします。
推奨アラート ポリシーパネルが右側に表示されます。プロジェクトに設定する推奨アラートのリストが表示されます。
[高検索エラー率] を有効にします。
必要に応じて、ご使用の環境に合うようにしきい値を調整します。
デフォルトのしきい値比率は 0.03 です。
アラートが発生したときに通知する通知チャネル（メールアドレス、モバイル デバイスなど）を選択します。
新しい通知チャンネルを設定するには、[通知チャンネル] > [refresh 通知チャンネルの管理] の順に選択します。チャンネルの作成と編集の詳細については、Cloud Monitoring のドキュメントをご覧ください。
[送信] ボタンをクリックして、アラートを作成します。
Cloud Monitoring を使用してカスタム アラートを作成することもできます。詳細については、Cloud Monitoring のドキュメントをご覧ください。
ユーザー イベント記録の削減に関するアラートを設定する
ユーザーイベント記録の低下が長時間続く場合は、ユーザー イベントの記録コードに問題がある可能性があります。このアラートは、ユーザー イベントを 10 分間記録しなかった場合に発生します。
小売向け検索コンソールからユーザー イベント記録の削減アラートを設定するには:
Search for Retail コンソールの [Monitoring] ページに移動します。
[Monitoring] ページに移動します。add[推奨アラート]をクリックします。
推奨アラート ポリシーパネルが右側に表示されます。プロジェクトに設定する推奨アラートのリストが表示されます。
[ユーザー イベント記録の削減] を有効にします。
アラートが発生したときに通知する通知チャネル（メールアドレス、モバイル デバイスなど）を選択します。
新しい通知チャンネルを設定するには、[通知チャンネル] > [refresh 通知チャンネルの管理] の順に選択します。チャンネルの作成と編集の詳細については、Cloud Monitoring のドキュメントをご覧ください。
[送信] ボタンをクリックして、アラートを作成します。
WriteUserEvent 以外のメソッド（ImportUserEvents など）を使用している場合は、Cloud Monitoring を使用してカスタム アラートを作成することもできます。詳細については、Cloud Monitoring のドキュメントをご覧ください。
結合されていないユーザー イベントに関するアラートを設定する
このアラートは、有効な商品に関連付けられていないユーザー イベントの比率が、指定のしきい値である 1 時間または 12 時間を超えた場合にトリガーされます。期間を選択してしきい値を調整できます。
小売向け検索コンソールからユーザー イベント記録の削減アラートを設定するには:
Search for Retail コンソールの [Monitoring] ページに移動します。
[Monitoring] ページに移動します。add[推奨アラート]をクリックします。
推奨アラート ポリシーパネルが右側に表示されます。プロジェクトに設定する推奨アラートのリストが表示されます。
[過去 1 時間において未結合のユーザー イベントの比率がしきい値を超えている] または [過去 12 時間において未結合のユーザー イベントの比率がしきい値を超えている] を有効にします。
必要に応じて、ご使用の環境に合うようにしきい値を調整します。
デフォルトの未結合のイベントの比率は 0.1 です。つまり、取り込まれたイベントの総数の 10% 以上が指定された期間内の有効な商品と結合されなかった場合、アラートがトリガーされます。
アラートが発生したときに通知する通知チャネル（メールアドレス、モバイル デバイスなど）を選択します。
新しい通知チャンネルを設定するには、[通知チャンネル] > [refresh 通知チャンネルの管理] の順に選択します。チャンネルの作成と編集の詳細については、Cloud Monitoring のドキュメントをご覧ください。
[送信] ボタンをクリックして、アラートを作成します。