greenstatic/bigbluebutton-exporter

BigBlueButton Exporter

镜像概述和主要用途

BigBlueButton Exporter是专为监控BigBlueButton（开源网络会议系统）设计的Prometheus导出器。它通过查询BigBlueButton的API接口获取数据，聚合处理后以Prometheus兼容指标形式通过HTTP /metrics端点暴露，支持与Prometheus、Grafana等监控工具集成，实现对BigBlueButton服务的可视化监控。

核心功能和特性

• Prometheus指标暴露：默认通过9688端口的/metrics端点提供标准化Prometheus指标
• API数据聚合：自动查询BigBlueButton API，整合会议状态、用户活动、服务器资源等关键数据
• 灵活配置：支持通过环境变量自定义API访问参数、数据轮询间隔等监控策略
• 多实例支持：可监控单个或多个BigBlueButton服务器节点
• Grafana集成：提供配套Grafana仪表盘模板，直观展示监控数据

使用场景和适用范围

适用于需要监控BigBlueButton服务运行状态的场景，包括：

• 教育机构的在线教学平台监控
• 企业远程会议系统的性能跟踪
• 多节点BigBlueButton集群的集中监控
• 基于Prometheus+Grafana构建监控体系的BigBlueButton部署环境

使用方法和配置说明

基本信息

• Docker镜像地址：https://hub.docker.com/r/greenstatic/bigbluebutton-exporter
• 默认监听端口：9688
• 指标路径：默认/metrics

Docker快速部署

bash
docker run -d \
  --name bigbluebutton-exporter \
  -p 9688:9688 \
  -e BBB_API_BASE_URL="https://your-bigbluebutton-server/bigbluebutton/api" \
  -e BBB_API_SECRET="your-bigbluebutton-api-secret" \
  docker.xuanyuan.run/greenstatic/bigbluebutton-exporter

Docker Compose配置

yaml
version: '3'
services:
  bigbluebutton-exporter:
    image: docker.xuanyuan.run/greenstatic/bigbluebutton-exporter
    container_name: bigbluebutton-exporter
    ports:
      - "9688:9688"
    environment:
      - BBB_API_BASE_URL=https://your-bigbluebutton-server/bigbluebutton/api
      - BBB_API_SECRET=your-bigbluebutton-api-secret
      # 可选：自定义轮询间隔（默认30秒）
      # - POLL_INTERVAL=60
    restart: unless-stopped

环境变量配置

环境变量用于自定义Exporter行为，详细说明参见https://bigbluebutton-exporter.greenstatic.dev/exporter-user-guide/#environment-variables%E3%80%82%E6%A0%B8%E5%BF%83%E5%8F%98%E9%87%8F%E5%8C%85%E6%8B%AC%EF%BC%9A

• BBB_API_BASE_URL：BigBlueButton API基础URL（必填）
• BBB_API_SECRET：BigBlueButton API密钥（必填）
• LISTEN_PORT：服务监听端口（默认：9688）
• POLL_INTERVAL：API数据查询间隔（默认：30秒，单位：秒）
• METRICS_PATH：指标暴露路径（默认：/metrics）

指标说明

支持的Prometheus指标包括会议数量、用户数、服务器资源使用等，完整指标列表参见https://bigbluebutton-exporter.greenstatic.dev/exporter-user-guide/#metrics%E3%80%82

Grafana仪表盘截图

提供多服务器和单服务器实例监控视图：

!多服务器Grafana仪表盘

!单服务器实例Grafana仪表盘

文档和资源

• 完整文档：https://bigbluebutton-exporter.greenstatic.dev
• GitHub源码：https://github.com/greenstatic/bigbluebutton-exporter
• 指标详情：https://bigbluebutton-exporter.greenstatic.dev/exporter-user-guide/#metrics
• 环境变量详情：https://bigbluebutton-exporter.greenstatic.dev/exporter-user-guide/#environment-variables