github.com/GuanceCloud/cliutils@v1.1.21/pipeline/ptinput/funcs/md/agg_create.md (about)

     1  ### `agg_create()` {#fn-agg-create}
     2  
     3  函数原型:`fn agg_create(bucket: str, on_interval: str = "60s", on_count: int = 0, keep_value: bool = false, const_tags: map[string]string = nil, category: str = "M")`
     4  
     5  函数说明:创建一个用于聚合的指标集,通过 `on_interval` 或 `on_count` 设置时间或次数作为聚合周期,聚合结束后将上传聚合数据,可以选择是否保留上一次聚合的数据;该函数不适用于中心 Pipeline。
     6  
     7  函数参数:
     8  
     9  - `bucket`: 字符串类型,作为聚合出的指标的指标集名,如果该 bucket 已经创建,则函数不执行任何操作。
    10  - `on_interval`:默认值 `60s`, 以时间作为聚合周期,单位 `s`,值大于 `0` 时参数生效;不能同时与 `on_count` 小于等于 0。
    11  - `on_count`: 默认值 `0`,以处理的点数作为聚合周期,值大于 `0` 时参数生效。
    12  - `keep_value`: 默认值 `false`。
    13  - `const_tags`: 自定义的 tags,默认为空。
    14  - `category`: 聚合数据的数据类别,可选参数,默认值为 "M",表示指标类别数据。
    15  
    16  示例:
    17  
    18  ```python
    19  agg_create("cpu_agg_info", on_interval = "30s")
    20  ```