Skip to content

docs: add README#334

Merged
caalador merged 3 commits into
micrometerfrom
docs/readme
Jun 10, 2026
Merged

docs: add README#334
caalador merged 3 commits into
micrometerfrom
docs/readme

Conversation

@heruan

@heruan heruan commented Jun 9, 2026

Copy link
Copy Markdown
Member

Adds a project README.md documenting Observability Kit.

Structure:

  • Overview — what the kit instruments (sessions, UIs, navigation, requests, errors, client-side timing) and that it records into the app MeterRegistry; tracing via the Observation API.
  • Requirements — Java 21+, Vaadin 25.3+, a MeterRegistry, Spring Boot 4 (starter only).
  • Getting started (Spring Boot) — add observability-kit-starter and you're done; separate step for exposing metrics via Actuator + a registry backend (Prometheus example).
  • Working with the metrics — generic example injecting MeterRegistry into a view, reading a built-in meter and recording a custom timer.
  • Other setups — plain Spring (@Import(ObservabilityConfiguration.class)) and standalone (ObservabilityKit.install(...)).
  • Configuration — full vaadin.observability.* table with defaults + the ObservabilitySettings.builder() equivalent.
  • Metrics — full meter table (name / type / description).
  • Tracing and License.

Docs only — no code changes.

@heruan heruan self-assigned this Jun 9, 2026
Comment thread README.md Outdated
Comment thread README.md
heruan and others added 2 commits June 10, 2026 11:04
Co-authored-by: caalador <mikael.grankvist@vaadin.com>
The standalone example showed a bare ObservabilityKit.install(...) with no
indication of where it must run. It has to complete before the VaadinService
initializes, so show it in a @weblistener ServletContextListener — matching
the kit's own standalone setup (caalador review).
@caalador caalador merged commit fa0d1df into micrometer Jun 10, 2026
2 checks passed
@caalador caalador deleted the docs/readme branch June 10, 2026 09:42
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.

2 participants