机器数据分析平台

  • 机器数据分析平台 > 产品手册 > SPL参考手册 > bin

    bin

    最近更新时间:2019-11-08 12:05:10

    bin 命令将连续数值放入离散集合或数据桶,使得每个桶中的所有项具有同样的统计值。

    语法:

    bin field [as <newfield>] options
    

    参数说明:

    • field:指定分桶的字段。

    • options:

      • bins= <N>:分桶数量。

      • span=<N>:分桶的间隔,对于数值字段为整数;对于时间字段为时间间隔,如 1s,1m,1h,支持毫秒(ms),秒(s),分钟(m),小时(h),天(d),周(w),月(M),季度(q),年(y)。

        • 若同时指定 span 参数和 bin 参数,优先使用 span 参数计算。
        • 在只指定 bins 的情况下,数值类型的 span 是大于 (end-start)/bins 的最小的 10 的 n 次方。例如,设定 end=200, start=100, bins=4, iterval计算出来的值为 (end-start)/bins =25。 >25且是10的次方的值是100,所以实际上会按照 100的间隔对数值分桶。
      • start=<N>:分桶的开始数值。

      • end=<N>:分桶的结束数值。

        • 使⽤ start 和 end 参数来扩展范围,⽽不能缩减范围。及 start 参数须小于默认范围最小值,end 参数须大于默认范围最大值。
        • 对于数值字段,start 和 end 默认是 [min(field), max(field)]。
        • 对于时间字段,start 和 end 默认是查询时指定的时间范围。

    注意:若 span 和 bins 参数均没有指定:
    1.对于时间字段,默认间隔为 1 Day。
    2.对于数值字段,若指定了 start 和 end 参数,默认 bins 参数的值是10;若没指定 start 和 end 参数,默认间隔是 10。

    用法示例:

    时间分桶

    返回每 5 分钟间隔内每个主机的平均 cpu:

    | bin _time span=5m | stats avg(cpu) by _time,host
    

    数值分桶

    按照10s间隔统计响应时间在0到30s之间的日志计数

    | bin responsetime as group span=10 start=0 end=30 | stats count()  as cnt by group
    
    以上内容是否对您有帮助?
  • Icon helper
    Icon free helper
    Close