cloudbaristaorg/cb-dragonfly

CB-Dragonfly

概述和主要用途

CB-Dragonfly是Cloud-Barista的集成监控框架，专注于多云环境的监控与管理。目前处于开发阶段（最新版本0.3 espresso），功能和安全性尚未稳定，不建议在生产环境中使用。如有使用问题，可通过提交issue或加入Cloud-Barista Slack社区反馈。

核心功能和特性

• 多云环境统一监控支持
• 集成InfluxDB、Kapacitor、Kafka实现数据存储与流处理
• 可配置监控间隔（agent采集间隔、collector聚合间隔）
• 支持Docker-Compose和Helm（Kubernetes）两种部署模式
• 提供API服务器（9090端口）和gRPC服务器（9999端口）接口

使用场景和适用范围

适用于开发及测试环境下的多云基础设施监控，支持对云资源的性能指标采集、聚合与分析。安装环境需为Linux系统（已验证Ubuntu 18.04版本）。

详细使用方法和配置说明

目录

1. 安装概要
2. 安装步骤
3. 安装&执行详细信息

安装概要

• 安装环境：Linux系统（推荐Ubuntu 18.04，已通过验证）

安装步骤

1. Git安装
2. Go安装（1.15以上版本）
3. Go环境变量配置
4. Docker及Docker-Compose安装

安装执行详细信息

1. Git安装

bash
$ sudo apt update
$ sudo apt install git
$ sudo apt-get install git-core

2. Go安装

注意：通过sudo apt install golang安装的版本为1.10，存在Go mod兼容性问题，需从官网安装1.15以上版本。

bash
# 下载Go安装包（以1.15.4版本为例）
$ wget https://golang.org/dl/go1.15.4.linux-amd64.tar.gz
# 解压至/usr/local目录
$ sudo tar -C /usr/local -xzf go1.15.4.linux-amd64.tar.gz

3. Go环境变量配置

bash
# 将Go可执行路径添加至系统环境变量
$ sudo echo "export PATH=$PATH:/usr/local/go/bin" >> ~/.bashrc
# 使环境变量生效
$ source ~/.bashrc
# 验证Go版本（需显示1.15以上）
$ go version

4. Docker/Docker-Compose安装

• Docker安装：参考官方文档
• Docker-Compose安装：参考官方文档

5. 多云监控框架（cb-dragonfly）安装

5.1 Git项目克隆

bash
# 配置Git颜色显示
$ sudo git config --global color.ui "auto"
# 克隆项目仓库
$ sudo git clone https://github.com/cloud-barista/cb-dragonfly.git
# 克隆时需输入Git账号信息
username = {{GitUserEmail}}  # 输入个人Git邮箱
Password = {{GitUserPW}}     # 输入个人Git密码

5.2 依赖库加载与验证

bash
# 进入项目目录
$ cd ~/cb-dragonfly
# 下载Go mod声明的依赖库
$ go mod download
# 验证依赖库完整性
$ go mod verify

5.3 环境变量设置

bash
# 创建并编辑环境变量配置文件
$ sudo vim conf/setup.env
# 在setup.env中添加以下内容
export CBSTORE_ROOT=~/cb-dragonfly
export CBLOG_ROOT=~/cb-dragonfly
export CBMON_ROOT=~/cb-dragonfly

# 使环境变量生效
$ source setup.env

5.4 配置文件设置（conf/config.yaml）

需在配置文件中依次配置基础设施连接信息、部署环境及监控策略：

yaml
#### Config for cb-dragonfly ####

# influxdb连接信息
influxdb:
  endpoint_url: http://cb-dragonfly-influxdb           # influxDB服务端点
  internal_port: 8086
  external_port: 28086
  database: {{ database_name }}                        # 数据库名称（用户自定义）
  user_name: {{ user_name }}                          # 数据库用户名（用户自定义）
  password: {{ password }}                            # 数据库密码（用户自定义）

kapacitor:
  endpoint_url: http://cb-dragonfly-kapacitor:9092     # Kapacitor服务端点

kafka:
  endpoint_url: cb-dragonfly-kafka
  external_ip: {{ external_ip }}                       # 外部访问IP（用户自定义）
  deploy_type: {{ deploy_type }}                       # 部署类型："compose"（Docker-Compose）或"helm"（K8s Helm）
  compose_external_port: 9092
  helm_external_port: 32000
  internal_port: 9092

# collect manager配置
collectManager:
  collector_ip: {{ collector_ip }}                     # 本地API服务访问IP（用户自定义）
  collector_port: 8094                                 # UDP通信端口
  collector_group_count: 1                             # 默认collector组数量

# API服务器配置
apiServer:
  port: 9090

# 监控间隔配置
monitoring:
  agent_interval: 2                                    # agent数据采集间隔（秒）
  collector_interval: 10                               # collector数据聚合间隔（秒）
  max_host_count: 5                                    # 单collector最大管理主机数
  monitoring_policy: {{ monitoring_policy }}           # 监控策略："agentCount"（按agent数量）或"csp"（按CSP分组）

grpcServer:
  port: 9999

6. Docker-Compose部署与运行

bash
# 进入项目目录
$ cd ~/cb-dragonfly
# 构建并启动服务
$ sudo make compose-up

7. 服务停止与清理

bash
# 进入项目目录
$ cd ~/cb-dragonfly
# 停止并删除服务容器
$ sudo make compose-rm