From a6c75414adfc55eec8bd4de4cb7c5da1b229546c Mon Sep 17 00:00:00 2001 From: Shuduo Sang Date: Wed, 20 Apr 2022 18:05:10 +0800 Subject: [PATCH] docs: refine statsd doc (#11680) [TD-14923] --- docs-cn/09-third-party/06-statsd.md | 59 +++++++++++++++++++++++++++-- docs-cn/14-reference/_statsd.mdx | 6 --- 2 files changed, 56 insertions(+), 9 deletions(-) diff --git a/docs-cn/09-third-party/06-statsd.md b/docs-cn/09-third-party/06-statsd.md index e82f3cae19..7efb467b07 100644 --- a/docs-cn/09-third-party/06-statsd.md +++ b/docs-cn/09-third-party/06-statsd.md @@ -4,14 +4,67 @@ title: StatsD 直接写入 --- import StatsD from "../14-reference/_statsd.mdx" -import DeployTaosAdapter from "./_deploytaosadapter.mdx" StatsD 是汇总和总结应用指标的一个简单的守护进程，近些年来发展迅速，已经变成了一个用于收集应用性能指标的统一的协议。 -将 StatsD 采集的指标数据存在到 TDengine 中可以充分利用 TDengine 对时序数据的高效存储查询性能和集群处理能力。TDengine（2.4.0.0+）包含一个 taosAdapter 独立程序，可以接收包括 StatsD 在内的多种应用的数据写入，只需要将 StatsD 的配置修改指向 taosAdapter 对应的服务器地址和端口接口。 +只需要将 StatsD 的配置修改指向 taosAdapter 对应的服务器地址和端口接口即可将 StatsD 的数据写入到 TDengine 中，可以充分利用 TDengine 对时序数据的高效存储查询性能和集群处理能力。 安装 StatsD 请参考[官方文档](https://github.com/statsd/statsd)。 - +## 前置条件 + +要将 StatsD 数据写入 TDengine, 需要几方面的准备工作。 +- TDengine 集群已经部署并正在运行 +- taosAdapter 已经安装并正在运行, 具体细节请参考 [taosAdapter 的使用手册](/reference/taosadapter) +- StatsD 已经安装 + +## 配置 StatsD +## 验证方法 + +运行 StatsD： + +``` +ubuntu@shuduo-1804 $ node stats.js config.js & +[1] 8546 +ubuntu@shuduo-1804 ~/work/statsd (master)c47fc48$ 20 Apr 09:54:41 - [8546] reading config file: exampleConfig.js +20 Apr 09:54:41 - server is up INFO + +使用 nc 写入测试数据： + +``` +ubuntu@shuduo-1804 ~/work/statsd (master)c47fc48$ echo "foo:1|c" | nc -u -w0 127.0.0.1 8125 +``` + +使用 TDengine CLI 验证从 StatsD 向 TDengine 写入数据并能够正确读出： + +``` +Welcome to the TDengine shell from Linux, Client Version:2.4.0.0 +Copyright (c) 2020 by TAOS Data, Inc. All rights reserved. + +taos> show databases; + name | created_time | ntables | vgroups | replica | quorum | days | keep | cache(MB) | blocks | minrows | maxrows | wallevel | fsync | comp | cachelast | precision | update | status | +==================================================================================================================================================================================================================================================================================== + log | 2022-04-20 07:19:50.260 | 11 | 1 | 1 | 1 | 10 | 3650 | 16 | 6 | 100 | 4096 | 1 | 3000 | 2 | 0 | ms | 0 | ready | + statsd | 2022-04-20 09:54:51.220 | 1 | 1 | 1 | 1 | 10 | 3650 | 16 | 6 | 100 | 4096 | 1 | 3000 | 2 | 0 | ns | 2 | ready | +Query OK, 2 row(s) in set (0.003142s) + +taos> use statsd; +Database changed. + +taos> show stables; + name | created_time | columns | tags | tables | +============================================================================================ + foo | 2022-04-20 09:54:51.234 | 2 | 1 | 1 | +Query OK, 1 row(s) in set (0.002161s) + +taos> select * from foo; + ts | value | metric_type | +======================================================================================= + 2022-04-20 09:54:51.219614235 | 1 | counter | +Query OK, 1 row(s) in set (0.004179s) + +taos> +``` + diff --git a/docs-cn/14-reference/_statsd.mdx b/docs-cn/14-reference/_statsd.mdx index c651ae2c54..534019f764 100644 --- a/docs-cn/14-reference/_statsd.mdx +++ b/docs-cn/14-reference/_statsd.mdx @@ -1,6 +1,4 @@ -## 配置 StatsD - 在 `config.js` 文件中增加如下内容后启动 StatsD，其中 host 和 port 请填写 TDengine 和 taosAdapter 配置的实际值： ``` @@ -18,7 +16,3 @@ port: 8125 } ``` -## 验证方法 - -重启 StatsD 后可通过查询 TDengine 中 taosAdapter 参数指定的数据库来验证 StatsD 写入的数据。 - -- GitLab