Skip to content

Commit e830547

Browse files
committed
Merge remote-tracking branch 'upstream/master' into graph/deangularize
2 parents 59004ff + 13c2ed4 commit e830547

File tree

807 files changed

+19679
-9631
lines changed

Some content is hidden

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

807 files changed

+19679
-9631
lines changed

.github/CODEOWNERS

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -109,6 +109,9 @@
109109
/x-pack/legacy/plugins/alerting @elastic/kibana-alerting-services
110110
/x-pack/legacy/plugins/actions @elastic/kibana-alerting-services
111111
/x-pack/legacy/plugins/task_manager @elastic/kibana-alerting-services
112+
/x-pack/test/alerting_api_integration @elastic/kibana-alerting-services
113+
/x-pack/test/plugin_api_integration/plugins/task_manager @elastic/kibana-alerting-services
114+
/x-pack/test/plugin_api_integration/test_suites/task_manager @elastic/kibana-alerting-services
112115

113116
# Design
114117
**/*.scss @elastic/kibana-design

.gitignore

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,6 @@ disabledPlugins
2929
webpackstats.json
3030
/config/*
3131
!/config/kibana.yml
32-
!/config/apm.js
3332
coverage
3433
selenium
3534
.babel_register_cache.json

.i18nrc.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@
2121
"kbn": "src/legacy/core_plugins/kibana",
2222
"kbnDocViews": "src/legacy/core_plugins/kbn_doc_views",
2323
"kbnVislibVisTypes": "src/legacy/core_plugins/kbn_vislib_vis_types",
24-
"management": "src/legacy/core_plugins/management",
24+
"management": ["src/legacy/core_plugins/management", "src/plugins/management"],
2525
"kibana_react": "src/legacy/core_plugins/kibana_react",
2626
"kibana-react": "src/plugins/kibana_react",
2727
"kibana_utils": "src/plugins/kibana_utils",

.node-version

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
10.15.2
1+
10.18.0

.nvmrc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
10.15.2
1+
10.18.0

config/apm.js

Lines changed: 0 additions & 87 deletions
This file was deleted.

docs/discover/context.asciidoc

Lines changed: 51 additions & 75 deletions
Original file line numberDiff line numberDiff line change
@@ -1,90 +1,66 @@
11
[[document-context]]
2-
== Viewing Document Context
2+
== Viewing a document in context
33

4-
For certain applications it can be useful to inspect a window of documents
5-
surrounding a specific event. The context view enables you to do just that for
6-
<<index-patterns, index patterns>> that are configured to contain time-based events.
4+
Once you've narrowed your search to a specific event,
5+
you might want to inspect the documents that occurred
6+
immediately before and after the event. With the Context view,
7+
you can do just that for index patterns that contain time-based events.
78

8-
To show the context surrounding an anchor document, click the *Expand* button
9-
image:images/ExpandButton.jpg[Expand Button] to the left of the document's
10-
table entry and then click the *View surrounding documents* link.
9+
To open the Context view, click the expand icon (<) in the document table, and then click
10+
*View surrounding documents.*
1111

12-
image::images/Expanded-Document.png[Expanded Document]
13-
{nbsp}
12+
The documents are sorted
13+
by the time field specified in the index pattern and displayed using the
14+
same set of columns as the *Discover* view from which the context was opened.
15+
The anchor document is highlighted in blue.
1416

15-
The context view displays a number of documents before and after the anchor
16-
document. The anchor document itself is highlighted in blue. The view is sorted
17-
by the time field specified in the index pattern configuration and uses the
18-
same set of columns as the Discover view the context was opened from. If there
19-
are multiple documents with the same time field value, the internal document
20-
order is used as a secondary sorting criterion by default.
21-
22-
[NOTE]
23-
--
24-
The field used for tiebreaking in case of equal time field values can be
25-
configured using the advanced setting `context:tieBreakerFields` in
26-
<<advanced-options, *Management > Advanced Settings*>>, which defaults to the
27-
`_doc` field. The value of this setting can be a comma-separated list of field
28-
names, which will be checked in sequence for suitability when a context is
29-
about to be displayed. The first suitable field is then used as the tiebreaking
30-
field. A field is suitable if the field exists and is sortable in the index
31-
pattern the context is based on.
32-
33-
While not required, it is recommended to only
34-
use fields which have {ref}/doc-values.html[doc values] enabled to achieve
35-
good performance and avoid unnecessary {ref}/modules-fielddata.html[field
36-
data] usage. Common examples for suitable fields include log line numbers,
37-
monotonically increasing counters and high-precision timestamps.
38-
--
3917

18+
[role="screenshot"]
4019
image::images/Discover-ContextView.png[Context View]
4120

42-
NOTE: The number of documents displayed by default can be configured
43-
via the `context:defaultSize` setting in <<advanced-options, *Management >
44-
Advanced Settings*>>.
45-
4621
[float]
47-
[[change-context-size]]
48-
=== Changing the Context Size
49-
50-
You can change the number documents displayed before and after the anchor
51-
document independently.
52-
53-
To increase the number of displayed documents that are newer than the anchor
54-
document, click the *Load 5 more* button above the document list or enter the
55-
desired number into the input box right of the button.
56-
57-
image::images/Discover-ContextView-SizePicker-Newer.png[]
58-
{nbsp}
59-
60-
To increase the number of displayed documents that are older than the anchor
61-
document, click the *Load 5 more* button below the document list or enter the
62-
desired number into the input box right of the button.
22+
[[filter-context]]
23+
=== Filter the context
6324

64-
image::images/Discover-ContextView-SizePicker-Older.png[]
65-
{nbsp}
25+
The
26+
filters you applied in *Discover* are carried over to the Context view. Pinned filters remain active, while normal
27+
filters are copied in a disabled state. You can re-enable these filters to
28+
refine your context view.
6629

67-
NOTE: The default number of documents loaded with each button click can be
68-
configured via the `context:step` setting in <<advanced-options, *Management >
69-
Advanced Settings*>>.
30+
If the Context view contains a large number of documents not related to the event under
31+
investigation, you can use filters to restrict the documents to
32+
display.
7033

7134
[float]
72-
[[filter-context]]
73-
=== Filtering the Context
74-
75-
Depending on how the documents are partitioned into index patterns, the context
76-
view might contain a large number of documents not related to the event under
77-
investigation. In order to adapt the focus of the context view to the task at
78-
hand, you can use filters to restrict the documents considered by Kibana for
79-
display in the context view.
80-
81-
When switching from the discover view to the context view, the previously
82-
applied filters are carried over. Pinned filters remain active while normal
83-
filters are copied in a disabled state. You can selectively re-enabled them to
84-
refine your context view.
35+
[[change-context-size]]
36+
=== Change the number of surrounding documents
8537

86-
New filters can be added via the *Add a filter* link in the filter bar, by
87-
clicking the filter icons appearing when hovering a field, or by expanding
88-
documents and clicking the filter icons in the table.
38+
By default, the five newest and oldest
39+
documents are listed. To increase the number of documents that surround the anchor document,
40+
click *Load*. Five documents are added with each click.
8941

90-
image::images/Discover-ContextView-FilterMontage.png[]
42+
[float]
43+
[[configure-context-ContextView]]
44+
=== Configure the context view
45+
46+
To configure the Context view, use these settings in <<advanced-options,
47+
Advanced Settings>>.
48+
49+
[horizontal]
50+
`context:defaultSize`:: The number of documents to display by default.
51+
`context:step`:: The default number of documents to load with each button click.
52+
`context:tieBreakerFields`:: The field to use for tiebreaking in case of equal time field values.
53+
The default is the
54+
`_doc` field.
55+
+
56+
You can enter a comma-separated list of field
57+
names, which is checked in sequence for suitability when a context is
58+
displayed. The first suitable field is used as the tiebreaking
59+
field. A field is suitable if the field exists and is sortable in the index
60+
pattern the context is based on.
61+
+
62+
Although not required, it is recommended to only
63+
use fields that have {ref}/doc-values.html[doc values] enabled to achieve
64+
good performance and avoid unnecessary {ref}/modules-fielddata.html[field
65+
data] usage. Common examples for suitable fields include log line numbers,
66+
monotonically increasing counters and high-precision timestamps.
Lines changed: 42 additions & 56 deletions
Original file line numberDiff line numberDiff line change
@@ -1,69 +1,55 @@
11
[[document-data]]
2-
== Viewing Document Data
2+
== Viewing document data
33

4-
When you submit a search query, the 500 most recent documents that match the query
5-
are listed in the Documents table. You can configure the number of documents shown
6-
in the table by setting the `discover:sampleSize` property in <<advanced-options,
7-
Advanced Settings>>. By default, the table shows the localized version of the time
8-
field configured for the selected <<index-patterns, index pattern>> and the document `_source`. You can
9-
<<adding-columns, add fields to the Documents table>> from the Fields list.
10-
You can <<sorting, sort the listed documents>> by any indexed field that's included
11-
in the table.
12-
13-
To view a document's field data, click the *Expand* button
14-
image:images/ExpandButton.jpg[Expand Button] to the left of the document's table
15-
entry.
16-
17-
image::images/Expanded-Document.png[]
18-
19-
To view the original JSON document (pretty-printed), click the *JSON* tab.
20-
21-
To view the document data as a separate page, click the *View single document*
22-
link. You can bookmark and share this link to provide direct access to a
23-
particular document.
24-
25-
To display or hide a field's column in the Documents table, click the
26-
image:images/add-column-button.png[Add Column] *Toggle column in table* button.
27-
28-
To collapse the document details, click the *Collapse* button
29-
image:images/CollapseButton.jpg[Collapse Button].
4+
When you submit a search query in *Discover*, the most recent documents that match the query
5+
are listed in the documents table.
6+
By default, the table includes columns for
7+
the time field and the document `_source`, which shows all fields and values in the document.
308

319
[float]
3210
[[sorting]]
33-
=== Sorting the Document List
34-
You can sort the documents in the Documents table by the values in any indexed
35-
field. If a time field is configured for the current index pattern, the
36-
documents are sorted in reverse chronological order by default.
37-
38-
To change the sort order, hover over the name of the field you want to sort by
39-
and click the sort button. Click again to reverse the sort order.
11+
=== Modify the document table
12+
13+
Use the following commands to
14+
tailor the documents table to suit your needs.
15+
16+
[horizontal]
17+
Add a field column::
18+
Hover over the list of *Available fields* and then click *add* next to each field you want include as a column in the table.
19+
The first field you add replaces the `_source` column.
20+
Change sort order:: By default, columns are sorted by the values in the field.
21+
If a time field is configured for the current index pattern,
22+
the documents are sorted in reverse chronological order.
23+
+
24+
To change the sort order, hover over the column
25+
and click image:images/sort-icon.png[].
26+
The first click sorts by ascending order, the second click sorts by descending order, and the third
27+
click removes the field from the sorted fields.
28+
29+
Move a field column:: Hover over the column header and click the move left (<<) or move right icon (>>).
30+
Remove&nbsp;a&nbsp;field&nbsp;column&nbsp;:: Hover over the list of *Specified fields*
31+
and then click *remove*.
32+
Or, use the (x) control in the column header.
4033

4134
[float]
42-
[[adding-columns]]
43-
=== Adding Field Columns to the Documents Table
44-
By default, the Documents table shows the localized version of the time field
45-
that's configured for the selected index pattern and the document `_source`.
46-
You can add fields to the table from the Fields list or from a document's
47-
field data.
48-
49-
To add a field column from the Fields list, hover over the field and click its
50-
*add* button.
35+
=== Drill down into field-level details
36+
To view the document data in either table or JSON format, click the expand icon (>).
37+
The expanded view provides these options for viewing your document:
5138

52-
To add a field column from a document's field data, expand the document
53-
and click the field's
54-
image:images/add-column-button.png[Add Column] *Toggle column in table* button.
39+
* View the events that surround your document.
40+
For example, you might want to see the 10 documents that occurred
41+
immediately before and after your event.
5542

56-
Added field columns replace the `_source` column in the Documents table. The added
57-
fields are also added to the *Selected Fields* list.
43+
* View the document data as a separate page. You can bookmark and
44+
share the link for direct access to a particular document.
5845

59-
To rearrange the field columns, hover over the header of the column you want to move
60-
and click the *Move left* or *Move right* button.
46+
[role="screenshot"]
47+
image::images/Expanded-Document.png[]
6148

62-
image:images/Discover-MoveColumn.jpg[Move Column]
6349

6450
[float]
65-
[[removing-columns]]
66-
=== Removing Field Columns from the Documents Table
67-
To remove a field column from the Documents table, hover over the header of the
68-
column you want to remove and click the *Remove* button
69-
image:images/RemoveFieldButton.jpg[Remove Field Button].
51+
=== Configure the number of documents to show
52+
53+
By default, the documents table includes the 500 most recent documents that
54+
match the query. To change this number, set the `discover:sampleSize` property in <<advanced-options,
55+
Advanced Settings>>.

0 commit comments

Comments
 (0)