Extended alerting documentation with information about using Kibana keystore and action types for preconfigured connectors

docs/user/alerting/action-types.asciidoc

@@ -44,10 +44,8 @@ see https://www.elastic.co/subscriptions[the subscription page].
 === Preconfigured connectors and action types
 
 You can create connectors for actions in <<managing-alerts-and-actions, Alerts and Actions>> or via the action API.
-For out-of-the-box and standardized connectors, you can <<pre-configured-connectors, preconfigure connectors>>
-before {kib} starts.
-
-Action type with only preconfigured connectors could be specified as a <<pre-configured-action-types, preconfigured action type>>.
+For out-of-the-box and standardized connectors, you can <<preconfigured-connector-example, preconfigure connectors>>
+or define action type with only preconfigured connectors could be specified as a <<preconfigured-action-type-example, preconfigured action type>> before {kib} starts .
 
 include::action-types/email.asciidoc[]
 include::action-types/index.asciidoc[]
@@ -56,4 +54,3 @@ include::action-types/server-log.asciidoc[]
 include::action-types/slack.asciidoc[]
 include::action-types/webhook.asciidoc[]
 include::pre-configured-connectors.asciidoc[]
-include::pre-configured-action-types.asciidoc[]

docs/user/alerting/action-types/email.asciidoc

@@ -19,6 +19,58 @@ Username::  username for 'login' type authentication.
 Password::  password for 'login' type authentication.
 
 [float]
+[[Preconfigured-email-configuration]]
+==== Preconfigured action type properties: 
+
+[source,text]
+--
+ id: 'my-email'
+ name: preconfigured-email-action-type
+ actionTypeId: .email
+ config:
+   from: testsender@test.com
+   host: validhostname
+   port: 8080
+   secure: false
+ secrets:
+   user: testuser
+   password: passwordkeystorevalue
+--
+
+`config:` define action type specific to the configuration. The config object contains the following properties:
+
+[cols="3*<"]
+|=====
+
+|`sender:`
+ | Email address string
+ | correspond to *Sender*.
+|`host:`
+ | String
+ | correspond to *Host*.
+|`port:`
+ | Number
+ | correspond to *Port*.
+|`secure:`
+ | Boolean
+ | correspond to *Secure*.
+
+|=====
+
+`secrets:` define action type sensitive configuration:
+
+[cols="3*<"]
+|=====
+
+|`user:`
+ | String
+ | correspond to *User*.
+|`password:`
+ | String
+ | correspond to *Password*. Should be stored in the <<creating-keystore, {kib} keystore>>.
+
+|=====
+
 [[email-action-configuration]]
 ==== Action configuration
 

docs/user/alerting/action-types/index.asciidoc

@@ -15,6 +15,39 @@ Index::     The {es} index to be written to.
 Refresh::   Setting for the {ref}/docs-refresh.html[refresh] policy for the write request.
 Execution time field::  This field will be automatically set to the time the alert condition was detected.
 
+[float]
+[[Preconfigured-index-configuration]]
+==== Preconfigured action type properties: 
+
+[source,text]
+--
+ id: 'my-index'
+ name: action-type-index
+ actionTypeId: .index
+ config:
+   index: .kibana
+   refresh: true
+   executionTimeField: somedate
+--
+
+`config:` define action type specific to the configuration. The config object contains the following properties:
+
+[cols="3*<"]
+|=====
+
+|`index:`
+ | String
+ | correspond to *Index*.
+|`refresh:`
+ | Boolean
+ | correspond to *Refresh*.
+|`executionTimeField:`
+ | String
+ | correspond to *Execution time field*.
+
+|=====
+
+
 [float]
 [[index-action-configuration]]
 ==== Action configuration

docs/user/alerting/action-types/pagerduty.asciidoc

@@ -135,6 +135,43 @@ Name::      The name of the connector. The name is used to identify a  connector
 API URL::   An optional PagerDuty event URL. Defaults to `https://events.pagerduty.com/v2/enqueue`. If you are using the <<action-settings, `xpack.actions.whitelistedHosts`>> setting, make sure the hostname is whitelisted.
 Integration Key::   A 32 character PagerDuty Integration Key for an integration on a service, also referred to as the routing key.
 
