arrow-left

All pages
gitbookPowered by GitBook
1 of 1

Loading...

Housekeeping

circle-exclamation

This is the manual for older MicroStream versions (Version < 5.0).

The new documentation (Version >= 5.0) is located at:

https://docs.microstream.one/arrow-up-right

hashtag
Intervall and Time Budget

interval and time budget is configured by setting up a StorageHousekeepingController.

Available properties are:

  • interval the housekeeping is triggered in milliseconds, default once per every second

  • time budget for housekeeping in nanoseconds, default is 0.01 seconds

hashtag
File Sizes and Payload

The desired file min and max sizes and payload ratio is configured by the StorageDataFileEvaluator:

available properties are:

  • Data file minimum size Files smaller then minimum file size will be merged with other files if possible, default is 1 MB.

  • Data file maximum size Files larger then maximum file size will be split in smaller ones, default is 8 MB.

  • Data file payload min ratio to trigger file refactoring, default is 0.75 (75%).

hashtag
Cache

The lifetime of objects in the internal entity cache can be configured by the StorageEntityCacheEvaluator:

Available properties are:

  • Entity cache threshold

    Abstract threshold value, roughly comparable to size in bytes with a time component, at which a cache must be cleared of some entities. Default is 1000000000.

  • Entity cache timeout Time in milliseconds after that an entity is considered to be old if not read meanwhile. must be greater zero, default is 86400000ms (1 day).

circle-info

For external configuration see:

Housekeeping
House keeping interval
House keeping budget
Data file dissolve ratio
Properties
EmbeddedStorageManager storage = EmbeddedStorage.Foundation(
	Storage.ConfigurationBuilder()
		.setHousekeepingController(Storage.HousekeepingController(1000, 10_000_000))
		.createConfiguration())
	.start();
EmbeddedStorageManager storage = EmbeddedStorage.Foundation(
	Storage.ConfigurationBuilder()
		.setFileEvaluator(Storage.DataFileEvaluator(1024*1024, 1024*1024*8, 0.75))
		.createConfiguration())
	.start();
EmbeddedStorageManager storage = EmbeddedStorage.Foundation(
	Storage.ConfigurationBuilder()
		.setEntityCacheEvaluator(Storage.EntityCacheEvaluator(
			86_400_000, 
			1_000_000_000))
		.createConfiguration())
	.start();