Notification logs

Notification logs allow you to understand and monitor what notifications are being sent for your workspace, who they're sent to, and how users are engaging with them.

Log retention

Notification logs are retained for 30 days, and the contents of the notifications are retained for 14 days.

Accessing notification logs in Cortex

You can view notification logs in the Cortex UI or fetch them through the Cortex API.

Access notification logs via the Cortex UI

Users with the View notification logs permission can access notification logs in Cortex under Settings > Notification logs.

Notification log summary

The summary at the top of this page includes:

• A count of how many notifications are enabled
  • In the upper right corner of this tile, click the gear icon to visit the Notifications page where you can review the list of enabled notifications.
• The number of notifications delivered in the last 7 days
• The number of notifications that failed to deliver in the last 7 days

Notification log list fields

The list of notifications includes:

• Timestamp when the notification was sent
• The name of the notification
  • An icon appears next to the notification name to indicate which medium was used to notify the user.
• The status
  • Statuses include:
    • Completed: The message was delivered successfully.
    • Completed with errors: Some recipients received the notification, but some did not. Click the notification to review details.
    • Failed: Notification failed to be delivered.
    • Ignored: The notification was ignored. This can occur for several reasons, including:
      • Disabled workspace: This status will appear if the notification medium has been disabled for the workspace, but there was an attempt to send a notification via that medium. For example, if an email notification is triggered, but email notifications are disabled for the workspace.
      • Scorecard disabled: Notifications are disabled for a scorecard.
    • Created: The notification has not yet been sent. If this occurs, try resending the notification.
• How many times it was sent
• The object that triggered the notification (e.g., a Scorecard, entity, initiative, etc.)
• The ability to resend the notification.

Filter the notification logs list

1. In the upper right corner of the list, click the filter icon.
2. In the "Filter notification logs" modal, apply any of the following:
   • Date created (start)
   • Date created (end)
   • Notification type
   • Status
   • Medium
   • Order
   • Ignored reason
   • Failed reason
     
3. Click Save.

View more information about a notification

Click into a log to open a side panel showing the date a notification was sent, when it was last resent, and who the recipients of the message were:

To see a preview of the notification message, click the eye icon next to the status:

Notification logs are retained for 30 days, and the contents of the notifications are retained for 14 days.

Resend a notification

Users with the Execute notification logs permission can resend a notification to all users, or to specific users.

To resend a notification:

1. Locate the notification in the list.
2. In the row for the notification, click the Resend icon on the right side.
3. In the "Resend notification" modal, select whether you want to send the notification to all previous recipients, or only recipients who did not receive the notification.
4. Click Resend notification.

Access notification logs via API

Notification logs can also be accessed through the public API endpoint.