rocksdb-doc-cn

DB的Statistics提供一个历史累计数据。他提供来自DB属性以及性能和IO状态上下文的不同的功能:历史性能累计统计,DB属性提供当前状态;DB统计提供一个针对所有操作的聚合的试图,而性能和IO状态上下文允许我们查看每个单独的操作。

使用

函数CreateDBStatistics()创建一个统计对象。

这里有一个例子展示如何把它传递给DB:

Options options;
options.statistics = rocksdb::CreateDBStatistics();

技术上来说,你可以创建一个统计对象然后传递给多个DB。然后统计对象会包含所有这些DB的数据的聚合结果。注意,在跨多个DB的时候,有些统计值是未定义的,因此他们没有任何意义,比如说”rocksdb.sequence.number”

高级用户可以自行实现自己的统计类。参考最后一章节

统计等级和性能损耗

统计带来的损耗通常很小,但是不可以忽视。我们通常会观察到5%~10%的损耗。

统计都使用原子整数来实现(原子递增)。更进一步,统计测量时间间隔需要发起调用来获得当前时间。原子递增和及时函数都会带来损耗,损耗的大小根据平台有所差异。

我们有三个统计等级 kExceptDetailedTimers, kExceptTimeForMutex 和 kAll。

获取统计数据

统计类型

有两种类型的统计数据,滴答器和矩形图。

滴答器类型以64bit无符号整形表示。数值不会减小或者重置。滴答统计被用于测量计数器(例如 ”rocksdb.block.cache.hit”),累计字节(例如”rocksdb.bytes.written”)或者时间(例如“rocksdb.l0.slowdown.micros”)。

矩阵图类型测量所有操作的统计分布。大多数矩阵图用于DB操作的耗时分布。以“rocksdb.db.get.micros”为例,我们测量每个Get的时间,然后计算他们的分布状态。

打印人类可读的字符串

我们可以通过对所有计数器调用ToString()得到人类可读的字符串。

在info日志中周期性导出统计日志

统计会自动导出到info日志,时间间隔为options.stats_dump_period_sec。注意,只有一次压缩之后才会有导出。所以如果数据库很长一段时间不做写入,统计数据可能不会导出,不管options.stats_dump_period_sec是多少。

代码中访问统计数据

我们还可以通过统计对象直接访问特定的统计数据。滴答器类型列表可以在枚举Tickers里面找到。通过调用statistics.getTickerCount(),我们可以获取一个滴答器的值。类似的,一个矩阵图统计可以通过statistics.histogramData()调用,传入具体的枚举;或者调用statistics.getHistogramString()来获得。

时间间隔的统计

所有的统计都是从打开DB就开始累加的。如果你需要根据时间间隔来监控或者报告,你可以周期性地检查数值,然后,通过计算当前值和之前的值,来计算时间间隔值。

自定义统计

Statistics是一个抽象类,用户可以实现自己的类,然后传递给options.statistics。如果你需要把RocksDB的统计数据整合到自己的统计系统里面,这就很有用了。当你实现一个自定义的统计的时候,请注意RocksDB对recordTick()和measureTime()的调用量。如果不小心实现,自定义的统计很容易就会变成性能瓶颈。

看到这里或许你有建议或者疑问或者指出错误,请留言评论! 多谢! 你的评论非常重要!也可以帮忙点赞收藏转发!多谢支持! 觉得写的不错那就给点吧, 在线乞讨 微信转账