[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["難以理解","hardToUnderstand","thumb-down"],["資訊或程式碼範例有誤","incorrectInformationOrSampleCode","thumb-down"],["缺少我需要的資訊/範例","missingTheInformationSamplesINeed","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間：2025-09-04 (世界標準時間)。"],[],[],null,["# Set up Cloud Monitoring alerts\n\nThis page describes how you can create alerts for Vertex AI Search for commerce,\nincluding examples of creating alerts for user event recording, predictions,\nand searches.\n\nFor information about data quality alerts, see\n[Data quality alerts](/retail/docs/data-quality#data-quality-alert).\n\nFor information about troubleshooting errors and viewing error logs, see\n[Troubleshooting data upload issues](/retail/docs/error-reporting).\n\nIntroduction\n------------\n\nKeeping your catalog up to date and recording user events successfully is\nimportant for getting high-quality results. Even if your initial imports\nand event recording are successful, monitoring error rates is still needed in\ncase of unexpected environmental issues, such as network connectivity failures.\n\nYou should set up Cloud Monitoring alerts so you can take action promptly in\ncase any issues arise with user event recording, predictions, and search\nresults. You can also monitor recent data integration error rates in the\nGoogle Cloud console at any time. \n\nSet up Cloud Monitoring alerts\n------------------------------\n\nCloud Monitoring can be set up to alert on a large number of triggers.\nWhen you set up alerts, Vertex AI Search for commerce suggests\nseveral to set up. If you're unsure which alerts to set up, start with setting\nup alerts for [prediction errors](#alert-predictions),\n[search errors](#alert-search), and\n[reductions in user event recording](#alert-user-events).\n\n### Set up an alert for prediction errors\n\nGenerally, calling the `predict` method should rarely return an error. This\nalert is triggered if the number of errors returned by the predict method causes\nthe error ratio to stay above the given threshold for more than 5 minutes. You\ncan adjust the threshold to suit your environment.\n\nTo set up alerts from the Search for commerce console:\n\n1.\n Go to the **Monitoring** page in the Search for commerce console. \n\n\n [Go to the Monitoring page](https://console.cloud.google.com/ai/retail/catalogs/default_catalog/monitoring/)\n\n2. Click *add* **Recommended Alerts**.\n\n The Recommended Alert Policies panel appears on the right. It displays a list\n of recommended alerts to set up for your project.\n3. Enable **High predict error ratio**.\n\n4. Optionally, adjust the threshold to suit your environment.\n\n The default predict error ratio is 0.03.\n5. Choose a notification channel through which you'll be notified if the alert\n is triggered, such as an email address or mobile device.\n\n To set up a new notification channel, select **Notification Channels \\\u003e\n *refresh* Manage Notification Channels** .\n See\n [the Cloud Monitoring documentation](/monitoring/support/notification-options)\n for more about creating and editing channels.\n6. Click the **Submit** button to create your alert.\n\nYou can also create a custom alert by using Cloud Monitoring. For more\ninformation, see [the Cloud Monitoring documentation](/monitoring/alerts).\n\n### Set up an alert for search errors\n\nThis alert is triggered if the number of errors returned by the `search` method\ncauses the error ratio to stay above the given threshold for more than 5\nminutes. You can adjust the threshold to suit your environment.\n\nTo set up alerts from the Search for commerce console:\n\n1.\n Go to the **Monitoring** page in the Search for commerce console. \n\n\n [Go to the Monitoring page](https://console.cloud.google.com/ai/retail/catalogs/default_catalog/monitoring/)\n\n2. Click *add* **Recommended Alerts**.\n\n The Recommended Alert Policies panel appears on the right. It displays a list\n of recommended alerts to set up for your project.\n3. Enable **High search error ratio**.\n\n4. Optionally, adjust the threshold to suit your environment.\n\n The default threshold ratio is 0.03.\n5. Choose a notification channel through which you'll be notified if the alert\n is triggered, such as an email address or mobile device.\n\n To set up a new notification channel, select **Notification Channels \\\u003e\n *refresh* Manage Notification Channels** .\n See\n [the Cloud Monitoring documentation](/monitoring/support/notification-options)\n for more about creating and editing channels.\n6. Click the **Submit** button to create your alert.\n\nYou can also create a custom alert by using Cloud Monitoring. For more\ninformation, see [the Cloud Monitoring documentation](/monitoring/alerts).\n\n### Set up an alert for user event recording reduction\n\nIf you see a drop in user event recording that lasts for a prolonged period of\ntime, there could be issues with your user event recording code. This alert\nis triggered if you don't record any user events for 10 minutes.\n\nTo set up a user event recording reduction alert from the Search for commerce console:\n\n1.\n Go to the **Monitoring** page in the Search for commerce console. \n\n\n [Go to the Monitoring page](https://console.cloud.google.com/ai/retail/catalogs/default_catalog/monitoring/)\n\n2. Click *add* **Recommended Alerts**.\n\n The Recommended Alert Policies panel appears on the right. It displays a list\n of recommended alerts to set up for your project.\n3. Enable **User events record reduction**.\n\n4. Choose a notification channel through which you'll be notified if the alert\n is triggered, such as an email address or mobile device.\n\n To set up a new notification channel, select **Notification Channels \\\u003e\n *refresh* Manage Notification Channels** .\n See\n [the Cloud Monitoring documentation](/monitoring/support/notification-options)\n for more about creating and editing channels.\n5. Click the **Submit** button to create your alert.\n\nIf you are using a method other than [`WriteUserEvent`](/retail/docs/reference/rpc/google.cloud.retail.v2#writeusereventrequest), such as [`ImportUserEvents`](/retail/docs/reference/rpc/google.cloud.retail.v2#importusereventsrequest), you can also create a custom alert by using Cloud Monitoring. For more\ninformation, see the [Cloud Monitoring documentation](/monitoring/alerts).\n\n### Set up an alert for unjoined user events\n\nThis alert is triggered if the ratio of user events that aren't associated with\nvalid products stays above the given threshold for more than one or twelve\nhours. You can choose the time window and adjust the threshold.\n\nTo set up a user event recording reduction alert from the Search for commerce console:\n\n1.\n Go to the **Monitoring** page in the Search for commerce console. \n\n\n [Go to the Monitoring page](https://console.cloud.google.com/ai/retail/catalogs/default_catalog/monitoring/)\n\n2. Click *add* **Recommended Alerts**.\n\n The Recommended Alert Policies panel appears on the right. It displays a list\n of recommended alerts to set up for your project.\n3. Enable **Ratio of unjoined user events ratio is above the threshold for last hour** or **Ratio of unjoined user events increases above threshold for last 12 hours**.\n\n4. Optionally, adjust the threshold to suit your environment.\n\n The default unjoined events ratio is 0.1. This means that if more than 10% of total events ingested are not joined with a valid product within the specified time window, an alert is triggered.\n5. Choose a notification channel through which you'll be notified if the alert\n is triggered, such as an email address or mobile device.\n\n To set up a new notification channel, select **Notification Channels \\\u003e\n *refresh* Manage Notification Channels** .\n See\n [the Cloud Monitoring documentation](/monitoring/support/notification-options)\n for more about creating and editing channels.\n6. Click the **Submit** button to create your alert.\n\nWhat's next\n-----------\n\n- [Troubleshoot your errors using Error Reporting](/retail/docs/error-reporting).\n- Learn more about [Google Cloud Observability alerting](/monitoring/alerts)."]]
