rbonghi/jetson_stats

jetson-stats 镜像文档

镜像概述和主要用途

jetson-stats是一款针对NVIDIA Jetson系列设备（Thor、Orin、Xavier、Nano、TX）的监控与控制工具。它可通过独立应用jtop或Python库形式集成到脚本中，提供硬件信息解析、性能监控及设备控制功能，适用于Jetson设备的开发、调试与性能优化场景。

核心功能和特性

• 硬件信息解码：解析设备架构、L4T版本及NVIDIA Jetpack信息
• 全面性能监控：实时监控CPU、GPU、内存、引擎负载及风扇状态
• 设备控制能力：支持NVP电源模式切换、风扇转速调节、jetson_clocks控制
• 灵活集成方式：可作为Python库导入自定义脚本
• 容器化支持：可在Docker容器中运行
• 权限友好：无需超级用户权限
• 广泛兼容性：经多种硬件配置测试，支持所有NVIDIA Jetpack版本

使用场景和适用范围

• Jetson设备开发调试过程中的性能监控
• 嵌入式系统资源利用分析
• 自动化脚本中集成硬件状态检查
• 教学或演示环境中的设备状态展示
• 需要远程监控Jetson设备运行状态的场景

详细使用方法和配置说明

安装方法

前置依赖

console
sudo apt update
sudo apt install python3-pip python3-setuptools -y

选项1：通过pip安装（需超级用户）

console
sudo pip3 install -U jetson-stats

选项2：从GitHub直接安装

console
sudo pip3 install git+https://github.com/rbonghi/jetson_stats.git

选项3：适用于Ubuntu 24.04

console
sudo pip3 install --break-system-packages -U jetson-stats

或

console
sudo pip3 install --break-system-packages git+https://github.com/rbonghi/jetson_stats.git

选项4：无需sudo运行jtop（适用于所有Jetson开发套件）

console
sudo -v
curl -LsSf https://raw.githubusercontent.com/rbonghi/jetson_stats/master/scripts/install_jtop_torun_without_sudo.sh | bash

或

console
# 下载安装脚本
sudo -v
chmod +x install_jtop_torun_without_sudo.sh
./install_jtop_torun_without_sudo.sh

运行jtop

安装完成后，直接在终端执行以下命令启动jtop：

console
jtop

启动后将显示终端界面，提供实时硬件监控信息。更多功能可参考jtop文档。

作为Python库使用

jetson-stats可作为Python库集成到自定义脚本中：

python
from jtop import jtop

with jtop() as jetson:
    # jetson.ok()确保适当的更新频率
    while jetson.ok():
        # 读取Tegra统计信息
        print(jetson.stats)

也支持在virtualenv环境中使用，详细用法见高级使用文档。

Docker部署

在Docker容器中运行jtop需满足以下条件：

1. 主机已安装jetson-stats
2. 容器内也需安装jetson-stats
3. 挂载主机的/run/jtop.sock到容器

快速运行命令

console
docker run --rm -it -v /run/jtop.sock:/run/jtop.sock rbonghi/jetson_stats:latest

更多Docker相关配置详见Docker文档。

文档与社区

• 完整文档：[***]
• 故障排除： troubleshooting页面
• 社区支持：***频道