tdengine/blm_prometheus

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）

bash
docker 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 \
  your-image-name:latest

Docker Compose配置

yaml
version: '3'
services:
  prometheus-writer:
    image: 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

环境变量配置说明

Prometheus配置示例

在Prometheus配置文件（prometheus.yml）中添加远程写入配置：

yaml
remote_write:
  - url: "http://prometheus-tdengine-writer:8080/write"
    queue_config:
      capacity: 10000
      max_shards: 30
      min_shards: 1

注意事项

1. 确保TDengine数据库已提前创建指定的数据库（如未创建，API会尝试自动创建）
2. 网络环境需保证Prometheus服务与本API服务、TDengine服务之间的连通性
3. 根据监控数据量调整API服务的资源配置（CPU/内存）以保证性能