nvitop命令行参数全解析：定制你的GPU监控体验 🚀

nvitop是一款功能强大的交互式NVIDIA GPU进程查看器，提供完整的GPU进程管理解决方案。作为深度学习开发者和研究人员的必备工具，nvitop通过丰富的命令行参数让你能够完全定制GPU监控体验。

🔧 核心监控模式参数

nvitop提供三种主要的运行模式，满足不同场景下的监控需求：

单次查询模式 (--once或-1)

• 执行一次查询后立即退出
• 适合脚本集成和快速状态检查
• 示例：nvitop --once

监控模式 (--monitor或-m)

• 持续监控GPU状态并实时更新
• 支持三种显示模式：auto、full、compact
• 示例：nvitop -m full 显示完整监控界面

环境变量控制 通过设置NVITOP_MONITOR_MODE环境变量可以预设监控模式：

export NVITOP_MONITOR_MODE="full,colorful"

🎨 显示与配色定制

nvitop提供丰富的显示定制选项，让你的监控界面更加个性化：

Unicode支持 (--no-unicode或-U)

• 在无Unicode支持的终端中使用ASCII字符
• 确保在各种环境下正常显示

多彩渐变 (--colorful)

• 使用渐变色显示频谱式柱状图
• 需要终端支持256色（设置TERM=xterm-256color）

强制着色 (--force-color)

• 即使在非TTY终端中也强制着色输出
• 适合重定向到文件时保持颜色

亮色主题 (--light)

• 针对亮色主题终端优化显示效果
• 也可以通过环境变量设置：NVITOP_MONITOR_MODE="light"

📊 阈值与性能指标

nvitop允许你自定义GPU利用率和内存使用的阈值：

GPU利用率阈值 (--gpu-util-thresh)

• 设置轻、中、重负载的分界点
• 默认值：[50, 90]
• 环境变量：NVITOP_GPU_UTILIZATION_THRESHOLDS

内存利用率阈值 (--mem-util-thresh)

• 控制内存使用情况的颜色标识
• 默认值：[50, 90]
• 环境变量：NVITOP_MEMORY_UTILIZATION_THRESHOLDS

🔍 设备过滤选项

精准筛选需要监控的GPU设备：

指定设备 (--only或-o)

• 只显示指定索引的设备
• 示例：nvitop --only 0 2 只监控设备0和2

可见设备 (--only-visible或-ov)

• 仅显示CUDA_VISIBLE_DEVICES环境变量中的设备
• 与容器环境完美配合

🖥️ 进程过滤功能

按不同类型筛选GPU进程：

计算进程 (--compute或-c)

• 显示包含计算上下文的进程（类型：'C'或'C+G'）

纯计算进程 (--only-compute或-C)

• 仅显示纯计算上下文的进程（类型：'C'）

图形进程 (--graphics或-g)

• 显示包含图形上下文的进程（类型：'G'或'C+G'）

纯图形进程 (--only-graphics或-G)

• 仅显示纯图形上下文的进程（类型：'G'）

用户过滤 (--user或-u)

• 按用户名筛选进程
• 不指定参数时默认为当前用户

PID过滤 (--pid或-p)

• 按进程ID精确筛选
• 示例：nvitop --pid 1234 5678

⚙️ 高级配置参数

更新间隔 (--interval)

• 设置状态更新间隔（秒）
• 默认值：2秒
• 最小值：0.25秒（性能考虑）

版本信息 (--version或-V)

• 显示nvitop版本信息
• 快速检查安装版本

帮助信息 (--help或-h)

• 显示完整的命令行帮助
• 查看所有可用参数说明

🚀 实用使用示例

基础监控：

nvitop -m auto

定制化监控：

nvitop -m full --colorful --gpu-util-thresh 40 80 --interval 1.5

特定用户进程：

nvitop -u username --compute

容器环境适配：

NVITOP_MONITOR_MODE="compact" nvitop --only-visible

💡 使用技巧与最佳实践

1. SSH连接优化：使用-m auto模式在SSH会话中获得最佳显示效果

2. 脚本集成：--once模式适合集成到自动化脚本中

3. 性能调优：适当调整--interval参数平衡实时性和系统负载

4. 环境预设：通过环境变量预设常用配置，简化命令行输入

5. 终端兼容：在不支持Unicode的终端中使用--no-unicode确保正常显示

nvitop的命令行参数设计既强大又灵活，无论你是需要简单的GPU状态查看，还是复杂的监控场景定制，都能找到合适的参数组合。通过熟练掌握这些参数，你可以打造完全符合个人需求的GPU监控环境，大幅提升工作效率。

通过nvitop/cli.py源码可以深入了解所有参数的实现细节，而官方文档则提供了更完整的API参考和使用指南。