+[float]
+[[Preconfigured-pagerduty-configuration]]
+==== Preconfigured action type properties: 
+
+[source,text]
+--
+ id: 'my-pagerduty'
+ name: preconfigured-pagerduty-action-type
+ actionTypeId: .pagerduty
+ config:
+   apiUrl: https://test.host
+ secrets:
+   routingKey: testroutingkey
+--
+
+`config:` define action type specific to the configuration. The config object contains the following properties:
+
+[cols="3*<"]
+|=====
+
+|`apiUrl:`
+ | URL string
+ | correspond to *API URL*.
+
+|=====
+
+`secrets:` define action type sensitive configuration:
+
+[cols="3*<"]
+|=====
+
+|`routingKey:`
+ | String
+ | correspond to *Integration Key*.
+
+|=====
+
 [float]
 [[pagerduty-action-configuration]]
 ==== Action configuration

docs/user/alerting/action-types/server-log.asciidoc

@@ -12,6 +12,17 @@ Server log connectors have the following configuration properties:
 
 Name::      The name of the connector. The name is used to identify a  connector in the management UI connector listing, or in the connector list when configuring an action.
 
+[float]
+[[Preconfigured-server-log-configuration]]
+==== Preconfigured action type properties: 
+
+[source,text]
+--
+ id: 'my-server-log'
+ name: test
+ actionTypeId: .server-log
+--
+
 [float]
 [[server-log-action-configuration]]
 ==== Action configuration

docs/user/alerting/action-types/slack.asciidoc

@@ -13,6 +13,31 @@ Slack connectors have the following configuration properties:
 Name::      The name of the connector. The name is used to identify a  connector in the management UI connector listing, or in the connector list when configuring an action.
 Webhook URL::   The URL of the incoming webhook. See https://api.slack.com/messaging/webhooks#getting_started[Slack Incoming Webhooks] for instructions on generating this URL. If you are using the <<action-settings, `xpack.actions.whitelistedHosts`>> setting, make sure the hostname is whitelisted.
 
+[float]
+[[Preconfigured-slack-configuration]]
+==== Preconfigured action type properties: 
+
+[source,text]
+--
+ id: 'my-slack'
+ name: preconfigured-slack-action-type
+ actionTypeId: .slack
+ config:
+   webhookUrl: 'https://hooks.slack.com/services/abcd/efgh/ijklmnopqrstuvwxyz'
+--
+
+`config:` define action type specific to the configuration. The config object contains the following properties:
+
+[cols="3*<"]
+|=====
+
+|`webhookUrl:`
+ | URL string
+ | correspond to *Webhook URL*.
+
+|=====
+
+
 [float]
 [[slack-action-configuration]]
 ==== Action configuration

docs/user/alerting/action-types/webhook.asciidoc

@@ -17,6 +17,56 @@ Headers::   A set of key-value pairs sent as headers with the request
 User::      An optional username. If set, HTTP basic authentication is used. Currently only basic authentication is supported.
 Password::  An optional password. If set, HTTP basic authentication is used. Currently only basic authentication is supported.
 
+[float]
+[[Preconfigured-webhook-configuration]]
+==== Preconfigured action type properties: 
+
+[source,text]
+--
+ id: 'my-webhook'
+ name: preconfigured-webhook-action-type
+ actionTypeId: .webhook
+ config:
+   url: https://test.host
+   method: POST
+   headers: 
+     testheader: testvalue
+ secrets:
+   user: testuser
+   password: passwordkeystorevalue
+--
+
+`config:` define action type specific to the configuration. The config object contains the following properties:
+
+[cols="3*<"]
+|=====
+
+|`url:`
+ | URL string
+ | correspond to *URL*.
+|`method:`
+ | String
+ | correspond to *Method*.
+|`headers:`
+ | Record<String, String>
+ | correspond to *Headers*.
+
+|=====
+
+`secrets:` define action type sensitive configuration:
+
+[cols="3*<"]
+|=====
+
+|`user:`
+ | String
+ | correspond to *User*.
+|`password:`
+ | String
+ | correspond to *Password*. Should be stored in the <<creating-keystore, {kib} keystore>>.
+
+|=====
+
 [float]
 [[webhook-action-configuration]]
 ==== Action configuration