[DOCS] Updates Discover docs (#151953)

## Summary

This PR updates the Discover docs for 8.7.
This commit is contained in:
gchaps 2023-03-08 07:05:25 -08:00 committed by GitHub
parent 64a7df7894
commit 8d6c63472c
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
19 changed files with 39 additions and 31 deletions

Binary file not shown.

Before

Width:  |  Height:  |  Size: 78 KiB

After

Width:  |  Height:  |  Size: 128 KiB

Before After
Before After

Binary file not shown.

After

Width:  |  Height:  |  Size: 4.4 KiB

View file

@ -16,7 +16,7 @@ Hide or resize the chart for a better fit.
* To turn off the display of the chart, click
image:images/chart-icon.png[icon button for opening Show/Hide chart menu, width=24px]
to open the *Chart options* menu, and then click *Hide*.
to open the *Chart options* menu, and then click *Hide chart*.
* To change the chart height, drag the resize handle
image:images/resize-icon.png[two-line icon for increasing or decreasing the height of the chart, width=24px]
@ -84,6 +84,7 @@ image::images/document-explorer-multi-field.png[Multi field sort in the document
. To change the sort order, select a field in the pop-up, and then drag it to the new location.
[float]
[[document-explorer-edit-field]]
==== Edit a field
@ -114,20 +115,11 @@ image::images/document-explorer-compare-data.png[Compare data in the document ta
[[document-explorer-configure-table]]
==== Set the number of rows per page
To change the numbers of rows you want to display on each page, use the *Rows per page* menu. By default, the document table displays 100 rows per page.
To change the numbers of rows you want to display on each page, use the *Rows per page* menu. The default is 100 rows per page.
[role="screenshot"]
image::images/document-table-rows-per-page.png["Menu with options for setting the number of rows in the document table"]
To customize the default number of rows per page, go to *Stack Managaement > Advanced Settings*
and search for *rows per page*.
[float]
[[document-explorer-full-screen]]
==== View in fullscreen
To toggle the table in and out of fullscreen mode, click the fullscreen icon
image:images/fullscreen-icon.png[icon to display the document table in fullscreen mode].
[float]
[[document-explorer-expand-documents]]

View file

@ -1,8 +1,6 @@
[[show-field-statistics]]
== View field statistics
beta::[]
Explore the fields in your data with the *Field statistics* view in *Discover* and
answer such questions as:

Binary file not shown.

Before

Width:  |  Height:  |  Size: 313 KiB

After

Width:  |  Height:  |  Size: 349 KiB

Before After
Before After

Binary file not shown.

Before

Width:  |  Height:  |  Size: 82 KiB

After

Width:  |  Height:  |  Size: 103 KiB

Before After
Before After

Binary file not shown.

Before

Width:  |  Height:  |  Size: 43 KiB

After

Width:  |  Height:  |  Size: 44 KiB

Before After
Before After

Binary file not shown.

Before

Width:  |  Height:  |  Size: 266 KiB

After

Width:  |  Height:  |  Size: 287 KiB

Before After
Before After

Binary file not shown.

Before

Width:  |  Height:  |  Size: 39 KiB

After

Width:  |  Height:  |  Size: 34 KiB

Before After
Before After

Binary file not shown.

Before

Width:  |  Height:  |  Size: 99 KiB

After

Width:  |  Height:  |  Size: 147 KiB

Before After
Before After

Binary file not shown.

Before

Width:  |  Height:  |  Size: 29 KiB

After

Width:  |  Height:  |  Size: 39 KiB

Before After
Before After

Binary file not shown.

Before

Width:  |  Height:  |  Size: 399 KiB

After

Width:  |  Height:  |  Size: 388 KiB

Before After
Before After

Binary file not shown.

Before

Width:  |  Height:  |  Size: 311 KiB

After

Width:  |  Height:  |  Size: 340 KiB

Before After
Before After

Binary file not shown.

Before

Width:  |  Height:  |  Size: 376 KiB

After

Width:  |  Height:  |  Size: 379 KiB

Before After
Before After

Binary file not shown.

Before

Width:  |  Height:  |  Size: 196 KiB

After

Width:  |  Height:  |  Size: 208 KiB

Before After
Before After

Binary file not shown.

Before

Width:  |  Height:  |  Size: 221 KiB

After

Width:  |  Height:  |  Size: 299 KiB

Before After
Before After

Binary file not shown.

Before

Width:  |  Height:  |  Size: 295 KiB

After

Width:  |  Height:  |  Size: 349 KiB

Before After
Before After

View file

@ -18,7 +18,8 @@ For the sample flights data, set the {data-source} to *Kibana Sample Data Flight
Warsaw OR Venice OR Clear
```
. If you don't see any results, expand the <<set-time-filter,time range>>, for example to *Last 7 days*.
. From the list of *Available fields*, add `_score` and any other fields you want to the document table.
. From the list of *Meta fields* list in the sidebar, add `_score`.
. Add any other fields you want to the document table.
+
At this point, you're sorting by the`timestamp` field.
. To turn off sorting by the `timestamp` field, click the *field sorted* option, and then click *Clear sorting.*

View file

@ -13,7 +13,7 @@ about the structure of the fields, and display your findings in a visualization.
You can also customize and save your searches and place them on a dashboard.
[role="screenshot"]
image::images/discover.png[A view of the Discover app]
image::images/hello-field.png[A view of the Discover app]
[float]
@ -82,13 +82,12 @@ that shows all the documents that match your search.
By default, the document table includes a column for the time field and a column that lists all other fields in the document.
Youll modify the document table to display your fields of interest.
. Scan through the list of **Available fields** until you find the `manufacturer` field.
You can also search for the field by name.
. In the sidebar, enter `ma` to in the search field to find the `manufacturer` field.
+
[role="screenshot"]
image:images/discover-sidebar-available-fields.png[Fields list that displays the top five search results, width=50%]
. Click `manufacturer` to view its most popular values.
. In the *Available fields* list, click `manufacturer` to view its most popular values.
+
**Discover** shows the top 10 values and the number of records used to calculate those values.
@ -104,14 +103,30 @@ them to the document table. Your table should look similar to this:
[role="screenshot"]
image:images/document-table.png[Document table with fields for manufacturer, customer_first_name, and customer_last_name]
. To rearrange the table columns, click a
column header, and then select *Move left* or *Move right*.
. To view more of the document table,
. Optionally try out these actions:
+
* To rearrange the table columns, click a
column header, and then select *Move left* or *Move right*.
+
* To copy the name or values in a column to the clipboard, click the column header and select the desired **Copy** option.
+
* For keyboard shortcuts on the document table, click
image:images/keyboard-shortcut-icon.png[icon button for opening list of keyboard shortcuts, width=24px].
+
* To view more of the document table,
click
image:images/chart-icon.png[icon button for opening Show/Hide chart menu, width=24px]
to open the *Chart options* menu,
and then select *Hide chart*.
+
* To toggle the table in and out of fullscreen mode, click the fullscreen icon
image:images/fullscreen-icon.png[icon to display the document table in fullscreen mode].
[float]
[[add-field-in-discover]]
@ -137,7 +152,7 @@ emit("Hello World!");
. Click *Save*.
. In the fields list, search for the *hello* field, and then add it to the document table.
. In the sidebar, search for the *hello* field, and then add it to the document table.
+
[role="screenshot"]
image:images/hello-field.png[hello field in the document tables]
@ -178,7 +193,7 @@ you can use to build a structured query.
Search the ecommerce data for documents where the country matches US:
. Enter `g`, and then select *geoip.country_iso_code*.
. Select *:* for equals some value and *US*, and then click *Refresh*.
. Select *:* for equals some value and *US*, and then click the refresh button or press the Enter key.
. For a more complex search, try:
+
```ts
@ -197,7 +212,8 @@ and more.
Exclude documents where day of week is not Wednesday:
. Click image:images/add-icon.png[Add icon] next to the query bar.
. In the *Add filter* pop-up, set *Field* to *day_of_week*, *Operator* to *is not*, and *Value* to *Wednesday*.
. In the *Add filter* pop-up, set the field to *day_of_week*, the operator to *is not*,
and the value to *Wednesday*.
+
[role="screenshot"]
image:images/discover-add-filter.png[Add filter dialog in Discover]
@ -242,19 +258,20 @@ the document table, the sort order, and the {data-source}.
. In the toolbar, click **Save**.
. Give your search a title.
. Optionally store <<managing-tags,tags>> and the time range with the search.
. Give your search a title, and then click **Save**.
. Click **Save**.
[float]
=== Visualize your findings
If a field can be {ref}/search-aggregations.html[aggregated], you can quickly
visualize it from **Discover**.
. From the **Available fields** list, click `day_of_week`, and then click **Visualize**.
+
[role="screenshot"]
image:images/discover-visualize.png[Discover sidebar field popover with visualize button, width=75%]
. In the sidebar, find and then click `day_of_week`.
. In the popup, click **Visualize**.
+
{kib} creates a visualization best suited for this field.
@ -315,6 +332,6 @@ include::{kib-repo-dir}/discover/search-for-relevance.asciidoc[]
include::{kib-repo-dir}/discover/save-search.asciidoc[]
include::{kib-repo-dir}/discover/search-sessions.asciidoc[]
include::{kib-repo-dir}/discover/field-statistics.asciidoc[]
include::{kib-repo-dir}/discover/search-sessions.asciidoc[]