uwsgitop 项目技术文档

1. 安装指南

安装 uwsgitop

要安装 uwsgitop，您可以使用 pip 命令。以下是安装步骤：

pip install uwsgitop

安装完成后，您就可以使用 uwsgitop 来监控您的 uWSGI 应用程序。

2. 项目的使用说明

启动 uWSGI Stats Server

在使用 uwsgitop 之前，您需要先启动 uWSGI 的 Stats Server。可以通过以下命令启动：

uwsgi --module myapp --socket :3030 --stats /tmp/stats.socket

使用 uwsgitop 监控应用程序

启动 Stats Server 后，您可以使用 uwsgitop 来监控您的应用程序。以下是使用 uwsgitop 的命令：

uwsgitop /tmp/stats.socket

如果您希望 Stats Server 通过 HTTP 提供服务，可以使用以下命令：

uwsgi --module myapp --http :3030 --stats :3031 --stats-http

然后，您可以通过以下命令使用 uwsgitop 进行监控：

uwsgitop http://127.0.0.1:3031

快捷键说明

• 按 a：显示异步核心统计信息（例如使用 gevent 时）或切换核心统计信息显示模式。
• 按 f：快速刷新屏幕。
• 按 q：退出 uwsgitop。

3. 项目API使用文档

uwsgitop 本身没有提供 API，但它通过 uWSGI 的 Stats Server 获取 JSON 格式的统计数据。您可以通过连接到 Stats Server 的套接字或 HTTP 端点来获取这些数据。

通过套接字获取统计数据

uwsgi --connect-and-read /tmp/stats.socket

通过 HTTP 获取统计数据

curl http://127.0.0.1:3031

4. 项目安装方式

uwsgitop 的安装非常简单，只需使用 pip 命令即可完成安装。以下是安装步骤：

pip install uwsgitop

安装完成后，您就可以在命令行中使用 uwsgitop 命令来监控您的 uWSGI 应用程序。

5. 字段说明

uwsgitop 显示的每个字段都有其特定的含义，以下是字段的详细说明：

字段	描述
WID	工作进程 ID
%	工作进程使用率
PID	工作进程 PID
REQ	自上次（重新）启动以来，工作进程执行的请求数量
RPS	每秒请求数
EXC	异常
SIG	管理的 uwsgi 信号
STATUS	工作进程是否繁忙或空闲
AVG	平均请求时间
RSS	工作进程 RSS（Resident Set Size，见 Linux 内存管理）
VSZ	工作进程 VSZ（Virtual Memory Size，见 Linux 内存管理）
TX	工作进程传输的数据量
ReSpwn	重新启动计数
HC	Harakiri 计数
RunT	工作进程运行的时间
LastSpwn	上次启动时间

6. 颜色说明

uwsgitop 使用不同的颜色来表示工作进程的状态：

• 默认颜色：工作进程空闲时显示。
• 绿色：工作进程繁忙时显示。
• 洋红色：工作进程处于 cheap 模式时显示。
• 黄色：工作进程正在处理 uwsgi 信号时显示。
• 蓝色：工作进程处于 suspended 状态时显示。

7. 进一步阅读

要了解更多关于 uWSGI Stats Server 的信息，请参考相关文档。