有奖捉虫:办公协同&微信生态&物联网文档专题 HOT

请求地址

地址为实例的 IP 和 PORT,可从控制台获取到,例如10.13.20.15:9200。

请求路径和方法

路径:/_metric/${metric_name}/update${metric_name}为 metric 的名称。 方法:PUT

请求参数

请求内容

字段 tags、time、fields、options 均为 map 类型的,选填,格式请参考 API 新建 metric。具体要求如下: tags:允许新增维度字段和修改已存在的维度字段类型,不会删除原有字段。 time:name 不能修改,format 允许修改。 fields:允许新增指标字段和修改已存在的指标字段类型,不会删除原有字段。 options 属性如下:
属性名称
必选
类型
描述
expire_day
integer
数据过期时间,取值范围为非零整数,过期后数据自动清理,缺省情况下永不过期
refresh_interval
string
数据刷新频率,写入的数据从内存刷新到磁盘后可查询,默认为10秒
number_of_shards
integer
表分片数,取值范围为正整数,小表可忽略,大表按照一个分片至多25G设置分片数,默认为3
number_of_replicas
integer
副本数,取值范围须设置为正整数,例如一主一副为1,缺省为1;不可设置为0,否则数据没有副本,存在丢失风险。
rolling_period
integer
子表时长(单位:天),取值范围为非零整数
CTSDB 存储数据时,为了方便做数据过期和提高查询效率,根据特定时间间隔划分子表,缺省情况下由数据过期时间决定
max_string_length
integer
自定义字符串 string 类型的值最大可支持的长度,取值范围为正整数,最大为32765,默认为256
default_date_format
string
自定义维度列和指标列 date 类型的格式,默认为 strict_date_optional_time 或 epoch_millis
indexed_fields
array
指定指标列中需要保留索引的字段,可指定多个,以数组形式指定
default_type
string
指定新增字段的默认类型。可选项为 tag、field,系统默认值为 tag
说明:
由于历史数据不可被修改,更新字段后 metric 信息不会立即变更,需要等待下一个 子表 产生。如果需要确认更新操作是否成功,可通过GET /_metric/${metric_name}?v接口进行确认。
只有为 short、integer、float 的字段才允许修改类型。其中 short 类型可被修改为 integer 和 long 类型;integer 类型可被修改为 long 类型;float 类型可被修改为 double 类型。

返回内容

需要通过 error 字段判断请求是否成功,若返回内容有 error 字段则请求失败,具体错误详情请参照 error 字段描述。

CURL 示例说明

请求:
curl -u root:le201909 -H 'Content-Type:application/json' -X PUT 172.16.345.14:9201/_metric/ctsdb_test/update -d'
{
"tags":{
"set":"string"
},
"time":{
"name":"timestamp",
"format":"epoch_second"
},
"fields":{
"diskUsage":"float"
},
"options":{
"expire_day":15,
"number_of_shards":10
}
}'
返回:
{
"acknowledged": true,
"message": "update ctsdb metric test111 success!"
}
?


http://www.vxiaotou.com