标签：1479496100 metric tag put host 详解 web01 Put openTSDB

openTSDB详解之 Put

本文译自：http://opentsdb.net/docs/build/html/api_telnet/put.html

尝试往存储中写入数据。注意：UTF-8编码字符集可能不能通过Telnet API被正确处理，所以使用/api/put方法而不是直接使用Java API。

Note

因为socket被异步的读和写，响应可能是混乱的。最好的方式是：将这个包同UDP的方式处理，因为你可能并非总是知道是否数据是被成功写入。如果你的确要求同步写，保证数据成功写入到存储中，请使用HTTP或者Java APIs.

Request

命令格式是：put <metric> <timestamp> <value> <tagk_1>=<tagv_1>[ <tagk_n>=<tagv_n>]

Note

• 因为字段是空格分割，metric和tag values必须不包含空格。
• 时间戳必须是一个正整数（Unix epoch timestamp）。例如：1479496100 代表的就是Fri, 18 Nov 2016 19:08:20 GMT
• 值必须是一个数字。它可以是一个正整数（java中long数据类型的最大值和最小值），一个浮点数或者是科学计数法（使用的格式是[-]<#>.<#>[e|E][-]<#>）。
• 至少存在一个tag 对。另外的tag 对能够被添加（原文：Additional tag pairs can be added with spaces in between）

Examples

put sys.if.bytes.out 1479496100 1.3E3 host=web01 interface=eth0

put sys.procs.running 1479496100 42 host=web01

Response

一个成功的请求不会反悔一个响应。仅仅错误的时候，socket包将会返回一行数据。下面列举出一些例子：

Example Requests and Responses

put
put: illegal argument: not enough arguments (need least 4, got 1)

put metric.foo notatime 42 host=web01
put: invalid value: Invalid character 'n' in notatime

下列将会被返回如果tsd.core.auto_create_metrics是被禁用的话：

put new.metric 1479496160 1.3e3 host=web01
put: unknown metric: No such name for 'metrics': 'new.metric'

标签：1479496100,metric,tag,put,host,详解,web01,Put,openTSDB
来源： https://blog.51cto.com/lawsonabs/3011535

本站声明： 1. iCode9 技术分享网（下文简称本站）提供的所有内容，仅供技术学习、探讨和分享；
2. 关于本站的所有留言、评论、转载及引用，纯属内容发起人的个人观点，与本站观点和立场无关；
3. 关于本站的所有言论和文字，纯属内容发起人的个人观点，与本站观点和立场无关；
4. 本站文章均是网友提供，不完全保证技术分享内容的完整性、准确性、时效性、风险性和版权归属；如您发现该文章侵犯了您的权益，可联系我们第一时间进行删除；
5. 本站为非盈利性的个人网站，所有内容不会用来进行牟利，也不会利用任何形式的广告来间接获益，纯粹是为了广大技术爱好者提供技术内容和技术思想的分享性交流网站。