Monitor Clarity issues
Clarity offers a self-service tool for managing issues: Clarity safety scenario. The safety scenario makes monitoring easy by alerting you to any issues or even stopping Clarity if it detects a critical issue.
This article guides you on how to use the Clarity safety scenario to monitor Clarity issues.
Clarity safety scenario
Clarity safety scenario (in the Clarity Safety initiative) runs every hour to monitor key Clarity metrics. Clarity must be running for the safety scenario to work.

Preview of Clarity safety scenario.
Clarity metrics and thresholds
The table below outlines the thresholds for the safety scenario to send you email notifications or stop Clarity. Clarity safety is running only if there were at least 5 messages from your customers within the past hour. If this condition is met, the safety scenario is active to send alerts or even stop Clarity.
Metric | Yellow warning threshold - email sent | Red threshold |
---|---|---|
Error rate (1H) - the percentage of messages with errors in the last hour | > 50% | > 75%. Clarity stops. |
Error rate (24H) - the percentage of messages with errors in the last 24 hours | > 5% | > 10%. Clarity stops. |
Sorry rate (1H) - the percentage of messages containing "sorry" in the last hour | > 80% | > 90%. Clarity stops. |
Sorry rate change (24H) - the percentage increase in "sorry" messages over 24 hours | > 50% | > 90%. Clarity stops. |
Traffic change (24H) - significant drop or spike in Clarity events | > 50% change | Doesn't stop Clarity. |
Close rate change (24H) - increase in users closing Clarity | > 50% change | Doesn't stop Clarity. |
Note
When Clarity can't answer a question, it responds, “Sorry, I can't help with that.” The sorry rate measures the frequency of messages containing “sorry” or an equivalent term in the local language (for example,"prepáč" in Slovak, “beklager” in Norwegian).
Error detection and email notifications
Clarity monitors key performance metrics. When it detects an issue, it triggers a notification based on severity:
-
Green: Clarity detects no issues and keeps running. If all metrics are green, you won't get an email.
-
Yellow: Warning. Clarity detects a potential issue but keeps running. Bloomreach sends a yellow warning email with the metrics that caused the warning. For you to receive an email, at least one metric must be in yellow.
Preview of the Clarity warning email notification.
-
Red: Clarity detects a critical issue and stops running. If the issue persists, Bloomreach sends a red stop mail every 6 hours. For Clarity to stop, at least one metric must be in red.
Preview of the Clarity stop email notification.
Edit email notification recipients
The notification mailing list is typically configured during integration. If you wish to get the notification emails or notify any other stakeholders, follow the steps:
-
Go to the Clarity Safety initiative.
-
Open the Clarity safety scenario.
-
Under the Design tab, you see the Emergency Notification flow. Double-click the emergency emails condition node.
Double-click the emergency emails condition node.
-
Enter the email in the indicated input box.
Enter the recipient emails.
Note: The number of specified emails must match the number of matched customers. If they don't match, the customer profile is missing for that email:
Ensure the number of emails matches with the matched customers.
- Go to Data & Assets > Customers.
- Create a new customer profile for the unmatched emails.
- After creating the new customer profiles, return to the email condition node in the safety scenario.
-
Click Done and then click Save.
Performance reports
Clarity safety scenario generates a report (daily, weekly, or monthly, as per your choice) to monitor key metrics and alert stakeholders. We track these metrics continuously. If they exceed the critical threshold, Clarity stops.

Preview of a weekly performance report.
Updated 2 days ago