thejeffski/system_sensors-docker

镜像概述

该Docker镜像用于运行系统传感器组件，实现对主机或容器的系统状态数据采集，并将采集到的数据实时推送到指定的MQTT服务器。适用于需要通过MQTT协议传输系统监控数据的场景，支持灵活配置以满足不同监控需求。

核心功能与特性

• 系统传感器运行：内置系统状态采集模块，支持监控核心系统指标，包括但不限于CPU使用率、内存占用、磁盘空间、网络流量等
• MQTT数据推送：将采集的传感器数据实时推送到指定MQTT服务器，支持标准MQTT协议
• 灵活配置能力：支持通过环境变量自定义MQTT连接参数、传感器采集项及采集频率
• 轻量部署：镜像体积精简，可快速部署于各类容器化环境

使用场景

• 服务器/设备监控：对物理机、虚拟机或容器的系统资源状态进行实时监控
• 物联网数据采集：作为边缘节点采集设备系统数据，接入物联网平台
• 自动化系统集成：为家庭自动化、工业控制等系统提供设备状态数据输入
• 第三方平台对接：通过MQTT协议将系统数据推送至监控平台、数据分析系统

使用方法与配置说明

基础部署命令

通过docker run命令快速启动容器：

bash
docker run -d \
  --name system-sensors-mqtt \
  --restart unless-stopped \
  -e MQTT_BROKER=mqtt://your-mqtt-server:1883 \
  -e MQTT_TOPIC=system/sensors/data \
  system-sensors-mqtt:latest

Docker Compose配置示例

yaml
version: '3.8'
services:
  system-sensors:
    image: system-sensors-mqtt:latest
    container_name: system-sensors
    restart: unless-stopped
    environment:
      # MQTT连接配置
      - MQTT_BROKER=mqtt://mosquitto:1883
      - MQTT_PORT=1883
      - MQTT_TOPIC=system/monitoring
      - MQTT_USER=mqtt-user
      - MQTT_PASSWORD=mqtt-pass
      - MQTT_CLIENT_ID=system-sensor-01
      # 传感器配置
      - SENSOR_CPU=true
      - SENSOR_MEMORY=true
      - SENSOR_DISK=/
      - SENSOR_NETWORK=eth0
      # 采集配置
      - POLLING_INTERVAL=10  # 采集间隔(秒)

环境变量配置说明

数据格式说明

推送至MQTT的消息为JSON格式，示例如下：

json
{
  "timestamp": "2024-05-20T15:30:45Z",
  "cpu_usage": 23.5,
  "memory_usage": 45.2,
  "disk_usage": 67.8,
  "network_rx": 1245.3,
  "network_tx": 876.2
}

字段说明：

• timestamp: 数据采集时间戳(UTC)
• cpu_usage: CPU使用率(百分比)
• memory_usage: 内存使用率(百分比)
• disk_usage: 磁盘使用率(百分比，针对配置的监控路径)
• network_rx: 网络接收速率(KB/s)
• network_tx: 网络发送速率(KB/s)