This section describes tools designed to assist with performance monitoring and tuning.
Profiling execution time
Saxon comes with a simple tool allowing profiling of the execution time in a stylesheet.
To run this tool, first execute the transformation with the
option, which will gather timed tracing information and create a profile report to the
specified file (or to the standard error output if no filename is given). For example:
Then view the resulting
profile.html file in your browser.
The output identifies templates and functions in the original stylesheet by their name or match pattern, line number, and the last part of the URI of their module. For each instruction it gives the number of times the instruction was executed, the average time in milliseconds of each execution, and the total time. Timings are given both gross (the time for a template including all the templates it calls recursively), and net (the time for a template excluding time in its called templates). The table is sorted according to a weighting function that attempts to put the dominant functions and templates at the top. These will not necessarily be those with the greatest time, which tend to be instructions that were only executed once but remained active for the duration of the transformation.
In addition, the option
-TPxsl:filename can be provided, where
is the URI or filename of a stylesheet to be used for formatting the results. This allows you to
output the results as XML or JSON, allowing further analysis. To get the results as raw XML (or to
inspect the format supplied as input), supply an identity stylesheet. The data consists primarily of elements
constructidentifies the type of construct (template, function, global variable)
matchidentifies a template rule;
nameidentifies a function or variable
lineidentify the location of the component
countgives the number of times it was executed
t-sum-netgive the total gross and net execution time (net time excludes time spent executing invoked components)
t-avg-netgive the average gross and net execution time (net time excludes time spent executing invoked components)
Note that in the case of a recursive template or function, the total time spent in the component may exceed the total time of the transformation. "Net time" is generally a more useful metric.