<commit_before>[role="xpack"]
[[notification-settings]]
=== {watcher} settings in Elasticsearch

[subs="attributes"]
++++
<titleabbrev>{watcher} settings</titleabbrev>
++++

[[notification-settings-description]]
// tag::notification-settings-description-tag[]
You configure {watcher} settings to set up {watcher} and send notifications via
<<email-notification-settings,email>>,
<<slack-notification-settings,Slack>>, and
<<pagerduty-notification-settings, PagerDuty>>.

All of these settings can be added to the `elasticsearch.yml` configuration file,
with the exception of the secure settings, which you add to the {es} keystore.
For more information about creating and updating the {es} keystore, see
<<secure-settings>>. Dynamic settings can also be updated across a cluster with the
<<cluster-update-settings,cluster update settings API>>.
// end::notification-settings-description-tag[]

[[general-notification-settings]]
==== General Watcher Settings
`xpack.watcher.enabled`::
(<<static-cluster-setting,Static>>)
Set to `false` to disable {watcher} on the node.

[[xpack-watcher-encrypt-sensitive-data]]
// tag::watcher-encrypt-sensitive-data-tag[]
`xpack.watcher.encrypt_sensitive_data` {ess-icon}::
(<<static-cluster-setting,Static>>)
Set to `true` to encrypt sensitive data. If this setting is enabled, you
must also specify the `xpack.watcher.encryption_key` setting. For more
information, see <<encrypting-data>>.
// end::watcher-encrypt-sensitive-data-tag[]

`xpack.watcher.encryption_key`::
(<<secure-settings,Secure>>)
Specifies the path to a file that contains a key for encrypting sensitive data.
If `xpack.watcher.encrypt_sensitive_data` is set to `true`, this setting is
required. For more information, see <<encrypting-data>>.

`xpack.http.proxy.host`::
(<<static-cluster-setting,Static>>)
Specifies the address of the proxy server to use to connect to HTTP services.

`xpack.http.proxy.port`::
(<<static-cluster-setting,Static>>)
Specifies the port number to use to connect to the proxy server.

`xpack.http.proxy.scheme`::
(<<static-cluster-setting,Static>>)
Protocol used to communicate with the proxy server. Valid values are `http` and
`https`. Defaults to the protocol used in the request.

`xpack.http.default_connection_timeout`::
(<<static-cluster-setting,Static>>)
The maximum period to wait until abortion of the request, when a
connection is being initiated.

`xpack.http.default_read_timeout`::
(<<static-cluster-setting,Static>>)
The maximum period of inactivity between two data packets, before the
request is aborted.

`xpack.http.tcp.keep_alive`
(<<static-cluster-setting,Static>>)
Whether to enable TCP keepalives on HTTP connections. Defaults to `true`.

`xpack.http.connection_pool_ttl`
(<<static-cluster-setting,Static>>)
The time-to-live of connections in the connection pool. If a connection is not
re-used within this timeout, it is closed. By default, the time-to-live is
infinite meaning that connections never expire.

`xpack.http.max_response_size`::
(<<static-cluster-setting,Static>>)
Specifies the maximum size an HTTP response is allowed to have, defaults to
`10mb`, the maximum configurable value is `50mb`.

