Notifications

Notifications are built into Cortex to help users stay on top of changes within their environments and within the platform. There are several types of notifications:

Initiative creation notifications will alert you when you create an initiative. These alerts will be sent within the hour that the initiative was created. For example, if you create an initiative at 3:32 p.m., you’ll get a notification at 4 p.m. that the initiative was created. The notification will also include the action items associated with the entities you own. These notifications will only be sent to users who own services that are included in the initiative.

Initiative reminder notifications will alert you seven days and one day before an initiative’s target date. This notification will tell you how much time remains in the initiative, as well as your uncompleted action items.

Entity evaluation notifications go out when you have updated an entity, and that entity is reevaluated by a Scorecard. This alert will tell you whether the score for that entity has increased or decreased. You will not receive a notification if the score is unchanged after we process the changes. 

Weekly report notifications are sent out Mondays at 9 a.m. PT, and will alert you to any changes in your workspace over the last week. This will include scores that improved or dropped, pull requests that are open and waiting for your review, and Jira tickets assigned to you.

On-call change notifications are sent out when the appointed user on call changes. These notifications will go about an hour before the on-call shift. On-call reminder notifications are sent to the user on call for a given entity 7 days and 1 day before the on-call shift. Reminder notifications don’t have to go to a designated service owner.

Integration configuration error notifications will also notify users who can edit settings if the configuration for an integration has been changed, and is no longer valid. Cortex runs a nightly cron job that checks to ensure configurations are valid; when it detects a change that makes the configuration invalid, admins will receive a notification around 7 am PT alerting them to fix it.

Onboarding notifications will go out to users after they log into Cortex for the first time. This notification will welcome users to the platform and will provide information to get started, including an introduction to the catalog. Users will also receive an onboarding message two weeks into using Cortex with information on using the developer homepage, and a final notification six weeks into using Cortex with more in-depth information on other tools, such as the API explorer and Dependency graph.

Unsubscribing

Users also have the ability to unsubscribe from any of these notification types. To access Notification subscriptions, navigate to Settings. You’ll find Notification subscriptions under Preferences. To unsubscribe, select the toggle next to the appropriate notification; you can re-subscribe to any notification type the same way.

You also have the ability to adjust workspace notifications — this is available in the Notifications page under Workspace. From this page, you have the ability to turn notifications on or off for all users, or for email users. Email users are users whose email address is in Cortex, but who have not yet logged into the platform.