Skip to content

Commit 7c38a07

Browse files
Merge branch 'master' into monitoring/external_link
2 parents ceb8e08 + 8ebd0c1 commit 7c38a07

File tree

573 files changed

+12320
-6055
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

573 files changed

+12320
-6055
lines changed

.eslintrc.js

+1-1
Original file line numberDiff line numberDiff line change
@@ -96,7 +96,7 @@ module.exports = {
9696
},
9797
},
9898
{
99-
files: ['x-pack/legacy/plugins/cross_cluster_replication/**/*.{js,ts,tsx}'],
99+
files: ['x-pack/plugins/cross_cluster_replication/**/*.{js,ts,tsx}'],
100100
rules: {
101101
'jsx-a11y/click-events-have-key-events': 'off',
102102
},

.sass-lint.yml

+1
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@ files:
99
- 'x-pack/legacy/plugins/canvas/**/*.s+(a|c)ss'
1010
- 'x-pack/plugins/triggers_actions_ui/**/*.s+(a|c)ss'
1111
- 'x-pack/plugins/lens/**/*.s+(a|c)ss'
12+
- 'x-pack/plugins/cross_cluster_replication/**/*.s+(a|c)ss'
1213
- 'x-pack/legacy/plugins/maps/**/*.s+(a|c)ss'
1314
- 'x-pack/plugins/maps/**/*.s+(a|c)ss'
1415
ignore:

docs/development/plugins/data/public/kibana-plugin-plugins-data-public.datapublicpluginstart.actions.md

+2-1
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,7 @@
88

99
```typescript
1010
actions: {
11-
createFiltersFromEvent: typeof createFiltersFromEvent;
11+
createFiltersFromValueClickAction: typeof createFiltersFromValueClickAction;
12+
createFiltersFromRangeSelectAction: typeof createFiltersFromRangeSelectAction;
1213
};
1314
```

docs/development/plugins/data/public/kibana-plugin-plugins-data-public.datapublicpluginstart.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ export interface DataPublicPluginStart
1414

1515
| Property | Type | Description |
1616
| --- | --- | --- |
17-
| [actions](./kibana-plugin-plugins-data-public.datapublicpluginstart.actions.md) | <code>{</code><br/><code> createFiltersFromEvent: typeof createFiltersFromEvent;</code><br/><code> }</code> | |
17+
| [actions](./kibana-plugin-plugins-data-public.datapublicpluginstart.actions.md) | <code>{</code><br/><code> createFiltersFromValueClickAction: typeof createFiltersFromValueClickAction;</code><br/><code> createFiltersFromRangeSelectAction: typeof createFiltersFromRangeSelectAction;</code><br/><code> }</code> | |
1818
| [autocomplete](./kibana-plugin-plugins-data-public.datapublicpluginstart.autocomplete.md) | <code>AutocompleteStart</code> | |
1919
| [fieldFormats](./kibana-plugin-plugins-data-public.datapublicpluginstart.fieldformats.md) | <code>FieldFormatsStart</code> | |
2020
| [indexPatterns](./kibana-plugin-plugins-data-public.datapublicpluginstart.indexpatterns.md) | <code>IndexPatternsContract</code> | |

docs/development/plugins/data/public/kibana-plugin-plugins-data-public.fieldformats.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@
1010
fieldFormats: {
1111
FieldFormat: typeof FieldFormat;
1212
FieldFormatsRegistry: typeof FieldFormatsRegistry;
13-
serialize: (agg: import("./search").AggConfig) => import("../../expressions/common").SerializedFieldFormat<object>;
13+
serialize: (agg: import("./search").AggConfig) => import("../../expressions").SerializedFieldFormat<object>;
1414
DEFAULT_CONVERTER_COLOR: {
1515
range: string;
1616
regex: string;

docs/development/plugins/data/server/kibana-plugin-plugins-data-server.fieldformats.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@
1010
fieldFormats: {
1111
FieldFormatsRegistry: typeof FieldFormatsRegistry;
1212
FieldFormat: typeof FieldFormat;
13-
serializeFieldFormat: (agg: import("../public/search").AggConfig) => import("../../expressions/common").SerializedFieldFormat<object>;
13+
serializeFieldFormat: (agg: import("../public/search").AggConfig) => import("../../expressions").SerializedFieldFormat<object>;
1414
BoolFormat: typeof BoolFormat;
1515
BytesFormat: typeof BytesFormat;
1616
ColorFormat: typeof ColorFormat;

docs/images/clone_panel.gif

798 KB
Loading

docs/management/advanced-options.asciidoc

+2
Original file line numberDiff line numberDiff line change
@@ -217,6 +217,8 @@ might increase the search time. This setting is off by default. Users must opt-i
217217
[horizontal]
218218
`siem:defaultAnomalyScore`:: The threshold above which Machine Learning job anomalies are displayed in the SIEM app.
219219
`siem:defaultIndex`:: A comma-delimited list of Elasticsearch indices from which the SIEM app collects events.
220+
`siem:ipReputationLinks`:: A JSON array containing links for verifying the reputation of an IP address. The links are displayed on
221+
{siem-guide}/siem-ui-overview.html#network-ui[IP detail] pages.
220222
`siem:enableNewsFeed`:: Enables the security news feed on the SIEM *Overview*
221223
page.
222224
`siem:newsFeedUrl`:: The URL from which the security news feed content is

docs/settings/ml-settings.asciidoc

+8-1
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,6 @@
88
You do not need to configure any settings to use {kib} {ml-features}. They are
99
enabled by default.
1010

11-
[float]
1211
[[general-ml-settings-kb]]
1312
==== General {ml} settings
1413

@@ -19,3 +18,11 @@ If set to `false` in `kibana.yml`, the {ml} icon is hidden in this {kib}
1918
instance. If `xpack.ml.enabled` is set to `true` in `elasticsearch.yml`, however,
2019
you can still use the {ml} APIs. To disable {ml} entirely, see the
2120
{ref}/ml-settings.html[{es} {ml} settings].
21+
22+
[[data-visualizer-settings]]
23+
==== {data-viz} settings
24+
25+
`xpack.ml.file_data_visualizer.max_file_size`::
26+
Sets the file size limit when importing data in the {data-viz}. The default
27+
value is `100MB`. The highest supported value for this setting is `1GB`.
28+

docs/siem/images/cases-ui.png

305 KB
Loading

docs/siem/siem-ui.asciidoc

+17-1
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ image::siem/images/network-ui.png[]
3535

3636
[float]
3737
[[detections-ui]]
38-
=== Detections (Beta)
38+
=== Detections (beta)
3939

4040
The Detections feature automatically searches for threats and creates
4141
signals when they are detected. Signal detection rules define the conditions
@@ -50,6 +50,22 @@ or the Detections API.
5050
[role="screenshot"]
5151
image::siem/images/detections-ui.png[]
5252

53+
[float]
54+
[[cases-ui]]
55+
=== Cases (beta)
56+
57+
Cases are used to open and track security issues directly in SIEM.
58+
Cases list the original reporter and all users who contribute to a case
59+
(`participants`). Case comments support Markdown syntax, and allow linking to
60+
saved Timelines. Additionally, you can send cases to external systems from
61+
within SIEM (currently ServiceNow).
62+
63+
For information about opening, updating, and closing cases, see
64+
{siem-guide}/cases-overview.html[Cases] in the SIEM Guide.
65+
66+
[role="screenshot"]
67+
image::siem/images/cases-ui.png[]
68+
5369
[float]
5470
[[timelines-ui]]
5571
=== Timeline

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

+5-5
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
[role="xpack"]
22
[[email-action-type]]
3-
== Email action type
3+
=== Email action
44

55
The email action type uses the SMTP protocol to send mail message, using an integration of https://nodemailer.com/[Nodemailer]. Email message text is sent as both plain text and html text.
66

@@ -10,11 +10,11 @@ The email action type uses the SMTP protocol to send mail message, using an inte
1010

1111
Email connectors have the following configuration properties:
1212

13-
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.
13+
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.
1414
Sender:: The from address for all emails sent with this connector, specified in `user@host-name` format.
15-
Host:: Host name of the service provider. If you are using the <<action-settings, `xpack.actions.whitelistedHosts`>> setting, make sure this hostname is whitelisted.
15+
Host:: Host name of the service provider. If you are using the <<action-settings, `xpack.actions.whitelistedHosts`>> setting, make sure this hostname is whitelisted.
1616
Port:: The port to connect to on the service provider.
17-
Secure:: If true the connection will use TLS when connecting to the service provider. See https://nodemailer.com/smtp/#tls-options[nodemailer TLS documentation] for more information.
17+
Secure:: If true the connection will use TLS when connecting to the service provider. See https://nodemailer.com/smtp/#tls-options[nodemailer TLS documentation] for more information.
1818
Username:: username for 'login' type authentication.
1919
Password:: password for 'login' type authentication.
2020

@@ -26,4 +26,4 @@ Email actions have the following configuration properties:
2626

2727
To, CC, BCC:: Each is a list of addresses. Addresses can be specified in `user@host-name` format, or in `name <user@host-name>` format. One of To, CC, or BCC must contain an entry.
2828
Subject:: The subject line of the email.
29-
Message:: The message text of the email. Markdown format is supported.
29+
Message:: The message text of the email. Markdown format is supported.

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

+2-2
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
[role="xpack"]
22
[[index-action-type]]
3-
== Index action type
3+
=== Index action
44

55
The index action type will index a document into {es}.
66

@@ -21,4 +21,4 @@ Execution time field:: This field will be automatically set to the time the ale
2121

2222
Index actions have the following properties:
2323

24-
Document:: The document to index in json format.
24+
Document:: The document to index in json format.

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

+11-13
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
[role="xpack"]
22
[[pagerduty-action-type]]
3-
== PagerDuty action type
3+
=== PagerDuty action
44

55
The PagerDuty action type uses the https://v2.developer.pagerduty.com/docs/events-api-v2[v2 Events API] to trigger, acknowledge, and resolve PagerDuty alerts.
66

@@ -10,7 +10,7 @@ The PagerDuty action type uses the https://v2.developer.pagerduty.com/docs/event
1010

1111
[float]
1212
[[pagerduty-benefits]]
13-
=== PagerDuty + Elastic integration benefits
13+
==== PagerDuty + Elastic integration benefits
1414

1515
By integrating PagerDuty with alerts, you can:
1616

@@ -20,15 +20,15 @@ By integrating PagerDuty with alerts, you can:
2020

2121
[float]
2222
[[pagerduty-how-it-works]]
23-
==== How it works
23+
===== How it works
2424

2525
{kib} allows you to create alerts to notify you of a significant move
2626
in your dataset.
2727
You can create alerts for all your Observability, Security, and Elastic Stack use cases.
2828
Alerts will trigger a new incident on the corresponding PagerDuty service.
2929

3030
[float]
31-
==== Requirements
31+
===== Requirements
3232

3333
In the `kibana.yml` configuration file, you must add the <<general-alert-action-settings, saved objects encryption setting>>.
3434
This is required to encrypt parameters that must be secured, for example PagerDuty’s integration key.
@@ -47,18 +47,17 @@ review the <<action-settings, Actions settings>> that are available to you.
4747

4848
[float]
4949
[[pagerduty-support]]
50-
==== Support
50+
===== Support
5151
If you need help with this integration, get in touch with the {kib} team by visiting
5252
https://support.elastic.co[support.elastic.co] or by using the *Ask Elastic* option in the {kib} Help menu.
5353
You can also select the {kib} category at https://discuss.elastic.co/[discuss.elastic.co].
5454

5555
[float]
5656
[[pagerduty-integration-walkthrough]]
57-
==== Integration with PagerDuty walkthrough
57+
===== Integration with PagerDuty walkthrough
5858

59-
[float]
6059
[[pagerduty-in-pagerduty]]
61-
===== In PagerDuty
60+
*In PagerDuty*
6261

6362
. From the *Configuration* menu, select *Services*.
6463
. Add an integration to a service:
@@ -83,9 +82,8 @@ image::user/alerting/images/pagerduty-integration.png[PagerDuty Integrations tab
8382

8483
. Save this key, as you will use it when you configure the integration with Elastic in the next section.
8584

86-
[float]
8785
[[pagerduty-in-elastic]]
88-
===== In Elastic
86+
*In Elastic*
8987

9088
. Create a PagerDuty Connector in Kibana. You can:
9189
+
@@ -117,7 +115,7 @@ https://v2.developer.pagerduty.com/v2/docs/send-an-event-events-api-v2[API v2 do
117115

118116
[float]
119117
[[pagerduty-uninstall]]
120-
==== How to uninstall
118+
===== How to uninstall
121119
To remove a PagerDuty connector from an alert, simply remove it
122120
from the *Actions* section of that alert, using the remove (x) icon.
123121
This will disable the integration for the particular alert.
@@ -129,7 +127,7 @@ This is an irreversible action and impacts all alerts that use this connector.
129127

130128
[float]
131129
[[pagerduty-connector-configuration]]
132-
=== Connector configuration
130+
==== Connector configuration
133131

134132
PagerDuty connectors have the following configuration properties:
135133

@@ -139,7 +137,7 @@ Routing Key:: A 32 character PagerDuty Integration Key for an integration on a
139137

140138
[float]
141139
[[pagerduty-action-configuration]]
142-
=== Action configuration
140+
==== Action configuration
143141

144142
PagerDuty actions have the following properties:
145143

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

+2-2
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
[role="xpack"]
22
[[server-log-action-type]]
3-
== Server log action type
3+
=== Server log action
44

55
This action type writes and entry to the {kib} server log.
66

@@ -18,4 +18,4 @@ Name:: The name of the connector. The name is used to identify a connector
1818

1919
Server log actions have the following properties:
2020

21-
Message:: The message to log.
21+
Message:: The message to log.
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
[role="xpack"]
22
[[slack-action-type]]
3-
== Slack action type
3+
=== Slack action
44

5-
The Slack action type uses https://api.slack.com/incoming-webhooks[Slack Incoming Webhooks].
5+
The Slack action type uses https://api.slack.com/incoming-webhooks[Slack Incoming Webhooks].
66

77
[float]
88
[[slack-connector-configuration]]
@@ -11,12 +11,12 @@ The Slack action type uses https://api.slack.com/incoming-webhooks[Slack Incomin
1111
Slack connectors have the following configuration properties:
1212

1313
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.
14-
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.
14+
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.
1515

1616
[float]
1717
[[slack-action-configuration]]
1818
==== Action configuration
1919

2020
Slack actions have the following properties:
2121

22-
Message:: The message text, converted to the `text` field in the Webhook JSON payload. Currently only the text field is supported. Markdown, images, and other advanced formatting are not yet supported.
22+
Message:: The message text, converted to the `text` field in the Webhook JSON payload. Currently only the text field is supported. Markdown, images, and other advanced formatting are not yet supported.

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

+3-3
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
[role="xpack"]
22
[[webhook-action-type]]
3-
== Webhook action type
3+
=== Webhook action
44

55
The Webhook action type uses https://github.com/axios/axios[axios] to send a POST or PUT request to a web service.
66

@@ -11,7 +11,7 @@ The Webhook action type uses https://github.com/axios/axios[axios] to send a POS
1111
Webhook connectors have the following configuration properties:
1212

1313
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.
14-
URL:: The request URL. If you are using the <<action-settings, `xpack.actions.whitelistedHosts`>> setting, make sure the hostname is whitelisted.
14+
URL:: The request URL. If you are using the <<action-settings, `xpack.actions.whitelistedHosts`>> setting, make sure the hostname is whitelisted.
1515
Method:: HTTP request method, either `post`(default) or `put`.
1616
Headers:: A set of key-value pairs sent as headers with the request
1717
User:: An optional username. If set, HTTP basic authentication is used. Currently only basic authentication is supported.
@@ -23,4 +23,4 @@ Password:: An optional password. If set, HTTP basic authentication is used. Cur
2323

2424
Webhook actions have the following properties:
2525

26-
Body:: A json payload sent to the request URL.
26+
Body:: A json payload sent to the request URL.

docs/user/dashboard.asciidoc

+18
Original file line numberDiff line numberDiff line change
@@ -98,6 +98,24 @@ to the new dimensions.
9898
* To delete a panel, open the panel menu and select *Delete from dashboard.* Deleting a panel from a
9999
dashboard does *not* delete the saved visualization or search.
100100

101+
[float]
102+
[[cloning-a-panel]]
103+
=== Clone dashboard elements
104+
105+
In *Edit* mode, you can clone any panel on a dashboard.
106+
107+
To clone an existing panel, open the panel menu of the element you wish to clone, then select *Clone panel*.
108+
109+
* Cloned panels appear beside the original, and will move other panels down to make room if necessary.
110+
111+
* Clones support all of the original panel's functionality, including renaming, editing, and cloning.
112+
113+
* All cloned visualizations will appear in the visualization list.
114+
115+
[role="screenshot"]
116+
image:images/clone_panel.gif[clone panel]
117+
118+
101119
[float]
102120
[[viewing-detailed-information]]
103121
=== Inspect and edit elements
Loading

docs/user/ml/index.asciidoc

+11-11
Original file line numberDiff line numberDiff line change
@@ -4,31 +4,31 @@
44

55
[partintro]
66
--
7-
As datasets increase in size and complexity, the human effort required to
7+
As data sets increase in size and complexity, the human effort required to
88
inspect dashboards or maintain rules for spotting infrastructure problems,
99
cyber attacks, or business issues becomes impractical. Elastic {ml-features}
1010
such as {anomaly-detect} and {oldetection} make it easier to notice suspicious
1111
activities with minimal human interference.
1212

13-
If you have a basic license, you can use the *Data Visualizer* to learn more
14-
about your data. In particular, if your data is stored in {es} and contains a
15-
time field, you can use the *Data Visualizer* to identify possible fields for
16-
{anomaly-detect}:
13+
{kib} includes a free *{data-viz}* to learn more about your data. In particular,
14+
if your data is stored in {es} and contains a time field, you can use the
15+
*{data-viz}* to identify possible fields for {anomaly-detect}:
1716

1817
[role="screenshot"]
19-
image::user/ml/images/ml-data-visualizer-sample.jpg[Data Visualizer for sample flight data]
18+
image::user/ml/images/ml-data-visualizer-sample.jpg[{data-viz} for sample flight data]
2019

21-
experimental[] You can also upload a CSV, NDJSON, or log file (up to 100 MB in
22-
size). The *Data Visualizer* identifies the file format and field mappings. You
23-
can then optionally import that data into an {es} index.
20+
experimental[] You can also upload a CSV, NDJSON, or log file. The *{data-viz}*
21+
identifies the file format and field mappings. You can then optionally import
22+
that data into an {es} index. To change the default file size limit, see
23+
<<data-visualizer-settings>>.
2424

25-
You need the following permissions to use the Data Visualizer with file upload:
25+
You need the following permissions to use the {data-viz} with file upload:
2626

2727
* cluster privileges: `monitor`, `manage_ingest_pipelines`
2828
* index privileges: `read`, `manage`, `index`
2929

3030
For more information, see {ref}/security-privileges.html[Security privileges]
31-
and {ref}/built-in-roles.html[Built-in roles].
31+
and {ml-docs}/setup.html[Set up {ml-features}].
3232

3333
--
3434

0 commit comments

Comments
 (0)