﻿---
title: Enable Watcher
description: Watcher can be enabled when configuring your cluster. You can run Alerting on a separate cluster from the cluster whose data you are actually watching...
url: https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/5609/explore-analyze/alerting/watcher/enable-watcher
products:
  - Elastic Cloud Hosted
applies_to:
  - Elastic Stack: Generally available
---

# Enable Watcher
<note>
  If you are looking for Kibana alerting, check [Alerting](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/5609/explore-analyze/alerting).
</note>

Watcher can be enabled when configuring your cluster. You can run Alerting on a separate cluster from the cluster whose data you are actually watching.

## Before you begin

Some restrictions apply when adding alerts. To learn more, check [Restrictions for alerts (via Watcher)](/elastic/docs-content/pull/5609/deploy-manage/deploy/elastic-cloud/restrictions-known-problems#ec-restrictions-watcher).
To enable Watcher on a cluster, you may first need to perform one or several of the following steps. The options shown in the UI differ between stack versions; if an option is not available, you can skip it.
- To receive default Elasticsearch Watcher alerts (cluster status, nodes changed, version mismatch), you need to have monitoring enabled to send to the Admin email address specified in Kibana. To enable this, go to **Advanced Settings > Admin email**.

To learn more about Kibana alerting and how to use it, check [Alerting and Actions](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/5609/explore-analyze/alerting).

## Send alerts by email

You can configure notifications similar to the [operational emails](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/5609/deploy-manage/cloud-organization/operational-emails) that Elastic Cloud sends automatically to alert you about performance issues in your clusters.
Watcher in Elastic Cloud is preconfigured with an email service and can be used without any additional configuration. Alternatively, a custom mail server can be configured as described in [Configuring a custom mail server](#watcher-custom-mail-server)
You can optionally add [HTML sanitization](/elastic/docs-content/pull/5609/explore-analyze/alerting/watcher/actions-email#email-html-sanitization) settings under [Elasticsearch User settings](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/5609/deploy-manage/deploy/elastic-cloud/edit-stack-settings) in the [Elastic Cloud Console](https://cloud.elastic.co?page=docs&placement=docs-body) so that HTML elements are sanitized in the email notification.
For more information on sending alerts by email, check [Email action](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/5609/explore-analyze/alerting/watcher/actions-email).

## Cloud email service limits

Refer to [Email service limits](/elastic/docs-content/pull/5609/deploy-manage/deploy/elastic-cloud/tools-apis#email-service-limits).

## Advanced usage


### Slack and PagerDuty integration

Under the hood, Alerting is configured through [`elasticsearch.yml`](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/5609/deploy-manage/stack-settings). If you want to customize your Alerting settings, you can provide custom `elasticsearch.yml` snippet which is appended to your configuration.
To provide the custom snippet, you can use the console [Elasticsearch settings editor](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/5609/deploy-manage/deploy/elastic-cloud/edit-stack-settings) for your deployment.
For example if you want to use the Slack integration:
There are three steps to integrate Elasticsearch with Slack:
1. Generate a Webhook URL in Slack.  It will look similar to `https://hooks.slack.com/services/..`
2. Add a Slack account name to your [Elasticsearch User settings](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/5609/deploy-manage/deploy/elastic-cloud/edit-stack-settings)
3. Associate the Slack account with the Slack Webhook in the Elasticsearch keystore

To add a webhook in Slack, select the settings icon, then choose **Add an app** and search for `webhook`.
The following example shows a configuration with multiple Slack accounts (`account1`, `account2`, and `account3`) specified in [`elasticsearch.yml`](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/5609/deploy-manage/stack-settings):
```sh
xpack.notification.slack:
  default_account: account1
  account:
    account1:
      message_defaults:
        from: account1
        to: channel1
    account2:
      message_defaults:
        from: account2
        to: channel2
    account3:
      message_defaults:
        from: account3
        to: channel3
```


### Slack Webhook account settings

The Slack Webhook is set for each account in the Elasticsearch Keystore with the following settings:
<definitions>
  <definition term="Setting name">
    `xpack.notification.slack.account.ACCOUNT_NAME.secure_url` where ACCOUNT_NAME is the Slack account, such as `account1`.
  </definition>
  <definition term="Type">
    Single string
  </definition>
  <definition term="Secret">
    The Webhook URL you generated in Slack earlier.
  </definition>
</definitions>

<note>
  To specify a Slack account to use for a Watcher Alert that isn’t set as `default_account`, you must create an Advanced Watch and explicitly define which Slack account to use in the actions section.
</note>

If you have a Slack account that is not currently set as *default_account*, and you want to use this account for a Watcher Alert, you must create an Advanced Watch and explicitly define in the Actions section of the UI which Slack account to use.
```sh
PUT _watcher/watch/test-alarm
{
  "metadata" : {
    ...
  },
  "trigger" : {
    ...
  },
  "input" : {
    ...
  },
  "actions" : {
    "notify-slack" : {
      "throttle_period" : "10s",
      "slack" : {
        "account" : "account2",
        "message" : {
          "to" : [ "#testing-channel" ],
          "text" : "You Know, for Search"
        }
      }
    }
  }
}
```

**In Elasticsearch versions before 7.0:**, you are not required to use the Elasticsearch keystore. Instead, you can use the console Elasticsearch settings editor for your deployment.
![Advanced Alerting configuration](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/5609/explore-analyze/images/cloud-user-settings.png)


## Configuring a custom mail server

It is possible to use a custom mail service instead of the one configured by default. It can be configured by following the [Elasticsearch documentation for configuring email accounts](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/5609/explore-analyze/alerting/watcher/actions-email).
An example on how to configure a new account from the Elastic cloud console:
1. From your deployment menu, go to the **Edit** page.
2. In the **Elasticsearch** section, select **Manage user settings and extensions**.
3. Add the settings for a new mail account.
   ```yaml
   xpack.notification.email:
     default_account: my_email_service
     account:
       my_email_service:
           smtp:
               auth: true
               starttls.enable: true
               starttls.required: true
               host: email-smtp.us-east-1.amazonaws.com
               port: 587
               user: <username>
   ```
4. Select **Save changes**.
5. To complete the configuration, the password for the email service has to be added to the keystore
   1. Follow the steps described in our security settings documentation to [Add a secret value](/elastic/docs-content/pull/5609/deploy-manage/security/secure-settings#ec-add-secret-values) to the keystore
2. Set the **Setting name** as `xpack.notification.email.account.my_email_service.smtp.secure_password` (The account name must match the configuration in the user settings).
6. The new email account is now set up. It will now be used by default for watcher email actions.

For a full reference of all available settings, see the [Elasticsearch documentation](https://docs-v3-preview.elastic.dev/elastic/elasticsearch/tree/main/reference/elasticsearch/configuration-reference/watcher-settings#email-notification-settings).