# telegraf-plugins

**Repository Path**: kaiwuDB/telegraf-plugins

## Basic Information

- **Project Name**: telegraf-plugins
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-23
- **Last Updated**: 2025-09-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

KaiwuDBLite 输出插件
====================

该插件用于将 Telegraf 收集的指标数据写入 KaiwuDB 的轻量版本 KaiwuDBLite。

## 快速开始
该项目为非完整可运行项目，仅为 [telegraf][telegraf] 项目 `plugins/output/` 下的一个插件，使用时需要先获取 telegraf 源码，然后将本项目下文件拷贝至 telegraf 源码目录，再编译出可执行文件。

[telegraf]:
 https://github.com/influxdata/telegraf

### 兼容性
兼容 telegraf v1.33 及后续版本。

### 编译
```bash
git clone https://gitee.com/kaiwuDB/telegraf-plugins.git
git clone https://github.com/influxdata/telegraf.git
cp -r telegraf-plugins/plugins/outputs/ telegraf/plugins/

cd telegraf
go mod tidy
make
```

## Schema 模式
该输出插件默认使用紧凑模式，便于列的扩展，即将一张时序表存储为:
```sql
CREATE TABLE "test" ("ts" timestamp, "tags" MAP, "fields" JSON);
```
格式，所有的 tags 存储为一个 MAP，所有的 fields 存储为一个 JSON object。



## 配置
最少指定 1 个参数，即 KaiwuDBLite 数据库的 IP、port、用户名，即可使用输出插件 kaiwudb_lite。
```toml
data_source_name = "host=192.168.10.123 port=36257 user=admin connect_timeout=5"
```
> 更多配置请参阅 [README for output/kaiwudb_lite](plugins/outputs/kaiwudb_lite/README.md) 和 [sample.conf](plugins/outputs/kaiwudb_lite/sample.conf)

## 运行
编译完成后，修改配置文件，然后运行：
```bash
./telegraf --config plugins/outputs/kaiwudb_lite/sample.conf
```
> 注意，`plugins/outputs/kaiwudb_lite/sample.conf` 仅配置了 [[outputs.kaiwudb_lite]] 选项，想要正常运行，还需要配置输入插件相关选项 [[inputs.xxx]].