Type to search.

Troubleshoot Watcher

Stack

The Elastic Stack includes Elastic's core products such as Elasticsearch, Kibana, Logstash, and Beats.

Availability

  • Generally available

    This functionality is generally available and ready for production usage.

Unless stated otherwise on the page, this functionality is available when your Elastic Stack is deployed on Elastic Cloud Hosted, Elastic Cloud Enterprise, Elastic Cloud on Kubernetes, and self-managed environments.

This documentation corresponds to the latest patch available for each minor version. If you're not using the latest patch, check the release notes for changes.

Dynamic mapping error when trying to add a watch

If you get the Dynamic Mapping is Disabled error when you try to add a watch, verify that the index mappings for the .watches index are available. You can do that by submitting the following request:

JSON 
GET .watches/_mapping

If the index mappings are missing, follow these steps to restore the correct mappings:

  1. Stop the Elasticsearch node.

  2. Add xpack.watcher.index.rest.direct_access : true to elasticsearch.yml.

  3. Restart the Elasticsearch node.

  4. Delete the .watches index:

    JSON 
    DELETE .watches

  5. Disable direct access to the .watches index:

    1. Stop the Elasticsearch node.
    2. Remove xpack.watcher.index.rest.direct_access : true from elasticsearch.yml.
    3. Restart the Elasticsearch node.

Unable to send email

If you get an authentication error indicating that you need to continue the sign-in process from a web browser when Watcher attempts to send email, you need to configure Gmail to Allow Less Secure Apps to access your account.

If you have two-step verification enabled for your email account, you must generate and use an App Specific password to send email from Watcher. For more information, see:

Watcher not responsive

Keep in mind that there’s no built-in validation of scripts that you add to a watch. Buggy or deliberately malicious scripts can negatively impact Watcher performance. For example, if you add multiple watches with buggy script conditions in a short period of time, Watcher might be temporarily unable to process watches until the bad watches time out.