Advanced Lens documentation #81780
Comments
|
Pinging @elastic/kibana-docs (Team:Docs) |
|
More things similar to that:
|
|
It seems easiest to discover some of this documentation directly in the product, but we don't currently have a design for this. This is pretty closely related to the idea of in-product help text about operations. |
|
After discussing some of these ideas with @KOTungseth and @MichaelMarcialis we have identified basically three possible types of reference content for Lens, mixing both in-product and external documentation.
I think the next steps are:
|
|
We've identified the following things need documentation.
|
|
For visibility, here are the design concepts that I shared with @wylieconlon and @KOTungseth in our last meeting. |
|
Migrating here as single source of truth from now on.
|
8-Jan-2021
|
flash1293
added
the
Team:Visualizations
|
Pinging @elastic/kibana-app (Team:KibanaApp) |
|
@dej611 @KOTungseth does it still make sense to keep this open? |
|
I'm using this issue to keep track of old and new Lens questions. |
|
Hi folks, I've been looking for documentation on "Group by this field First". I haven't really been able to find anything in the docs. Could someone point me to it or post an official description of what that switch is supposed to do? Thank you! |
|
Hi @govindrai , thanks for raising this. I think we actually don't document this well (@KOTungseth do you think we can get it into some of the existing guides?). A short explanation here: "Group by this field first" is about the order of multiple grouping dimensions. Let's say you have an xy chart with a date histogram on the horizontal axis and a "top 5 values of x" as breakdown. By default, your whole dataset is grouped by the top 5 values first, so you will get the top 5 values of x for the whole data set, then see their trends over time. However if you uncheck "group by this field first" for the breakdown dimension, it means it will do the date histogram first (grouping your data into time intervals), and then afterwards apply the "top 5 values of x" grouping separately per time bucket. This means you don't get the top 5 values overall over time, you get the top 5 values per time interval (e.g. per day). So your chart could show many more than 5 different values of x because there might be a different top 5 for each day. The same applies in other cases (e.g. if you have two "top values" dimensions on different fields). In some situations there is no effect at all, e.g. if there are less than 5 values in total - as all of them will show up either way, the grouping order doesn't change the result. See this example: Top 3 geo.dest overall, then do the time grouping: Time grouping, then top 3 geo.dest per 3 hour interval separately: |
stratoula
added
the
impact:medium
As we make Lens more complex, there will be more areas that would benefit from more technical descriptions.
For example:
For all of these things there are obvious, intuitive answers, which are right most of the time, but as with almost everything, there's depth to them and it would be cool to have an official answer for them (right now most of these are answered in blog posts or forum questions, but it's not really structured)
@flash1293 @wylieconlon @timroes @mbondyra
The text was updated successfully, but these errors were encountered: