clambin/grafana-exporter

grafana-exporter

镜像概述

grafana-exporter是一款用于从Grafana平台导出指标的工具，旨在将Grafana的相关数据转换为Prometheus可抓取的格式，从而实现对Grafana实例性能、数据查询状态及其他关键指标的监控与分析。该工具通过调用Grafana API获取数据，并以标准化的Prometheus指标形式对外暴露，便于集成到现有的监控体系中。

核心功能与特性

• Prometheus兼容：输出符合Prometheus规范的指标格式，可直接被Prometheus抓取
• Grafana API集成：通过Grafana官方API获取各类指标数据
• 可配置性：支持通过环境变量或配置文件自定义连接参数、指标采集规则等
• 轻量高效：基于Go语言开发，资源占用低，性能稳定
• 多指标支持：可导出Grafana的仪表盘状态、查询性能、用户活动等多种指标

使用场景与适用范围

• Grafana实例监控：监控Grafana服务的运行状态、资源占用及性能指标
• 数据查询分析：跟踪Grafana中数据查询的执行效率、成功率等关键指标
• 监控体系集成：作为Prometheus的数据源，将Grafana指标纳入统一监控平台
• 运维与故障排查：通过导出的指标快速定位Grafana相关问题

使用方法与配置说明

基本使用（Docker Run）

bash
docker run -d \
  --name grafana-exporter \
  -p 9275:9275 \
  -e GRAFANA_URL=http://your-grafana-instance:3000 \
  -e GRAFANA_API_KEY=your-grafana-api-key \
  clambin/grafana-exporter

Docker Compose配置

yaml
version: '3'
services:
  grafana-exporter:
    image: clambin/grafana-exporter
    container_name: grafana-exporter
    ports:
      - "9275:9275"
    environment:
      - GRAFANA_URL=http://grafana:3000  # Grafana实例地址
      - GRAFANA_API_KEY=your-secure-api-key  # Grafana API密钥（需具备适当权限）
      - EXPORTER_PORT=9275  #  exporter暴露指标的端口（默认9275）
      - SCRAPE_INTERVAL=30s  # 指标采集间隔（默认30s）
    restart: unless-stopped

环境变量配置

指标访问

启动后，可通过 http://<exporter-ip>:9275/metrics 访问导出的Prometheus指标，例如：

# HELP grafana_dashboard_count Total number of dashboards in Grafana
# TYPE grafana_dashboard_count gauge
grafana_dashboard_count 42
# HELP grafana_query_success_total Total number of successful queries
# TYPE grafana_query_success_total counter
grafana_query_success_total 12345

注意事项

• 确保Grafana API密钥具备足够权限（至少Viewer角色），以获取所需指标
• 根据Grafana实例规模和指标采集需求，适当调整SCRAPE_INTERVAL参数，避免对Grafana服务造成过大压力
• 建议在生产环境中通过容器编排工具（如Kubernetes）部署，以确保高可用性