?

?

/api/put

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

參數(shù)說明example

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

請求body

名稱類型描述

metric	String	要存儲指標的名稱
timestamp	Integer	以秒或者毫秒為單位的時間戳
value	Integer/Float	時序數(shù)據(jù)庫的值
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寫入成功默認返回的http狀態(tài)碼是204，也就是返回的body為空。若想要知道更詳細的結(jié)果可以在請求路徑上加上summary或者details參數(shù)。

?

/api/query

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

• 請求方式：get、post、delete，注意:從opentsdb2.2版本開始，若用delete查詢數(shù)據(jù)，則在返回數(shù)據(jù)的同時會刪除數(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：設定一個掃描的時間，從當前時刻往后掃描。

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

?

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

?

?

/api/dropcaches

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

?

/api/config

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

?

?

總結(jié)

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

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