@gasket/plugin-elastic-apm 6.28.0 → 6.34.2

package/README.md

@@ -99,6 +99,25 @@ According to the [Elastic APM docs], the _Elastic APM agent for Node.js is a
 singleton_. This means that you can require and configure singleton in various
 hooks of your Gasket app, such as with the [init] or [middleware] lifecycles.
 
+## Lifecycles
+
+### apmTransaction
+
+Enables customizing an APM transaction. Hooks receive the current APM [Transaction](https://www.elastic.co/guide/en/apm/agent/nodejs/current/transaction-api.html) and details about the request. Hooks may be asynchronous. The request details are as follows:
+
+| Property | Description |
+|----------|-------------|
+| `req`    | The HTTP request or framework-specific wrapper around it |
+| `res`    | The HTTP response or framework-specific wrapper around it |
+
+```javascript
+// /lifecycles/apm-transaction.js
+
+module.exports = (gasket, transaction, { req, res }) => {
+  transaction.setLabel('language', req.headers['accept-language']);
+}
+```
+
 ## How it works
 
 This plugin hooks the Gasket [preboot] lifecycle from [@gasket/plugin-start]

package/lib/index.d.ts

@@ -1,4 +1,5 @@
-import type { AgentConfigOptions } from 'elastic-apm-node';
+import type { IncomingMessage, ServerResponse } from 'http';
+import type { AgentConfigOptions, Transaction } from 'elastic-apm-node';
 
 declare module '@gasket/engine' {
   export interface GasketConfig {
@@ -6,4 +7,14 @@ declare module '@gasket/engine' {
       sensitiveCookies?: Array<string>
     },
   }
+
+  export interface HookExecTypes {
+    apmTransaction(
+      transaction: Transaction,
+      details: {
+        req: IncomingMessage,
+        res: ServerResponse
+      }
+    ): MaybeAsync<void>
+  }
 }

package/lib/index.js

@@ -1,4 +1,5 @@
 const { filterSensitiveCookies } = require('./cookies');
+const middleware = require('./middleware');
 const { dependencies } = require('../package.json');
 
 const isDefined = o => typeof o !== 'undefined';
@@ -83,6 +84,7 @@ module.exports = {
         });
       }
     },
+    middleware,
     metadata(gasket, meta) {
       return {
         ...meta,
@@ -97,6 +99,13 @@ module.exports = {
           description: 'List of sensitive cookies to filter',
           type: 'string[]',
           default: '[]'
+        }],
+        lifecycles: [{
+          name: 'apmTransaction',
+          method: 'exec',
+          description: 'Modify the APM transaction',
+          link: 'README.md#apmtransaction',
+          parent: 'middleware'
         }]
       };
     }

package/lib/middleware.js

@@ -0,0 +1,33 @@
+/* eslint-disable spaced-comment */
+// @ts-check
+/// <reference types="./index" />
+/// <reference types="../../gasket-plugin-nextjs" />
+
+/**
+ * @typedef {import('@gasket/engine').Gasket} Gasket
+ * @typedef {import('http').IncomingMessage}  Request
+ * @typedef {import('http').ServerResponse}   Response
+ */
+
+const { callbackify } = require('util');
+const apm = require('elastic-apm-node');
+
+/**
+ * Middleware for customizing transactions
+ *
+ * @param {Gasket}    gasket  The Gasket engine
+ * @param {Request}   req     The HTTP request being handled
+ * @param {Response}  res     The server response
+ */
+async function customizeTransaction(gasket, req, res) {
+  const transaction = apm.currentTransaction;
+  if (!transaction) {
+    return;
+  }
+
+  await gasket.exec('apmTransaction', transaction, { req, res });
+}
+
+module.exports = (gasket) => [
+  callbackify(async (req, res) => customizeTransaction(gasket, req, res))
+];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gasket/plugin-elastic-apm",
-  "version": "6.28.0",
+  "version": "6.34.2",
   "description": "Adds Elastic APM instrumentation to your application",
   "main": "lib",
   "types": "lib/index.d.ts",
@@ -43,10 +43,10 @@
     "elastic-apm-node": "^3.26.0"
   },
   "devDependencies": {
-    "@gasket/engine": "^6.26.1",
+    "@gasket/engine": "^6.34.2",
     "eslint": "^8.7.0",
     "eslint-config-godaddy": "^6.0.0",
-    "eslint-plugin-jest": "^25.7.0",
+    "eslint-plugin-jest": "^27.0.0",
     "eslint-plugin-json": "^3.1.0",
     "eslint-plugin-mocha": "^10.0.3",
     "eslint-plugin-unicorn": "^40.1.0",
@@ -68,5 +68,5 @@
   "jest": {
     "testEnvironment": "node"
   },
-  "gitHead": "b63c2abff1b9c8c2a47794f1439be00cc2243749"
+  "gitHead": "a92fc252c4bed8fe16980bdc9c5389ecf0a0f4d9"
 }