[Lens] introduce unified user messages system

[drewdaemon]

Summary

Preparation for #147485, #143673

This PR revamps the code that surfaces feedback in Lens. Warnings, deprecation messages, and errors are merged into a unified concept of the UserMessage. Guiding principles:

• Globally available—messages created from anywhere within the Lens codebase can be displayed in any UI location with minimal to no extra work.
• Maximally helpful—messages are equipped with useful information and unlimited dynamic user interface (e.g. quick fix buttons, links to docs). The severity of a message (error, warning) is carefully chosen and clearly communicated.
• Easily extensible—new messages and display locations can be added with ease. Adding a new message or display location adds very little complexity to the code.

Architecture changes

Current State

Warnings and errors are distinct entities. Ad hoc methods and call stacks have been added each time messages needed to be displayed in new UI locations. Warnings surfaced from children in the component tree are pushed to the Redux store in order to display them at a higher hierarchical level. Dimension trigger state is controlled by visualization configuration.

New State

Most user messages originate from visualization.getUserMessages, datasource.getUserMessages, and getApplicationUserMessages. When messages need to be generated outside those routines, addUserMessages utility makes them available globally. Redux store is no longer in play. Dimension trigger state is now controlled by user messages just like every other display location. Messages are queried for display via the global getUserMessages API.

Example test cases

Display locations

Editor toolbar

• new bar vertical stacked visualization
• horizontal axis -> top 50 values of clientip
• vertical axis -> median of bytes
• time range -> last 30 days

Embeddable badge

Trigger shard failures by following these instructions

Dimension trigger

• new gauge chart
• set minimum dimension to a value greater than the maximum dimension

Visualization

• new bar vertical stacked visualization
• horizontal axis -> date histogram with @timestamp
• vertical axis -> select cumulative sum quick function

Text-based languages query input

• Enable discover:enableSql in Advanced Settings
• Open Lens and select SQL from the datasource menu
• Introduce a typo in the query

Banner

• Enable lens:useFieldExistenceSampling in Advanced Settings
• Open Lens editor

Checklist

Delete any items that are not applicable to this PR.

• Unit or functional tests were updated or added to match the most common scenarios

[dej611]

Tested locally and it works.
Left some minor code refactoring nits. Approving to not block.

[MichaelMarcialis]

Left one small comment, but LGTM otherwise.

[stratoula]

Changes LGTM! Thanx Andrew, I really like the new system and will become even more handy in the future:)

[kibana-ci]

💚 Build Succeeded

• Buildkite Build
• Commit: 4648fe1

Metrics [docs]

Module Count

Fewer modules leads to a faster build time

id	before	after	diff
lens	889	890	+1

Public APIs missing comments

Total count of every public API that lacks a comment. Target amount is 0. Run node scripts/build_api_docs --plugin [yourplugin] --stats comments for more detailed information.

id	before	after	diff
lens	602	598	-4

Async chunks

Total size of all lazy-loaded chunks that will be downloaded as the user navigates the app

id	before	after	diff
lens	1.3MB	1.3MB	+5.0KB
maps	2.7MB	2.7MB	-22.0B
total			+4.9KB

Public APIs missing exports

Total count of every type that is part of your API that should be exported but is not. This will cause broken links in the API documentation system. Target amount is 0. Run node scripts/build_api_docs --plugin [yourplugin] --stats exports for more detailed information.

id	before	after	diff
lens	50	52	+2

Page load bundle

Size of the bundles that are downloaded on every page load. Target size is below 100kb

id	before	after	diff
lens	33.9KB	34.0KB	+36.0B

Unknown metric groups

API count

id	before	after	diff
lens	698	693	-5

ESLint disabled line counts

id	before	after	diff
lens	19	15	-4

Total ESLint disabled count

id	before	after	diff
lens	22	18	-4

History

• 💚 Build #101674 succeeded 3261793
• 💛 Build #101525 was flaky 360ded4
• 💚 Build #101434 succeeded b53c208
• 💔 Build #101406 failed 80de181
• 💛 Build #101156 was flaky 28b0b41
• 💔 Build #101129 failed 8a10b3e

To update your PR or re-run it, just comment with:
@elasticmachine merge upstream