`xpack.http.whitelist`::
(<<dynamic-cluster-setting,Dynamic>>)
A list of URLs, that the internal HTTP client is allowed to connect to. This
client is used in the HTTP input, the webhook, the slack, pagerduty,
and jira actions. This setting can be updated dynamically. It defaults to `*`
allowing everything. Note: If you configure this setting and you are using one
of the slack/pagerduty actions, you have to ensure that the
corresponding endpoints are explicitly allowed as well.<commit_msg>[DOCS] Fix formatting for Watcher settings (#76491)<commit_after>[role="xpack"]
[[notification-settings]]
=== {watcher} settings in Elasticsearch

[subs="attributes"]
++++
<titleabbrev>{watcher} settings</titleabbrev>
++++

[[notification-settings-description]]
// tag::notification-settings-description-tag[]
You configure {watcher} settings to set up {watcher} and send notifications via
<<email-notification-settings,email>>,
<<slack-notification-settings,Slack>>, and
<<pagerduty-notification-settings, PagerDuty>>.

All of these settings can be added to the `elasticsearch.yml` configuration file,
with the exception of the secure settings, which you add to the {es} keystore.
For more information about creating and updating the {es} keystore, see
<<secure-settings>>. Dynamic settings can also be updated across a cluster with the
<<cluster-update-settings,cluster update settings API>>.
// end::notification-settings-description-tag[]

[[general-notification-settings]]
==== General Watcher Settings
`xpack.watcher.enabled`::
(<<static-cluster-setting,Static>>)
Set to `false` to disable {watcher} on the node.

[[xpack-watcher-encrypt-sensitive-data]]
// tag::watcher-encrypt-sensitive-data-tag[]
`xpack.watcher.encrypt_sensitive_data` {ess-icon}::
(<<static-cluster-setting,Static>>)
Set to `true` to encrypt sensitive data. If this setting is enabled, you
must also specify the `xpack.watcher.encryption_key` setting. For more
information, see <<encrypting-data>>.
// end::watcher-encrypt-sensitive-data-tag[]

`xpack.watcher.encryption_key`::
(<<secure-settings,Secure>>)
Specifies the path to a file that contains a key for encrypting sensitive data.
If `xpack.watcher.encrypt_sensitive_data` is set to `true`, this setting is
required. For more information, see <<encrypting-data>>.

`xpack.http.proxy.host`::
(<<static-cluster-setting,Static>>)
Specifies the address of the proxy server to use to connect to HTTP services.

`xpack.http.proxy.port`::
(<<static-cluster-setting,Static>>)
Specifies the port number to use to connect to the proxy server.

`xpack.http.proxy.scheme`::
(<<static-cluster-setting,Static>>)
Protocol used to communicate with the proxy server. Valid values are `http` and
`https`. Defaults to the protocol used in the request.

`xpack.http.default_connection_timeout`::
(<<static-cluster-setting,Static>>)
The maximum period to wait until abortion of the request, when a
connection is being initiated.

`xpack.http.default_read_timeout`::
(<<static-cluster-setting,Static>>)
The maximum period of inactivity between two data packets, before the
request is aborted.

`xpack.http.tcp.keep_alive`::
(<<static-cluster-setting,Static>>)
Whether to enable TCP keepalives on HTTP connections. Defaults to `true`.

`xpack.http.connection_pool_ttl`::
(<<static-cluster-setting,Static>>)
The time-to-live of connections in the connection pool. If a connection is not
re-used within this timeout, it is closed. By default, the time-to-live is
infinite meaning that connections never expire.

`xpack.http.max_response_size`::
(<<static-cluster-setting,Static>>)
Specifies the maximum size an HTTP response is allowed to have, defaults to
`10mb`, the maximum configurable value is `50mb`.

`xpack.http.whitelist`::
(<<dynamic-cluster-setting,Dynamic>>)
A list of URLs, that the internal HTTP client is allowed to connect to. This
client is used in the HTTP input, the webhook, the slack, pagerduty,
and jira actions. This setting can be updated dynamically. It defaults to `*`
allowing everything. Note: If you configure this setting and you are using one
of the slack/pagerduty actions, you have to ensure that the
corresponding endpoints are explicitly allowed as well.
{'fraction_non_alphanumeric': 0.11602285092491839, 'fraction_numerical': 0.0017682263329706202, 'mean_word_length': 5.727355901189387, 'pattern_counts': {'":': 0, '<': 83, '<?xml version=': 0, '>': 83, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '1082611', 'n_tokens_mistral': 2164, 'n_tokens_neox': 2103, 'n_words': 775}