Skip to content

Commit 28751ac

Browse files
gchapsKOTungseth
andauthored
[DOCS] Adds content on ad-hoc data views (#146250)
## Summary This PR updates the data view doc to include more information about temporary data views. Closes #144582 Co-authored-by: Kaarina Tungseth <[email protected]>
1 parent 7022e56 commit 28751ac

File tree

1 file changed

+38
-24
lines changed

1 file changed

+38
-24
lines changed

docs/concepts/data-views.asciidoc

Lines changed: 38 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,6 @@
22
=== Create a {data-source}
33

44
{kib} requires a {data-source} to access the {es} data that you want to explore.
5-
A {data-source} selects the data to use and allows you to define properties of the fields.
6-
75
A {data-source} can point to one or more indices, {ref}/data-streams.html[data streams], or {ref}/alias.html[index aliases].
86
For example, a {data-source} can point to your log data from yesterday,
97
or all indices that contain your data.
@@ -19,7 +17,7 @@ or all indices that contain your data.
1917
`view_index_metadata`.
2018

2119
* If a read-only indicator appears in {kib}, you have insufficient privileges
22-
to create or save {data-sources}. The buttons to create {data-sources} or
20+
to create or save {data-sources}. In addition, the buttons to create {data-sources} or
2321
save existing {data-sources} are not visible. For more information,
2422
refer to <<xpack-security-authorization,Granting access to {kib}>>.
2523

@@ -32,51 +30,67 @@ uploaded a file, or added sample data,
3230
you get a {data-source} for free, and can start exploring your data.
3331
If you loaded your own data, follow these steps to create a {data-source}.
3432

35-
. Open the main menu, then click *Stack Management > Data Views*.
33+
. Open *Lens* or *Discover*, and then open the data view menu.
34+
+
35+
[role="screenshot"]
36+
image::images/discover-data-view.png[How to set the {data-source} in Discover, width="40%"]
37+
38+
. Click *Create a {data-source}*.
3639

37-
. Click *Create {data-source}*.
40+
. Give your {data-source} a name.
3841

39-
. Start typing in the *name* field, and {kib} looks for the names of
42+
. Start typing in the *Index pattern* field, and {kib} looks for the names of
4043
indices, data streams, and aliases that match your input.
4144
+
4245
[role="screenshot"]
4346
image:management/index-patterns/images/create-data-view.png["Create data view"]
4447
+
45-
** To match multiple sources, use a wildcard (*). For example, `filebeat-*` matches
48+
** To match multiple sources, use a wildcard (*). `filebeat-*` matches
4649
`filebeat-apache-a`, `filebeat-apache-b`, and so on.
4750
+
4851
** To match multiple single sources, enter their names,
4952
separated by a comma. Do not include a space after the comma.
50-
`filebeat-a,filebeat-b` matches two indices, but does not match `filebeat-c`.
53+
`filebeat-a,filebeat-b` matches two indices.
5154
+
5255
** To exclude a source, use a minus sign (-), for example, `-test3`.
5356

54-
. If {kib} detects an index with a timestamp, expand the *Timestamp field* menu,
57+
. Open the *Timestamp field* dropdown,
5558
and then select the default field for filtering your data by time.
5659
+
57-
** If your index doesn’t have time-based data, choose *I don’t want to use the time filter*.
58-
+
5960
** If you don’t set a default time field, you can't use
6061
global time filters on your dashboards. This is useful if
6162
you have multiple time fields and want to create dashboards that combine visualizations
6263
based on different timestamps.
64+
+
65+
** If your index doesn’t have time-based data, choose *I don’t want to use the time filter*.
6366

64-
. To display all indices, click *Show advanced settings*, then select *Allow hidden and system indices*.
67+
. Click *Show advanced settings* to:
68+
** Display hidden and system indices.
69+
** Specify your own {data-source} name. For example, enter your {es} index alias name.
6570

66-
. To specify your own {data-source} name, click *Show advanced settings*, then enter the name in the *Custom {data-source} ID* field. For example, enter your {es} index alias name.
71+
. [[reload-fields]] Click *Save {data-source} to {kib}*.
72+
+
73+
You can manage your data view from *Stack Management*.
74+
75+
[float]
76+
==== Create a temporary {data-source}
6777

68-
. [[reload-fields]] To use this data in searches and visualizations that you intend to save, click *Save {data-source} to {kib}*.
78+
Want to explore your data or create a visualization without saving it as a data view?
79+
Select *Use without saving* in the *Create {data-source}* form in *Discover*
80+
or *Lens*. With a temporary {data-source}, you can add fields and create an {es}
81+
query alert, just like you would a regular {data-source}. Your work won't be visible to others in your space.
6982

70-
. To explore your data without creating a {data-source}, click *Use without saving*.
71-
+
72-
This allows you to explore your data in *Discover*, *Lens*, and *Maps*
73-
without making it visible to others in your space. You can save the {data-source} later
74-
if you create a search or visualization that you want to share.
83+
A temporary {data-source} remains in your space until you change apps, or until you save it.
84+
85+
86+
[role="screenshot"]
87+
image::https://images.contentstack.io/v3/assets/bltefdd0b53724fa2ce/blte3a4f3994c44c0cc/637eb0c95834861044c21a25/ad-hoc-data-view.gif[how to create an ad-hoc data view]
7588

89+
NOTE: Temporary {data-sources} are not available in *Stack Management.*
7690

7791
[float]
7892
[[rollup-data-view]]
79-
==== Create a data view for rolled up data
93+
==== Use {data-sources} with rolled up data
8094

8195
A {data-source} can match one rollup index. For a combination rollup
8296
{data-source} with both raw and rolled up data, use the standard notation:
@@ -88,11 +102,11 @@ For an example, refer to <<rollup-data-tutorial,Create and visualize rolled up d
88102

89103
[float]
90104
[[management-cross-cluster-search]]
91-
==== Create a data view that searches across clusters
105+
==== Use {data-sources} with {ccs}
92106

93107
If your {es} clusters are configured for {ref}/modules-cross-cluster-search.html[{ccs}],
94108
you can create a {data-source} to search across the clusters of your choosing.
95-
You specify data streams, indices, and aliases in a remote cluster using the
109+
Specify data streams, indices, and aliases in a remote cluster using the
96110
following syntax:
97111

98112
```ts
@@ -139,14 +153,14 @@ aggregations using that {data-source} in {kib} take advantage of {ccs}.
139153

140154
[float]
141155
[[delete-data-view]]
142-
=== Delete {data-sources}
156+
=== Delete a {data-source}
143157

144158
When you delete a {data-source}, you cannot recover the associated field formatters, runtime fields, source filters,
145159
and field popularity data. Deleting a {data-source} does not remove any indices or data documents from {es}.
146160

147161
WARNING: Deleting a {data-source} breaks all visualizations, saved searches, and other saved objects that reference the data view.
148162

149-
. Open the main menu, then click *Stack Management > Data Views*.
163+
. Open the main menu, and then click *Stack Management > Data Views*.
150164

151165
. Find the {data-source} that you want to delete, and then
152166
click image:management/index-patterns/images/delete.png[Delete icon] in the *Actions* column.

0 commit comments

Comments
 (0)