1 <?xml version="1.0" encoding="utf-8"?>
  2 <!--
  3  Copyright (c) 2012, 2017, Oracle and/or its affiliates. All rights reserved.
  4  DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  5 
  6  This code is free software; you can redistribute it and/or modify it
  7  under the terms of the GNU General Public License version 2 only, as
  8  published by the Free Software Foundation.
  9 
 10  This code is distributed in the hope that it will be useful, but WITHOUT
 11  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 12  FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
 13  version 2 for more details (a copy is included in the LICENSE file that
 14  accompanied this code).
 15 
 16  You should have received a copy of the GNU General Public License version
 17  2 along with this work; if not, write to the Free Software Foundation,
 18  Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
 19 
 20  Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
 21  or visit www.oracle.com if you need additional information or have any
 22  questions.
 23 
 24 -->
 25 
 26 
 27 <!DOCTYPE events SYSTEM "trace.dtd">
 28 
 29 <events>
 30 
 31 <!--
 32 
 33 Events in the JVM are by default timed (it's more common)
 34 Perhaps a little strange. Might change.
 35 
 36 EVENTS
 37 
 38 Declard with the 'event' tag.
 39 
 40 <value fields> can be one or more of
 41    value            - a simple primitive or constant type value
 42    structvalue      - value is a sub-struct. This type must be previously defined
 43                       with 'struct'
 44 All these require you to declare type, field and label of the field. They also accept
 45 an optional description of the field. If the meaning of the field is not obvious
 46 from the label you should provide a description. If an event however is not actually
 47 meant for end-users, you should probably _not_ write descriptions at all, since you
 48 might just add more concepts the user has no notion of/interest in.
 49 
 50 Events should be modeled after what conceptual process you are expressing, _NOT_
 51 from whatever data structures you might use inside the JVM for expressing a process.
 52 
 53 
 54 STRUCT
 55 
 56 Declared with the 'struct' tag.
 57 
 58 Declares a structure type that can be used in other events.
 59 
 60 -->
 61 
 62   <event id="ThreadStart" path="java/thread_start" label="Java Thread Start"
 63          has_thread="true" is_instant="true">
 64     <value type="THREAD" field="thread" label="Java Thread"/>
 65   </event>
 66 
 67   <event id="ThreadEnd" path="java/thread_end" label="Java Thread End"
 68          has_thread="true" is_instant="true">
 69     <value type="THREAD" field="thread" label="Java Thread"/>
 70   </event>
 71 
 72   <event id="ThreadSleep" path="java/thread_sleep" label="Java Thread Sleep"
 73           has_thread="true" has_stacktrace="true" is_instant="false">
 74     <value type="MILLIS" field="time" label="Sleep Time"/>
 75   </event>
 76 
 77   <event id="ThreadPark" path="java/thread_park" label="Java Thread Park"
 78           has_thread="true" has_stacktrace="true" is_instant="false">
 79     <value type="CLASS" field="parkedClass" label="Class Parked On"/>
 80     <value type="MILLIS" field="timeout" label="Park Timeout"/>
 81     <value type="ADDRESS" field="address" label="Address of Object Parked" relation="JavaMonitorAddress"/>
 82   </event>
 83 
 84   <event id="JavaMonitorEnter" path="java/monitor_enter" label="Java Monitor Blocked"
 85           has_thread="true" has_stacktrace="true" is_instant="false">
 86     <value type="CLASS" field="monitorClass" label="Monitor Class"/>
 87     <value type="THREAD" field="previousOwner" label="Previous Monitor Owner"/>
 88     <value type="ADDRESS" field="address" label="Monitor Address" relation="JavaMonitorAddress"/>
 89   </event>
 90 
 91   <event id="JavaMonitorWait" path="java/monitor_wait" label="Java Monitor Wait" description="Waiting on a Java monitor"
 92           has_thread="true" has_stacktrace="true" is_instant="false">
 93     <value type="CLASS" field="monitorClass" label="Monitor Class" description="Class of object waited on"/>
 94     <value type="THREAD" field="notifier" label="Notifier Thread" description="Notifying Thread"/>
 95     <value type="MILLIS" field="timeout" label="Timeout" description="Maximum wait time"/>
 96     <value type="BOOLEAN" field="timedOut" label="Timed Out" description="Wait has been timed out"/>
 97     <value type="ADDRESS" field="address" label="Monitor Address" description="Address of object waited on" relation="JavaMonitorAddress"/>
 98   </event>
 99 
100   <event id="JavaMonitorInflate" path="java/monitor_inflate" label="Java Monitor Inflated"
101          has_thread="true" has_stacktrace="true" is_instant="false">
102     <value type="CLASS" field="monitorClass" label="Monitor Class"/>
103     <value type="ADDRESS" field="address" label="Monitor Address" relation="JavaMonitorAddress"/>
104     <value type="INFLATECAUSE" field="cause" label="Monitor Inflation Cause" description="Cause of inflation"/>
105   </event>
106 
107   <event id="BiasedLockRevocation" path="java/biased_lock_revocation" label="Biased Lock Revocation"
108          description="Revoked bias of object" has_thread="true" has_stacktrace="true" is_instant="false">
109     <value type="CLASS" field="lockClass" label="Lock Class" description="Class of object whose biased lock was revoked"/>
110     <value type="INTEGER" field="safepointId" label="Safepoint Identifier" relation="SafepointId"/>
111     <value type="THREAD" field="previousOwner" label="Previous Owner" description="Thread owning the bias before revocation"/>
112   </event>
113 
114   <event id="BiasedLockSelfRevocation" path="java/biased_lock_self_revocation" label="Biased Lock Self Revocation"
115          description="Revoked bias of object biased towards own thread" has_thread="true" has_stacktrace="true" is_instant="false">
116     <value type="CLASS" field="lockClass" label="Lock Class" description="Class of object whose biased lock was revoked"/>
117   </event>
118 
119   <event id="BiasedLockClassRevocation" path="java/biased_lock_class_revocation" label="Biased Lock Class Revocation"
120          description="Revoked biases for all instances of a class" has_thread="true" has_stacktrace="true" is_instant="false">
121     <value type="CLASS" field="revokedClass" label="Revoked Class" description="Class whose biased locks were revoked"/>
122     <value type="BOOLEAN" field="disableBiasing" label="Disable Further Biasing" description="Whether further biasing for instances of this class will be allowed"/>
123     <value type="INTEGER" field="safepointId" label="Safepoint Identifier" relation="SafepointId"/>
124   </event>
125 
126   <event id="ReservedStackActivation" path="vm/runtime/reserved_stack_activation" label="Reserved Stack Activation"
127          description="Activation of Reserved Stack Area caused by stack overflow with ReservedStackAccess annotated method in call stack"
128          has_thread="true" has_stacktrace="true" is_instant="true">
129       <value type="METHOD" field="method" label="Java Method"/>
130   </event>
131 
132   <event id="ClassLoad" path="vm/class/load" label="Class Load"
133          has_thread="true" has_stacktrace="true" is_instant="false">
134     <value type="CLASS" field="loadedClass" label="Loaded Class"/>
135     <value type="CLASSLOADER" field="definingClassLoader" label="Defining Class Loader"/>
136     <value type="CLASSLOADER" field="initiatingClassLoader" label="Initiating Class Loader"/>
137   </event>
138 
139   <event id="ClassDefine" path="vm/class/define" label="Class Define"
140          has_thread="true" has_stacktrace="true" is_instant="true">
141     <value type="CLASS" field="definedClass" label="Defined Class"/>
142     <value type="CLASSLOADER" field="definingClassLoader" label="Defining Class Loader"/>
143   </event>
144 
145   <event id="ClassUnload" path="vm/class/unload" label="Class Unload"
146          has_thread="true" is_instant="true">
147     <value type="CLASS" field="unloadedClass" label="Unloaded Class"/>
148     <value type="CLASSLOADER" field="definingClassLoader" label="Defining Class Loader"/>
149   </event>
150 
151   <event id="IntFlagChanged" path="vm/flag/int_changed" label="Int Flag Changed"
152          is_instant="true">
153     <value type="STRING" field="name" label="Name" />
154     <value type="INTEGER" field="oldValue" label="Old Value" />
155     <value type="INTEGER" field="newValue" label="New Value" />
156     <value type="FLAGVALUEORIGIN" field="origin" label="Origin" />
157   </event>
158 
159   <event id="UnsignedIntFlagChanged" path="vm/flag/uint_changed" label="Unsigned Int Flag Changed"
160          is_instant="true">
161     <value type="STRING" field="name" label="Name" />
162     <value type="UINT" field="oldValue" label="Old Value" />
163     <value type="UINT" field="newValue" label="New Value" />
164     <value type="FLAGVALUEORIGIN" field="origin" label="Origin" />
165   </event>
166 
167   <event id="LongFlagChanged" path="vm/flag/long_changed" label="Long Flag Changed"
168          is_instant="true">
169     <value type="STRING" field="name" label="Name" />
170     <value type="LONG" field="oldValue" label="Old Value" />
171     <value type="LONG" field="newValue" label="New Value" />
172     <value type="FLAGVALUEORIGIN" field="origin" label="Origin" />
173   </event>
174 
175   <event id="UnsignedLongFlagChanged" path="vm/flag/ulong_changed" label="Unsigned Long Flag Changed"
176          is_instant="true">
177     <value type="STRING" field="name" label="Name" />
178     <value type="ULONG" field="oldValue" label="Old Value" />
179     <value type="ULONG" field="newValue" label="New Value" />
180     <value type="FLAGVALUEORIGIN" field="origin" label="Origin" />
181   </event>
182 
183   <event id="DoubleFlagChanged" path="vm/flag/double_changed" label="Double Flag Changed"
184          is_instant="true">
185     <value type="STRING" field="name" label="Name" />
186     <value type="DOUBLE" field="oldValue" label="Old Value" />
187     <value type="DOUBLE" field="newValue" label="New Value" />
188     <value type="FLAGVALUEORIGIN" field="origin" label="Origin" />
189   </event>
190 
191   <event id="BooleanFlagChanged" path="vm/flag/boolean_changed" label="Boolean Flag Changed"
192          is_instant="true">
193     <value type="STRING" field="name" label="Name" />
194     <value type="BOOLEAN" field="oldValue" label="Old Value" />
195     <value type="BOOLEAN" field="newValue" label="New Value" />
196     <value type="FLAGVALUEORIGIN" field="origin" label="Origin" />
197   </event>
198 
199   <event id="StringFlagChanged" path="vm/flag/string_changed" label="String Flag Changed"
200          is_instant="true">
201     <value type="STRING" field="name" label="Name" />
202     <value type="STRING" field="oldValue" label="Old Value" />
203     <value type="STRING" field="newValue" label="New Value" />
204     <value type="FLAGVALUEORIGIN" field="origin" label="Origin" />
205   </event>
206 
207   <struct id="VirtualSpace">
208     <value type="ADDRESS" field="start" label="Start Address" description="Start address of the virtual space" />
209     <value type="ADDRESS" field="committedEnd" label="Committed End Address" description="End address of the committed memory for the virtual space" />
210     <value type="BYTES64" field="committedSize" label="Committed Size" description="Size of the committed memory for the virtual space" />
211     <value type="ADDRESS" field="reservedEnd" label="Reserved End Address" description="End address of the reserved memory for the virtual space" />
212     <value type="BYTES64" field="reservedSize" label="Reserved Size" description="Size of the reserved memory for the virtual space" />
213   </struct>
214 
215   <struct id="ObjectSpace">
216     <value type="ADDRESS" field="start" label="Start Address" description="Start address of the space" />
217     <value type="ADDRESS" field="end" label="End Address" description="End address of the space" />
218     <value type="BYTES64" field="used" label="Used" description="Bytes allocated by objects in the space" />
219     <value type="BYTES64" field="size" label="Size" description="Size of the space" />
220   </struct>
221 
222   <event id="GCHeapSummary" path="vm/gc/heap/summary" label="Heap Summary" is_instant="true">
223     <value type="UINT" field="gcId" label="GC Identifier" relation="GcId"/>
224     <value type="GCWHEN" field="when" label="When" />
225     <structvalue type="VirtualSpace" field="heapSpace" label="Heap Space"/>
226     <value type="BYTES64" field="heapUsed" label="Heap Used" description="Bytes allocated by objects in the heap"/>
227   </event>
228 
229   <struct id="MetaspaceSizes">
230     <value type="BYTES64" field="committed" label="Committed" description="Committed memory for this space" />
231     <value type="BYTES64" field="used" label="Used" description="Bytes allocated by objects in the space" />
232     <value type="BYTES64" field="reserved" label="Reserved" description="Reserved memory for this space" />
233   </struct>
234 
235   <event id="MetaspaceSummary" path="vm/gc/heap/metaspace_summary" label="Metaspace Summary" is_instant="true">
236     <value type="UINT" field="gcId" label="GC Identifier" relation="GcId"/>
237     <value type="GCWHEN" field="when" label="When" />
238     <value type="BYTES64" field="gcThreshold" label="GC Threshold" />
239     <structvalue type="MetaspaceSizes" field="metaspace" label="Total"/>
240     <structvalue type="MetaspaceSizes" field="dataSpace" label="Data"/>
241     <structvalue type="MetaspaceSizes" field="classSpace" label="Class"/>
242   </event>
243 
244   <event id="MetaspaceGCThreshold" path="vm/gc/metaspace/gc_threshold" label="Metaspace GC Threshold" is_instant="true">
245     <value type="BYTES64" field="oldValue" label="Old Value" />
246     <value type="BYTES64" field="newValue" label="New Value" />
247     <value type="GCTHRESHOLDUPDATER" field="updater" label="Updater" />
248   </event>
249 
250   <event id="MetaspaceAllocationFailure" path="vm/gc/metaspace/allocation_failure" label="Metaspace Allocation Failure" is_instant="true" has_stacktrace="true">
251     <value type="CLASSLOADER" field="classLoader" label="Class Loader" />
252     <value type="BOOLEAN" field="anonymousClassLoader" label="Anonymous Class Loader" />
253     <value type="BYTES64" field="size" label="Size" />
254     <value type="METADATATYPE" field="metadataType" label="Metadata Type" />
255     <value type="METASPACEOBJTYPE" field="metaspaceObjectType" label="Metaspace Object Type" />
256   </event>
257 
258   <event id="MetaspaceOOM" path="vm/gc/metaspace/out_of_memory" label="Metaspace Out of Memory" is_instant="true" has_stacktrace="true">
259     <value type="CLASSLOADER" field="classLoader" label="Class Loader" />
260     <value type="BOOLEAN" field="anonymousClassLoader" label="Anonymous Class Loader" />
261     <value type="BYTES64" field="size" label="Size" />
262     <value type="METADATATYPE" field="metadataType" label="Metadata Type" />
263     <value type="METASPACEOBJTYPE" field="metaspaceObjectType" label="Metaspace Object Type" />
264   </event>
265 
266   <event id="MetaspaceChunkFreeListSummary" path="vm/gc/metaspace/chunk_free_list_summary" label="Metaspace Chunk Free List Summary" is_instant="true">
267     <value type="UINT" field="gcId" label="GC Identifier" relation="GcId"/>
268     <value type="GCWHEN" field="when" label="When" />
269     <value type="METADATATYPE" field="metadataType" label="Metadata Type" />
270     <value type="ULONG" field="specializedChunks" label="Specialized Chunks" />
271     <value type="BYTES64" field="specializedChunksTotalSize" label="Specialized Chunks Total Size" />
272     <value type="ULONG" field="smallChunks" label="Small Chunks" />
273     <value type="BYTES64" field="smallChunksTotalSize" label="Small Chunks Total Size" />
274     <value type="ULONG" field="mediumChunks" label="Medium Chunks" />
275     <value type="BYTES64" field="mediumChunksTotalSize" label="Medium Chunks Total Size" />
276     <value type="ULONG" field="humongousChunks" label="Humongous Chunks" />
277     <value type="BYTES64" field="humongousChunksTotalSize" label="Humongous Chunks Total Size" />
278   </event>
279 
280   <event id="PSHeapSummary" path="vm/gc/heap/ps_summary" label="Parallel Scavenge Heap Summary" is_instant="true">
281     <value type="UINT" field="gcId" label="GC Identifier" relation="GcId"/>
282     <value type="GCWHEN" field="when" label="When" />
283 
284     <structvalue type="VirtualSpace" field="oldSpace" label="Old Space"/>
285     <structvalue type="ObjectSpace" field="oldObjectSpace" label="Old Object Space"/>
286 
287     <structvalue type="VirtualSpace" field="youngSpace" label="Young Space"/>
288     <structvalue type="ObjectSpace" field="edenSpace" label="Eden Space"/>
289     <structvalue type="ObjectSpace" field="fromSpace" label="From Space"/>
290     <structvalue type="ObjectSpace" field="toSpace" label="To Space"/>
291   </event>
292 
293   <event id="G1HeapSummary" path="vm/gc/heap/g1_summary" label="G1 Heap Summary" is_instant="true">
294     <value type="UINT" field="gcId" label="GC Identifier" relation="GcId"/>
295     <value type="GCWHEN" field="when" label="When" />
296 
297     <value type="BYTES64" field="edenUsedSize" label="Eden Used Size" />
298     <value type="BYTES64" field="edenTotalSize" label="Eden Total Size" />
299     <value type="BYTES64" field="survivorUsedSize" label="Survivor Used Size" />
300     <value type="UINT" field="numberOfRegions" label="Number of Regions" />
301   </event>
302 
303   <event id="GarbageCollection" path="vm/gc/collector/garbage_collection" label="Garbage Collection"
304          description="Garbage collection performed by the JVM">
305     <value type="UINT" field="gcId"  label="GC Identifier" relation="GcId" />
306     <value type="GCNAME" field="name" label="Name" description="The name of the Garbage Collector" />
307     <value type="GCCAUSE" field="cause" label="Cause" description="The reason for triggering this Garbage Collection" />
308     <value type="TICKSPAN" field="sumOfPauses" label="Sum of Pauses" description="Sum of all the times in which Java execution was paused during the garbage collection" />
309     <value type="TICKSPAN" field="longestPause" label="Longest Pause" description="Longest individual pause during the garbage collection" />
310   </event>
311 
312   <event id="ParallelOldGarbageCollection" path="vm/gc/collector/parold_garbage_collection" label="Parallel Old Garbage Collection"
313          description="Extra information specific to Parallel Old Garbage Collections">
314     <value type="UINT" field="gcId"  label="GC Identifier" relation="GcId" />
315     <value type="ADDRESS" field="densePrefix" label="Dense Prefix" description="The address of the dense prefix, used when compacting" />
316   </event>
317 
318   <event id="YoungGarbageCollection" path="vm/gc/collector/young_garbage_collection" label="Young Garbage Collection"
319          description="Extra information specific to Young Garbage Collections">
320     <value type="UINT" field="gcId"  label="GC Identifier" relation="GcId" />
321     <value type="UINT" field="tenuringThreshold" label="Tenuring Threshold" />
322   </event>
323 
324   <event id="OldGarbageCollection" path="vm/gc/collector/old_garbage_collection" label="Old Garbage Collection"
325          description="Extra information specific to Old Garbage Collections">
326     <value type="UINT" field="gcId" label="GC Identifier" relation="GcId"/>
327   </event>
328 
329   <event id="G1GarbageCollection" path="vm/gc/collector/g1_garbage_collection" label="G1 Garbage Collection"
330          description="Extra information specific to G1 Garbage Collections">
331     <value type="UINT" field="gcId" label="GC Identifier" relation="GcId"/>
332     <value type="G1YCTYPE" field="type" label="Type" />
333   </event>
334 
335   <event id="G1MMU" path="vm/gc/detailed/g1_mmu_info" label="G1 MMU Information" is_instant="true">
336     <value type="UINT" field="gcId" label="GC Identifier" relation="GcId"/>
337     <value type="MILLIS" field="timeSlice" label="Time Slice" description="Time slice used to calculate MMU"/>
338     <value type="MILLIS" field="gcTime" label="GC Time" description="Time stopped because of GC during last time slice"/>
339     <value type="MILLIS" field="pauseTarget" label="Pause Target" description="Max time allowed to be spent on GC during last time slice"/>
340   </event>
341 
342   <event id="EvacuationInformation" path="vm/gc/detailed/evacuation_info" label="Evacuation Information" is_instant="true">
343     <value type="UINT" field="gcId" label="GC Identifier" relation="GcId"/>
344     <value type="UINT" field="cSetRegions" label="Collection Set Regions"/>
345     <value type="BYTES64" field="cSetUsedBefore" label="Collection Set Before" description="Memory usage before GC in the collection set regions"/>
346     <value type="BYTES64" field="cSetUsedAfter" label="Collection Set After" description="Memory usage after GC in the collection set regions"/>
347     <value type="UINT" field="allocationRegions" label="Allocation Regions" description="Regions chosen as allocation regions during evacuation (includes survivors and old space regions)"/>
348     <value type="BYTES64" field="allocationRegionsUsedBefore" label="Allocation Regions Before" description="Memory usage before GC in allocation regions"/>
349     <value type="BYTES64" field="allocationRegionsUsedAfter" label="Allocation Regions After" description="Memory usage after GC in allocation regions"/>
350     <value type="BYTES64" field="bytesCopied" label="Bytes Copied"/>
351     <value type="UINT" field="regionsFreed" label="Regions Freed"/>
352   </event>
353 
354   <event id="GCReferenceStatistics" path="vm/gc/reference/statistics"
355          label="GC Reference Statistics" is_instant="true"
356          description="Total count of processed references during GC">
357     <value type="UINT" field="gcId" label="GC Identifier" relation="GcId"/>
358     <value type="REFERENCETYPE" field="type" label="Type" />
359     <value type="ULONG" field="count" label="Total Count" />
360   </event>
361 
362   <struct id="CopyFailed">
363     <value type="ULONG" field="objectCount" label="Object Count"/>
364     <value type="BYTES64" field="firstSize" label="First Failed Object Size"/>
365     <value type="BYTES64" field="smallestSize" label="Smallest Failed Object Size"/>
366     <value type="BYTES64" field="totalSize" label="Total Object Size"/>
367   </struct>
368 
369   <event id="ObjectCountAfterGC" path="vm/gc/detailed/object_count_after_gc" is_instant="true" label="Object Count after GC">
370     <value type="UINT" field="gcId"  label="GC Identifier" relation="GcId" />
371     <value type="CLASS" field="objectClass" label="Object Class" />
372     <value type="LONG" field="count" label="Count" />
373     <value type="BYTES64" field="totalSize" label="Total Size" />
374   </event>
375 
376   <struct id="G1EvacuationStatistics">
377     <value type="UINT" field="gcId" label="GC Identifier" relation="GcId"/>
378     <value type="BYTES64" field="allocated" label="Allocated" description="Total memory allocated by PLABs"/>
379     <value type="BYTES64" field="wasted" label="Wasted" description="Total memory wasted within PLABs due to alignment or refill"/>
380     <value type="BYTES64" field="used" label="Used" description="Total memory occupied by objects within PLABs"/>
381     <value type="BYTES64" field="undoWaste" label="Undo Wasted" description="Total memory wasted due to allocation undo within PLABs"/>
382     <value type="BYTES64" field="regionEndWaste" label="Region End Wasted" description="Total memory wasted at the end of regions due to refill"/>
383     <value type="UINT" field="regionsRefilled" label="Region Refills" description="Total memory wasted at the end of regions due to refill"/>
384     <value type="BYTES64" field="directAllocated" label="Allocated (direct)" description="Total memory allocated using direct allocation outside of PLABs"/>
385     <value type="BYTES64" field="failureUsed" label="Used (failure)" description="Total memory occupied by objects in regions where evacuation failed"/>
386     <value type="BYTES64" field="failureWaste" label="Wasted (failure)" description="Total memory left unused in regions where evacuation failed"/>
387   </struct>
388 
389   <event id="G1EvacuationYoungStatistics" path="vm/gc/detailed/g1_evac_young_stats" label="G1 Evacuation Statistics for Young"
390          is_instant="true" description="Memory related evacuation statistics during GC for the young generation">
391     <structvalue type="G1EvacuationStatistics" field="statistics" label="Evacuation Statistics"/>
392   </event>
393 
394   <event id="G1EvacuationOldStatistics" path="vm/gc/detailed/g1_evac_old_stats" label="G1 Evacuation Memory Statistics for Old"
395          is_instant="true" description="Memory related evacuation statistics during GC for the old generation">
396     <structvalue type="G1EvacuationStatistics" field="statistics" label="Evacuation Statistics"/>
397   </event>
398 
399   <event id="G1BasicIHOP" path="vm/gc/detailed/g1_basic_ihop_status" label="G1 Basic IHOP Statistics"
400          is_instant="true" description="Basic statistics related to current IHOP calculation">
401     <value type="UINT" field="gcId" label="GC Identifier" relation="GcId"/>
402     <value type="BYTES64" field="threshold" label="Current IHOP Threshold" description="Current IHOP threshold"/>
403     <value type="PERCENTAGE" field="thresholdPercentage" label="Current IHOP Threshold" description="Current IHOP threshold in percent of old generation"/>
404     <value type="BYTES64" field="targetOccupancy" label="Target Occupancy" description="Target old generation occupancy to reach at the start of mixed GC"/>
405     <value type="BYTES64" field="currentOccupancy" label="Current Occupancy" description="Current old generation occupancy"/>
406     <value type="BYTES64" field="recentMutatorAllocationSize" label="Recent Mutator Allocation Size" description="Mutator allocation during mutator operation in the most recent interval"/>
407     <value type="MILLIS" field="recentMutatorDuration" label="Recent Mutator Duration" description="Time the mutator ran in the most recent interval"/>
408     <value type="DOUBLE" field="recentAllocationRate" label="Recent Allocation Rate" description="Allocation rate of the mutator in the most recent interval in bytes/second"/>
409     <value type="MILLIS" field="lastMarkingDuration" label="Last Marking Duration" description="Last time from the end of the last initial mark to the first mixed GC"/>
410   </event>
411 
412   <event id="G1AdaptiveIHOP" path="vm/gc/detailed/g1_adaptive_ihop_status" label="G1 Adaptive IHOP Statistics"
413          is_instant="true" description="Statistics related to current adaptive IHOP calculation">
414     <value type="UINT" field="gcId" label="GC Identifier" relation="GcId"/>
415     <value type="BYTES64" field="threshold" label="Threshold" description="Current IHOP Threshold"/>
416     <value type="PERCENTAGE" field="thresholdPercentage" label="Threshold" description="Current IHOP threshold in percent of the internal target occupancy"/>
417     <value type="BYTES64" field="ihopTargetOccupancy" label="IHOP Target Occupancy" description="Internal target old generation occupancy to reach at the start of mixed GC"/>
418     <value type="BYTES64" field="currentOccupancy" label="Current Occupancy" description="Current old generation occupancy"/>
419     <value type="BYTES64" field="additionalBufferSize" label="Additional Buffer" description="Additional buffer size" experimental="true"/>
420     <value type="DOUBLE" field="predictedAllocationRate" label="Predicted Allocation Rate" description="Current predicted allocation rate for the mutator in bytes/second"/>
421     <value type="MILLIS" field="predictedMarkingDuration" label="Predicted Marking Duration" description="Current predicted time from the end of the last initial mark to the first mixed GC"/>
422     <value type="BOOLEAN" field="predictionActive" label="Prediction Active" description="Indicates whether the adaptive IHOP prediction is active"/>
423   </event>
424 
425   <!-- Promotion events, Supported GCs are Parallel Scavange, G1 and CMS with Parallel New. -->
426   <event id="PromoteObjectInNewPLAB" path="vm/gc/detailed/object_promotion_in_new_PLAB" label="Promotion in new PLAB"
427          description="Object survived scavenge and was copied to a new Promotion Local Allocation Buffer (PLAB). Supported GCs are Parallel Scavange, G1 and CMS with Parallel New. Due to promotion being done in parallel an object might be reported multiple times as the GC threads race to copy all objects."
428          has_thread="true" has_stacktrace="false" is_instant="true">
429     <value type="UINT" field="gcId" label="GC Identifier" relation="GcId" description="Identifier signifying GC during which the object was promoted"/>
430     <value type="CLASS" field="objectClass" label="Object Class" description="Class of promoted object"/>
431     <value type="BYTES64" field="objectSize" label="Object Size" description="Size of promoted object"/>
432     <value type="UINT" field="tenuringAge" label="Object Tenuring Age" description="Tenuring age of a surviving object before being copied. The tenuring age of an object is a value between 0-15 and is incremented each scavange the object survives. Newly allocated objects have tenuring age 0."/>
433     <value type="BOOLEAN" field="tenured" label="Tenured" description="True if object was promoted to Old space, otherwise the object was aged and copied to a Survivor space"/>
434     <value type="BYTES64" field="plabSize" label="PLAB Size" description="Size of the allocated PLAB to which the object was copied"/>
435   </event>
436 
437   <event id="PromoteObjectOutsidePLAB" path="vm/gc/detailed/object_promotion_outside_PLAB" label="Promotion outside PLAB"
438          description="Object survived scavenge and was copied directly to the heap. Supported GCs are Parallel Scavange, G1 and CMS with Parallel New. Due to promotion being done in parallel an object might be reported multiple times as the GC threads race to copy all objects."
439          has_thread="true" has_stacktrace="false" is_instant="true">
440     <value type="UINT" field="gcId" label="GC Identifier" relation="GcId" description="Identifier signifying GC during which the object was promoted"/>
441     <value type="CLASS" field="objectClass" label="Object Class" description="Class of promoted object"/>
442     <value type="BYTES64" field="objectSize" label="Object Size" description="Size of promoted object"/>
443     <value type="UINT" field="tenuringAge" label="Object Tenuring Age" description="Tenuring age of a surviving object before being copied. The tenuring age of an object is a value between 0-15 and is incremented each scavange the object survives. Newly allocated objects have tenuring age 0."/>
444     <value type="BOOLEAN" field="tenured" label="Tenured" description="True if object was promoted to Old space, otherwise the object was aged and copied to a Survivor space"/>
445   </event>
446 
447   <event id="PromotionFailed" path="vm/gc/detailed/promotion_failed" label="Promotion Failed" is_instant="true"
448          description="Promotion of an object failed">
449     <value type="UINT" field="gcId" label="GC Identifier" relation="GcId"/>
450     <structvalue type="CopyFailed" field="promotionFailed" label="Promotion Failed Data"/>
451     <value type="THREAD" field="thread" label="Running thread"/>
452   </event>
453 
454   <event id="EvacuationFailed" path="vm/gc/detailed/evacuation_failed" label="Evacuation Failed" is_instant="true"
455          description="Evacuation of an object failed">
456     <value type="UINT" field="gcId" label="GC Identifier" relation="GcId"/>
457     <structvalue type="CopyFailed" field="evacuationFailed" label="Evacuation Failed Data"/>
458   </event>
459 
460   <event id="ConcurrentModeFailure" path="vm/gc/detailed/concurrent_mode_failure" label="Concurrent Mode Failure"
461          is_instant="true" description="Concurrent Mode failed">
462     <value type="UINT" field="gcId" label="GC Identifier" relation="GcId"/>
463   </event>
464 
465   <event id="GCPhasePause" path="vm/gc/phases/pause" label="GC Phase Pause" has_thread="true">
466     <value type="UINT" field="gcId" label="GC Identifier" relation="GcId"/>
467     <value type="STRING" field="name" label="Name" />
468   </event>
469 
470   <event id="GCPhasePauseLevel1" path="vm/gc/phases/pause_level_1" label="GC Phase Pause Level 1" has_thread="true">
471     <value type="UINT" field="gcId" label="GC Identifier" relation="GcId"/>
472     <value type="STRING" field="name" label="Name" />
473   </event>
474 
475   <event id="GCPhasePauseLevel2" path="vm/gc/phases/pause_level_2" label="GC Phase Pause Level 2" has_thread="true">
476     <value type="UINT" field="gcId" label="GC Identifier" relation="GcId"/>
477     <value type="STRING" field="name" label="Name" />
478   </event>
479 
480   <event id="GCPhasePauseLevel3" path="vm/gc/phases/pause_level_3" label="GC Phase Pause Level 3" has_thread="true">
481     <value type="UINT" field="gcId" label="GC Identifier" relation="GcId"/>
482     <value type="STRING" field="name" label="Name" />
483   </event>
484 
485   <event id="GCPhasePauseLevel4" path="vm/gc/phases/pause_level_4" label="GC Phase Pause Level 4" has_thread="true">
486     <value type="UINT" field="gcId" label="GC Identifier" relation="GcId"/>
487     <value type="STRING" field="name" label="Name" />
488   </event>
489 
490   <event id="GCPhaseConcurrent" path="vm/gc/phases/concurrent" label="GC Phase Concurrent" has_thread="true">
491     <value type="UINT" field="gcId" label="GC Identifier" relation="GcId"/>
492     <value type="STRING" field="name" label="Name" />
493   </event>
494 
495   <event id="AllocationRequiringGC" path="vm/gc/detailed/allocation_requiring_gc" label="Allocation Requiring GC"
496          has_thread="true" has_stacktrace="true"  is_instant="true">
497     <value type="UINT" field="gcId"  label="Pending GC Identifier" relation="GcId" />
498     <value type="BYTES64" field="size" label="Allocation Size" />
499   </event>
500 
501   <event id="TenuringDistribution" path="vm/gc/detailed/tenuring_distribution" label="Tenuring Distribution"
502          is_instant="true">
503     <value type="UINT" field="gcId" label="GC Identifier" relation="GcId"/>
504     <value type="UINT" field="age" label="Age" />
505     <value type="BYTES64" field="size" label="Size" />
506   </event>
507 
508   <event id="G1HeapRegionTypeChange" path="vm/gc/detailed/g1_heap_region_type_change" label="G1 Heap Region Type Change"
509          description="Information about a G1 heap region type change" is_instant="true">
510     <value type="UINT" field="index" label="Index" />
511     <value type="G1HEAPREGIONTYPE" field="from" label="From" />
512     <value type="G1HEAPREGIONTYPE" field="to" label="To" />
513     <value type="ADDRESS" field="start" label="Start" />
514     <value type="BYTES64" field="used" label="Used" />
515     <value type="UINT" field="allocationContext" label="Allocation Context" />
516   </event>
517 
518   <!-- Compiler events -->
519 
520   <event id="Compilation" path="vm/compiler/compilation" label="Compilation"
521          has_thread="true" is_requestable="false" is_constant="false">
522     <value type="METHOD" field="method" label="Java Method"/>
523     <value type="UINT" field="compileId" label="Compilation Identifier" relation="CompileId"/>
524     <value type="USHORT" field="compileLevel" label="Compilation Level"/>
525     <value type="BOOLEAN" field="succeded" label="Succeeded"/>
526     <value type="BOOLEAN" field="isOsr" label="On Stack Replacement"/>
527     <value type="BYTES" field="codeSize" label="Compiled Code Size"/>
528     <value type="BYTES" field="inlinedBytes" label="Inlined Code Size"/>
529   </event>
530 
531   <event id="CompilerPhase" path="vm/compiler/phase" label="Compiler Phase"
532          has_thread="true" is_requestable="false" is_constant="false">
533     <value type="COMPILERPHASETYPE" field="phase" label="Compile Phase"/>
534     <value type="UINT" field="compileId" label="Compilation Identifier" relation="CompileId"/>
535     <value type="USHORT" field="phaseLevel" label="Phase Level"/>
536   </event>
537 
538   <event id="CompilationFailure" path="vm/compiler/failure" label="Compilation Failure"
539          has_thread="true" is_requestable="false" is_constant="false" is_instant="true">
540     <value type="STRING" field="failureMessage" label="Failure Message"/>
541     <value type="UINT" field="compileId" label="Compilation Identifier" relation="CompileId"/>
542   </event>
543 
544   <struct id="CalleeMethod">
545     <value type="STRING" field="type" label="Class"/>
546     <value type="STRING" field="name" label="Method Name"/>
547     <value type="STRING" field="descriptor" label="Method Descriptor"/>
548   </struct>
549 
550   <event id="CompilerInlining" path="vm/compiler/optimization/inlining" label="Method Inlining"
551          has_thread="true" is_instant="true">
552     <value type="UINT" field="compileId" label="Compilation Identifier" relation="CompileId"/>
553     <value type="METHOD" field="caller" label="Caller Method"/>
554     <structvalue type="CalleeMethod" field="callee" label="Callee Method"/>
555     <value type="BOOLEAN" field="succeeded" label="Succeeded"/>
556     <value type="STRING" field="message" label="Message"/>
557     <value type="INTEGER" field="bci" label="Byte Code Index"/>
558   </event>
559 
560   <!-- Code sweeper events -->
561 
562   <event id="SweepCodeCache" path="vm/code_sweeper/sweep" label="Sweep Code Cache"
563          has_thread="true" is_requestable="false" is_constant="false">
564     <value type="INTEGER" field="sweepId" label="Sweep Identifier" relation="SweepId"/>
565     <value type="UINT" field="sweptCount" label="Methods Swept"/>
566     <value type="UINT" field="flushedCount" label="Methods Flushed"/>
567     <value type="UINT" field="zombifiedCount" label="Methods Zombified"/>
568   </event>
569 
570   <!-- Code cache events -->
571 
572   <event id="CodeCacheFull" path="vm/code_cache/full" label="Code Cache Full"
573          has_thread="true" is_requestable="false" is_constant="false" is_instant="true">
574     <value type="CODEBLOBTYPE" field="codeBlobType" label="Code Heap"/>
575     <value type="ADDRESS" field="startAddress" label="Start Address"/>
576     <value type="ADDRESS" field="commitedTopAddress" label="Commited Top"/>
577     <value type="ADDRESS" field="reservedTopAddress" label="Reserved Top"/>
578     <value type="INTEGER" field="entryCount" label="Entries"/>
579     <value type="INTEGER" field="methodCount" label="Methods"/>
580     <value type="INTEGER" field="adaptorCount" label="Adaptors"/>
581     <value type="BYTES64" field="unallocatedCapacity" label="Unallocated"/>
582     <value type="INTEGER" field="fullCount" label="Full Count"/>
583   </event>
584 
585   <event id="SafepointBegin" path="vm/runtime/safepoint/begin" label="Safepoint Begin"
586          description="Safepointing begin" has_thread="true">
587     <value type="INTEGER" field="safepointId" label="Safepoint Identifier" relation="SafepointId"/>
588     <value type="INTEGER" field="totalThreadCount" label="Total Threads" description="The total number of threads at the start of safe point"/>
589     <value type="INTEGER" field="jniCriticalThreadCount" label="JNI Critical Threads" description="The number of threads in JNI critical sections"/>
590   </event>
591 
592   <event id="SafepointStateSynchronization" path="vm/runtime/safepoint/statesync" label="Safepoint State Synchronization"
593          description="Synchronize run state of threads" has_thread="true">
594     <value type="INTEGER" field="safepointId" label="Safepoint Identifier" relation="SafepointId"/>
595     <value type="INTEGER" field="initialThreadCount" label="Initial Threads" description="The number of threads running at the beginning of state check"/>
596     <value type="INTEGER" field="runningThreadCount" label="Running Threads" description="The number of threads still running"/>
597     <value type="INTEGER" field="iterations" label="Iterations" description="Number of state check iterations"/>
598   </event>
599 
600   <event id="SafepointWaitBlocked" path="vm/runtime/safepoint/waitblocked" label="Safepoint Wait Blocked"
601          description="Safepointing begin waiting on running threads to block" has_thread="true">
602     <value type="INTEGER" field="safepointId" label="Safepoint Identifier" relation="SafepointId"/>
603     <value type="INTEGER" field="runningThreadCount" label="Running Threads" description="The number running of threads wait for safe point"/>
604   </event>
605 
606   <event id="SafepointCleanup" path="vm/runtime/safepoint/cleanup" label="Safepoint Cleanup"
607          description="Safepointing begin running cleanup tasks" has_thread="true">
608     <value type="INTEGER" field="safepointId" label="Safepoint Identifier" relation="SafepointId"/>
609   </event>
610 
611   <event id="SafepointCleanupTask" path="vm/runtime/safepoint/cleanuptask" label="Safepoint Cleanup Task"
612          description="Safepointing begin running cleanup tasks" has_thread="true">
613     <value type="INTEGER" field="safepointId" label="Safepoint Identifier" relation="SafepointId"/>
614     <value type="STRING" field="name" label="Task Name" description="The task name"/>
615   </event>
616 
617   <event id="SafepointEnd" path="vm/runtime/safepoint/end" label="Safepoint End"
618          description="Safepointing end" has_thread="true">
619     <value type="INTEGER" field="safepointId" label="Safepoint Identifier" relation="SafepointId"/>
620   </event>
621 
622   <event id="ExecuteVMOperation" path="vm/runtime/execute_vm_operation" label="VM Operation"
623          description="Execution of a VM Operation" has_thread="true">
624     <value type="VMOPERATIONTYPE" field="operation" label="Operation" />
625     <value type="BOOLEAN" field="safepoint" label="At Safepoint" description="If the operation occured at a safepoint"/>
626     <value type="BOOLEAN" field="blocking" label="Caller Blocked" description="If the calling thread was blocked until the operation was complete"/>
627     <value type="THREAD" field="caller" label="Caller" transition="FROM" description="Thread requesting operation. If non-blocking, will be set to 0 indicating thread is unknown"/>
628     <value type="INTEGER" field="safepointId" label="Safepoint Identifier" description="The safepoint (if any) under which this operation was completed" relation="SafepointId"/>
629   </event>
630 
631   <!-- Allocation events -->
632   <event id="ObjectAllocationInNewTLAB" path="java/object_alloc_in_new_TLAB" label="Allocation in new TLAB"
633          description="Allocation in new Thread Local Allocation Buffer" has_thread="true" has_stacktrace="true" is_instant="true">
634     <value type="CLASS" field="objectClass" label="Object Class" description="Class of allocated object"/>
635     <value type="BYTES64" field="allocationSize" label="Allocation Size"/>
636     <value type="BYTES64" field="tlabSize" label="TLAB Size"/>
637   </event>
638 
639   <event id="ObjectAllocationOutsideTLAB" path="java/object_alloc_outside_TLAB" label="Allocation outside TLAB"
640          description="Allocation outside Thread Local Allocation Buffers" has_thread="true" has_stacktrace="true" is_instant="true">
641     <value type="CLASS" field="objectClass" label="Object Class" description="Class of allocated object"/>
642     <value type="BYTES64" field="allocationSize" label="Allocation Size"/>
643   </event>
644 </events>