ngx_slab_stat

该模块可以提供NGINX/Tengine共享内存的状态信息。

示例

获取NGINX/Tengine共享内存池的slab和空闲页状态信息

http {
   server {
       listen 80;

       location = /slab_stat {
           slab_stat;
       }
   }
}

请求URI /slab_stat，可以获取到该NGINX/Tengine实例的共享内存使用情况统计。页面输出如下：

$ curl http://localhost:80/slab_stat
* shared memory: one
total:      102400(KB) free:      101792(KB) size:           4(KB)
pages:      101792(KB) start:0000000003496000 end:0000000009800000
slot:           8(Bytes) total:           0 used:           0 reqs:           0 fails:           0
slot:          16(Bytes) total:           0 used:           0 reqs:           0 fails:           0
slot:          32(Bytes) total:         127 used:           1 reqs:           1 fails:           0
slot:          64(Bytes) total:           0 used:           0 reqs:           0 fails:           0
slot:         128(Bytes) total:          32 used:           1 reqs:           1 fails:           0
slot:         256(Bytes) total:           0 used:           0 reqs:           0 fails:           0
slot:         512(Bytes) total:           0 used:           0 reqs:           0 fails:           0
slot:        1024(Bytes) total:           0 used:           0 reqs:           0 fails:           0
slot:        2048(Bytes) total:           0 used:           0 reqs:           0 fails:           0

共享内存使用情况统计

数据说明

每个数据段落的前三行表明共享内存的总使用信息及空闲页(free pages)信息，剩余行表明slab的使用信息，数据项意义如下：

• shared memory: 共享内存池的名称信息

• total: 该共享内存池总内存占用

• free: 该共享内存池空闲内存

• size: 该共享内存池的页大小

• pages: 可供分配的连续页

• start: 可供分配的连续页起始地址

• end: 可供分配的连续页末尾地址

• slot: 可供分配的slot(不同大小代表不同的slot队列)

• total: 总的slot个数

• used: 已使用的slot个数
• reqs: 申请分配次数
• fails: 申请失败次数

NGINX兼容性

• 1.13.4 (stable version of 1.13.x)
  NGINX版本低于 1.13.x 需要补丁支持（参考安装说明）

Tengine兼容性

• 2.1.1 (stable version of 2.1.x)
  Tengine版本低于 2.1.x 需要补丁支持（参考安装说明）

安装说明

源码安装，执行如下命令：

$ wget http://nginx.org/download/nginx-1.13.4.tar.gz
$ tar -xzvf nginx-1.13.4.tar.gz
$ cd nginx-1.13.4/
$ ./configure --add-module=/path/to/ngx_slab_stat
$ make -j4 && make install

注意：若NGINX版本低于 1.13.x 或者 Tengine版本低于 2.1.1，请安装补丁文件slab_stat.patch后再编译二进制版本，该补丁文件可以自行比对NGINX 1.13.4 版本生成。

$ patch -p1 < /path/to/ngx_slab_stat/slab_stat.patch

配置指令

语法: slab_stat

默认: none

位置: server, location

NGINX/Tenigne实例的共享内存状态信息可以通过该location访问得到。

注意信息

仅支持NGINX官方指令分配的共享内存和lua-nginx-module分配的共享内存。

原文: http://tengine.taobao.org/document_cn/ngx_slab_stat_cn.html