Query the License Server¶
You will learn to query Roq’s license server.
Install¶
Install the roq-tools package
$ conda install -y -c https://roq-trading.com/conda/unstable roq-tools
Deployment¶
The license server keeps track of locked licenses. You can query the license server about your current deployment topology.
Note
Notice the last argument (deployment) which indicates the reporting type.
$ roq-auth --auth_keys_file $HOME/roq-auth_keys.json deployment
machines: (count=1)
[ 0] address : 178.xxx.xxx.xxx
hostname : fv-svr-01
machine_id : dc68xxxxxxxxxxxxxxxxxxxxxxxxda72
machine : x86_64
cpu_vendor : AuthenticAMD
cpu_brand : AMD EPYC 4545P 16-Core Processor
kernel_name : Linux
kernel_release : 6.8.0-110-generic
kernel_version : 110-Ubuntu SMP PREEMPT_DYNAMIC Thu Mar 19 15:09:20 UTC 2026
system_start_time_utc : 2026-04-18T17:01:05.040512273Z
system_uptime : 9 day(s) 19 hour(s)
number_of_processors : 32
cache_line_size : 64
page_size : 4096
system_total_memory : 30.459 (gigabytes)
system_available_memory : 13.918 (gigabytes)
services: (count=1)
[ 0] public_key : FmgAxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxI3c=
config_hash : 4lW7jOwq5-z5u0JwL6fF1SIO8hvGzRHYYQ1BXuchBLo=
token_expiry_time_utc : 2026-04-28T14:16:16.559713147Z
package_name : roq-deribit
package_version : 1.1.4
package_build_number : DEBUG
address : 178.xxx.xxx.xxx
hostname : fv-svr-01
machine_id : dc68xxxxxxxxxxxxxxxxxxxxxxxxda72
process_id : 1019883
process_start_time_utc : 2026-04-28T12:15:16.518440061Z
process_uptime : 0 day(s) 0 hour(s)
process_max_rss : 0.429 (gigabytes)
service_name : deribit
api_name :
instance : 0
session_id : b5a90fbb-d2fb-47ea-8499-9bce06bad4f9
is_uat : false
cpu_affinity : -1
symbols : 24 / 4570 (count)
accounts : 1 (count)
users : 8 (count)
create_order : 1 (count)
modify_order : 2 (count)
cancel_order : 2 (count)
cancel_all_orders : 0 (count)
mass_quote : 0 (count)
cancel_quotes : 0 (count)
please_report : 0 (count)
download_trades? : true
download_orders? : true
event_log? : true
position_manager? : false
risk_manager? : false
journal? : false
udp_publish? : false
internal_latency:
- avg(x) : 128.010µs (=640051/5)
- prob( x < 500ns) : 0.00 (=0/5)
- prob(500ns <= x < 1µs) : 0.00 (=0/5)
- prob( 1µs <= x < 2µs) : 0.00 (=0/5)
- prob( 2µs <= x < 5µs) : 0.00 (=0/5)
- prob( 5µs <= x < 10µs) : 0.00 (=0/5)
- prob( 10µs <= x < 20µs) : 0.00 (=0/5)
- prob( 20µs <= x ) : 1.00 (=5/5)
external_latency:
- avg(x) : 26.753ms (=133762821/5)
- prob( x < 10µs) : 0.00 (=0/5)
- prob( 10µs <= x < 100µs) : 0.00 (=0/5)
- prob(100µs <= x < 1ms) : 0.00 (=0/5)
- prob( 1ms <= x < 10ms) : 0.00 (=0/5)
- prob( 10ms <= x < 100ms) : 1.00 (=5/5)
- prob(100ms <= x < 1s) : 0.00 (=0/5)
- prob( 1s <= x ) : 0.00 (=0/5)
packages: (count=1)
[ 0] package_name : roq-deribit
package_version : 1.1.4 / DEBUG
summary:
services : 1 (count)
production licenses : 1 (count)
UAT licenses : 0 (count)
note! unique config_hash is used to determine the license count
note! to separate UAT from production, add --is_uat=true to your gateways command-line flags
Important
Roq only collects generic information about the host system and the flags used to configure the gateways. These metrics help Roq decide on future investments, e.g. the adoption of AVX-512 features.