suryastef/remote_storage_adapter

remote_storage_adapter 镜像文档

镜像概述和主要用途

remote_storage_adapter是Prometheus的远程存储适配器，用于将监控数据存储到外部时序数据库（TSDB），替代Prometheus内置的TSDB。该镜像基于golang:alpine构建编译源代码，使用scratch作为主镜像以减小体积。它接收Prometheus的远程写入协议样本，存储到Graphite、InfluxDB或OpenTSDB，并对InfluxDB支持通过远程读取协议回读数据，替代Prometheus已移除的内置特定远程存储实现。

核心功能和特性

• 多TSDB支持：兼容Graphite、InfluxDB、OpenTSDB作为外部存储目标
• 双向数据流动：所有支持的TSDB均支持远程写入，InfluxDB额外支持远程读取
• 轻量级设计：基于scratch镜像构建，最小化镜像体积和资源占用
• 灵活配置：通过命令行参数灵活配置存储连接信息和策略

使用场景和适用范围

• Prometheus需要将监控数据持久化到外部TSDB时
• 替代Prometheus已移除的内置特定远程存储实现
• 需要从InfluxDB读取历史监控数据到Prometheus时
• 构建分布式监控系统，实现数据集中存储和查询

使用方法和配置说明

启动命令示例

OpenTSDB配置

bash
docker run -d --name remote-storage-adapter -p 9201:9201 remote_storage_adapter --opentsdb-url=http://opentsdb-host:8081/

InfluxDB配置

bash
docker run -d --name remote-storage-adapter -p 9201:9201 remote_storage_adapter \
  --influxdb-url=http://influxdb-host:8086/ \
  --influxdb.database=prometheus \
  --influxdb.retention-policy=autogen

查看所有配置参数

bash
docker run --rm remote_storage_adapter -h

Prometheus集成配置

在Prometheus配置文件prometheus.yml中添加以下配置，使其将数据发送到适配器：

yaml
# 远程写入配置（适用于Graphite、OpenTSDB或InfluxDB）
remote_write:
  - url: "http://remote-storage-adapter-host:9201/write"

# 远程读取配置（目前仅适用于InfluxDB）
remote_read:
  - url: "http://remote-storage-adapter-host:9201/read"

容器功能测试

验证容器是否正常运行：

bash
# 启动测试容器
docker container run -d --rm -p 9201:9201 --name test-adapter remote_storage_adapter

# 访问metrics端点检查状态
curl localhost:9201/metrics

成功运行后，将输出类似以下的指标信息（部分示例）：

# HELP go_gc_duration_seconds A summary of the GC invocation durations.
# TYPE go_gc_duration_seconds summary
go_gc_duration_seconds{quantile="0"} 0
...
# HELP received_samples_total Total number of received samples.
# TYPE received_samples_total counter
received_samples_total 0