未验证 提交 a6c75414 编写于 作者: sangshuduo's avatar sangshuduo 提交者: GitHub

docs: refine statsd doc (#11680)

[TD-14923]
上级 ad2e3b2d
......@@ -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)
<DeployTaosAdapter />
## 前置条件
要将 StatsD 数据写入 TDengine, 需要几方面的准备工作。
- TDengine 集群已经部署并正在运行
- taosAdapter 已经安装并正在运行, 具体细节请参考 [taosAdapter 的使用手册](/reference/taosadapter)
- StatsD 已经安装
## 配置 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>
```
## 配置 StatsD
在 `config.js` 文件中增加如下内容后启动 StatsD,其中 host 和 port 请填写 TDengine 和 taosAdapter 配置的实际值:
```
......@@ -18,7 +16,3 @@ port: 8125
}
```
## 验证方法
重启 StatsD 后可通过查询 TDengine 中 taosAdapter 参数指定的数据库来验证 StatsD 写入的数据。
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册