Skip to main content
Atoti implements some custom Java Flight Recording events, that are captured when using the Java Flight Recorder.
Those events are public facing, and allow low-level debugging, but are susceptible to change at any version (major, minor, bugfix).
All Atoti events share a flat atoti.* namespace (following Oracle’s JFR naming guidelines). Grouping is conveyed through the @Category attribute rather than dotted sub-namespaces.

​
How to use

It is possible to activate/deactivate an event when launching a JFR. It is recommended to use a configuration files, see jfr --help configure. For example: 
<configuration label="Custom" version="2.0">

    <event name="atoti.CubeCommit">
        <setting name="enabled">true</setting>
    </event>

    <event name="atoti.HierarchyCommit">
        <setting name="enabled">true</setting>
    </event>
</configuration>
Then when launching the java process, the argument -XX:StartFlightRecording:filename=myFileName.jfr,settings=myCustomSettings.jfc must be supplied. To limit the number of events recorded, several JFR options can be used:
  • period
  • threshold
  • throttle (starting with Java 25)
It is also possible to scrub an existing JFR from an event to reduce its size via the scrub command, see jfr --help scrub.

​
Available events

Event nameEvent LabelDefaultMeaningDocumentation
atoti.MemoryAllocationMemory AllocationDisabledOff-heap memory allocationOff-Heap Memory Monitoring
atoti.MemoryReleaseMemory ReleaseDisabledOff-heap memory freeingOff-Heap Memory Monitoring
atoti.AggregatesContributionTaskAggregates Contribution TaskDisabled (since 6.1.17)Task that aggregates the updates from the database into the collectors
atoti.ConflatedTransactionProcessingConflated Transaction ProcessingEnabledConflation of several epochs by the continuous query engineConflating Continuous Query Engine
atoti.ContributionTaskContribution TaskDisabled (since 6.1.17)Task that merges the contribution collectors into the aggregate provider
atoti.RemovalTaskRemoval TaskDisabled (since 6.1.17)Task that merges the removal collectors into the aggregate provider
atoti.CubeCommitCube CommitEnabledCommit event on a cube
atoti.HierarchyCommitHierarchy CommitDisabled (since 6.1.17)Commit event on a hierarchy
atoti.HierarchyPipelineTaskHierarchy Pipeline TaskDisabled (since 6.1.17)Task that performs contributions from a source partition to one or more hierarchies
atoti.MembersExtractionMembers ExtractionDisabled (since 6.1.17)Task that extracts and dictionarizes hierarchy members from fact records
atoti.StorePartitionWorkStore Partition WorkDisabled (since 6.1.15)Work type performed on a store partition