a3a915ab66
* [DOCS] Adds information about query timeout * [DOCS] Adds image to search doc * [DOCS] Improves organization * Update docs/discover/search.asciidoc Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co> * Update docs/discover/search.asciidoc Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co> Co-authored-by: Kaarina Tungseth <kaarina.tungseth@elastic.co>
116 lines
4 KiB
Text
116 lines
4 KiB
Text
[[discover]]
|
|
= Discover
|
|
|
|
[partintro]
|
|
--
|
|
|
|
When you know what your data includes, you can create visualizations
|
|
that best display that data and build better dashboards.
|
|
*Discover* enables you to explore your data, find
|
|
hidden insights and relationships, and get answers to your questions.
|
|
|
|
With *Discover*, you can:
|
|
|
|
* Access every document in every index that matches your selected index pattern
|
|
* Search your data and filter the search results
|
|
* Get field-level details about the documents that match your search
|
|
* View the events that occurred just before and after a document
|
|
|
|
[role="screenshot"]
|
|
image::images/Discover-Start.png[Discover]
|
|
|
|
|
|
[float]
|
|
[[select-pattern]]
|
|
=== Set up your index pattern
|
|
|
|
The first thing to do in *Discover* is to select an <<index-patterns, index pattern>>, which
|
|
defines the data you want to explore and visualize.
|
|
If you haven't yet created an index pattern, you can add a <<add-sample-data, sample data set>>,
|
|
which has a pre-built index pattern.
|
|
|
|
[float]
|
|
=== Set a time filter
|
|
|
|
By default, *Discover* shows data for the last 15 minutes.
|
|
If you have a time-based index, and no data displays,
|
|
you might need to increase the time range. Using the <<set-time-filter, time filter>>,
|
|
you can specify a common or recently-used time range, a relative time
|
|
from now, or an absolute time range.
|
|
|
|
[float]
|
|
=== Search your data
|
|
|
|
Now that you have your data and set the time span, you can start asking your questions.
|
|
You can search your data using the <<kuery-query, Kibana Query language>>,
|
|
which offers a simplified query syntax.
|
|
For example, if
|
|
you search for `day_of_week : Friday`, you'll get a list of all documents
|
|
in which `day_of_week` is set to `Friday`. If you prefer
|
|
<<lucene-query, Lucene query syntax>>, you can access it from the KQL menu.
|
|
|
|
[float]
|
|
=== Filter your search results
|
|
|
|
Next, you'll want narrow your search results to a more manageable data set.
|
|
When you click on a name in the field list, you'll see
|
|
the top five values for the field, the number of documents that contain the field,
|
|
and the percentage of documents that contain each value. From this view, you can
|
|
use the (+) magnifier icon to quickly find all
|
|
documents that have that value, or (-) to exclude all
|
|
documents with that value. For more filter options, see <<field-filter, filtering by field>>.
|
|
|
|
[role="screenshot"]
|
|
image::images/filter-field.png[height=317]
|
|
|
|
|
|
[float]
|
|
=== Add and remove fields
|
|
|
|
The sortable documents table
|
|
lists the documents that match your search.
|
|
By default, the table includes columns for the time field and the document `_source`.
|
|
To zero in on a specific field, click *add* next to the field name.
|
|
For example, if you add the `currency`, `customer_last_name`, and `day_of_week` fields,
|
|
the document table includes columns for those three fields.
|
|
|
|
[float]
|
|
=== Examine document contents
|
|
|
|
From the documents table, you can expand a document to
|
|
examine its field data in either table or JSON format.
|
|
The table view provides yet another filtering option—filtering for whether the field
|
|
is present. See <<document-data, Viewing document data>> for details.
|
|
|
|
[float]
|
|
=== View a document in context
|
|
|
|
Suppose you're troubleshooting your data, and you've narrowed down your results to a single document.
|
|
Now you want to to see the events that occurred just before and after the
|
|
document that you are looking at. You can do that by expanding the document and
|
|
clicking <<document-context, View surrounding documents>>.
|
|
|
|
[float]
|
|
=== Save and share your search
|
|
|
|
Finally, its time to save and share your data. You can export your data as a CSV file
|
|
or create a direct link to share. The *Save* and *Share* actions are in the menu bar.
|
|
|
|
|
|
|
|
|
|
--
|
|
|
|
include::{kib-repo-dir}/management/index-patterns.asciidoc[]
|
|
|
|
include::{kib-repo-dir}/discover/set-time-filter.asciidoc[]
|
|
|
|
include::{kib-repo-dir}/discover/search.asciidoc[]
|
|
|
|
include::{kib-repo-dir}/discover/field-filter.asciidoc[]
|
|
|
|
include::{kib-repo-dir}/discover/document-data.asciidoc[]
|
|
|
|
include::{kib-repo-dir}/discover/context.asciidoc[]
|
|
|
|
include::{kib-repo-dir}/discover/viewing-field-stats.asciidoc[]
|