Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 3 additions & 11 deletions docs/production-deployment/cloud/get-started/certificates.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -35,8 +35,8 @@ connecting to a Namespace or starting a Workflow Execution. If the client is on
Executions that are processed by that Worker either run indefinitely without making progress until the Worker resumes or
fail because of timeouts.

Temporal Cloud sends courtesy emails 15 days, 10 days, and 5 days prior to certificate expiry. Emails are sent to Global
and Namespace Admins.
Temporal Cloud sends [courtesy emails](/cloud/notifications#admin-notifications) prior to certificate expiry.


To update certificates, see
[How to add, update, and remove certificates in a Temporal Cloud Namespace](#manage-certificates).
Expand Down Expand Up @@ -259,15 +259,7 @@ trusted authority for access to your Namespaces.
To keep your Namespace secure and online, you must update the CA certificate for the Namespace _before_ the certificate
expires.

To help you remember to do so, Temporal Cloud sends email notifications to users who have the Account Owner or Global
Admin [roles](/cloud/users#account-level-roles) or the Namespace Admin
[permission](/cloud/users#namespace-level-permissions) 15 days, 10 days and 5 days before expiration.

To ensure that you receive email notifications, configure your junk-email filters to permit email from
`noreply@temporal.io`.

To change who receives certificate-expiration notifications for a Namespace (or to provide feedback about such
notifications), [create a support ticket](/cloud/support#support-ticket).
To help you remember to do so, Temporal Cloud sends [email notifications](/cloud/notifications#admin-notifications).

## How to handle a compromised end-entity certificate

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -232,7 +232,7 @@ The audit log entry for Failover uses the `"operation": "FailoverNamespace"` eve
After failover, the replica becomes active, taking over in the isolation domain or region.

You don't need to monitor Temporal Cloud's failover response in real time.
Whenever there is a failover event, users with the Account Owner and Global Admin roles automatically receive an alert email.
Whenever there is a failover event, Temporal Cloud [notifies you via email](/cloud/notifications#admin-notifications)

### Returning to the primary with failbacks

Expand Down
51 changes: 51 additions & 0 deletions docs/production-deployment/cloud/notifications.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,51 @@
---
id: notifications
title: Notifications
sidebar_label: Notifications
description: Receive updates about Temporal Cloud including when certificates will expire, billing updates, and when a failover has completed.
slug: /cloud/notifications
toc_max_heading_level: 4
keywords:
- notification
- explanation
- how-to
- operations
- temporal cloud
- email
tags:
- Notification
- Security
- Temporal Cloud
- Billing
---

## Get notified about Temporal Cloud status {#cloud-status}

In the event of an incident, Temporal updates the [Temporal Cloud status page](https://status.temporal.io/) with important updates.
Users can subscribe to updates in their preferred mode (e.g. email, Slack, SMS, etc.) by visiting this page.

## Get notified about administrative events {#admin-notifications}

Temporal Cloud sends emails to notify users of important administrative events.

| Reason for email | Who receives email |
|------------------ | -------------------|
| Certificate Expiring in 15 days | Global Administrator, Namespace Administrator, Account Owner |
| Certificate Expiring in 10 days | Global Administrator, Namespace Administrator, Account Owner |
| Certificate Expiring in 5 days | Global Administrator, Namespace Administrator, Account Owner |
| API Key Expiring in 30 days | Global Administrator, Account Owner, individual user (if API Key has an owner) |
| API Key Expiring in 20 days | Global Administrator, Account Owner, individual user (if API Key has an owner) |
| API Key Expiring in 10 days | Global Administrator, Account Owner, individual user (if API Key has an owner) |
| Sign up credit expiring in 30 days | Account Owner, Finance Administrator |
| Sign up credit expiring in 14 days | Account Owner, Finance Administrator |
| Sign up credit expiring in 7 days | Account Owner, Finance Administrator |
| Sign up credit expiring in 1 days | Account Owner, Finance Administrator |
| Sign up credit is 50% consumed | Account Owner, Finance Administrator |
| Sign up credit is 90% consumed | Account Owner, Finance Administrator |
| Account plan type changed | Global Administrator, Account Owner, Finance Administrator |
| Namespace Failover Completed/Failed | Global Administrator, Namespace Administrator, Account Owner |

To ensure that you receive email notifications, configure your junk-email filters to permit email from
`noreply@temporal.io`.

To provide feedback on notifications or request changes, [create a support ticket](/cloud/support#support-ticket).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks great! Can get this into the docs.

1 change: 1 addition & 0 deletions sidebars.js
Original file line number Diff line number Diff line change
Expand Up @@ -439,6 +439,7 @@ module.exports = {
],
},
'production-deployment/cloud/rpo-rto',
'production-deployment/cloud/notifications',
{
type: 'category',
label: 'Temporal Nexus',
Expand Down