Skip to content

Commit b8758a9

Browse files
committed
mention Hibernate JFR in the Short Guide
1 parent 597f74f commit b8758a9

File tree

2 files changed

+11
-0
lines changed

2 files changed

+11
-0
lines changed

documentation/src/main/asciidoc/introduction/Configuration.adoc

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -121,6 +121,7 @@ and `com.github.ben-manes.caffeine:jcache`
121121
or `org.eclipse:yasson`
122122
| <<spatial,Hibernate Spatial>> | `org.hibernate.orm:hibernate-spatial`
123123
| <<envers,Envers>>, for auditing historical data | `org.hibernate.orm:hibernate-envers`
124+
| <<jfr,Hibernate JFR>>, for monitoring via Java Flight Recorder | `org.hibernate.orm:hibernate-jfr`
124125
|===
125126

126127
You might also add the Hibernate {enhancer}[bytecode enhancer] to your

documentation/src/main/asciidoc/introduction/Tuning.adoc

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -992,6 +992,16 @@ long publisherCacheMissCount =
992992
Hibernate's statistics enable observability.
993993
Both {micrometer}[Micrometer] and {smallrye-metrics}[SmallRye Metrics] are capable of exposing these metrics.
994994

995+
[[jfr]]
996+
=== Using Java Flight Recorder
997+
998+
Hibernate JFR is a separate module which reports events to Java Flight Recorder.
999+
This is different to reporting aggregated <<statistics,metrics>> via a tool like Micrometer, since JFR records information about the timing and duration of each discrete event, along with a stack trace.
1000+
If anything, the information reported by JFR is a little _too_ detailed to make it really useful for performance tuning.
1001+
It's perhaps more useful for _troubleshooting_.
1002+
1003+
No special configuration is required to use Hibernate JFR, just include `org.hibernate.orm:hibernate-jfr` as a runtime dependency. In particular, you _don't_ need to enable `hibernate.generate_statistics`.
1004+
9951005
[[slow-queries]]
9961006
=== Tracking down slow queries
9971007

0 commit comments

Comments
 (0)