Setting up alerts for data upload issues

This page describes how you can create alerts for Recommendations AI, including examples of creating alerts for user event recording and predictions.

For information about troubleshooting errors and viewing error logs, see Troubleshooting data upload issues.

Introduction

Keeping your catalog up to date and recording user events successfully is important for getting high-quality recommendations. Even if your initial imports and event recording are successful, monitoring error rates is still needed in case of unexpected environmental issues, such as network connectivity failures.

You should set up Cloud Monitoring alerts so you can take action promptly in case any issues arise with user event recording and predictions. You can also monitor recent data integration error rates in the Google Cloud console at any time.

Setting up Cloud Monitoring alerts

Cloud Monitoring can be set up to alert on a large number of triggers. When you set up alerts in the Google Cloud console, Recommendations AI suggests several to set up. If you're unsure which alerts to set up, start with setting up alerts for prediction errors and reductions in user event recording.

Setting up an alert for prediction errors

Generally, calling the predict method should rarely return an error. This alert is triggered if the number of errors returned by the predict method causes the error ratio to stay above the given threshold for more than 5 minutes. You can adjust the threshold to suit your environment.

To set up alerts from the Recommendations AI Console:

  1. Go to the Recommendations AI Errors page in the Google Cloud console.
    Go to the Recommendations AI Errors page

  2. Click Recommended Alerts.

    The Recommended Alert Policies panel appears on the right. It displays a list of recommended alerts to set up for your project.

  3. Enable High predict error ratio.

  4. Optionally, adjust the threshold to suit your environment.

    The default predict error ratio is 0.03.

  5. Choose a notification channel through which you'll be notified if the alert is triggered, such as an email address or mobile device.

    To set up a new notification channel, select Notification Channels > Manage Notification Channels. See the Cloud Monitoring documentation for more about creating and editing channels.

  6. Click the Submit button to create your alert.

You can also create a custom alert by using Cloud Monitoring. For more information, see the Cloud Monitoring documentation.

Setting up an alert for user event recording reduction

If you see a drop in user event recording that lasts for a prolonged period of time, there could be issues with your user event recording code. This alert is triggered if you don't record any user events for 10 minutes.

To set up a user event recording reduction alert from the Recommendations AI Console:

  1. Go to the Recommendations AI Errors page in the Google Cloud console.
    Go to the Recommendations AI Errors page

  2. Click Recommended Alerts.

    The Recommended Alert Policies panel appears on the right. It displays a list of recommended alerts to set up for your project.

  3. Enable User events record reduction.

  4. Choose a notification channel through which you'll be notified if the alert is triggered, such as an email address or mobile device.

    To set up a new notification channel, select Notification Channels > Manage Notification Channels. See the Cloud Monitoring documentation for more about creating and editing channels.

  5. Click the Submit button to create your alert.

You can also create a custom alert by using Cloud Monitoring. For more information, see the Cloud Monitoring documentation.

What's next