TDIGEST.INFO

Syntax
TDIGEST.INFO key
Available in:
Redis Open Source / Bloom 2.4.0
Time complexity:
O(1)
ACL categories:
@tdigest, @read,
Compatibility:
Redis Enterprise and Redis Cloud compatibility

Returns information and statistics about a t-digest sketch.

Required arguments

key

is the key name for an existing t-digest sketch.

Examples 

redis> TDIGEST.CREATE t
OK
redis> TDIGEST.ADD t 1 2 3 4 5
OK
redis> TDIGEST.INFO t
 1) Compression
 2) (integer) 100
 3) Capacity
 4) (integer) 610
 5) Merged nodes
 6) (integer) 0
 7) Unmerged nodes
 8) (integer) 5
 9) Merged weight
10) (integer) 0
11) Unmerged weight
12) (integer) 5
13) Observations
14) (integer) 5
15) Total compressions
16) (integer) 0
17) Memory usage
18) (integer) 9768

Redis Enterprise and Redis Cloud compatibility

Redis
Enterprise		 Redis
Cloud		 Notes
✅ Supported
 ✅ Flexible & Annual
✅ Free & Fixed

Return information

One of the following:

  • Array reply with information about the given sketch as name-value pairs:
    Name
    Simple string reply    		 Description
    Compression Integer reply
    The compression (controllable trade-off between accuracy and memory consumption) of the sketch
    Capacity Integer reply
    Size of the buffer used for storing the centroids and for the incoming unmerged observations
    Merged nodes Integer reply
    Number of merged observations
    Unmerged nodes Integer reply
    Number of buffered nodes (uncompressed observations)
    Merged weight Integer reply
    Weight of values of the merged nodes
    Unmerged weight Integer reply
    Weight of values of the unmerged nodes (uncompressed observations)
    Observations Integer reply
    Number of observations added to the sketch
    Total compressions Integer reply
    Number of times this sketch compressed data together
    Memory usage Integer reply
    Number of bytes allocated for the sketch
  • Simple error reply in these cases: the given key does not exist or is of an incorrect type or an incorrect number of arguments.
RATE THIS PAGE
Back to top ↑