* [Docs][Alerting] Changed overall alerting documentation structure
* fixed image link
* moved alerting and connectors under the graph in the menu list
* moved management docs to alerting and connectors
* fixed image link
* fixed connector menu position
* fixed mappings
* fixed mappings
* fixed links
* fixed levels
* move manage connectors before action types
* adjust connectors management
* adjust connectors management
* split domain specific and stack rules
* fixed rule types links
* added connectors ui images
* fixed image links
* fixed image links
* fixed image links
* test
* fixed image links
* fixed broken links
* fixed broken links
* fixed email links
* fixed email links
* fixed email links
* fixed links
* added images to connectors docs
* Update docs/user/alerting/rule-management.asciidoc
Co-authored-by: gchaps <33642766+gchaps@users.noreply.github.com>
* Update docs/user/alerting/stack-rules.asciidoc
Co-authored-by: gchaps <33642766+gchaps@users.noreply.github.com>
* fixed due to comments
* fixed due to comments
* fixed create connector
* moved connectors to stack management section
* removed bazel files
* fixed managing-alerts-and-actions links
* Revert "fixed managing-alerts-and-actions links"
This reverts commit 0ed228b090
.
* fixed code owners
Co-authored-by: gchaps <33642766+gchaps@users.noreply.github.com>
Co-authored-by: Kibana Machine <42973632+kibanamachine@users.noreply.github.com>
73 lines
2.8 KiB
Plaintext
73 lines
2.8 KiB
Plaintext
[role="xpack"]
|
|
[[pre-configured-connectors]]
|
|
=== Preconfigured connectors
|
|
|
|
You can preconfigure a connector to have all the information it needs prior to startup by adding it to the `kibana.yml` file.
|
|
|
|
Preconfigured connectors offer the following benefits:
|
|
|
|
- Require no setup. Configuration and credentials needed to execute an
|
|
action are predefined, including the connector name and ID.
|
|
- Appear in all spaces because they are not saved objects.
|
|
- Cannot be edited or deleted.
|
|
|
|
[float]
|
|
[[preconfigured-connector-example]]
|
|
==== Preconfigured connectors example
|
|
|
|
This example shows a valid configuration for
|
|
two out-of-the box connectors: <<slack-action-type, Slack>> and <<webhook-action-type, Webhook>>.
|
|
|
|
```js
|
|
xpack.actions.preconfigured:
|
|
my-slack1: <1>
|
|
actionTypeId: .slack <2>
|
|
name: 'Slack #xyz' <3>
|
|
secrets:
|
|
webhookUrl: 'https://hooks.slack.com/services/abcd/efgh/ijklmnopqrstuvwxyz'
|
|
webhook-service:
|
|
actionTypeId: .webhook
|
|
name: 'Email service'
|
|
config: <4>
|
|
url: 'https://email-alert-service.elastic.co'
|
|
method: post
|
|
headers:
|
|
header1: value1
|
|
header2: value2
|
|
secrets: <5>
|
|
user: elastic
|
|
password: changeme
|
|
```
|
|
|
|
<1> The key is the connector identifier, `my-slack1` in this example.
|
|
<2> `actionTypeId` is the action type identifier.
|
|
<3> `name` is the name of the preconfigured connector.
|
|
<4> `config` is the configuration specific to the connector type.
|
|
<5> `secrets` is the sensitive configuration, such as username, password, and keys, specific to the connector type.
|
|
|
|
[NOTE]
|
|
==============================================
|
|
Sensitive properties, such as passwords, can also be stored in the <<creating-keystore, {kib} keystore>>.
|
|
==============================================
|
|
|
|
[float]
|
|
[[build-in-preconfigured-connectors]]
|
|
==== Built-in preconfigured connectors
|
|
|
|
{kib} provides one built-in preconfigured connector:
|
|
|
|
* <<preconfigured-connector-alert-history, Alert history preconfigured {es} index connector>>
|
|
|
|
[float]
|
|
[[managing-pre-configured-connectors]]
|
|
==== View preconfigured connectors
|
|
|
|
When you open the main menu, click *Stack Management > Rules and Connectors*. Preconfigured connectors appear on the <<connector-management, *Connectors* tab>>, regardless of which space you are in. They are tagged as “preconfigured”, and you cannot delete them.
|
|
|
|
[role="screenshot"]
|
|
image::images/pre-configured-connectors-managing.png[Connectors managing tab with pre-configured]
|
|
|
|
Clicking a preconfigured connector shows the description, but not the configuration. A message indicates that this is a preconfigured connector.
|
|
|
|
[role="screenshot"]
|
|
image::images/pre-configured-connectors-view-screen.png[Pre-configured connector view details] |