|
|
@ -1,31 +1,30 @@ |
|
|
|
<h1>Configuring Notifications</h1> |
|
|
|
<p>You can set up multiple ways to receive notifications when checks in your account |
|
|
|
change state. This is useful for multiple reasons:</p> |
|
|
|
change state. This is useful for several reasons:</p> |
|
|
|
<ul> |
|
|
|
<li><strong>Redundancy in case of notification failures.</strong> Set up notifications using two different |
|
|
|
transports (for example, email and Slack). If one transport fails (e.g., an email |
|
|
|
message goes to spam), you still receive the notification over the other transport.</li> |
|
|
|
<li><strong>Redundancy in case of notification failures.</strong> Set up notifications using two |
|
|
|
different notification channels (for example, email and Slack). If one transport |
|
|
|
fails (e.g., an email message goes to spam), you still receive a notification over the |
|
|
|
other channel.</li> |
|
|
|
<li><strong>Use different notification methods depending on urgency</strong>. For example, if a |
|
|
|
low-priority housekeeping script fails, post a message in chat. If a vital service fails, |
|
|
|
post in chat, send an email, and send SMS.</li> |
|
|
|
post in chat, send an email and send SMS.</li> |
|
|
|
<li>Route notifications to the right people.</li> |
|
|
|
</ul> |
|
|
|
<p>Notification methods ("integrations") are scoped to a project: |
|
|
|
if you want to use a notification method in multiple projects, it must be |
|
|
|
set up in each project separately.</p> |
|
|
|
<p>In the web interface, the list of checks shows a visual overview of which alerting |
|
|
|
methods are enabled for each check. You can click the icons to toggle them on and off:</p> |
|
|
|
<p>Each notification method ("integration") belongs to a project: |
|
|
|
if you want to use a notification method in multiple projects, you will need to |
|
|
|
set it up in each project separately.</p> |
|
|
|
<p>In the web interface, the "Checks" page shows a visual overview of which alerting |
|
|
|
methods are active for each check. You can click the icons to toggle them on and off:</p> |
|
|
|
<p><img alt="Integration icons in the checks list" src="IMG_URL/checks_integrations.png" /></p> |
|
|
|
<p>You can also toggle the integrations on and off when viewing an individual check by |
|
|
|
clicking on the "ON" / "OFF" labels:</p> |
|
|
|
<p>You can also toggle the integrations by clicking the "ON" / "OFF" labels in |
|
|
|
individual check's details pages:</p> |
|
|
|
<p><img alt="Integration on/off toggles in the check details page" src="IMG_URL/details_integrations.png" /></p> |
|
|
|
<h2>SMS, WhatsApp and Phone Call Monthly Quotas</h2> |
|
|
|
<p>SITE_NAME limits the maximum number of SMS, WhatsApp and phone call notifications an |
|
|
|
account can send per any given month. The specific limit depends on account's |
|
|
|
billing plan.</p> |
|
|
|
<p>The limit is applied to the combined number of sent SMS, WhatsApp and phone call |
|
|
|
notifications. It automatically resets at the start of each month. The "unused" sends |
|
|
|
from one month do not carry over to the next month.</p> |
|
|
|
<h2>SMS, WhatsApp, and Phone Call Monthly Quotas</h2> |
|
|
|
<p>SITE_NAME sets a quota on the maximum number of SMS, WhatsApp, and phone-call |
|
|
|
notifications an account can send per given month. The specific limit depends on the |
|
|
|
account's billing plan. The quota automatically resets at the start of each month. |
|
|
|
The "unused" sends from one month do not carry over to the next month.</p> |
|
|
|
<p>When an account exceeds its monthly limit, SITE_NAME will:</p> |
|
|
|
<ul> |
|
|
|
<li>Send a warning email to account's primary email address</li> |
|
|
@ -41,22 +40,22 @@ PagerTree), you can set up escalation rules there.</li> |
|
|
|
play a loud notification sound on your phone every 5 minutes until the notification |
|
|
|
is acknowledged.</li> |
|
|
|
<li>SITE_NAME can send <strong>hourly or daily email reminders</strong> if any check is down |
|
|
|
across all projects you have access to. |
|
|
|
in any of your projects. |
|
|
|
Set them up in <a href="../../accounts/profile/notifications">Account Settings › Email Reports</a>:</li> |
|
|
|
</ul> |
|
|
|
<p><img alt="Email reminder options" src="IMG_URL/email_reports.png" /></p> |
|
|
|
<h2>Monthly Reports</h2> |
|
|
|
<p>SITE_NAME sends monthly email reports at the start of each month. Use them |
|
|
|
to make sure all checks have their expected state and nothing has |
|
|
|
"fallen through the cracks".</p> |
|
|
|
<p>A monthly report shows checks from all projects you have access |
|
|
|
to. For each check it lists:</p> |
|
|
|
"fallen through the cracks."</p> |
|
|
|
<p>A monthly report shows checks from all your projects. |
|
|
|
For each check it lists:</p> |
|
|
|
<ul> |
|
|
|
<li>check's current status</li> |
|
|
|
<li>the number of downtimes by month, for the two previous months</li> |
|
|
|
<li>the total downtime duration by month, for the two previous months</li> |
|
|
|
<li>the number of downtimes by month, for the last two months</li> |
|
|
|
<li>the total downtime duration by month, for the last two months</li> |
|
|
|
</ul> |
|
|
|
<p><img alt="Example monthly report" src="IMG_URL/monthly_report.png" /></p> |
|
|
|
<p>You can opt out from the monthly reports in the |
|
|
|
<p>You can opt-out from the monthly reports in the |
|
|
|
<a href="../../accounts/profile/notifications/">Account Settings › Email Reports</a> page |
|
|
|
or by clicking the "Unsubscribe" link in report's footer.</p> |
|
|
|
or by clicking the "Unsubscribe" link in the email report's footer.</p> |