Skip to content

Conversation

@florent-leborgne
Copy link
Contributor

@florent-leborgne florent-leborgne commented Oct 24, 2025

Fixes #2543

Here is a draft of a page for metrics charts. Would like reviewers to advise on anything missing and inaccuracies in particular for the settings part where there may be more nuance to add in some places.

Let's finetune what we can and once we have a few different chart pages ready, we can release in small batches

Done:

  • Optimize structure for readability
  • Analyze competition, check discuss forums, test product and check existing materials to decide on optimal content depth
  • Extract best practices from EUI's dataviz guidelines
  • Test current content - doesn't mean the doc is exhaustive, just that what's in there is correctly reflecting the product, there may be more nuance to add edge cases.
  • Have doc reviewed for completeness and accuracy
  • Have visualization best practices checked

Missing:

  • refine examples (various use cases but also various configuration setups) Done and checked
  • visuals for examples Done and checked
  • add some advanced, undocumented options that don't look so simple for defining values Done and checked

Release plan:

  • We'll release these as hidden for now, and turn it on once we have a batch of pages that makes sense (metric, line, bar, area, time series pages at least)
  • We'll remove duplicated content from main Lens page when turning those pages on

@github-actions
Copy link

github-actions bot commented Oct 24, 2025

@florent-leborgne florent-leborgne changed the base branch from main to chart-project-integration-branch October 29, 2025 15:34
@florent-leborgne florent-leborgne changed the base branch from chart-project-integration-branch to main October 29, 2025 15:41
@florent-leborgne florent-leborgne marked this pull request as ready for review October 29, 2025 15:46
@florent-leborgne florent-leborgne requested review from a team as code owners October 29, 2025 15:46
@alaudazzi alaudazzi changed the base branch from main to lens-charts-all October 30, 2025 11:43
Copy link

@teresaalvarezsoler teresaalvarezsoler left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hey @florent-leborgne great progress on this. I just left a few comments.

@florent-leborgne florent-leborgne changed the base branch from lens-charts-all to main November 7, 2025 16:18
@florent-leborgne
Copy link
Contributor Author

Updated to take first round of feedback from @teresaalvarezsoler and @gvnmagni into account

Copy link
Member

@markov00 markov00 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Great works here folks!
I've added some minor comments, but the overall page looks great.
Is way more readable, way more clear and precise then ever.


Metric charts make important single values stand out on a dashboard. They're perfect for highlighting KPIs such as error rates or SLOs for example, and for making them understandable at a glance with dynamic coloring or trend indicators.

They work with any numeric data: plain numbers, percentages, or calculations like a count, sum, or average. You can get this numeric data from numeric fields stored in your {{es}} documents, or from aggregation functions and formulas that you can apply to any type of field.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

note that you can also display strings by using the Last Value aggregation that picks up the last document, sorted by timestamp, in the current tine frame.

This is actually great to show the last event, the last status notified of a system/machine/app

Image

Copy link
Contributor Author

@florent-leborgne florent-leborgne Nov 18, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oh nice, do you have a practical example in mind that I could show? I'm not sure what I could do with the sample data. Still, I added a sentence to explain this. Thanks!

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A pratical example can be: show the last failing service in the current time frame, or the last error message, or the last failing server name/ip

Screenshot 2025-11-19 at 12 27 42

Copy link
Contributor

@nastasha-solomon nastasha-solomon left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Left some suggestions and questions that are hopefully helpful. Looks great overall though!

Copy link
Member

@bmorelli25 bmorelli25 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Great stuff. The structure and flow makes sense. Good approachable examples.

A few additional comments for you.

Copy link
Member

@markov00 markov00 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks fine to me, thanks!


Metric charts make important single values stand out on a dashboard. They're perfect for highlighting KPIs such as error rates or SLOs for example, and for making them understandable at a glance with dynamic coloring or trend indicators.

They work with any numeric data: plain numbers, percentages, or calculations like a count, sum, or average. You can get this numeric data from numeric fields stored in your {{es}} documents, or from aggregation functions and formulas that you can apply to any type of field.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A pratical example can be: show the last failing service in the current time frame, or the last error message, or the last failing server name/ip

Screenshot 2025-11-19 at 12 27 42

@florent-leborgne
Copy link
Contributor Author

florent-leborgne commented Nov 20, 2025

Thanks all for the helpful reviews, here and offline! I'll merge this now

@florent-leborgne florent-leborgne merged commit 934faf8 into elastic:main Nov 20, 2025
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Page for Metric charts

5 participants