Prometheus到TDengine的远程写入API,用于将Prometheus监控数据通过远程写入方式存储到TDengine数据库。
Prometheus TDengine 远程写入API 镜像文档
镜像概述
本镜像提供了一个API接口,用于实现Prometheus与TDengine数据库的集成,支持Prometheus通过远程写入(remote write)协议将监控指标数据存储到TDengine时序数据库中,解决Prometheus数据持久化与长期存储的需求。
核心功能与特性
- 协议支持:兼容Prometheus远程写入协议,可直接对接Prometheus的remote_write配置
- 数据转换:自动将Prometheus指标数据转换为TDengine支持的格式
- 高效传输:优化数据传输流程,减少网络开销与数据处理延迟
- TDengine兼容:适配TDengine的表结构与数据模型,支持时序数据特性
使用场景与适用范围
- 需将Prometheus监控数据长期存储的场景
- 基于TDengine构建监控数据存储与分析平台的场景
- 需要对Prometheus数据进行历史趋势分析、报表生成的场景
- 监控系统数据容量扩展,需替代Prometheus本地存储的场景
使用方法与配置说明
基本部署(Docker Run)
bashdocker run -d \ --name prometheus-tdengine-writer \ -p 8080:8080 \ -e TDENGINE_HOST=tdengine-server \ -e TDENGINE_PORT=6030 \ -e TDENGINE_USER=root \ -e TDENGINE_PASSWORD=taosdata \ -e TDENGINE_DATABASE=prometheus_metrics \ docker.xuanyuan.run/your-image-name:latest
Docker Compose配置
yamlversion: '3' services: prometheus-writer: image: docker.xuanyuan.run/your-image-name:latest ports: - "8080:8080" environment: - TDENGINE_HOST=tdengine-server - TDENGINE_PORT=6030 - TDENGINE_USER=root - TDENGINE_PASSWORD=taosdata - TDENGINE_DATABASE=prometheus_metrics - API_PORT=8080 # API服务监听端口,默认8080 depends_on: - tdengine-server
环境变量配置说明
| 环境变量名 | 描述 | 默认值 |
|---|---|---|
| TDENGINE_HOST | TDengine数据库主机地址 | localhost |
| TDENGINE_PORT | TDengine数据库端口 | 6030 |
| TDENGINE_USER | TDengine数据库用户名 | root |
| TDENGINE_PASSWORD | TDengine数据库密码 | taosdata |
| TDENGINE_DATABASE | 存储Prometheus数据的数据库名 | prometheus |
| API_PORT | API服务监听端口 | 8080 |
| LOG_LEVEL | 日志级别(debug/info/warn/error) | info |
Prometheus配置示例
在Prometheus配置文件(prometheus.yml)中添加远程写入配置:
yamlremote_write: - url: "http://prometheus-tdengine-writer:8080/write" queue_config: capacity: 10000 max_shards: 30 min_shards: 1
注意事项
- 确保TDengine数据库已提前创建指定的数据库(如未创建,API会尝试自动创建)
- 网络环境需保证Prometheus服务与本API服务、TDengine服务之间的连通性
- 根据监控数据量调整API服务的资源配置(CPU/内存)以保证性能
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 blm_prometheus 镜像标签
docker pull docker.xuanyuan.run/tdengine/blm_prometheus:<标签>
DockerHub 原生拉取命令
docker pull tdengine/blm_prometheus:<标签>
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务