evanxyhu/example_write_adapter

Prometheus远程写入示例适配器镜像

镜像概述

该镜像提供了一个Prometheus远程写入的示例适配器，实现了Prometheus远程写入API规范，主要用于演示和测试Prometheus监控数据的远程写入机制，帮助开发者理解远程写入接口的实现方式和数据传输流程。

核心功能和特性

• 完整实现Prometheus远程写入API（/api/v1/write端点）
• 支持Prometheus数据格式的接收与基础处理
• 可配置的目标数据转发端点
• 内置基本日志系统，记录数据接收和转发状态
• 轻量级设计，资源占用低，易于部署测试

使用场景和适用范围

• Prometheus远程写入机制的学习与研究
• 自定义远程存储适配器的开发参考
• 远程数据传输流程的功能验证与测试
• 教学环境中演示Prometheus数据导出功能

使用方法和配置说明

基本部署（Docker Run）

bash
docker run -d -p 8080:8080 --name prom-write-adapter example_write_adapter

环境变量配置

自定义配置示例

bash
docker run -d -p 8081:8081 --name custom-adapter \
  -e LISTEN_PORT=8081 \
  -e TARGET_ENDPOINT="http://remote-storage:8080/receive" \
  -e LOG_LEVEL=debug \
  -e TIMEOUT=15 \
  example_write_adapter

Docker Compose配置示例

yaml
version: '3.8'
services:
  prometheus-adapter:
    image: example_write_adapter
    container_name: prometheus-write-adapter
    ports:
      - "8080:8080"
    environment:
      - LISTEN_PORT=8080
      - TARGET_ENDPOINT=http://prometheus-server:9090/api/v1/write
      - LOG_LEVEL=info
    restart: unless-stopped
    networks:
      - monitoring-network

  prometheus-server:
    image: prom/prometheus
    container_name: prometheus
    volumes:
      - ./prometheus.yml:/etc/prometheus/prometheus.yml
    ports:
      - "9090:9090"
    networks:
      - monitoring-network

networks:
  monitoring-network:
    driver: bridge

验证与测试

1. 启动适配器后，通过访问http://localhost:8080/health检查服务状态，返回{"status":"ok"}表示运行正常
2. 在Prometheus配置文件中添加远程写入配置：

   yaml
   remote_write:
     - url: "http://prometheus-adapter:8080/api/v1/write"
   

3. 重启Prometheus后，适配器日志将显示接收到的数据记录