https://github.com/openresty/nginx-dtrace

An nginx fork that adds dtrace USDT probes
https://github.com/openresty/nginx-dtrace

Last synced: 5 months ago
JSON representation

An nginx fork that adds dtrace USDT probes

• Host: GitHub
• URL: https://github.com/openresty/nginx-dtrace
• Owner: openresty
• License: bsd-2-clause
• Created: 2012-07-20T06:31:52.000Z (over 13 years ago)
• Default Branch: master
• Last Pushed: 2016-05-02T22:51:43.000Z (over 9 years ago)
• Last Synced: 2025-06-07T18:07:46.235Z (6 months ago)
• Language: C
• Size: 1.86 MB
• Stars: 44
• Watchers: 19
• Forks: 6
• Open Issues: 0
• Metadata Files:
  • Readme: README
  • Changelog: CHANGES
  • License: LICENSE

Awesome Lists containing this project

• awesome-nginx - nginx-dtrace - An nginx fork that adds dtrace USDT probes. (Tools / Lua Modules)

README

          
This is an Nginx fork that adds dtrace USDT probes.

Installation:

    ./configure --with-dtrace-probes \

        --with-dtrace=/usr/sbin/dtrace \

        ...

    make

    make install

Usage on Linux (with systemtap):

    # make the stap-nginx script visiable in your PATH

    export PATH=/usr/local/nginx/sbin:$PATH

    # list all the static probes available in your nginx

    stap-nginx -L 'process("nginx").mark("*")'

    # run the test.stp file

    stap-nginx test.stp

Sample test.stp file:

    probe begin

    {

        print("Tracing.  Hit CTRL-C to stop.\n")

    }

    probe process("nginx").mark("http-subrequest-start")

    {

        printf("uri: %s?%s\n", ngx_http_req_uri($arg1),

            ngx_http_req_args($arg1))

    }

For now, only tested on Solaris 11 Express and Fedora Linux 17.

The original Nginx documentation is available at http://nginx.org