# Get alerts

> Lampwick alerts every member of a project's team by push notification and e-mail. Mute alerts per monitor or task, or turn off alert e-mails per account.

Lampwick alerts every member of a project's team by push notification in the Lampwick iOS app and by e-mail when a monitor, host check, site crawl or scheduled task needs attention. Alerts are on by default; there is nothing to set up.

## Requirements

- Membership of the team that owns the project.
- For e-mail: a [confirmed address](#confirm-your-address).
- For push: the Lampwick iOS app, signed in to your account.

## What alerts you

| Alert | When | Docs |
|---|---|---|
| **Down: MONITOR** | An uptime monitor fails 2 checks in a row. | [Uptime](/docs/uptime/) |
| **Up again: MONITOR** | The monitor is up again, only after a down alert. | [Uptime](/docs/uptime/) |
| SSL certificate expires or is invalid | 14, 7, 3 and 1 days before expiry, and when it becomes invalid. | [SSL, domain & DNS](/docs/host-checks/) |
| Domain expires | 30, 14, 7 and 1 days before the registration expires. | [SSL, domain & DNS](/docs/host-checks/) |
| **DNS records changed** | NS or MX records changed, confirmed by a second lookup. | [SSL, domain & DNS](/docs/host-checks/) |
| **Broken links** | A site crawl found new broken links or mixed content. | [Site crawl](/docs/crawler/) |
| **Missed**, **Failed**, **Slow**, **Running again** | A scheduled task missed a run, started failing or ran too long, and when it runs again. | [Schedule health](/docs/cron-health/) |

New and returning [issues](/docs/issues/) notify the iOS app only, not by e-mail.

A down alert puts the reason first and shows only the host and path of the URL, never the query string, because alerts pass through Apple, the mail provider and lock screens:

> **Down: Checkout API**
> HTTP 404 Not Found · 2 failed checks in a row · api.example.com/health

## Check that it works

On a monitor's page, the **Alerts** card says who gets what and shows your own alert e-mail setting. On **Account & security**, the **Alert e-mails** card shows **On** when e-mails will reach you.

## Fewer alerts on purpose

| Rule | What it does |
|---|---|
| Flapping | A monitor sends at most one down alert per 30 minutes. If it goes down again within that time, the alert comes after the 30 minutes, if it is still down. A new URL starts over. |
| Quiet starts | A new monitor that comes up alerts nothing. |
| Batching | E-mails wait 1 minute, so alerts close together arrive in one mail (up to 50 per mail). |
| Per address | At most 20 alert e-mails per address per hour; the rest go with the next mail. |
| Per project | Above 30 alerts in a project in an hour, further alerts go by e-mail only. |

## Mute alerts

| What | Where | API |
|---|---|---|
| One monitor, for the whole team | Monitor's page → **Mute alerts for everyone**, or <kbd>⌘</kbd> <kbd>K</kbd>. **Unmute alerts** turns them back on. | `updateMonitor` with `notify: false` |
| One scheduled task | **Schedule health** → **Mute** next to the task | `updateSchedule` with `muted: true` |
| All alert e-mails, for you only | **Account & security** → **Turn off alert e-mails** | `updateMe` with `alert_emails: false` |

A muted monitor keeps running its checks, host checks and crawl, and shows a **Muted** badge in the monitor list.

## Confirm your address {#confirm-your-address}

Alert e-mails go only to addresses confirmed by mail: the signup verification link, a password reset link or a mailed team invite.

1. Go to **Account & security**.
2. If the **Alert e-mails** card says **Not confirmed**, click **Send confirmation link**.
3. Open the link in the e-mail.

## Troubleshooting

| What you see | Cause and fix |
|---|---|
| No alert e-mails | On **Account & security**, check the **Alert e-mails** card: **Off** means you turned them off, **Not confirmed** means you need to confirm your address. |
| No alert for a monitor that is down | The monitor is muted (**Muted** badge), or it alerted less than 30 minutes ago. |
| Alerts on your phone stopped during a big outage | Over 30 alerts in a project in an hour go by e-mail only. |
| A colleague gets no alerts | They aren't a member of the project's team. [Invite them](/docs/teams/). |
