hapi-dtrace

Plugin for hapi that adds dtrace probes to the request lifecycle events.

Usage

Register the plugin with a hapi server:

const Hapi = require('hapi');
const HapiDTrace = require('hapi-dtrace');


const server = new Hapi.Server();
server.connection({ port: 3000 });
server.register(HapiDTrace);

Start the server and run dtrace to list the available probes in the hapi provider:

$ dtrace -l -P hapi*
ID   PROVIDER            MODULE                          FUNCTION NAME
4514  hapi67987   mod-0x104801970                           request request
4515  hapi67987   mod-0x104801970                          pre-auth pre-auth
4516  hapi67987   mod-0x104801970                         post-auth post-auth
4517  hapi67987   mod-0x104801970                       pre-handler pre-handler
4518  hapi67987   mod-0x104801970                      post-handler post-handler
4519  hapi67987   mod-0x104801970                      pre-response pre-response

Available Probes

| Probe Name | Request Event | Arguments | |------------|---------------|-----------| | request | onRequest | (request.id, method, path, headers) | | pre-auth | onPreAuth | (request.id, method, path, headers) | | post-auth | onPostAuth | (request.id, method, path, headers) | | pre-handler | onPreHandler | (request.id, method, path, headers) | | post-handler | onPostHandler | (request.id, method, path, headers) | | pre-response | onPreResponse | (request.id, method, path, headers) |

Example

In the /example folder is a server.js that you can run that registers the plugin. After the server is running execute the .d script with the appropriate permissions. Next, use curl or a browser to make requests to the server and observe the request information logged from dtrace.