Skip to content

Commit

Permalink
Merge branch '7.8' into backport/7.8/pr-66432
Browse files Browse the repository at this point in the history
  • Loading branch information
DianaDerevyankina committed May 29, 2020
2 parents 6309c97 + 23939c4 commit 85aa509
Show file tree
Hide file tree
Showing 114 changed files with 1,015 additions and 209 deletions.
6 changes: 5 additions & 1 deletion .ci/Jenkinsfile_flaky
Original file line number Diff line number Diff line change
Expand Up @@ -70,6 +70,8 @@ def getWorkerFromParams(isXpack, job, ciGroup) {
"run `node scripts/mocha`"
)
})
} else if (job == 'accessibility') {
return kibanaPipeline.functionalTestProcess('kibana-accessibility', './test/scripts/jenkins_accessibility.sh')
} else if (job == 'firefoxSmoke') {
return kibanaPipeline.functionalTestProcess('firefoxSmoke', './test/scripts/jenkins_firefox_smoke.sh')
} else if(job == 'visualRegression') {
Expand All @@ -79,7 +81,9 @@ def getWorkerFromParams(isXpack, job, ciGroup) {
}
}

if (job == 'firefoxSmoke') {
if (job == 'accessibility') {
return kibanaPipeline.functionalTestProcess('xpack-accessibility', './test/scripts/jenkins_xpack_accessibility.sh')
} else if (job == 'firefoxSmoke') {
return kibanaPipeline.functionalTestProcess('xpack-firefoxSmoke', './test/scripts/jenkins_xpack_firefox_smoke.sh')
} else if(job == 'visualRegression') {
return kibanaPipeline.functionalTestProcess('xpack-visualRegression', './test/scripts/jenkins_xpack_visual_regression.sh')
Expand Down
Binary file added docs/images/lens_viz_types.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/management-rollup-index-pattern.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
35 changes: 26 additions & 9 deletions docs/management/rollups/create_and_manage_rollups.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -60,7 +60,7 @@ You can read more at {ref}/rollup-job-config.html[rollup job configuration].
=== Try it: Create and visualize rolled up data

This example creates a rollup job to capture log data from sample web logs.
To follow along, add the <<add-sample-data, sample web logs data set>>.
To follow along, add the <<get-data-in, sample web logs data set>>.

In this example, you want data that is older than 7 days in the target index pattern `kibana_sample_data_logs`
to roll up once a day into the index `rollup_logstash`. You’ll bucket the
Expand Down Expand Up @@ -127,19 +127,36 @@ rollup index, or you can remove or archive it using <<creating-index-lifecycle-p
==== Visualize the rolled up data

Your next step is to visualize your rolled up data in a vertical bar chart.
Most visualizations support rolled up data, with the exception of Timelion, TSVB, and Vega visualizations.
Most visualizations support rolled up data, with the exception of Timelion and Vega visualizations.

Using the information from the example rollup configuration,
you can use `rollup_logstash` to match the rolled up index pattern,
and `kibana_sample_data_logs` to match the index pattern for raw data.

. Create the rollup index pattern in *Management > Index Patterns* so you can
select your rolled up data for visualizations. Click *Create index pattern*, and select *Rollup index pattern* from the dropdown.
+
[role="screenshot"]
image::images/management-rollup-index-pattern.png[][Create rollup index pattern]

. Enter *rollup_logstash,kibana_sample_logs* as your *Index Pattern* and `@timestamp`
as the *Time Filter field name*.
+
The notation for a combination index pattern with both raw and rolled up data
is `rollup_logstash,kibana_sample_data_logs`.
is `rollup_logstash,kibana_sample_data_logs`. In this index pattern, `rollup_logstash`
matches the rolled up index pattern and `kibana_sample_data_logs` matches the index
pattern for raw data.

. Go to *Visualize* and create a vertical bar chart. Choose `rollup_logstash,kibana_sample_data_logs`
as your source to see both the raw and rolled up data.
+
[role="screenshot"]
image::images/management_rollup_job_vis.png[][Visualization of rolled up data]
image::images/management-create-rollup-bar-chart.png[][Create visualization of rolled up data]

You can then create a dashboard that contains visualizations of the rolled up
data, raw data, or both. For more information, refer to <<rollup-index-pattern,rolled up data>>.
. Look at the data in your visualization.
+
[role="screenshot"]
image::images/management_rollup_job_vis.png[][Visualization of rolled up data]

. Optionally, create a dashboard that contains visualizations of the rolled up
data, raw data, or both.
+
[role="screenshot"]
image::images/management_rollup_job_dashboard.png[][Dashboard with rolled up data]
2 changes: 1 addition & 1 deletion docs/user/alerting/index.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -160,7 +160,7 @@ If you are using an *on-premises* Elastic Stack deployment:

If you are using an *on-premises* Elastic Stack deployment with <<using-kibana-with-security, *security*>>:

* Transport Layer Security (TLS) must be configured for communication <<configuring-tls-kib-es, between {es} and {kib}>>. {kib} alerting uses <<api-keys, API keys>> to secure background alert checks and actions, and API keys require {ref}/configuring-tls.html#tls-http[TLS on the HTTP interface].
* You must enable Transport Layer Security (TLS) for communication <<configuring-tls-kib-es, between {es} and {kib}>>. {kib} alerting uses <<api-keys, API keys>> to secure background alert checks and actions, and API keys require {ref}/configuring-tls.html#tls-http[TLS on the HTTP interface]. A proxy will not suffice.

[float]
[[alerting-security]]
Expand Down
2 changes: 1 addition & 1 deletion docs/user/dashboard.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -160,7 +160,7 @@ When you're finished adding and arranging the panels, save the dashboard.
. Enter the dashboard *Title* and optional *Description*, then *Save* the dashboard.

[[sharing-dashboards]]
=== Share the dashboard
== Share the dashboard

[[embedding-dashboards]]
Share your dashboard outside of {kib}.
Expand Down
127 changes: 55 additions & 72 deletions docs/visualize/lens.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -4,60 +4,51 @@

beta[]

*Lens* provides you with a simple and fast way to create visualizations from your {es} data. With Lens, you can:
*Lens* is a simple and fast way to create visualizations of your {es} data. With *Lens*,
you drag and drop your data fields onto the visualization builder pane, and *Lens* automatically generates
a visualization that best displays your data.

* Quickly build visualizations by dragging and dropping data fields.
With Lens, you can:

* Understand your data with a summary view on each field.
* Explore your data in just a few clicks.

* Easily change the visualization type by selecting the automatically generated visualization suggestions.
* Create visualizations with multiple layers and indices.

* Save your visualization for use in a dashboard.
* Use the automatically generated visualization suggestions to change the visualization type.

[float]
[[drag-drop]]
=== Drag and drop

The panel shows the data fields for the selected time period. When
you drag a field from the data panel, Lens highlights where you can drop that field. The first time you drag a data field,
you'll see two places highlighted in green:

* The visualization builder pane
* Add your visualizations to dashboards and Canvas workpads.

* The *X-axis* or *Y-axis* fields

You can incorporate many fields into your visualization, and Lens uses heuristics to decide how
to apply each one to the visualization.
To get started with *Lens*, click a field in the data panel, then drag and drop the field on a highlighted area.

[role="screenshot"]
image::images/lens_drag_drop.gif[]

TIP: Drag-and-drop capabilities are available only when Lens knows how to use the data. You can still customize
your visualization if Lens is unable to make a suggestion.
You can incorporate many fields into your visualization, and Lens uses heuristics to decide how to apply each one to the visualization.

TIP: Drag-and-drop capabilities are available only when Lens knows how to use the data. If *Lens* is unable to automatically generate a visualization,
you can still configure the customization options for your visualization.

[float]
[[apply-lens-filters]]
==== Find the right data
==== Filter the data panel fields

Lens shows you fields based on the <<index-patterns, index patterns>> you have defined in
{kib}, and the current time range. When you change the index pattern or time filter,
the list of fields are updated.
The fields in the data panel based on your selected <<index-patterns, index pattern>>, and the <<set-time-filter,time filter>>.

To narrow the list of fields, you can:
To change the index pattern, click it, then select a new one. The fields in the data panel automatically update.

* Enter the field name in *Search field names*.
To filter the fields in the data panel:

* Click *Filter by type*, then select the filter. You can also select *Only show fields with data*
to show the full list of fields from the index pattern.
* Enter the name in *Search field names*.

* Click *Filter by type*, then select the filter. To show all of the fields in the index pattern, deselect *Only show fields with data*.

[float]
[[view-data-summaries]]
==== Data summaries

To help you decide exactly the data you want to display, get a quick summary of each data field.
The summary shows the distribution of values in the time range.
To help you decide exactly the data you want to display, get a quick summary of each field. The summary shows the distribution of values in the time range.

To view the data information, navigate to a data field, then click *i*.
To view the field summary information, navigate to the field, then click *i*.

[role="screenshot"]
image::images/lens_data_info.png[]
Expand All @@ -66,46 +57,40 @@ image::images/lens_data_info.png[]
[[change-the-visualization-type]]
==== Change the visualization type

With Lens, you are no longer required to build each visualization from scratch. Lens allows
you to switch between any supported chart type at any time. Lens also provides
suggestions, which are shortcuts to alternate visualizations based on the data you have.
*Lens* enables you to switch between any supported visualization type at any time.

You can switch between suggestions without losing your previous state:
*Suggestions* are shortcuts to alternate visualizations that *Lens* generates for you.

[role="screenshot"]
image::images/lens_suggestions.gif[]

If you want to switch to a chart type that is not suggested, click the chart type,
then select a chart type. When there is an exclamation point (!)
next to a chart type, Lens is unable to transfer your current data, but
If you'd like to use a visualization type that is not suggested, click the visualization type,
then select a new one.

[role="screenshot"]
image::images/lens_viz_types.png[]

When there is an exclamation point (!)
next to a visualization type, Lens is unable to transfer your data, but
still allows you to make the change.

[float]
[[customize-operation]]
==== Customize the data for your visualization
==== Change the aggregation and labels

Lens allows some customizations of the data for each visualization.

. Click the index pattern name, then select the new index pattern.
+
If there is a match, Lens displays the new data. All fields that do not match the index pattern are removed.

. Change the data field options, such as the aggregation or label.

.. Click *Drop a field here* or the field name in the column.
. Click *Drop a field here* or the field name in the column.

.. Change the options that appear depending on the type of field.
. Change the options that appear depending on the type of field.

[float]
[[layers]]
==== Layers in bar, line, and area charts
==== Add layers and indices

The bar, line, and area charts allow you to layer two different series. To add a layer, click *+*.
Bar, line, and area charts allow you to visualize multiple data layers and indices so that you can compare and analyze data from multiple sources.

To remove a layer, click the chart icon next to the index name:

[role="screenshot"]
image::images/lens_remove_layer.png[]
To add a layer, click *+*, then drag and drop the fields for the new layer. To view a different index, click it, then select a new one.

[float]
[[lens-tutorial]]
Expand All @@ -125,50 +110,48 @@ To start, you'll need to add the <<add-sample-data, sample ecommerce data>>.

Drag and drop your data onto the visualization builder pane.

. Open *Visualize*, then click *Create visualization*.
. From the menu, click *Visualize*, then click *Create visualization*.

. On the *New Visualization* window, click *Lens*.

. Select the *kibana_sample_data_ecommerce* index.
. Select the *kibana_sample_data_ecommerce* index pattern.

. Click image:images/time-filter-calendar.png[], then click *Last 7 days*. The list of data fields are updated.
. Click image:images/time-filter-calendar.png[], then click *Last 7 days*.
+
The fields in the data panel update.

. Drag and drop the *taxful_total_price* data field to the visualization builder pane.
+
[role="screenshot"]
image::images/lens_tutorial_1.png[Lens tutorial]

Lens has taken your intent to see *taxful_total_price* and added in the *order_date* field to show
average order prices over time.
To display the average order prices over time, *Lens* automatically added in *order_date* field.

To break down your data, drag the *category.keyword* field to the visualization builder pane. Lens
understands that you want to show the top categories and compare them across the dates,
and creates a chart that compares the sales for each of the top 3 categories:
knows that you want to show the top categories and compare them across the dates,
and creates a chart that compares the sales for each of the top three categories:

[role="screenshot"]
image::images/lens_tutorial_2.png[Lens tutorial]

[float]
[[customize-lens-visualization]]
==== Further customization
==== Customize your visualization

Customize your visualization to look exactly how you want.
Make your visualization look exactly how you want with the customization options.

. Click *Average of taxful_total_price*.

.. Change the *Label* to `Sales`, or a name that you prefer for the data.
.. Change the *Label* to `Sales`.

. Click *Top values of category.keyword*.

.. Increase *Number of values* to `10`. The visualization updates in the background to show there are only
.. Change *Number of values* to `10`. The visualization updates to show there are only
six available categories.
+
Look at the *Suggestions*. An area chart is not an option, but for sales data, a stacked area chart might be the best option.

. Look at the suggestions. None of them show an area chart, but for sales data, a stacked area chart
might make sense. To switch the chart type:

.. Click *Stacked bar chart* in the column.

.. Click *Stacked area*.
. To switch the chart type, click *Stacked bar chart* in the column, then click *Stacked area* from the *Select a visualizations* window.
+
[role="screenshot"]
image::images/lens_tutorial_3.png[Lens tutorial]
Expand All @@ -177,6 +160,6 @@ image::images/lens_tutorial_3.png[Lens tutorial]
[[lens-tutorial-next-steps]]
==== Next steps

Now that you've created your visualization in Lens, you can add it to a Dashboard.
Now that you've created your visualization, you can add it to a dashboard or Canvas workpad.

For more information, see <<dashboard,Dashboard>>.
For more information, refer to <<dashboard,Dashboard>> or <<canvas,Canvas>>.
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,8 @@
"_source": [],
"_source_excludes": [],
"_source_includes": [],
"pipeline": ""
"pipeline": "",
"prefer_v2_templates": "__flag__"
},
"methods": [
"POST",
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
{
"cluster.delete_voting_config_exclusions": {
"url_params": {
"wait_for_removal": "__flag__"
},
"methods": [
"DELETE"
],
"patterns": [
"_cluster/voting_config_exclusions"
],
"documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/master/voting-config-exclusions.html"
}
}
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
{
"cluster.exists_component_template": {
"url_params": {
"master_timeout": "",
"local": "__flag__"
},
"methods": [
"HEAD"
],
"patterns": [
"_component_template/{name}"
],
"documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-component-templates.html"
}
}
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
{
"cluster.get_component_template": {
"url_params": {
"master_timeout": "",
"local": "__flag__"
},
"methods": [
"GET"
],
"patterns": [
"_component_template",
"_component_template/{name}"
],
"documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-component-templates.html"
}
}
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
{
"cluster.post_voting_config_exclusions": {
"url_params": {
"node_ids": "",
"node_names": "",
"timeout": ""
},
"methods": [
"POST"
],
"patterns": [
"_cluster/voting_config_exclusions"
],
"documentation": "https://www.elastic.co/guide/en/elasticsearch/reference/master/voting-config-exclusions.html"
}
}
Loading

0 comments on commit 85aa509

Please sign in to comment.