Skip to content
/ cprof Public

Conditional Profiling for MarkLogic Server (XQuery and XSLT)

Notifications You must be signed in to change notification settings


Folders and files

Last commit message
Last commit date

Latest commit



6 Commits

Repository files navigation

CPROF - Conditional Profiling for MarkLogic Server

Conditional Profiling

You have written an application or a service using MarkLogic Server and XQuery or XSLT. Your application uses some combination of HTTP, xdmp:eval, xdmp:invoke, xdmp:value, xdmp:xslt-eval, and xdmp:xslt-invoke. You have discovered a slow request, and you want to profile it. But adding profiler support to an HTTP request can be tricky. Changing metaprogramming calls like xdmp:invoke to prof:invoke is also tricky: the functions from the Profile API return a sequence of the ordinary results, followed by a profile. This breaks your existing code.

What you want is a way to profile your main request, and stack up nested evaluation profiles until the end of the query. Then you can decide what to do with all the profiler output: display it, log it, email it, etc.

This XQuery library makes that pattern easy. Here is an example:

import module namespace cprof="com.blakeley.cprof" at "/path/to/cprof.xqy";

(: logic to enable profiling :)
if (xs:boolean(xdmp:get-request-field('profile', '0'))) then cprof:enable()
else (),


(: send the report XML wherever you like :)

The only necessary logic is whether or not to call cprof:enable. After that, you can simply replace xdmp:eval, xdmp:invoke, etc with cprof:eval, cprof:invoke, etc. The function signatures are identical. At the end of the query, call cprof:report and do whatever you like with the sequence of prof:report elements. If you get back the empty sequence, then profiling was not enabled.

Note that cprof:report takes an optional boolean argument. If set, the return value will be a single prof:report element with the main request's prof:metadata element and with all of the histograms merged into one prof:histogram element. This may be a little confusing, since the sum of all the histogram expressions may exceed headline elapsed time.

You may you have trouble invoking a module using a relative path, because cprof will call xdmp:invoke from its location instead of the caller's location. To work around this, use an absolute path. This also applies to xdmp:spawn, xdmp:xslt-invoke, etc.

The functions in this library are lightweight, so you do not need to disable them for production.

The cprof test cases use XQUT. If you find problems, please provide a test case. Patches are welcome.


Copyright (c) 2011-2014 Michael Blakeley. All Rights Reserved.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

The use of the Apache License does not indicate that this project is affiliated with the Apache Software Foundation.


Conditional Profiling for MarkLogic Server (XQuery and XSLT)






No releases published


No packages published