Whisper

概述

Whisper 是 Graphite 项目中的三个组件之一：

Graphite-Web，一个基于 Django 的 Web 应用程序，用于渲染图表和仪表板
Carbon 指标处理守护进程
Whisper 时间序列数据库库

Graphite 组件

Whisper 是一个固定大小的数据库，在设计和用途上类似于 RRD（轮询数据库）。它提供了快速、可靠的数字数据随时间存储。Whisper 允许最近数据的高分辨率（每个点的秒数）逐渐降低为长期保留历史数据的低分辨率。

安装、配置和使用

请参阅 readthedocs 上的说明。

Whisper 脚本

rrd2whisper.py

将 rrd 文件转换为 whisper (.wsp) 文件。

用法：rrd2whisper.py rrd_路径

选项：
  -h, --help            显示此帮助消息并退出
  --xFilesFactor=XFILESFACTOR
                        在输出文件中使用的 xFilesFactor。默认为输入 RRD 的 xFilesFactor
  --aggregationMethod=AGGREGATIONMETHOD
                        从输入获取的合并函数和设置在输出上的聚合方法。可选项：average、
                        last、max、min、avg_zero、absmax、absmin
  --destinationPath=DESTINATIONPATH
                        创建的 whisper 文件的放置路径。默认为 RRD 文件的源路径。

whisper-create.py

创建新的 whisper 数据库文件。

用法：whisper-create.py 路径 每点时间:存储时间 [每点时间:存储时间]*
      whisper-create.py --estimate 每点时间:存储时间 [每点时间:存储时间]*

每点时间和存储时间指定时间长度，例如：

60:1440      每个数据点60秒，1440个数据点 = 1天的保留时间
15m:8        每个数据点15分钟，8个数据点 = 2小时的保留时间
1h:7d        每个数据点1小时，7天的保留时间
12h:2y       每个数据点12小时，2年的保留时间


选项：
  -h, --help            显示此帮助消息并退出
  --xFilesFactor=XFILESFACTOR
  --aggregationMethod=AGGREGATIONMETHOD
                        聚合值时使用的函数（average、sum、last、max、min、avg_zero、absmax、absmin）
  --overwrite
  --estimate            不创建 whisper 文件，仅根据归档定义估算存储需求

whisper-dump.py

将整个 whisper 文件内容导出到标准输出。

用法：whisper-dump.py 路径

选项：
  -h, --help            显示此帮助消息并退出
  --pretty              显示人类可读的时间戳而不是 Unix 时间
  -t TIME_FORMAT, --time-format=TIME_FORMAT
                        与 --pretty 一起使用的时间格式；参见 time.strftime()
  -r, --raw             仅以与 whisper-update 相同的格式导出值（UTC 时间戳）

whisper-fetch.py

将 whisper 文件中存储的所有指标获取到标准输出。

用法：whisper-fetch.py [选项] 路径

选项：
  -h, --help     显示此帮助消息并退出
  --from=_FROM   请求区间开始的 Unix 纪元时间（默认：24小时前）
  --until=UNTIL  请求区间结束的 Unix 纪元时间（默认：现在）
  --json         以 JSON 格式输出结果
  --pretty       显示人类可读的时间戳而不是 Unix 时间
  -t TIME_FORMAT, --time-format=TIME_FORMAT
                 与 --pretty 一起使用的时间格式；参见 time.strftime()
  --drop=DROP    指定 'nulls' 删除所有空值。指定 'zeroes' 删除所有零值。
                 指定 'empty' 删除空值和零值。

whisper-info.py

将 whisper 文件的元数据导出到标准输出。

用法：whisper-info.py [选项] 路径 [字段]
选项：
  -h, --help  显示此帮助信息并退出
  --json      以JSON格式输出结果

whisper-merge.py
----------------
合并两个现有的whisper文件。

用法：whisper-merge.py [选项] 源路径 目标路径

选项：
  -h, --help  显示此帮助信息并退出

whisper-fill.py
----------------
将src中的数据复制到dst（如果缺失）。
与whisper-merge不同，不覆盖目标文件中已存在的数据，
而仅添加缺失的数据（例如，目标文件中的空白处）。
由于不覆盖任何值，因此不会丢失数据或精度。
此外，与whisper-merge不同，尝试使用精度最高的存档
提供数据，而不是使用保留时间最长的存档。

用法：whisper-fill.py [选项] 源路径 目标路径

选项：
  -h, --help  显示此帮助信息并退出

whisper-resize.py
-----------------
更改现有whisper文件的保留率。

用法：whisper-resize.py 路径 每点时间:存储时间 [每点时间:存储时间]*

每点时间和存储时间指定时间长度，例如：

60:1440      每个数据点60秒，1440个数据点 = 1天的保留时间
15m:8        每个数据点15分钟，8个数据点 = 2小时的保留时间
1h:7d        每个数据点1小时，7天的保留时间
12h:2y       每个数据点12小时，2年的保留时间

选项：
  -h, --help            显示此帮助信息并退出
  --xFilesFactor=XFILESFACTOR
                        更改xFilesFactor
  --aggregationMethod=AGGREGATIONMETHOD
                        更改聚合函数（平均、总和、最后、最大、最小、零均值、绝对最大、绝对最小）
  --force               执行破坏性更改
  --newfile=NEWFILE     创建新的数据库文件而不删除现有文件
  --nobackup            成功执行后删除.bak文件
  --aggregate           尝试聚合值以更好地适应新的存档。请注意，这会使过程变慢并使用更多内存。

whisper-set-aggregation-method.py
---------------------------------
更改现有whisper文件的聚合方法。

用法：whisper-set-aggregation-method.py 路径 <average|sum|last|max|min|avg_zero|absmax|absmin>

选项：
  -h, --help  显示此帮助信息并退出

whisper-update.py
-----------------
用一个或多个值更新whisper文件，必须提供带有值的时间戳。

用法：whisper-update.py [选项] 路径 时间戳:值 [时间戳:值]*

选项：
  -h, --help  显示此帮助信息并退出

whisper-diff.py
---------------
检查whisper文件之间的差异。在合并前使用完整性检查。

用法：whisper-diff.py [选项] 路径_a 路径_b

选项：
  -h, --help      显示此帮助信息并退出
  --summary       显示差异摘要
  --ignore-empty  如果任一值未定义，则跳过比较
  --columns       以简单列形式打印输出
  --no-headers    不打印列标题
  --until=UNTIL   请求间隔结束的Unix纪元时间（默认：现在）
  --json          以JSON格式输出结果

## 许可证

Whisper根据Apache许可证2.0版获得许可。有关详细信息，请参阅LICENSE文件。