tomldev/graphite-exporter

Graphite Exporter 镜像说明

镜像概述

本镜像为Prometheus的Graphite查询导出器，与官方导出器不同，它通过主动查询Graphite实例获取指标，而非接收Graphite推送的指标。用户可配置Graphite查询规则，当访问指标端点时，导出器会执行查询并将结果以Prometheus兼容格式暴露。

核心功能

1. 多Graphite实例支持：可配置多个Graphite连接，满足不同实例的指标查询需求。
2. 灵活查询配置：支持自定义Graphite查询语句，允许使用通配符匹配指标。
3. 标签管理：提供固定标签和基于查询结果的通配符标签，增强指标维度。
4. SSL/TLS支持：支持Graphite实例的SSL认证（含证书配置和基本认证）。
5. 服务定制：可调整暴露指标的端口、端点路径及日志级别。

使用场景

适用于需要将Graphite中的监控指标整合到Prometheus监控体系的场景，例如企业内部已部署Graphite但希望利用Prometheus的告警、可视化能力时。

配置说明

基础配置示例

yaml
---
graphite:
  - name: local
    url: http://192.168.178.53:2999/

targets:
  - name: foo
    graphite: local
    query: "some.graphite.query.*"

扩展配置示例

yaml
---
graphite:
  - name: local
    url: http://localhost:1234/
    namespace: "graphite_exporter"
    offset: 60
  - name: external
    url: https://graphite.instance.com/1234
    ssl:
      credentials: "user:pass"
      certificate: "/etc/certs/root.cer"
      skip_tls: true

server:
  port: 9000
  endpoint: "/metrics"
  log_level: info

targets:
  - name: foo
    graphite: local
    query: "some.graphite.query.*"
    labels:
      - "key: value"
    namespace: "metric_namespace"
  - name: bar
    graphite: local
    query: "sensors.basement.dht22.temperature"
    wildcards:
      - "1: location"
      - "2: sensor_type"

关键配置项说明

• graphite：Graphite实例连接列表
  • name：唯一连接名称
  • url：Graphite实例地址
  • offset（可选）：查询时间范围（默认60秒）
  • ssl（可选）：SSL配置（含认证信息和证书路径）
• server：导出器服务设置
  • port：指标暴露端口
  • endpoint：指标访问路径
  • log_level：日志级别（支持Critical/Error/Warning/Notice/Info/Debug）
• targets：查询目标配置
  • name：目标名称（无空格或连字符）
  • query：Graphite查询语句
  • wildcards（可选）：通配符标签（格式："索引:标签名"）

部署示例

Docker Run 命令

shell
docker run -d \
-v /path/to/config.yml:/app/config/config.yml:ro \
-v /path/to/certificate/my-cert:/etc/certs/root.cer \
-p 8080:8080 \
tomldev/graphite-exporter

Docker Compose 配置

yaml
version: '3.3'

networks:
  networkname:
    external: true

services:
  graphiteexporter:
    image: tomldev/graphite-exporter:v2.0.0
    networks:
      - networkname
    ports:
      - "9999:8080"
    volumes:
      - ./config.yml:/app/config/config.yml
      - ./certs/my-cert.cer:/etc/certs/root.cer

部署命令：

• Compose启动：docker-compose up -d
• Swarm集群部署：docker stack deploy --compose-file docker-compose.yml STACKNAME