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 ```