1 <?xml version="1.0" encoding="utf-8"?>
   2 <!--
   3  Copyright (c) 2012, 2013, 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 trace SYSTEM "trace.dtd" [
  28 <!ENTITY % xinclude SYSTEM "xinclude.mod">
  29 %xinclude;
  30 ]>
  31 
  32 <trace>
  33   <xi:include href="tracetypes.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
  34 
  35   <relation_decls>
  36     <relation_decl id="GC_ID" uri="vm/gc/id"/>
  37     <relation_decl id="COMP_ID" uri="vm/compiler/id"/>
  38     <relation_decl id="SWEEP_ID" uri="vm/code_sweeper/id"/>
  39     <relation_decl id="JAVA_MONITOR_ADDRESS" uri="java/monitor/address"/>
  40   </relation_decls>
  41 
  42 <!--
  43 
  44 Events in the JVM are by default timed (it's more common)
  45 Perhaps a little strange. Might change.
  46 
  47 EVENTS
  48 
  49 Declard with the 'event' tag.
  50 
  51 <value fields> can be one or more of
  52    value            - a simple primitive or constant type value
  53    structvalue      - value is a sub-struct. This type must be previously defined
  54                       with 'struct'
  55 All these require you to declare type, field and label of the field. They also accept
  56 an optional description of the field. If the meaning of the field is not obvious
  57 from the label you should provide a description. If an event however is not actually
  58 meant for end-users, you should probably _not_ write descriptions at all, since you
  59 might just add more concepts the user has no notion of/interest in.
  60 
  61 Events should be modeled after what conceptual process you are expressing, _NOT_
  62 from whatever data structures you might use inside the JVM for expressing a process.
  63 
  64 
  65 STRUCT
  66 
  67 Declared with the 'struct' tag.
  68 
  69 Declares a structure type that can be used in other events.
  70 
  71 -->
  72 
  73   <events>
  74     <event id="ThreadStart" path="java/thread_start" label="Java Thread Start"
  75            has_thread="true" is_instant="true">
  76       <value type="JAVALANGTHREAD" field="javalangthread" label="Java Thread"/>
  77     </event>
  78 
  79     <event id="ThreadEnd" path="java/thread_end" label="Java Thread End"
  80            has_thread="true" is_instant="true">
  81       <value type="JAVALANGTHREAD" field="javalangthread" label="Java Thread"/>
  82     </event>
  83 
  84     <event id="ThreadSleep" path="java/thread_sleep" label="Java Thread Sleep"
  85             has_thread="true" has_stacktrace="true" is_instant="false">
  86       <value type="MILLIS" field="time" label="Sleep Time"/>
  87     </event>
  88 
  89     <event id="ThreadPark" path="java/thread_park" label="Java Thread Park"
  90             has_thread="true" has_stacktrace="true" is_instant="false">
  91       <value type="CLASS" field="klass" label="Class Parked On"/>
  92       <value type="MILLIS" field="timeout" label="Park Timeout"/>
  93       <value type="ADDRESS" field="address" label="Address of Object Parked" relation="JAVA_MONITOR_ADDRESS"/>
  94     </event>
  95 
  96     <event id="JavaMonitorEnter" path="java/monitor_enter" label="Java Monitor Blocked"
  97             has_thread="true" has_stacktrace="true" is_instant="false">
  98       <value type="CLASS" field="klass" label="Monitor Class"/>
  99       <value type="JAVALANGTHREAD" field="previousOwner" label="Previous Monitor Owner"/>
 100       <value type="ADDRESS" field="address" label="Monitor Address" relation="JAVA_MONITOR_ADDRESS"/>
 101     </event>
 102 
 103     <event id="JavaMonitorWait" path="java/monitor_wait" label="Java Monitor Wait" description="Waiting on a Java monitor"
 104             has_thread="true" has_stacktrace="true" is_instant="false">
 105       <value type="CLASS" field="klass" label="Monitor Class" description="Class of object waited on"/>
 106       <value type="OSTHREAD" field="notifier" label="Notifier Thread" description="Notifying Thread"/>
 107       <value type="MILLIS" field="timeout" label="Timeout" description="Maximum wait time"/>
 108       <value type="BOOLEAN" field="timedOut" label="Timed Out" description="Wait has been timed out"/>
 109       <value type="ADDRESS" field="address" label="Monitor Address" description="Address of object waited on" relation="JAVA_MONITOR_ADDRESS"/>
 110     </event>
 111 
 112     <event id="ClassLoad" path="vm/class/load" label="Class Load"
 113             has_thread="true" has_stacktrace="true" is_instant="false">
 114       <value type="CLASS" field="loadedClass" label="Loaded Class"/>
 115       <value type="CLASS" field="definingClassLoader" label="Defining Class Loader"/>
 116       <value type="CLASS" field="initiatingClassLoader" label="Initiating Class Loader"/>
 117     </event>
 118 
 119     <event id="ClassUnload" path="vm/class/unload" label="Class Unload"
 120         has_thread="true" is_instant="true">
 121       <value type="CLASS" field="unloadedClass" label="Unloaded Class"/>
 122       <value type="CLASS" field="definingClassLoader" label="Defining Class Loader"/>
 123     </event>
 124 
 125     <event id="LongFlagChanged" path="vm/flag/long_changed" label="Long Flag Changed"
 126           is_instant="true">
 127       <value type="UTF8" field="name" label="Name" />
 128       <value type="LONG" field="old_value" label="Old Value" />
 129       <value type="LONG" field="new_value" label="New Value" />
 130       <value type="FLAGVALUEORIGIN" field="origin" label="Origin" />
 131     </event>
 132 
 133     <event id="UnsignedLongFlagChanged" path="vm/flag/ulong_changed" label="Unsigned Long Flag Changed"
 134           is_instant="true">
 135       <value type="UTF8" field="name" label="Name" />
 136       <value type="ULONG" field="old_value" label="Old Value" />
 137       <value type="ULONG" field="new_value" label="New Value" />
 138       <value type="FLAGVALUEORIGIN" field="origin" label="Origin" />
 139     </event>
 140 
 141     <event id="DoubleFlagChanged" path="vm/flag/double_changed" label="Double Flag Changed"
 142          is_instant="true">
 143       <value type="UTF8" field="name" label="Name" />
 144       <value type="DOUBLE" field="old_value" label="Old Value" />
 145       <value type="DOUBLE" field="new_value" label="New Value" />
 146       <value type="FLAGVALUEORIGIN" field="origin" label="Origin" />
 147     </event>
 148 
 149     <event id="BooleanFlagChanged" path="vm/flag/boolean_changed" label="Boolean Flag Changed"
 150          is_instant="true">
 151       <value type="UTF8" field="name" label="Name" />
 152       <value type="BOOLEAN" field="old_value" label="Old Value" />
 153       <value type="BOOLEAN" field="new_value" label="New Value" />
 154       <value type="FLAGVALUEORIGIN" field="origin" label="Origin" />
 155     </event>
 156 
 157     <event id="StringFlagChanged" path="vm/flag/string_changed" label="String Flag Changed"
 158          is_instant="true">
 159       <value type="UTF8" field="name" label="Name" />
 160       <value type="UTF8" field="old_value" label="Old Value" />
 161       <value type="UTF8" field="new_value" label="New Value" />
 162       <value type="FLAGVALUEORIGIN" field="origin" label="Origin" />
 163     </event>
 164 
 165     <struct id="VirtualSpace">
 166       <value type="ADDRESS" field="start" label="Start Address" description="Start address of the virtual space" />
 167       <value type="ADDRESS" field="committedEnd" label="Committed End Address" description="End address of the committed memory for the virtual space" />
 168       <value type="BYTES64" field="committedSize" label="Committed Size" description="Size of the committed memory for the virtual space" />
 169       <value type="ADDRESS" field="reservedEnd" label="Reserved End Address" description="End address of the reserved memory for the virtual space" />
 170       <value type="BYTES64" field="reservedSize" label="Reserved Size" description="Size of the reserved memory for the virtual space" />
 171     </struct>
 172 
 173     <struct id="ObjectSpace">
 174       <value type="ADDRESS" field="start" label="Start Address" description="Start address of the space" />
 175       <value type="ADDRESS" field="end" label="End Address" description="End address of the space" />
 176       <value type="BYTES64" field="used" label="Used" description="Bytes allocated by objects in the space" />
 177       <value type="BYTES64" field="size" label="Size" description="Size of the space" />
 178     </struct>
 179 
 180     <event id="GCHeapSummary" path="vm/gc/heap/summary" label="Heap Summary" is_instant="true">
 181       <value type="UINT" field="gcId" label="GC ID" relation="GC_ID"/>
 182       <value type="GCWHEN" field="when" label="When" />
 183       <structvalue type="VirtualSpace" field="heapSpace" label="Heap Space"/>
 184       <value type="BYTES64" field="heapUsed" label="Heap Used" description="Bytes allocated by objects in the heap"/>
 185     </event>
 186 
 187     <struct id="MetaspaceSizes">
 188       <value type="BYTES64" field="capacity" label="Capacity" description="Total available memory to allocate in" />
 189       <value type="BYTES64" field="used" label="Used" description="Bytes allocated by objects in the space" />
 190       <value type="BYTES64" field="reserved" label="Reserved" description="Reserved memory for this space" />
 191     </struct>
 192 
 193     <event id="MetaspaceSummary" path="vm/gc/heap/metaspace_summary" label="Metaspace Summary" is_instant="true">
 194       <value type="UINT" field="gcId" label="GC ID" relation="GC_ID"/>
 195       <value type="GCWHEN" field="when" label="When" />
 196       <value type="BYTES64" field="gcThreshold" label="GC Threshold" />
 197       <structvalue type="MetaspaceSizes" field="metaspace" label="Total"/>
 198       <structvalue type="MetaspaceSizes" field="dataSpace" label="Data"/>
 199       <structvalue type="MetaspaceSizes" field="classSpace" label="Class"/>
 200     </event>
 201 
 202     <event id="MetaspaceGCThreshold" path="vm/gc/metaspace/gc_threshold" label="Metaspace GC Threshold" is_instant="true">
 203       <value type="BYTES64" field="oldValue" label="Old Value" />
 204       <value type="BYTES64" field="newValue" label="New Value" />
 205       <value type="GCTHRESHOLDUPDATER" field="updater" label="Updater" />
 206     </event>
 207 
 208     <event id="PSHeapSummary" path="vm/gc/heap/ps_summary" label="Parallel Scavenge Heap Summary" is_instant="true">
 209       <value type="UINT" field="gcId" label="GC ID" relation="GC_ID"/>
 210       <value type="GCWHEN" field="when" label="When" />
 211 
 212       <structvalue type="VirtualSpace" field="oldSpace" label="Old Space"/>
 213       <structvalue type="ObjectSpace" field="oldObjectSpace" label="Old Object Space"/>
 214 
 215       <structvalue type="VirtualSpace" field="youngSpace" label="Young Space"/>
 216       <structvalue type="ObjectSpace" field="edenSpace" label="Eden Space"/>
 217       <structvalue type="ObjectSpace" field="fromSpace" label="From Space"/>
 218       <structvalue type="ObjectSpace" field="toSpace" label="To Space"/>
 219     </event>
 220 
 221     <event id="GCGarbageCollection" path="vm/gc/collector/garbage_collection" label="Garbage Collection"
 222            description="Garbage collection performed by the JVM">
 223       <value type="UINT" field="gcId"  label="GC ID" relation="GC_ID" />
 224       <value type="GCNAME" field="name" label="Name" description="The name of the Garbage Collector" />
 225       <value type="GCCAUSE" field="cause" label="Cause" description="The reason for triggering this Garbage Collection" />
 226       <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" />
 227       <value type="TICKSPAN" field="longestPause" label="Longest Pause" description="Longest individual pause during the garbage collection" />
 228     </event>
 229 
 230     <event id="GCParallelOld" path="vm/gc/collector/parold_garbage_collection" label="Parallel Old Garbage Collection"
 231            description="Extra information specific to Parallel Old Garbage Collections">
 232       <value type="UINT" field="gcId"  label="GC ID" relation="GC_ID" />
 233       <value type="ADDRESS" field="densePrefix" label="Dense Prefix" description="The address of the dense prefix, used when compacting" />
 234     </event>
 235 
 236     <event id="GCYoungGarbageCollection" path="vm/gc/collector/young_garbage_collection" label="Young Garbage Collection"
 237            description="Extra information specific to Young Garbage Collections">
 238       <value type="UINT" field="gcId"  label="GC ID" relation="GC_ID" />
 239       <value type="UINT" field="tenuringThreshold" label="Tenuring Threshold" />
 240     </event>
 241 
 242     <event id="GCOldGarbageCollection" path="vm/gc/collector/old_garbage_collection" label="Old Garbage Collection"
 243            description="Extra information specific to Old Garbage Collections">
 244       <value type="UINT" field="gcId" label="GC ID" relation="GC_ID"/>
 245     </event>
 246 
 247     <event id="GCG1GarbageCollection" path="vm/gc/collector/g1_garbage_collection" label="G1 Garbage Collection"
 248            description="Extra information specific to G1 Garbage Collections">
 249       <value type="UINT" field="gcId" label="GC ID" relation="GC_ID"/>
 250       <value type="G1YCTYPE" field="type" label="Type" />
 251     </event>
 252 
 253     <event id="EvacuationInfo" path="vm/gc/detailed/evacuation_info" label="Evacuation Information" is_instant="true">
 254       <value type="UINT" field="gcId" label="GC ID" relation="GC_ID"/>
 255       <value type="UINT" field="cSetRegions" label="Collection Set Regions"/>
 256       <value type="BYTES64" field="cSetUsedBefore" label="Collection Set Before" description="Memory usage before GC in the collection set regions"/>
 257       <value type="BYTES64" field="cSetUsedAfter" label="Collection Set After" description="Memory usage after GC in the collection set regions"/>
 258       <value type="UINT" field="allocationRegions" label="Allocation Regions" description="Regions chosen as allocation regions during evacuation (includes survivors and old space regions)"/>
 259       <value type="BYTES64" field="allocRegionsUsedBefore" label="Alloc Regions Before" description="Memory usage before GC in allocation regions"/>
 260       <value type="BYTES64" field="allocRegionsUsedAfter" label="Alloc Regions After" description="Memory usage after GC in allocation regions"/>
 261       <value type="BYTES64" field="bytesCopied" label="Bytes Copied"/>
 262       <value type="UINT" field="regionsFreed" label="Regions Freed"/>
 263     </event>
 264 
 265     <event id="GCReferenceStatistics" path="vm/gc/reference/statistics"
 266            label="GC Reference Statistics" is_instant="true"
 267            description="Total count of processed references during GC">
 268       <value type="UINT" field="gcId" label="GC ID" relation="GC_ID"/>
 269       <value type="REFERENCETYPE" field="type" label="Type" />
 270       <value type="ULONG" field="count" label="Total Count" />
 271     </event>
 272 
 273     <struct id="CopyFailed">
 274       <value type="ULONG" field="objectCount" label="Object Count"/>
 275       <value type="BYTES64" field="firstSize" label="First Failed Object Size"/>
 276       <value type="BYTES64" field="smallestSize" label="Smallest Failed Object Size"/>
 277       <value type="BYTES64" field="totalSize" label="Total Object Size"/>
 278     </struct>
 279 
 280     <event id="ObjectCountAfterGC" path="vm/gc/detailed/object_count_after_gc" is_instant="true" label="Object Count after GC">
 281       <value type="UINT" field="gcId"  label="GC ID" relation="GC_ID" />
 282       <value type="CLASS" field="class" label="Class" />
 283       <value type="LONG" field="count" label="Count" />
 284       <value type="BYTES64" field="totalSize" label="Total Size" />
 285     </event>
 286 
 287     <event id="PromotionFailed" path="vm/gc/detailed/promotion_failed" label="Promotion Failed" is_instant="true"
 288            description="Promotion of an object failed">
 289       <value type="UINT" field="gcId" label="GC ID" relation="GC_ID"/>
 290       <structvalue type="CopyFailed" field="data" label="Data"/>
 291       <value type="OSTHREAD" field="thread" label="Running thread"/>
 292     </event>
 293 
 294     <event id="EvacuationFailed" path="vm/gc/detailed/evacuation_failed" label="Evacuation Failed" is_instant="true"
 295            description="Evacuation of an object failed">
 296       <value type="UINT" field="gcId" label="GC ID" relation="GC_ID"/>
 297       <structvalue type="CopyFailed" field="data" label="Data"/>
 298     </event>
 299 
 300     <event id="ConcurrentModeFailure" path="vm/gc/detailed/concurrent_mode_failure" label="Concurrent Mode Failure"
 301            is_instant="true" description="Concurrent Mode failed">
 302       <value type="UINT" field="gcId" label="GC ID" relation="GC_ID"/>
 303     </event>
 304 
 305     <event id="GCPhasePause" path="vm/gc/phases/pause" label="GC Phase Pause">
 306       <value type="UINT" field="gcId" label="GC ID" relation="GC_ID"/>
 307       <value type="UTF8" field="name" label="Name" />
 308     </event>
 309 
 310     <event id="GCPhasePauseLevel1" path="vm/gc/phases/pause_level_1" label="GC Phase Pause Level 1">
 311       <value type="UINT" field="gcId" label="GC ID" relation="GC_ID"/>
 312       <value type="UTF8" field="name" label="Name" />
 313     </event>
 314 
 315     <event id="GCPhasePauseLevel2" path="vm/gc/phases/pause_level_2" label="GC Phase Pause Level 2">
 316       <value type="UINT" field="gcId" label="GC ID" relation="GC_ID"/>
 317       <value type="UTF8" field="name" label="Name" />
 318     </event>
 319 
 320     <event id="GCPhasePauseLevel3" path="vm/gc/phases/pause_level_3" label="GC Phase Pause Level 3">
 321       <value type="UINT" field="gcId" label="GC ID" relation="GC_ID"/>
 322       <value type="UTF8" field="name" label="Name" />
 323     </event>
 324 
 325     <!-- Compiler events -->
 326 
 327     <event id="Compilation" path="vm/compiler/compilation" label="Compilation"
 328          has_thread="true" is_requestable="false" is_constant="false">
 329       <value type="METHOD" field="method" label="Java Method"/>
 330       <value type="UINT" field="compileID" label="Compilation ID" relation="COMP_ID"/>
 331       <value type="USHORT" field="compileLevel" label="Compilation Level"/>
 332       <value type="BOOLEAN" field="succeded" label="Succeeded"/>
 333       <value type="BOOLEAN" field="isOsr" label="On Stack Replacement"/>
 334       <value type="BYTES" field="codeSize" label="Compiled Code Size"/>
 335       <value type="BYTES" field="inlinedBytes" label="Inlined Code Size"/>
 336     </event>
 337 
 338     <event id="CompilerPhase" path="vm/compiler/phase" label="Compiler Phase"
 339             has_thread="true" is_requestable="false" is_constant="false">
 340       <value type="COMPILERPHASETYPE" field="phase" label="Compile Phase"/>
 341       <value type="UINT" field="compileID" label="Compilation ID" relation="COMP_ID"/>
 342       <value type="USHORT" field="phaseLevel" label="Phase Level"/>
 343     </event>
 344 
 345     <event id="CompilerFailure" path="vm/compiler/failure" label="Compilation Failure"
 346             has_thread="true" is_requestable="false" is_constant="false" is_instant="true">
 347       <value type="UTF8" field="failure" label="Message"/>
 348       <value type="UINT" field="compileID" label="Compilation ID" relation="COMP_ID"/>
 349     </event>
 350 
 351     <!-- Code sweeper events -->
 352 
 353     <event id="SweepCodeCache" path="vm/code_sweeper/sweep" label="Sweep Code Cache"
 354        has_thread="true" is_requestable="false" is_constant="false">
 355       <value type="INTEGER" field="sweepIndex" label="Sweep Index" relation="SWEEP_ID"/>
 356       <value type="USHORT" field="sweepFractionIndex" label="Fraction Index"/>
 357       <value type="UINT" field="sweptCount" label="Methods Swept"/>
 358       <value type="UINT" field="flushedCount" label="Methods Flushed"/>
 359       <value type="UINT" field="markedCount" label="Methods Reclaimed"/>
 360       <value type="UINT" field="zombifiedCount" label="Methods Zombified"/>
 361     </event>
 362 
 363     <!-- Code cache events -->
 364 
 365     <event id="CodeCacheFull" path="vm/code_cache/full" label="Code Cache Full"
 366          has_thread="true" is_requestable="false" is_constant="false" is_instant="true">
 367       <value type="ADDRESS" field="startAddress" label="Start Address"/>
 368       <value type="ADDRESS" field="commitedTopAddress" label="Commited Top"/>
 369       <value type="ADDRESS" field="reservedTopAddress" label="Reserved Top"/>
 370       <value type="INTEGER" field="entryCount" label="Entries"/>
 371       <value type="INTEGER" field="methodCount" label="Methods"/>
 372       <value type="INTEGER" field="adaptorCount" label="Adaptors"/>
 373       <value type="BYTES64" field="unallocatedCapacity" label="Unallocated"/>
 374       <value type="INTEGER" field="fullCount" label="Full Count"/>
 375     </event>
 376 
 377     <event id="ExecuteVMOperation" path="vm/runtime/execute_vm_operation" label="VM Operation"
 378         description="Execution of a VM Operation" has_thread="true">
 379       <value type="VMOPERATIONTYPE" field="operation" label="Operation" />
 380       <value type="BOOLEAN" field="safepoint" label="At Safepoint" description="If the operation occured at a safepoint."/>
 381       <value type="BOOLEAN" field="blocking" label="Caller Blocked" description="If the calling thread was blocked until the operation was complete."/>
 382       <value type="OSTHREAD" field="caller" label="Caller" transition="FROM" description="Thread requesting operation. If non-blocking, will be set to 0 indicating thread is unknown."/>
 383     </event>
 384 
 385     <!-- Allocation events -->
 386     <event id="AllocObjectInNewTLAB" path="java/object_alloc_in_new_TLAB" label="Allocation in new TLAB"
 387         description="Allocation in new Thread Local Allocation Buffer" has_thread="true" has_stacktrace="true" is_instant="true">
 388       <value type="CLASS" field="class" label="Class" description="Class of allocated object"/>
 389       <value type="BYTES64" field="allocationSize" label="Allocation Size"/>
 390       <value type="BYTES64" field="tlabSize" label="TLAB Size"/>
 391     </event>
 392 
 393     <event id="AllocObjectOutsideTLAB" path="java/object_alloc_outside_TLAB" label="Allocation outside TLAB"
 394         description="Allocation outside Thread Local Allocation Buffers" has_thread="true" has_stacktrace="true" is_instant="true">
 395       <value type="CLASS" field="class" label="Class" description="Class of allocated object"/>
 396       <value type="BYTES64" field="allocationSize" label="Allocation Size"/>
 397     </event>
 398   </events>
 399 
 400   <xi:include href="../../../closed/share/vm/trace/traceeventtypes.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
 401     <xi:fallback/>
 402   </xi:include>
 403 
 404   <xi:include href="../../../closed/share/vm/trace/traceevents.xml" xmlns:xi="http://www.w3.org/2001/XInclude">
 405     <xi:fallback/>
 406   </xi:include>
 407 </trace>