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 the Notification logs page, click Workspace notifications 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 timestamp is based on the client timezone from your browser. Hover over the timestamp to view the timezone being used.

• 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 Filter.

2. Select and configure filters for any of the following:

   • Failed reason

   • Ignored reason

   • Notification source

   • Notification type

   • Status

3. Click Apply.

You can also sort by date:

1. Click Date in the upper right corner.

2. Choose whether to sort ascending or descending.

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, who the recipients of the message were, and the contents of the notification:

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. A confirmation modal will appear.

   1. If the previous notification did not successfully send to all recipients, you will have the option to only resend to recipients who didn't receive the notification.

4. Click Resend notification.

Access notification logs via API

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