measurementlab/nodeinfo

nodeinfo

镜像概述和主要用途

nodeinfo是用于收集M-Lab（Measurement Lab）平台节点硬件、软件及配置数据的工具。该工具每小时（平均间隔，含随机化）执行lspci、lshw、ifconfig等系统命令，并将输出结果写入磁盘，以实现对节点配置的长期追踪。Docker镜像可在https://hub.docker.com/r/measurementlab/nodeinfo/%E8%8E%B7%E5%8F%96%E3%80%82

核心功能和特性

• 简洁设计：每个命令生成独立数据类型，结合M-Lab统一数据命名规范和Pusher最佳实践，输出目录结构完全确定。
• 命令执行：调用预设系统命令集，将各命令输出导向对应文件；命令集硬编码在二进制程序中。
• 错误处理：若任一命令执行失败，程序将崩溃。
• 定期运行：平均每小时重新执行一次命令（含随机化），运行间隔服从指数分布，以确保测量序列具有PASTA属性（泊松到达定理）。

使用场景和适用范围

适用于M-Lab平台节点，用于长期监控和记录节点的硬件配置（如PCI设备、USB设备）、网络信息（如IP地址、路由表）、系统信息（如内核版本、OS发行版）等，为平台维护、性能分析和配置变更追踪提供数据支持。

使用方法和配置说明

配置文件示例

配置文件为JSON格式，定义需执行的命令、数据类型及输出文件名。示例如下：

json
[
  {
    "Datatype": "lshw",
    "Filename": "lshw.json",
    "Cmd":      ["lshw", "-json"]
  },
  {
    "Datatype": "lspci",
    "Filename": "lspci.txt",
    "Cmd":      ["lspci", "-mm", "-vv", "-k", "-nn"]
  },
  {
    "Datatype": "lsusb",
    "Filename": "lsusb.txt",
    "Cmd":      ["lsusb", "-v"]
  },
  {
    "Datatype": "ip-address",
    "Filename": "ip-address.txt",
    "Cmd":      ["ip", "address", "show"]
  },
  {
    "Datatype": "ip-route-4",
    "Filename": "ip-route-4.txt",
    "Cmd":      ["ip", "-4", "route", "show"]
  },
  {
    "Datatype": "ip-route-6",
    "Filename": "ip-route-6.txt",
    "Cmd":      ["ip", "-6", "route", "show"]
  },
  {
    "Datatype": "uname",
    "Filename": "uname.txt",
    "Cmd":      ["uname", "-a"]
  },
  {
    "Datatype": "os-release",
    "Filename": "os-release.txt",
    "Cmd":      ["cat", "/etc/os-release"]
  },
  {
    "Datatype": "bios_version",
    "Filename": "bios_version.txt",
    "Cmd":      ["cat", "/sys/class/dmi/id/bios_version"]
  },
  {
    "Datatype": "chassis_serial",
    "Filename": "chassis_serial.txt",
    "Cmd":      ["cat", "/sys/class/dmi/id/chassis_serial"]
  }
]

Docker部署示例

基本运行命令

bash
docker run -d \
  -v /path/to/output/directory:/output \  # 挂载输出目录，用于存储命令执行结果
  measurementlab/nodeinfo

说明

• 需将/path/to/output/directory替换为宿主机实际目录，用于持久化存储节点信息数据。
• 容器默认使用内置配置文件执行预设命令，若需自定义命令集，可通过挂载自定义配置文件实现（具体路径需参考镜像内部配置）。