?

?

/api/put

• 請(qǐng)求方式：post
• 請(qǐng)求參數(shù)：

參數(shù)說(shuō)明example

summary	返回主要摘要	/api/put?summary
details	返回詳細(xì)信息	/api/put?details
sync	是否同步，即是否等待數(shù)據(jù)都寫入成功后才返回結(jié)果	/api/put?sync
sync_timeout	返回結(jié)果之前的等待時(shí)間	/api/put/?sync&sync_timeout=60000

請(qǐng)求body

名稱類型描述

metric	String	要存儲(chǔ)指標(biāo)的名稱
timestamp	Integer	以秒或者毫秒為單位的時(shí)間戳
value	Integer/Float	時(shí)序數(shù)據(jù)庫(kù)的值
tags	Map	本條數(shù)據(jù)的tags

單條數(shù)據(jù)的寫入例子：

{"metric": "sys.cpu.nice","timestamp": 1346846400,"value": 18,"tags": {"host": "web01","dc": "lga"} }

寫入多條數(shù)據(jù)的例子：

[{"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"}} ]

Response
tsdb寫入成功默認(rèn)返回的http狀態(tài)碼是204，也就是返回的body為空。若想要知道更詳細(xì)的結(jié)果可以在請(qǐng)求路徑上加上summary或者details參數(shù)。

?

/api/query

查詢數(shù)據(jù)的接口，也是用的最多的接口。

• 請(qǐng)求方式：get、post、delete，注意:從opentsdb2.2版本開始，若用delete查詢數(shù)據(jù)，則在返回?cái)?shù)據(jù)的同時(shí)會(huì)刪除數(shù)據(jù)，第二次就查詢結(jié)果則為空。

參考：https://datamining.blog.csdn.net/article/details/105879150

?

/api/query/last

該接口是查詢最新數(shù)據(jù)，查詢最新數(shù)據(jù)的方式有兩種：

Counter Method：該查詢方式是基于data point counter的。

Back Scan：設(shè)定一個(gè)掃描的時(shí)間，從當(dāng)前時(shí)刻往后掃描。

請(qǐng)求body中的backScan即代表往后掃描24小時(shí)，當(dāng)backScan為0時(shí)表示采用第一種查詢方式。resolveNames=true時(shí)，會(huì)把數(shù)據(jù)的metric，tags，tsuid也一起返回回來(lái)。

?

{"queries": [{"metric":"sys.cpu.nice","tags":{"host":"web01","dc":"lga"}}],"resolveNames":true,"backScan":24 }

?

?

/api/dropcaches

• 請(qǐng)求方式：get、post
• 請(qǐng)求參數(shù)：無(wú)
  該接口的作用是清理tsdb的內(nèi)存，主要是清理UID到metric、tags，和metric、tags到UID的映射關(guān)系，需要注意的是這個(gè)接口并不會(huì)清理磁盤上的緩存。

?

/api/config

• 請(qǐng)求方式：get、post
• 請(qǐng)求參數(shù)：無(wú)
  該接口以key/value的方式返回tsdb所有的配置。

?

?

總結(jié)

以上是生活随笔為你收集整理的OpenTSDB 开发指南之 Api操作数据的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問(wèn)題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。