Email Notifications Overview
CloudShell admins can configure CloudShell to send notification emails at different stages during the lifecycle of CloudShell sandboxes and/or automation suites. To use email notifications, configure SNMP, as explained in the CloudShell Suite Installation Guide's Admin Configuration Settings, and set the appropriate sandbox lifecycle key(s) and/or automation suite notification.
For example, a "sandbox started" notification email:
- CloudShell sends notification emails to the email defined in the CloudShell user's profile.
- The time stamp on the emails is in the time zone of the recipient. In the event of multiple recipients in different time zones, CloudShell will send a different email to each time zone's recipients.
Automation suite notifications
Suite notifications are configured per suite, in the Email Notifications drop-down list. The recipient is the user that executed the automation suite. For additional information, see Add a new automation suite.
Sandbox lifecycle notifications
Sandbox lifecycle notifications include notifications for the different sandbox lifecycle events including On start, On setup complete (active) and On end, and calendar invites for future reservations or extended sandboxes.
These notifications are set using the configuration keys listed in the following sections. To set any of these configuration keys, copy the appropriate key from this article to the \QualiSystems\CloudShell\Server\customer.config file and restart the Quali Server service.
Sandbox notification defaults
These keys define the email notification defaults for new sandboxes. The recipient of each notification is mentioned below, but you can configure CloudShell to also send these notifications to admins and specific email addresses, as explained in the Admin override keys section below.
On start (when the sandbox is reserved):
<add key="ReservationEmail.SendNotificationOnStart" value="True"/>
On setup completion (when the sandbox's setup phase completes, provided in CloudShell 9.3):
<add key="ReservationEmail.SendNotificationOnSetupComplete" value="True"/>
- Time to Teardown (when teardown is scheduled to start): For details about this notification, see the Admin override keys section below.
Before end (x minutes before the sandbox's teardown phase starts):
<add key="ReservationEmail.NotificationMinutesBeforeEnd" value="True"/>
On end (when the sandbox ends):
<add key="ReservationEmail.SendNotificationOnEnd" value="True"/>
Note that the sandbox end-user can change the defaults in the Email Notifications section of the sandbox's Reserve, Restore or Update forms.
Email notifications for all sandbox events to admins/domain admins
These keys ensure the admins/domain admins receive notifications for all sandbox lifecycle events, even if the sandbox end-user disabled them.
<add key="ReservationEmail.NotifySystemAdmins" value="True"/>
<add key="ReservationEmail.NotifyDomainAdmins" value="True"/>
Email notifications for specific sandbox events
These keys ensure the admins receive a notification for specific sandbox events, even if the sandbox end-user disabled them.
On Start (when the sandbox is reserved):
<add key="ReservationEmail.OverrideSendNotificationOnStart" value="True"/>
On setup complete (when the sandbox's setup phase completes, provided in CloudShell 9.3):
<add key="ReservationEmail.OverrideSendNotificationOnSetupComplete" value="True"/>
Before end (x minutes before the sandbox is scheduled to end):
<add key="ReservationEmail.OverrideSendNotificationBeforeEnd" value="True"/>
Time to Teardown (when teardown is scheduled to start, sent at the start of the sandbox; recipients are the admins and domain admins):
<add key="ReservationEmail.SendNotificationBeforeEnd" value="True"/>
On end (when the sandbox ends):
<add key="ReservationEmail.OverrideSendNotificationOnEnd" value="True"/>
Additional sandbox notifications
Send calendar invite for future sandboxes (recipient is the owner of the sandbox):
<add key="SendEmailForFutureReservations" value="True"/>
Note that the sandbox end-user can also manually create a calendar invite, as explained in Create a Calendar Event for a Sandbox.
Disable calendar invites for extended/cancelled sandboxes (recipient is the admin): By default, CloudShell sends an email notification whenever the user extends a sandbox or cancels a future sandbox. To disable this behavior, set these keys:
<add key="ReservationEmail.SendNotificationOnReschedule" value="False"/>and
<add key="ReservationEmail.OverrideSendNotificationOnRescheduled" value="False"/>
- New permitted user notification (recipients are the permitted users): When adding permitted users to an active sandbox, those users will receive both a notification email informing them of the addition and any other email notifications defined in the sandbox. The notification is only sent if the sandbox has any notifications enabled. This behavior is provided out-of-the-box in CloudShell 9.3.
Email notifications for all sandbox events to specific email addresses
This key enables CloudShell to send sandbox event notifications to a list of email addresses (comma-separated).
<add key="ReservationEmail.RecipientsToNotify" value="firstname.lastname@example.org;email@example.com"/>