Customizing local instance

You may set TStorage params via Docker environment variables to further customize your experience. Some of those options may be changed freely, while others can only be set once and require purging previous records to change, since they influence data placement.

Instance options

Compose param name	Possible values	Default	Short description
tstorage_cid_log2_width	[0; 28]	3	Describes how many consecutive CID values (expressed as a power of 2) are bundled together for filtering. Increasing it speeds up PUTs over multiple values, decreasing optimizes GET requests.
tstorage_mid_log2_width	[0; 60]	10	Describes how many consecutive MID values (expressed as a power of 2) are bundled together for filtering. Increasing it speeds up PUTs over multiple values, decreasing optimizes GET requests.
tstorage_moid_log2_width	[0; 28]	3	Describes how many consecutive MOID values (expressed as a power of 2) are bundled together for filtering. Increasing it speeds up PUTs over multiple values, decreasing optimizes GET requests.
tstorage_cap_log2_width	[0; 60]	49	Describes how many consecutive CAP values (expressed as a power of 2) are bundled together for filtering. Increasing it speeds up PUTs over multiple values, decreasing optimizes GET requests.
tstorage_acq_log2_width	[0; 60]	46	Describes how many consecutive CID values (expressed as a power of 2) are bundled together for filtering. Increasing it speeds up PUTs over multiple values, decreasing optimizes GET requests.

Runtime options

Compose param name	Default	Short description
tstorage_workers	10	Describes total number of parallel requests that may be handled by given TStorage instance. Incrementing this param may lead to proportional increase in RAM consumption by database instance.
tstorage_buf_size	67108864	Describes size of internal buffers to store serialized data in bytes. Min. size 33MiB.
tstorage_timeout_ms	30000	Describes timeout of internal TCP connections in milliseconds.

Example customization

To optimize TStorage for retrieving data from singular measurements at a time, we may change its parameters to:

Compose param name	Value
tstorage_cid_log2_width	0
tstorage_mid_log2_width	0
tstorage_moid_log2_width	0

cap and acq will depend on the frequency of measurements:

Compose param name	15 minutes measurements	1 minute measurements	10 seconds measurements	1 second measurements
tstorage_cap_log2_width	56	52	49	46
tstorage_acq_log2_width	56	52	49	46

Note that exact optimized configuration will depend on various other components and has to be prepared for specific use case. For example if you want to retrieve data from longer duration, then you should increase both tstorage_cap_log2_width as well as tstorage_acq_log2_width. Feel free to contact us if you have any more questions.