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

docs: refine tcollector doc (#11691)

[TD-14943]
上级 a71e29fd
......@@ -7,26 +7,55 @@ import Tcollector from "../14-reference/_tcollector.mdx"
TCollector 是 openTSDB 的一部分,它用来采集客户端日志发送给数据库。
将 TCollector 采集的日志数据存在到 TDengine 中可以充分利用 TDengine 对时序数据的高效存储查询性能和集群处理能力。
只需要将 TCollect 的配置修改指向 taosAdapter 对应的服务器和端口即可将 icinga2 采集的数据存在到 TDengine 中,可以充分利用 TDengine 对时序数据的高效存储查询性能和集群处理能力。
安装 TCollector 请参考[官方文档](http://opentsdb.net/docs/build/html/user_guide/utilities/tcollector.html#installation-of-tcollector)
## 依赖配置
## 前置条件
TDengine(2.4.0.0+)包含一个 taosAdapter 独立程序,可以接收包括 TCollector 在内的多种应用的数据写入。只需要将 TCollector 的配置修改指向 taosAdapter 对应的地址和端口即可。taosAdapter 可以和 TDengine 部署在同一个系统中,也可以分离部署,taosAdapter 的详细使用方法请参考相关文档。
要将 TCollect 数据写入 TDengine, 需要几方面的准备工作。
- TDengine 集群已经部署并正在运行
- taosAdapter 已经安装, 具体细节请参考 [taosAdapter 的使用手册](/reference/taosadapter)
- TCollect 已经安装
启动 taosAdapter:
## 配置 TCollector
<Tcollector />
```
systemctl start taosadapter
```
## 验证方法
检查 taosAdapter 的运行状态:
手动执行 sudo ./tcollector.py 后使用 TDengine CLI 查询 TDengine 是否创建相应数据库并写入数据。
```
systemctl status taosadapter
taos> show databases;
name | created_time | ntables | vgroups | replica | quorum | days | keep | cache(MB) | blocks | minrows | maxrows | wallevel | fsync | comp | cachelast | precision | update | status |
====================================================================================================================================================================================================================================================================================
tcollector | 2022-04-20 12:44:49.604 | 88 | 1 | 1 | 1 | 10 | 3650 | 16 | 6 | 100 | 4096 | 1 | 3000 | 2 | 0 | ns | 2 | ready |
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 |
Query OK, 2 row(s) in set (0.002679s)
taos> use tcollector;
Database changed.
taos> show stables;
name | created_time | columns | tags | tables |
============================================================================================
proc.meminfo.hugepages_rsvd | 2022-04-20 12:44:53.945 | 2 | 1 | 1 |
proc.meminfo.directmap1g | 2022-04-20 12:44:54.110 | 2 | 1 | 1 |
proc.meminfo.vmallocchunk | 2022-04-20 12:44:53.724 | 2 | 1 | 1 |
proc.meminfo.hugepagesize | 2022-04-20 12:44:54.004 | 2 | 1 | 1 |
tcollector.reader.lines_dro... | 2022-04-20 12:44:49.675 | 2 | 1 | 1 |
proc.meminfo.sunreclaim | 2022-04-20 12:44:53.437 | 2 | 1 | 1 |
proc.stat.ctxt | 2022-04-20 12:44:55.363 | 2 | 1 | 1 |
proc.meminfo.swaptotal | 2022-04-20 12:44:53.158 | 2 | 1 | 1 |
proc.uptime.total | 2022-04-20 12:44:52.813 | 2 | 1 | 1 |
tcollector.collector.lines_... | 2022-04-20 12:44:49.895 | 2 | 2 | 51 |
proc.meminfo.vmallocused | 2022-04-20 12:44:53.704 | 2 | 1 | 1 |
proc.meminfo.memavailable | 2022-04-20 12:44:52.939 | 2 | 1 | 1 |
sys.numa.foreign_allocs | 2022-04-20 12:44:57.929 | 2 | 2 | 1 |
proc.meminfo.committed_as | 2022-04-20 12:44:53.639 | 2 | 1 | 1 |
proc.vmstat.pswpin | 2022-04-20 12:44:54.177 | 2 | 1 | 1 |
proc.meminfo.cmafree | 2022-04-20 12:44:53.865 | 2 | 1 | 1 |
proc.meminfo.mapped | 2022-04-20 12:44:53.349 | 2 | 1 | 1 |
proc.vmstat.pgmajfault | 2022-04-20 12:44:54.251 | 2 | 1 | 1 |
...
```
<Tcollector />
taosAdapter 相关配置参数请参考 `taosadapter --help` 命令输出以及相关文档。
## 配置 TCollector
配置 taosAdapter 接收 TCollector 数据的方法:
- 使能 taosAdapter 配置项 `opentsdb_telnet.enable`
- 修改 TCollector 配置文件,修改 OpenTSDB 宿主机地址为 taosAdapter 被部署的地址,并修改端口号为 taosAdapter 使用的端口(默认 6049)。
## 验证方法
- 修改 TCollector 配置文件,修改 OpenTSDB 宿主机地址为 taosAdapter 被部署的地址,并修改端口号为 taosAdapter 使用的端口(默认 6049)。注意:TCollector 各个版本变化较大,以 master 分支代码为例,需要修改 collectors/etc/config.py 和 tcollector.py 中相应设置。其他版本需要修改的文件可能有所不同。
重启 TCollector 后可通过查询 TDengine 中 taosAdapter 参数指定的数据库来验证 TCollector 写入的数据。
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册