二十.stub_status模块功能(ngx_http_stub_status_module)

1.描述

增加对每请求的响应时间的统计：在stub status模块中增加了自Tengine启动以来所有请求的总响应时间(request_time)，

单位为ms，可以用来统计一段时间的平均RT(response time)：

Active connections: 1

server accepts handled requests request_time

1140 1140 1140 75806

Reading: 0 Writing: 1 Waiting: 0

在tsar中监控Tengine/Nginx可以使用我们开发的tsar模块。

2.安装tsar

$ wget -O tsar.zip https://github.com/alibaba/tsar/archive/master.zip --no-check-certificate

$ unzip tsar.zip

$ cd tsar

$ make

$ sudo make install

3.安装tsardevel

$ make tsardevel

4.Tengine/Nginx module for tsar

这是一个tsar模块，它可以从Tengine/Nginx端采集数据.

下载源文件 (https://github.com/taobao/tsar-mod_nginx)

使用指南

1. 安装 tsar.

2. 使用tsar的模块开发工具tsardevel生成一个模块模板

tsardevel mod_ngx

3. 替换模板中的mod_ngx.c.

make

make install

4. 启动tsar.

tsar --nginx

5.常见用法列表：

tsar -i 1 -l 以1秒钟为间隔，实时打印tsar的概述数据

tsar 显示1天内的历史汇总（summury）信息，以默认5分钟为间隔

tsar --cpu -i 1 显示一天内cpu的历史信息，以1分钟为间隔

tsar --live --mem -i 2 以2秒钟为间隔，实时打印mem的数据。

tsar --cpu --mem -i 1 显示一天内的cpu和内存历史数据，以1分钟为间隔。

5.配置

A. 默认采集地址和端口分别为127.0.0.1,80。可以通过环境变量来修改:

example:

export NGX_TSAR_HOST=192.168.0.1

export NGX_TSAR_PORT=8080

B. Tengine/Nginx必须编译了stub_status模块，而且必须在配置文件中增加类似如下配置：

location = /nginx_status {

stub_status on;

}

C. 另外我们也可以使用unix域套接字，比如将NGX_TSAR_HOST指定为一个文件路径：

export NGX_TSAR_HOST=/tmp/nginx-tsar.sock

同时，Tengine/Nginx的配置文件中包含location /nginx_status的server也必须是监听在该域套接口路径上

listen unix:/tmp/nginx-tsar.sock;

D. tsar模块发送给Tengine/Nginx的uri和主机名也可以通过如下环境变量设置：

example:

export NGX_TSAR_SERVER_NAME=status.taobao.com

export NGX_TSAR_URI=/nginx_status