feat: allow manual instrumentation with instrument: false

Fixes #858

docs/configuration.asciidoc

@@ -98,7 +98,7 @@ var options = {
 * *Default:* `true`
 * *Env:* `ELASTIC_APM_INSTRUMENT`
 
-A boolean specifying if the agent should collect performance metrics for the app.
+A boolean specifying if the agent should automatically apply instrumentation to supported modules when they are loaded.
 
 Note that both `active` and `instrument` needs to be `true` for instrumentation to be running.
 

lib/instrumentation/index.js

@@ -104,9 +104,7 @@ Instrumentation.prototype.clearPatches = function (name) {
 Instrumentation.modules = Object.freeze(MODULES)
 
 Instrumentation.prototype.start = function () {
-  if (!this._agent._conf.instrument) return
   if (this._started) return
-
   this._started = true
 
   if (this._agent._conf.asyncHooks && semver.gte(process.version, '8.2.0')) {
@@ -138,7 +136,7 @@ Instrumentation.prototype._startHook = function () {
   this._agent.logger.debug('adding hook to Node.js module loader')
 
   this._hook = hook(this._patches.keys, function (exports, name, basedir) {
-    var enabled = !disabled.has(name)
+    var enabled = !disabled.has(name) && self._agent._conf.instrument
     var pkg, version
 
     if (basedir) {

test/_mock_http_client.js

@@ -50,7 +50,7 @@ module.exports = function (expected, done) {
     if (timer) clearTimeout(timer)
     timer = setTimeout(function () {
       done(client._writes)
-    }, 100)
+    }, 200)
   }
 }
 

test/config.js

@@ -760,6 +760,28 @@ test('globalLabels should be received by transport', function (t) {
   })
 })
 
+test('instrument: false allows manual instrumentation', function (t) {
+  var trans
+  var opts = {
+    metricsInterval: 0,
+    instrument: false
+  }
+
+  var server = APMServer(opts, { expect: 'transaction' })
+    .on('listening', function () {
+      trans = this.agent.startTransaction('trans')
+      trans.end()
+    })
+    .on('data-transaction', (data) => {
+      assertEncodedTransaction(t, trans, data)
+      t.end()
+    })
+
+  t.on('end', function () {
+    server.destroy()
+  })
+})
+
 function assertEncodedTransaction (t, trans, result) {
   t.comment('transaction')
   t.equal(result.id, trans.id, 'id matches')