iopipe

IOpipe Analytics & Distributed Tracing Agent

This package provides analytics and distributed tracing for event-driven applications running on AWS Lambda.

Installation & usage

Installation is simple. Just require this module with your client id (contact us to get set up) and it will automatically monitor and collect metrics from your application running on AWS Lambda.

Example:

var iopipe = require("iopipe")({ clientId: "YOUR_ID"})

exports.handle = iopipe(
  function (event, context) {
    context.succeed("This is my serverless function!")
  }
)

Configuration

When requiring the metrics agent, it accepts a config object where you define the URL for the collector service and a client id. By default, telemetry will be reported to the IOpipe Telemetry Service.

var config = {
    url: "https://metrics-api.iopipe.com", // This is the default value
    clientId: "YOUR_ID"
}
var iopipe = require("iopipe")(config)

To override the collector service, specify a URL (ex. "127.0.0.1") running the IOpipe Collector as follows:

var iopipe = require("iopipe")({ url: "https://127.0.0.1", clientId: "YOUR_ID" })

exports.handle = iopipe_metrics(
  function (event, context) {
    context.succeed("Reporting these metrics to my own collector!")
  }
)

Data reported

The following is provided to IOpipe:

• function_id (a hashed identifier of the function)
• client_id (your client id, common among all your functions)
• errors
• events (custom events sent via .emit('event', [data])
• time_sec_nanosec (execution time: [secs, nanosecs])
• time_sec (execution time: secs)
• time_nanosec (execution time: nanosecs)

License

Apache 2.0