使用curl命令操作OpenTSDB

写入数据

例如，录入一个指标名称为testdata，时间戳为1524900185，值为true，标签为key，value的指标数据。

curl -ki -X POST -d '{"metric":"testdata", "timestamp":1524900185, "value":"true", "tags":{"key":"value"}}' https://<tsd_ip>:4242/api/put?sync

<tsd_ip>表示所需写入数据的Opentsdb服务的TSD实例的IP地址。

HTTP/1.1 204 No Content
Content-Type: application/json; charset=UTF-8
Content-Length:0

查询数据

例如，可查询指标testdata在过去三年的汇总信息。

curl -ks https://<tsd_ip>:4242/api/query?start=3y-ago\&m=sum:testdata | python -m json.tool

• <tsd_ip>：所需访问Opentsdb服务的TSD实例IP或主机名。
• <start=3y-ago\&m=sum:testdata>：在请求中可能无法识别“&”符号，需对其进行转义。
• <python -m json.tool>（可选）: 把响应的请求转换为json格式。

[
    {
        "aggregateTags": [],
        "dps": {
            "1524900185": 1
        },
        "metric": "testdata",
        "tags": {
            "key": "value"
        }
    }
]

查询tsd状态信息

例如，可查询连接HBase的客户端信息。

curl -ks https://<tsd_ip>:4242/api/stats/region_clients | python -m json.tool

<tsd_ip>：所需访问Opentsdb服务的TSD实例IP地址。

[
    {
        "dead": false,
        "endpoint":"/xx.xx.xx.xx:16020",
        "inflightBreached": 0,
        "pendingBatchedRPCs": 0,
        "pendingBreached": 0,
        "pendingRPCs": 0,
        "rpcResponsesTimedout": 0,
        "rpcResponsesUnknown": 0,
        "rpcid": 78,
        "rpcsInFlight": 0,
        "rpcsSent": 79,
        "rpcsTimedout": 0,
        "writesBlocked": 0
    }
]