OpenTSDB使用总结-(2)
【摘要】 API
写入数据
可以在一次请求中将多个数据写入OpenTSDB，每个数据都会被单独处理，且单数据出错不会影响其他数据的写入。建议每个请求中最大数据点数不超过50.
URI URI格式 写入数据
POST {OpenTSDB URL}/api/put
写入数据并返回概要信息
POST {OpenTSDB URL}/api/put?summary
写入数...
API
写入数据
可以在一次请求中将多个数据写入OpenTSDB，每个数据都会被单独处理，且单数据出错不会影响其他数据的写入。建议每个请求中最大数据点数不超过50.
URI
URI格式
写入数据
POST {OpenTSDB URL}/api/put
写入数据并返回概要信息
POST {OpenTSDB URL}/api/put?summary
写入数据并返回详细信息
POST {OpenTSDB URL}/api/put?details
说明：
如果summary和details标志同时存在于查询字符串，该API将响应detailed信息。
写入数据并等待数据刷入磁盘
POST {OpenTSDB URL}/api/put?sync
写入数据等待数据刷入磁盘，并设置超时时间（毫秒）。当发生超时时，使用details标志将会返回成功和失败的数据点数量。
POST {OpenTSDB URL}/api/put?sync&sync_timeout=60000
请求
请求样例：单数据点写入
{ "metric": "sys.cpu.nice", "timestamp": 1346846400, "value": 18, "tags": { "host": "web01", "dc": "lga" }
}
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
请求样例：多数据点写入-传入Json数组
[ { "metric": "sys.cpu.nice", "timestamp": 1346846400, "value": 18, "tags": { "host": "web01", "dc": "lga" } }, { "metric": "sys.cpu.nice", "timestamp": 1346846400, "value": 9, "tags": { "host": "web02", "dc": "lga" } }
]
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
- 16
- 17
- 18
- 19
- 20
- 21
参数说明
表1
| 请求参数说明 | 属性名 | 型是否必须 | 描述 | 限制 |
|---|---|---|---|---|
| metric | String | 是 | 指标项名 | 可以包含大小写英文字母，数字，“-”，“_”，“.”，“/”以及Unicode字符。不允许包含空格及其它字符。区分大小写。 |
| timestamp | Integer | 是 | 时间戳，单位：秒 | 以秒为单位的Unix/POSIX Epoch时间戳，从1970年1月1日00:00:00 UTC时间起经过的秒数。说明：时间戳建议使用4334400秒到4291718400秒之间的时间，即从1970/02/20 12:00:00到2106/01/01 00:00:00。必须是整数。不能超过13位数。仅支持秒级别的数据，毫秒级别的数据会转换成秒。 |
| value | Integer,Long,Double | 是 | 数据值 | 整数或者单精度浮点数（Float）。如果使用双精度（Double）的浮点数，可能能导致查询结果不正确。 |
| tags | Map | 是 | Tagk和Tagv的键值对 | 可以包含大小写英文字母，数字，“-”，“_”，“.”，“/”以及Unicode字符。不允许包含空格及其它字符。区分大小写。最少1个，最多8个Tagk和TagV的键值对。 |
响应
响应样例： summary
{ "failed": 1, "success": 0
}
- 1
- 2
- 3
- 4
- 5
- 6
响应样例：details
{ "errors": [ { "datapoint": { "metric": "sys.cpu.nice", "timestamp": 1365465600, "value": "NaN", "tags": { "host": "web01" } }, "error": "Unable to parse value to a number" } ], "failed": 1, "success": 0
}
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
- 16
- 17
- 18
- 19
文章来源: zclhit.blog.csdn.net，作者：zclhit_，版权归原作者所有，如需转载，请联系作者。
原文链接：zclhit.blog.csdn.net/article/details/80682605
【版权声明】本文为华为云社区用户转载文章，如果您发现本社区中有涉嫌抄袭的内容，欢迎发送邮件进行举报，并提供相关证据，一经查实，本社区将立刻删除涉嫌侵权内容，举报邮箱：
cloudbbs@huaweicloud.com
- 点赞
- 收藏
- 关注作者
评论（0）