Add User Settings

Change how Elasticsearch runs by providing your own user settings. User settings are appended to the elasticsearch.yml configuration file for your cluster and provide custom configuration options. Elastic Cloud Enterprise supports all user settings for the version of Elasticsearch that your cluster is running.

Important

You can change Elasticsearch user settings on Elastic Cloud Enterprise without restriction. Be aware that changing some user settings can affect your cluster negatively. Use with care. For settings that are generally safe in cloud environments, see User Settings in the Elastic Cloud documentation.

To add user settings:

  1. Log into the Cloud UI.
  2. Click on a cluster name from the Clusters panel and click Edit icon.
  3. In the User Settings section, update the user settings.
  4. Click Save changes.

Example: Enable Email Notifications from Gmail

The following examples configure email notifications to Gmail for a user that you specify. Which example you use depends on the version of Elasticsearch that your cluster is running.

For version 5.0 and later: Use X-Pack to configure an email watch action. To learn more, see Configuring Email Actions.

xpack.notification.email.account:
    gmail_account:
        profile: gmail
        smtp:
            auth: true
            starttls.enable: true
            host: smtp.gmail.com
            port: 587
            user: <username>
            password: <password>

For versions before 5.0: Use Watcher to configure an email watch action. To learn more, see Configuring Email Actions.

watcher.actions.email.service.account:
  work:
    profile: gmail
    email_defaults:
      from: <email>
    smtp:
      auth: true
      starttls.enable: true
      host: smtp.gmail.com
      port: 587
      user: <username>
      password: <password>

Additional Examples of Supported User Settings

These example user settings cover only a subset of all user settings that you can include in the elasticsearch.yml configuration file. To learn more about available settings, see Configuring Elasticsearch.

User settings that you might find useful include:

reindex.remote.whitelist
Whitelists the hosts that can be reindexed from remotely. Consists of a comma-delimited list of host:port entries. Defaults to ["\*.io:*", "\*.com:*"].
script.painless.regex.enabled
Enables regular expressions for the Painless scripting language.
X-Pack alerting features (formerly Watcher)

Enables watches, including integration with Slack, HipChat, and PagerDuty. For example:

For version 5.0 and later:

For versions before 5.0:

Tip

Remember to check your user settings when performing a major version upgrade. For version 5.0 and later, the syntax for alerts is different when compared to earlier versions, for example.