bwsw/cs-pulse-sensor

CS-Umbrella / Pulse Plugin Sensor

镜像概述

本容器旨在监控远程libvirt KVM hypervisor主机，收集虚拟机资源使用信息。它基于Python2.7和libvirt实现，将收集的统计数据存储到远程InfluxDB中，帮助用户掌握虚拟化环境的资源运行状态。

核心功能

• 收集指标：
  • 主机：CPU统计、RAM统计
  • 虚拟机：cpuTime、RAM使用、磁盘IO、网络IO
• 特点：
  • 专为KVM hypervisor设计
  • 支持文件中的块设备（适用于Apache Cloudstack和NFS存储）
  • 以易于使用的Docker容器形式打包（每个虚拟化主机对应一个容器）
• 兼容版本：
  • Apache Cloudstack 4.3（带KVM hypervisor和NFS主存储）
  • Apache Cloudstack 4.9（带KVM hypervisor和NFS主存储）

使用场景

适用于需要监控KVM虚拟化环境资源使用情况的场景，例如云平台运维、虚拟化资源容量规划、性能故障排查等。

配置说明

Docker部署示例

bash
# 拉取镜像
docker pull bwsw/cs-pulse-sensor
# 运行容器
docker run --restart=always -d --name 10.252.1.11 \
             -v /root/.ssh:/root/.ssh \
             -e PAUSE=10 \
             -e INFLUX_HOST=influx \
             -e INFLUX_PORT=8086 \
             -e INFLUX_DB=puls \
             -e INFLUX_USER=puls \
             -e INFLUX_PASSWORD=secret \
             -e GATHER_HOST_STATS=true \
             -e DEBUG=true \
             -e KVM_HOST=qemu+ssh://root@10.252.1.11/system \
             bwsw/cs-pulse-sensor

容器参数

• KVM_HOST：libvirt KVM连接地址（如qemu+ssh://root@host/system）
• PAUSE：指标采集间隔（秒）
• INFLUX_*：InfluxDB访问信息（包括主机、端口、数据库名、用户名、密码）
• GATHER_HOST_STATS：是否收集hypervisor主机的统计信息（true/false）
• DEBUG：是否在容器内打印JSON日志（用于故障排查）

InfluxDB数据结构

虚拟化节点数据

json
[
    {
        "fields": {
            "freeMem": 80558,
            "idle": 120492574,
            "iowait": 39380,
            "kernel": 1198652,
            "totalMem": 128850,
            "user": 6416940
        },
        "measurement": "nodeInfo",
        "tags": {
            "vmHost": "qemu+ssh://root@10.252.1.33/system"
        }
    }
]

虚拟机数据

json
[
    {
        "fields": {
            "cpuTime": 1070.75,
            "cpus": 4
        },
        "measurement": "cpuTime",
        "tags": {
            "vmHost": "qemu+ssh://root@10.252.1.33/system",
            "vmId": "i-376-1733-VM",
            "vmUuid": "12805898-0fda-4fa6-9f18-fac64f673679"
        }
    },
    {
        "fields": {
            "maxmem": 4194304,
            "mem": 4194304,
            "rss": 1443428
        },
        "measurement": "rss",
        "tags": {
            "vmHost": "qemu+ssh://root@10.252.1.33/system",
            "vmId": "i-376-1733-VM",
            "vmUuid": "12805898-0fda-4fa6-9f18-fac64f673679"
        }
    },
    {
        "fields": {
            "readBytes": 111991494,
            "readDrops": 0,
            "readErrors": 0,
            "readPackets": 1453303,
            "writeBytes": 3067403974,
            "writeDrops": 0,
            "writeErrors": 0,
            "writePackets": 588124
        },
        "measurement": "networkInterface",
        "tags": {
            "mac": "06:f2:64:00:01:54",
            "vmHost": "qemu+ssh://root@10.252.1.33/system",
            "vmId": "i-376-1733-VM",
            "vmUuid": "12805898-0fda-4fa6-9f18-fac64f673679"
        }
    },
    {
        "fields": {
            "allocatedSpace": 890,
            "ioErrors": -1,
            "onDiskSpace": 890,
            "readBytes": 264512607744,
            "readIOPS": 16538654,
            "totalSpace": 1000,
            "writeBytes": 930057794560,
            "writeIOPS": 30476842
        },
        "measurement": "disk",
        "tags": {
            "image": "cc8121ef-2029-4f4f-826e-7c4f2c8a5563",
            "pool": "b13cb3c0-c84d-334c-9fc3-4826ae58d984",
            "vmHost": "qemu+ssh://root@10.252.1.33/system",
            "vmId": "i-376-1733-VM",
            "vmUuid": "12805898-0fda-4fa6-9f18-fac64f673679"
        }
    }
]

Grafana仪表盘

1. 将grafana_dashboard.json导入Grafana
2. 调整数据源以匹配你的InfluxDB配置

许可证

本镜像基于Apache 2.0许可证授权。