Genozip telemetry service
What is Telemetry?
Genozip Telemetry Service is an optional service Genozip offers its customers (at no cost), allowing us to gain insight into the performance of the compression, and to proactively offer you tweaks to optimize compression effeciency, speed, and use of compute resources.
If the Genozip Telemetry Service is enabled, then when a file is compressed with genozip, a tiny record containing aggregate statistics regarding the performance of our compression methods and associated metadata is uploaded and logged on the Genozip server.
How to enable or disable Telemetry?
When you activate your license you will be asked to choose whether or not you permit telemetry. You can always switch telemetry on or off by re-activating using genozip --activate.
If telemetry is disabled, you can still send telemetry for a specific compression using genozip --telemetry.
If you are using an Evaluation license, telemetry is always enabled.
Data collected
The structure of a telemetry record is illustrated by the table below (one record per file compressed). This structure may continue to evolve over time as Genozip develops.
The precise record sent to Genozip can be seen by using the genozip --telemetry=FILE. This causes the telemetry record to be written to telemetry.json in the current directory.
Data retention policy
Per our privacy policy, telemetry logs may be retained indefinitely, or may be deleted if no longer needed, if required to do so by law or regulations, or if requested to do so by the user. To request deletion or to receive a copy of your telemetry records retained by us, please email support@genozip.com.
Questions? support@genozip.com
Field name | Example | Notes |
|---|---|---|
qual_histo (SAM/BAM/FASTQ) | ISD<72+$ | the most common base quality scores, in descending order of frequency. |
runtime | 0h14'25"; 25,13 | runtime of genozip, and the average number of cores used to compress each component |
timestamp | 1/June/2022 9:54 | Time this record was created |
txt_codec | GZ,GZ | for each component: codec of the source file and if GZIP, also the first GZIP header (typically 12-32 bytes) excluding the FNAME field, and the block sizes of the first 2 GZIP blocks. |
txt_size | 8234126873,3463182091 | Sizes of file(s) prior to Genozip compression - after removal of source compression (eg .gz) and original size (i.e. with source compression). |
user_host | john@lab | User and host running genozip |
version | 15.0.25 | Version of Genozip used |