Configure telemetry with XQuery
- Last Updated: September 1, 2025
- 1 minute read
- MarkLogic Server
- Version 12.0
- Documentation
You can also configure telemetry using the Telemetry APIs. See APIs for telemetry for the complete list. Here are a few examples of configuring telemetry using XQuery. You can run these examples in the Query Console. To set the telemetry log level with XQuery:
xquery version "1.0-ml";
import module namespace admin = "https://marklogic.com/xdmp/admin"
at "/MarkLogic/admin.xqy";
let $config := admin:get-configuration()
let $groupid := admin:group-get-id($config, "Default")
let $value := "finest"
let $tlogconfig := admin:group-set-telemetry-log-level($config, $groupid, $value)
return
admin:save-configuration($tlogconfig)
To check the telemetry log configuration, use this query:
xquery version "1.0-ml";
import module namespace admin = "https://marklogic.com/xdmp/admin"
at "/MarkLogic/admin.xqy";
let $config := admin:get-configuration()
let $groupid := admin:group-get-id($config, "Default")
return
admin:group-get-telemetry-log-level($config, $groupid)
=>
finest
To see the type of metering data that is being collected by telemetry, you can use the admin:group-get-telemetry-metering() function.
xquery version "1.0-ml";
import module namespace admin = "https://marklogic.com/xdmp/admin"
at "/MarkLogic/admin.xqy";
let $config := admin:get-configuration()
return
admin:group-get-telemetry-metering($config,
admin:group-get-id($config, "Default"))
=>
daily
To see whether telemetry usage data is being collected by telemetry, you can use the admin:group-get-telemetry-usage function.
xquery version "1.0-ml";
import module namespace admin = "https://marklogic.com/xdmp/admin"
at "/MarkLogic/admin.xqy";
let $config := admin:get-configuration()
let $groupid := admin:group-get-id($config, "Default")
return admin:group-get-telemetry-usage($config, $groupid)
=>
enabled
To see the type of proxy server URL that is being used by telemetry, you can use the admin:group-get-telemetry-proxy function.
xquery version "1.0-ml";
import module namespace admin = "https://marklogic.com/xdmp/admin"
at "/MarkLogic/admin.xqy";
let $config := admin:get-configuration()
return
admin:group-get-telemetry-proxy($config,
admin:group-get-id($config, "Default"))
=>
"https://proxy.marklogic.com:8080"