nginx module for tsar
Switch branches/tags
Nothing to show
Latest commit d8fae59 Nov 16, 2012 @jinglong jinglong update readme
Failed to load latest commit information.
mod_nginx.c update readme Nov 16, 2012


#nginx/tengine module for tsar

Support read data from nginx by common socket or unix domain socket.

Quick start

  1. Install tsar.

  2. Generate a new module by using tsardevel.

    tsardevel ngx_mod

  3. Replace ngx_mod.c.


    make install

  4. tsar --nginx


  1. Default host is and default port is 80. But we can change both (or one of) the host and port:


    export NGX_TSAR_HOST=

    export NGX_TSAR_PORT=8080

  2. Stub Status module must be included,and add configuration as below:

    location = /nginx_status {

        stub_status on;


  3. We can also using unix domain socket, if we set NGX_TSAR_HOST to a filesystem path:


    export NGX_TSAR_HOST=/tmp/nginx-tsar.sock

    nginx server(which includes the location /nginx_status) must also listen to the unix domain socket path

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

  4. The uri and server name sent to the nginx server can alse be changed:



    export NGX_TSAR_URI=/nginx_status