Add nodereport & heapdump calls to appmetrics API

Author: mattcolegate

README.md

@@ -208,6 +208,12 @@ Allows custom monitoring events to be added into the Node Application Metrics ag
 * `type` (String) the name you wish to use for the data. A subsequent event of that type will be raised, allowing callbacks to be registered for it.
 * `data` (Object) the data to be made available with the event. The object must not contain circular references, and by convention should contain a `time` value representing the milliseconds when the event occurred.
 
+### appmetrics.writeHeapSnapshot([filename],[callback])
+Dumps the v8 heap via `heapdump`. For more information, see [the heapdump README](https://github.com/bnoordhuis/node-heapdump/blob/master/README.md)
+
+### appmetrics.nodereport()
+Provides an instance of `nodereport` that can be used to obtain a human-readable diagnostic summary. For more information, see [the nodereport README](https://github.com/nodejs/nodereport/blob/master/README.md)
+
 ### appmetrics.monitor()
 Creates a Node Application Metrics agent client instance. This can subsequently be used to get environment data and subscribe to data events. This function will start the appmetrics monitoring agent if it is not already running.
 

index.js

@@ -20,6 +20,7 @@ var os = require("os")
 var aspect = require('./lib/aspect.js');
 var request = require('./lib/request.js');
 var fs = require('fs');
+var nodereport = require('nodereport');
 var agent = require("./appmetrics")
 // Set the plugin search path
 agent.spath(path.join(module_dir, "plugins"))
@@ -264,3 +265,12 @@ module.exports.setJSONProfilingMode = function(val) {
 module.exports.getJSONProfilingMode = function() {
     return jsonProfilingMode;
 }
+
+module.exports.nodereport = function() {
+    return nodereport;
+}
+
+module.exports.writeHeapSnapshot = function() {
+    return require('heapdump').writeSnapshot.apply(null, arguments);
+}
+

package.json

@@ -6,7 +6,9 @@
     "node-hc": "bin/appmetrics-cli.js"
   },
   "dependencies": {
+    "heapdump": "0.x",
     "nan": "2.x",
+    "nodereport": "1.x",
     "tar": "2.x"
   },
   "bundleDependencies": [