{"_id":"opentelemetry-instrumentation-express","_rev":"57-a8a21bb0afc0532d87dfba6976b9c29a","name":"opentelemetry-instrumentation-express","dist-tags":{"latest":"0.41.0","alpha":"0.0.0-2024-05-16--12-47"},"versions":{"0.4.1":{"name":"opentelemetry-instrumentation-express","version":"0.4.1","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/aspecto-opentelemetry-js.git"},"scripts":{"build":"tsc","prepare":"yarn run build","test":"mocha","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav"},"publishConfig":{"access":"public"},"dependencies":{"@opentelemetry/api":"^1.0.0-rc.0","@opentelemetry/instrumentation":"^0.19.0","@opentelemetry/semantic-conventions":"^0.19.0"},"devDependencies":{"@opentelemetry/instrumentation-http":"^0.19.0","@opentelemetry/tracing":"^0.19.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.3.2","test-all-versions":"^5.0.1"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":"ts-node/register"},"gitHead":"e9928659612059b6fb2af15605eebe0a32ef0d4f","bugs":{"url":"https://github.com/aspecto-io/aspecto-opentelemetry-js/issues"},"homepage":"https://github.com/aspecto-io/aspecto-opentelemetry-js#readme","_id":"opentelemetry-instrumentation-express@0.4.1","_nodeVersion":"12.22.1","_npmVersion":"lerna/3.22.1/node@v12.22.1+x64 (linux)","dist":{"integrity":"sha512-6NNhXxCyDFD2dWa+2rNUxNUDBIU+1SBRlekrMARzeAqnocMOkCyRcX8PYi/k5Gqh6WIlNHbW4cB5uNPgWNpmtg==","shasum":"4aad3b0515e33c0655b30bcbb16ec20ff526e3cf","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.4.1.tgz","fileCount":18,"unpackedSize":49529,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJgj9OFCRA9TVsSAnZWagAAtSgP/AzX0Lixe/mMxJr7q4dw\nYhc0ik5ti+jLBig5DDfxmluUt+cAc/6awcspbXLbrH8mV2K76vx1YFeC4Wc+\nHVIZdYU5Zj/ek/K6RBFltlpyLzXNs5vG+sd8hXPg/9kpdcxnm++szH50OFMR\nYhq376FgCjpLSdwEj0rbBXbk7Fs13uwj55hiwRp6Ch4TYlpVKMp1lcOBrWsH\nytxOv9cMEuwJQBzw1XXgqDWYOJYg09gqGfVl+Haq0OJGsfBta8xUdRekMtDN\nI8Cz8UXeLSyQuYvaKE7znqz4rQRpSjhXQEhA2AFSfKnWxf4gONK4OotNQSrL\nHbnXaG42GWPVWL/6to7Gw/r5MINRzP6lYSV7Eakcra/jJiLzCMshJhAK6H6Z\nbND1emCkkFRCfPrqVOICQilrpRbI+cqBivTfD9KfBwSo/IPINaKijKZtd0jT\nJc37FxChSDy+yuTSSqnxqrntDvsKvHGO2iwWP4KhuQem8iwNRf3DC0ngjIhp\nJSMWHDB0jJTB3YGLaQfr3H6fV0awaZAzrKALxRzXreHz5W16qSsn86Lc9av6\nma4LHgDV+T4XvES0HmzkMsJUZMUuiYo6hV4UhmZxgkHUPTe7FdL+ydzPiu6l\n7nd/bkf4bcEbeux2Djs47ELdWeKCnNIReojkTl5wGNzIzbCcVCAIkTFaKKsN\ny8yX\r\n=qTK5\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIEaoCm5Rf+x2mED5COAqzmpeEmQVhKusJMXekqGnQm0KAiEA+tCukiPM0HhMvqYULjhK+Huomk4rW9mA4fWPdWUXFiU="}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.4.1_1620038533139_0.7728170040432008"},"_hasShrinkwrap":false},"0.4.2":{"name":"opentelemetry-instrumentation-express","version":"0.4.2","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/aspecto-opentelemetry-js.git"},"scripts":{"build":"tsc","prepare":"yarn run build","test":"mocha","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav"},"publishConfig":{"access":"public"},"dependencies":{"@opentelemetry/api":"^1.0.0-rc.0","@opentelemetry/instrumentation":"^0.19.0","@opentelemetry/semantic-conventions":"^0.19.0"},"devDependencies":{"@opentelemetry/instrumentation-http":"^0.19.0","@opentelemetry/tracing":"^0.19.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.3.2","test-all-versions":"^5.0.1"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":"ts-node/register"},"gitHead":"9927d3ebd726b2af70d44d64180fc23c1319ecf9","bugs":{"url":"https://github.com/aspecto-io/aspecto-opentelemetry-js/issues"},"homepage":"https://github.com/aspecto-io/aspecto-opentelemetry-js#readme","_id":"opentelemetry-instrumentation-express@0.4.2","_nodeVersion":"12.22.1","_npmVersion":"lerna/3.22.1/node@v12.22.1+x64 (linux)","dist":{"integrity":"sha512-cL/2Jh9LYyWolYV5iIk75RTNsVCBrGq+JzB4HVYS5G+oZ7l6oNWGF1roN8h233cltOlU6H4njhRd0RdxlSVInw==","shasum":"a5ebf5760e9e23ab6390d24b19cc63d269721327","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.4.2.tgz","fileCount":18,"unpackedSize":49782,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJgkVkWCRA9TVsSAnZWagAAvCkP+wR1tMCLEKoPa4XRjFYW\nOmZ9AP6fXKeQt704iQTp6GGFSz4y14gedLg2uaqcClBkNnb6vmZlJl3R7BiD\nYTugqb21odJeKqlhSnxBTpucFVyBPeVYRHa2vi+HcoKCG6fy4pZ3NcpjXuHx\nxfxorUAIunN/OgQeqzmX2dq/ZdJihSbVrkvlfzL/ocLd1CoZL1JML/8/LZ3y\nS5AMFQ161qwUWsE2kOVt+zTKTppcDAutEDybxobNieaLdrMghyAoOQIwdNP2\n39c1q31A4sc0yc9V4SVcuxpi1WmmpvCX3KuVr0CeWOeORzJf50ksWO/V6gBJ\nUf554skg/vLIb/wKQ5u8tNwzlbx+p0hQNkUZNfNGGcr8X2e3LBV6ixXN/XoA\nUt7uRJUZ0mPdAnp3tCGdmkVhrwuo/f04g13RC4cDyPz9KfqbFoVdT4wDUyrx\n9aJ30wKFClDSZ1CKAwL6ygnUcDrL2+HWM7k+2EXmrior9FWCm6zCVujXh7vu\nri9HNuGtY4e5nWAXrDA6H3ti8IJzX9eJm+9s86rY0VIXQpaJRkU4ZZsbOofb\nx12gkItQvs0NclWZhtHaAIA4jJMAyI2TO0RYV/sfWRpqAy33UpgnpyxrIFN9\n27xY/UYTHMxqrpnZDSDGLQQXTqpOoiZEJUWcwKEFukTXplH90mo/DA/Ndg2e\nbbNh\r\n=OL5i\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQD+0nh7mEUH5DQfKl1/Fsniq/kBv/sgpyJFfT5XMRwvHQIgJ10K6LEmxHFh4wdwPiCf1dP/hJYw7y1Zbm+6Zr8mBoY="}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.4.2_1620138261590_0.5736980102929705"},"_hasShrinkwrap":false},"0.4.3":{"name":"opentelemetry-instrumentation-express","version":"0.4.3","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/aspecto-opentelemetry-js.git"},"scripts":{"build":"tsc","prepare":"yarn run build","test":"mocha","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"peerDependencies":{"@opentelemetry/api":"1.0.0-rc.0"},"dependencies":{"@opentelemetry/instrumentation":"^0.19.0","@opentelemetry/semantic-conventions":"^0.19.0"},"devDependencies":{"@opentelemetry/api":"1.0.0-rc.0","@opentelemetry/instrumentation-http":"^0.19.0","@opentelemetry/tracing":"^0.19.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.3.2","test-all-versions":"^5.0.1"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":"ts-node/register"},"gitHead":"51bf5256ec5f0e623cef5705be9fa04a8a829b9a","bugs":{"url":"https://github.com/aspecto-io/aspecto-opentelemetry-js/issues"},"homepage":"https://github.com/aspecto-io/aspecto-opentelemetry-js#readme","_id":"opentelemetry-instrumentation-express@0.4.3","_nodeVersion":"12.22.1","_npmVersion":"lerna/3.22.1/node@v12.22.1+x64 (linux)","dist":{"integrity":"sha512-K8lm/bUhZgjYLeRImTZaNg/Wv0fryQaPELoyN211Q2K6NEbRZODV1wuplZrxALbBzLu2jENtpSoaPGcSVkvhaA==","shasum":"00a88970d0e54c2791f13bec68d26220f1817dda","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.4.3.tgz","fileCount":18,"unpackedSize":50164,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJgpP3wCRA9TVsSAnZWagAAH3QQAKDmYLgD8tHctY/+GgeX\njKDzZ/SbTJZSt33zRWLpISH/O7Cg+P1re/JwcArAHKdGiTn3drRLkcmV2Fe/\nlgMla6gcWwi2y8dm3l6HG6fo8BfXI4IVZcKqMaXF3hZNiQfAuJyhgrwnpAa7\nbljit4CaxJumklRUMryG4bnQynJgf8jDv1zL4ra1J6HwECOaSKzOpiZj34G6\ncHWIZUNuIo75X7nnzyvB4+DHvIdnWmPaocWItMXiBfC811sSc3Y4GX04rPAo\nJNQitR2Wlr98JHP49AagnE68jS0WONBlSOOgpr3wW7EYTPdp/2kGfuz2/HlH\nX9wTBWlvuyLiLYyesmMuqln6tU5iDQGoYd4CGySzw5xEESIwQYlZhi5n4a1k\nzAro/gV5955P9btNnQQVDf3vZ9fFq8DVyGQhnj2/rFAQCgrFlUUD+08NzeaP\namquAUYzc0ibrqctupwoGjLHIjoh/uv32RzloDZ07BZRk7HX9nfUvwvs9AkN\nMZ/bmxwKOzRxEfN/3Op6kI5u7eZ8+n8MRIFMYvVyO1y7QcH1PENakIkIAY3d\ngMUWEVuRhUuywbAMmXmpQcKkshgWOzpCkg839aoittI6RNAt+MgVgW/ohXhg\n6B+0LhwrrivD44t5Xq+UKOMr84CtvS1ExvKj/zLYQmXL/dcHRGTCIViTxilB\nogHk\r\n=amW1\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIEGQirmJDI6qy6lx8k6chI8DV5bNhm9GkEENQLB6HA/DAiEA/VoDRqooTKmqANL4aJ8XYK9kj6Gs1T0/XF0WoArfbIA="}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.4.3_1621425648056_0.7570691750244642"},"_hasShrinkwrap":false},"0.4.4":{"name":"opentelemetry-instrumentation-express","version":"0.4.4","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn run build","test":"mocha","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"dependencies":{"@opentelemetry/api":"^1.0.0-rc.0","@opentelemetry/instrumentation":"^0.19.0","@opentelemetry/semantic-conventions":"^0.19.0"},"devDependencies":{"@opentelemetry/instrumentation-http":"^0.19.0","@opentelemetry/tracing":"^0.19.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.3.2","test-all-versions":"^5.0.1"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":"ts-node/register"},"gitHead":"61891435509330061efea9e3ffcdf34b80a584a9","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.4.4","_nodeVersion":"12.22.1","_npmVersion":"lerna/3.22.1/node@v12.22.1+x64 (linux)","dist":{"integrity":"sha512-8uZAcJbO3HVzI1/LZw+SjPkAEXMVRLX3XFriK5ciEsF0c2a0TDXA/EbFwKmWTR60n2Dlm92GfGhho8/WLN2dwQ==","shasum":"e8a6408f62381658770fdabc2e479b1dc87ad914","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.4.4.tgz","fileCount":18,"unpackedSize":50343,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJgpR3xCRA9TVsSAnZWagAAB8wP/0voXQktPNgrZUX9pZTr\nOXkJrpHSxJUa3d0+Fs7wLVJhvP1pPRi9wYHQmLcBVOKhnL9GYUGOSjVKl//K\nLAeH7eVtBNQ9dxb+4w/G6kc+o86730+9Wut7WCtNlu3OCATlAnpe8Yxt0OH+\n7G3XlCiblVdsFIUQYLzpJBSYf/qENJheKQXwZIMBSyo98QqrJKH8IzQh1/ds\n81TDC/XKBTA9d9+qLox8tJhZr5+7lwdsoGUuTPJqf1d6Au6NSySCQgscgzXz\njMcfNAHYFSwjQBU/oTN9un0f4opUNQ78WfGwhjfKWUh3aeCdh+RWmIh36gfm\nWWtpupaNYv0T2DS8H1bPT3hKVS7BPJEvJYcMXtgiFWDldHWoUBD6A174Pk2f\nqD2qk0O04WG4c/Cpsos5Wi3qllVIUpRUJyH6LIA+bXZhQTgMT8GanwroqfZt\nWTs/rNB7ll0z/R9Mxto7e1XIS9CYhj8Yu4JiS6JTq96p1F52f+tjj5mn4iu2\nlS3utzP/FbiuwObW5jIngBuH4zFgL9XX+DFMDg5MCX6wehBfqL4nX3NkHyMo\nxHRsqpDSngP5SA+SzlLmwuF7Voz0OQshWpsI36fI9rZXzy/LJQgGtlj12Tmg\nFUONJ/XKJtSIqG2WMXwLJIim4yJfMzMAZkLSeyWW136BeSlB5V/J6GMo5qfT\nmISi\r\n=alt+\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQD7rG06MMKHXg4BoTkHmI/jW9a2MpmlbcDkw3JTVRFWkAIgNw47o/t6Mkx3PBcM42/IhK8U1u0oYATDl7ZvSTa6Vzk="}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.4.4_1621433841289_0.9050912627037788"},"_hasShrinkwrap":false},"0.0.0-2021-05-25--13-03":{"name":"opentelemetry-instrumentation-express","version":"0.0.0-2021-05-25--13-03","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/aspecto-opentelemetry-js.git"},"scripts":{"build":"tsc","prepare":"yarn run build","test":"mocha","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"dependencies":{"@opentelemetry/api":"^1.0.0-rc.0","@opentelemetry/instrumentation":"^0.19.0","@opentelemetry/semantic-conventions":"^0.19.0"},"devDependencies":{"@opentelemetry/instrumentation-http":"^0.19.0","@opentelemetry/tracing":"^0.19.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.3.2","test-all-versions":"^5.0.1"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":"ts-node/register"},"gitHead":"bd533753ec41cf4673d0393c42ed081d3a4e4f34","readme":"# OpenTelemetry express Instrumentation for Node.js\n[![NPM version](https://img.shields.io/npm/v/opentelemetry-instrumentation-express.svg)](https://www.npmjs.com/package/opentelemetry-instrumentation-express)\n\nThis module provide enhanced instrumentation for the `express` web framework.\n\n## Installation\n\n```\nnpm install --save opentelemetry-instrumentation-express\n```\n## Supported Versions\nThis instrumentation supports `^4.9.0`:\n\nall versions >= `4.9.0` (released 2014) and < `5.0.0` (in alpha).\n\n## Usage\nFor further automatic instrumentation instruction see the [@opentelemetry/instrumentation](https://github.com/open-telemetry/opentelemetry-js/tree/main/packages/opentelemetry-instrumentation) package.\n\n```js\nconst { NodeTracerProvider } = require('@opentelemetry/node');\nconst { registerInstrumentations } = require('@opentelemetry/instrumentation');\nconst { ExpressInstrumentation } = require('opentelemetry-instrumentation-express');\n\nconst traceProvider = new NodeTracerProvider();\ntraceProvider.register();\n\nregisterInstrumentations({\n  traceProvider,\n  instrumentations: [\n    new ExpressInstrumentation()\n  ]\n});\n```\n\n### Express Instrumentation Options\n\nExpress instrumentation has few options available to choose from. You can set the following:\n\n| Options | Type  | Description |\n| --- | --- | --- |\n| `requestHook` | `RequestHook` (function) | Hook for adding custom attributes before express start handling the request. Receives params: `span, { moduleVersion, req, res }` |\n| `includeHttpAttributes` | `boolean` | If set to true, plugin will include semantic http attributes in each express span |\n\n## Semantic Behavior\nExpress auto instrumentation will create a single span per request with the following attributes.\nDetailed specification and cases can be found [here](./doc/attributes-specification.MD).\n\n### `http.route`\nThis is a conventional http attribute, which is collected by express instead of the http module (which is not aware of the route). It will always contain path-parameterized data with low cardinality (no ids), but might be missing parts of the path in case of early termination or middlewares that accept any path.\n\nExample: `/api/users/:id`\n\n### `express.route.full`\nThis attribute will always contain the entire path. The part of the path that has been consumed by express will be shown as is (parameterized), and the leftover will be concatenated after (due to early termination or middleware that accept any path).\n\nExample: `/api/users/:id/books/758734` (The `:id` part was consumed, but the `bookid` part was not).\n\n### `express.route.configured`\nThis attribute is relevant when user configures multi path options for the same middleware. It reduces even further the cardinality space compared to `http.route`, and supply more info about how the app routing works.\n\nExample: `/api[\"/foo\", /\"bar\"]` - meaning that the same endpoint is triggered by routes `/api/foo` and `/api/bar`.\n\n### `express.route.params`\nThis attribute holds a json stringified map, where the keys are the url path param names, and the values are the matched params from the actual url.\n\nExample: `{\"id\":\"1234\"}`. \n\n### `express.unhandled`\nSet to true when request was not handled by any middleware in express, and got fallback to the default app `finalhandler`. This can happen if client sent request with invalid path or method (resulting in 404). This can be useful to filter out requests from internet bots which try to call common routes on servers.\n\n### `express.instrumentation.errors`\nIn case of internal error in instrumentation, this attribute will contain the error description. There are no known valid use cases which are expected to produce this attribute.\n\n## Difference from [@opentelemetry/instrumentation-express](https://github.com/open-telemetry/opentelemetry-js-contrib/tree/main/plugins/node/opentelemetry-instrumentation-express)\n\n* This instrumentation is focusing on extracting the most accurate and complete `route` data, in any valid express edge case. Contrib instrumentation does a good job for common cases, but miss nuances on complex setups.\n* This instrumentation create a single span per request. Contrib instrumentation creates span per express Router/Route, which can be useful to observe express internal components, with the cost of more spans in each trace.\n* Set few alternatives for route attribute, each with different level of cardinality vs accuracy.\n* Allows to set `requestHook` for adding custom attributes to span, as well as ability to capture express version into user defined attribute.\n* Distinguish between handled requests (ended from user middleware), and unhandled (terminated from express built in 'finalhandler').\n* Option to conform with the [Semantic conventions for HTTP spans](https://github.com/open-telemetry/opentelemetry-specification/blob/master/specification/trace/semantic_conventions/http.md).\n\n\n---\n\nThis extension (and many others) was developed by [Aspecto](https://www.aspecto.io/) with ❤️","readmeFilename":"README.md","bugs":{"url":"https://github.com/aspecto-io/aspecto-opentelemetry-js/issues"},"homepage":"https://github.com/aspecto-io/aspecto-opentelemetry-js#readme","_id":"opentelemetry-instrumentation-express@0.0.0-2021-05-25--13-03","_nodeVersion":"12.22.1","_npmVersion":"lerna/3.22.1/node@v12.22.1+x64 (linux)","dist":{"integrity":"sha512-70t2cxIeKqGANeWgguvvwCuyB3NWXg+Y7Gq2ez1t0N3ycSU3y6+3JAlFymfU0J0KyHRbT/fjPb+93NGakDV3Qg==","shasum":"734ff6178ca4a8de5b2c9bae5eebfe950c4d0218","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.0.0-2021-05-25--13-03.tgz","fileCount":18,"unpackedSize":49881,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJgrPXfCRA9TVsSAnZWagAAAQEP/jxLh07btA4x3bJnBsa/\n6qdodMr8lqhZx4GjwXbtXTo9D7dqONss3ohz7Ogj7avCak2lqxVOjpovPOo1\n/oMsR4Gnzo+/kQm2KKu4QVlpf7y/nEfLLJPGjvF3vprTmTIF9HL0kWw00ApF\nDxvYpfBz237ji1kPwrbwgkN1aDb4RjT4wzjXHmELo4dHyxhCIpV4kdM1btXB\nKaxyvIdB8qbrYRRlE2usU4IUWEAFNnB3MQB7zd6fVKsuDv+3RsgTRqykIQKi\nSABC/K0ZiNlIuzvl5N3qwoeaVqpkIS6DMondUbJvBotu/fLww2GABGL84TeG\n7q1flnQ48BLXX/rciLM4+KZD07iVcQo7wtlgTlGXRI+1pGSnvRa+NmVuE8s6\nCQ0uEl8xdUT8H4dfhCSFYsrFtV1H0bPi0lcXnNqpFdHVdMI2RNUjZPBE+dHP\nGtyVk0DDb0ADWeXznSjITIwWwNwefc4523JeHQDmCeQfKZaLgrl+mLHPPtis\nlscM5cQhrJIvPElGiF/08rgR5PwtEUGYMTNOxhhpSFpK02q7nKkLlmoieZN4\nsKTBMVDlMfWJSZMl7veMlvaaY+1YS1zIEK7+Ibq9uxHE/SC55xpXGqupQkZA\n3GE88nQIKlcdFCTntz4APlkTMa3ZEwmxMVWXY29RGm9JjP9Cpp40hvqBvqeA\nFDkf\r\n=d23Z\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCID3TIBCF3CtFY9PehcOo+/wEj6ZHqILCgrdJkz50p40rAiEArg9OQGqFrZbk0X+pMkpc8bK6MLG+9wE1OCYbH65NXt0="}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.0.0-2021-05-25--13-03_1621947871370_0.23109911935777316"},"_hasShrinkwrap":false},"0.0.0-2021-05-26--07-22":{"name":"opentelemetry-instrumentation-express","version":"0.0.0-2021-05-26--07-22","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/aspecto-opentelemetry-js.git"},"scripts":{"build":"tsc","prepare":"yarn run build","test":"mocha","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"dependencies":{"@opentelemetry/api":"^1.0.0-rc.0","@opentelemetry/instrumentation":"^0.19.0","@opentelemetry/semantic-conventions":"^0.19.0"},"devDependencies":{"@opentelemetry/instrumentation-http":"^0.19.0","@opentelemetry/tracing":"^0.19.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.3.2","test-all-versions":"^5.0.1"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":"ts-node/register"},"gitHead":"2b31e4e63d0670d8067ee32ba46ce1979d17a6f8","readme":"# OpenTelemetry express Instrumentation for Node.js\n[![NPM version](https://img.shields.io/npm/v/opentelemetry-instrumentation-express.svg)](https://www.npmjs.com/package/opentelemetry-instrumentation-express)\n\nThis module provide enhanced instrumentation for the `express` web framework.\n\n## Installation\n\n```\nnpm install --save opentelemetry-instrumentation-express\n```\n## Supported Versions\nThis instrumentation supports `^4.9.0`:\n\nall versions >= `4.9.0` (released 2014) and < `5.0.0` (in alpha).\n\n## Usage\nFor further automatic instrumentation instruction see the [@opentelemetry/instrumentation](https://github.com/open-telemetry/opentelemetry-js/tree/main/packages/opentelemetry-instrumentation) package.\n\n```js\nconst { NodeTracerProvider } = require('@opentelemetry/node');\nconst { registerInstrumentations } = require('@opentelemetry/instrumentation');\nconst { ExpressInstrumentation } = require('opentelemetry-instrumentation-express');\n\nconst traceProvider = new NodeTracerProvider();\ntraceProvider.register();\n\nregisterInstrumentations({\n  traceProvider,\n  instrumentations: [\n    new ExpressInstrumentation()\n  ]\n});\n```\n\n### Express Instrumentation Options\n\nExpress instrumentation has few options available to choose from. You can set the following:\n\n| Options | Type  | Description |\n| --- | --- | --- |\n| `requestHook` | `RequestHook` (function) | Hook for adding custom attributes before express start handling the request. Receives params: `span, { moduleVersion, req, res }` |\n| `includeHttpAttributes` | `boolean` | If set to true, plugin will include semantic http attributes in each express span |\n\n## Semantic Behavior\nExpress auto instrumentation will create a single span per request with the following attributes.\nDetailed specification and cases can be found [here](./doc/attributes-specification.MD).\n\n### `http.route`\nThis is a conventional http attribute, which is collected by express instead of the http module (which is not aware of the route). It will always contain path-parameterized data with low cardinality (no ids), but might be missing parts of the path in case of early termination or middlewares that accept any path.\n\nExample: `/api/users/:id`\n\n### `express.route.full`\nThis attribute will always contain the entire path. The part of the path that has been consumed by express will be shown as is (parameterized), and the leftover will be concatenated after (due to early termination or middleware that accept any path).\n\nExample: `/api/users/:id/books/758734` (The `:id` part was consumed, but the `bookid` part was not).\n\n### `express.route.configured`\nThis attribute is relevant when user configures multi path options for the same middleware. It reduces even further the cardinality space compared to `http.route`, and supply more info about how the app routing works.\n\nExample: `/api[\"/foo\", /\"bar\"]` - meaning that the same endpoint is triggered by routes `/api/foo` and `/api/bar`.\n\n### `express.route.params`\nThis attribute holds a json stringified map, where the keys are the url path param names, and the values are the matched params from the actual url.\n\nExample: `{\"id\":\"1234\"}`. \n\n### `express.unhandled`\nSet to true when request was not handled by any middleware in express, and got fallback to the default app `finalhandler`. This can happen if client sent request with invalid path or method (resulting in 404). This can be useful to filter out requests from internet bots which try to call common routes on servers.\n\n### `express.instrumentation.errors`\nIn case of internal error in instrumentation, this attribute will contain the error description. There are no known valid use cases which are expected to produce this attribute.\n\n## Difference from [@opentelemetry/instrumentation-express](https://github.com/open-telemetry/opentelemetry-js-contrib/tree/main/plugins/node/opentelemetry-instrumentation-express)\n\n* This instrumentation is focusing on extracting the most accurate and complete `route` data, in any valid express edge case. Contrib instrumentation does a good job for common cases, but miss nuances on complex setups.\n* This instrumentation create a single span per request. Contrib instrumentation creates span per express Router/Route, which can be useful to observe express internal components, with the cost of more spans in each trace.\n* Set few alternatives for route attribute, each with different level of cardinality vs accuracy.\n* Allows to set `requestHook` for adding custom attributes to span, as well as ability to capture express version into user defined attribute.\n* Distinguish between handled requests (ended from user middleware), and unhandled (terminated from express built in 'finalhandler').\n* Option to conform with the [Semantic conventions for HTTP spans](https://github.com/open-telemetry/opentelemetry-specification/blob/master/specification/trace/semantic_conventions/http.md).\n\n\n---\n\nThis extension (and many others) was developed by [Aspecto](https://www.aspecto.io/) with ❤️","readmeFilename":"README.md","bugs":{"url":"https://github.com/aspecto-io/aspecto-opentelemetry-js/issues"},"homepage":"https://github.com/aspecto-io/aspecto-opentelemetry-js#readme","_id":"opentelemetry-instrumentation-express@0.0.0-2021-05-26--07-22","_nodeVersion":"12.22.1","_npmVersion":"lerna/3.22.1/node@v12.22.1+x64 (linux)","dist":{"integrity":"sha512-fE+kyOzdUdc1BtcT7c0qOPS6EP19JB4MEj3SIdb1ovgI0P0nAPcdyVtmXCTVQHHIFS8aCnAMG31bHe8xBTiF5g==","shasum":"3921b890ebc8cfb8501b04f2c2085ec6c99ab983","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.0.0-2021-05-26--07-22.tgz","fileCount":18,"unpackedSize":49881,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJgrfdbCRA9TVsSAnZWagAAMEIP/1F7nqgXfATfuvxlQGst\nFr0XQ3wb4uO0e+ayVKN8+Mrdw+AhwTbKbnNj8k4i4jZXUQl1V7cJ0d4xnNbs\nUFw4V9hWuZfMKk104RPgvyH0jrr8y0p1U2PRKYZdyyGbGxRBKqXx3yE7QRGV\ntjs4+pZaRQLZVi5P3r93lkuQ3uuxgLWaP1j1EUGyXYQYXmZQla4gJXY0ETa7\njcZtVIuXIEft2ljuc6iTASLhoQtMvVNCn78EKZmjqClYERsWeBtqoDop1Zmf\nRCTgeKh3zhJt1hybpaoyBjMuApGeHQPIkGk7gsaQN3OCYocoX6r1QdDAQBmg\nr8UqtnL26BQIunUyd/8knraEndIDjxt1Y4/xCTmxAtKpAoK6GfNgO6KNjaqd\nZ6StAXqb9dVSQKPRqsb1CEUMmFNvYXkjaC9cJ8bJpoCmLF22Q55EIxc1OfKS\n+7CSkFgbojuTlxKMBH4eYE15pMyUY4Yzs0C0w98pDjOMbtSRZMReKzSSEXVa\nk019laNjOnjH3bA4dJqnNkHBze0sWPBKC8HKBUIXf+6gLZmK9eDLaQVIFCqp\nWRFCDGK3sZH+hyZ0dv+ZcbFtz+Zeol6fqvnygRmEq9hkaEd7Oy/2iBBzo4GD\nyPTGIP4BFzw9d5dZLk/vEDy8XqACpw6nP/mD60+IegFBEgCQZKvxU9Sk57A5\nn+EA\r\n=OYFd\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIA3NRUILVttFzvelo9RKkKZbZqqvSDr05mVAFH3XsDBwAiEApRUiVZqkRKOexP5Agh5WLSVeT/xNjeJezM5r9se6ewU="}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.0.0-2021-05-26--07-22_1622013786699_0.898016695639557"},"_hasShrinkwrap":false},"0.0.0-2021-05-26--15-12":{"name":"opentelemetry-instrumentation-express","version":"0.0.0-2021-05-26--15-12","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/aspecto-opentelemetry-js.git"},"scripts":{"build":"tsc","prepare":"yarn run build","test":"mocha","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"dependencies":{"@opentelemetry/api":"^1.0.0-rc.0","@opentelemetry/instrumentation":"^0.19.0","@opentelemetry/semantic-conventions":"^0.19.0"},"devDependencies":{"@opentelemetry/instrumentation-http":"^0.19.0","@opentelemetry/tracing":"^0.19.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.3.2","test-all-versions":"^5.0.1"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":"ts-node/register"},"gitHead":"6f64818f1e8c571b9e7341a8f019edb26605ea66","readme":"# OpenTelemetry express Instrumentation for Node.js\n[![NPM version](https://img.shields.io/npm/v/opentelemetry-instrumentation-express.svg)](https://www.npmjs.com/package/opentelemetry-instrumentation-express)\n\nThis module provide enhanced instrumentation for the `express` web framework.\n\n## Installation\n\n```\nnpm install --save opentelemetry-instrumentation-express\n```\n## Supported Versions\nThis instrumentation supports `^4.9.0`:\n\nall versions >= `4.9.0` (released 2014) and < `5.0.0` (in alpha).\n\n## Usage\nFor further automatic instrumentation instruction see the [@opentelemetry/instrumentation](https://github.com/open-telemetry/opentelemetry-js/tree/main/packages/opentelemetry-instrumentation) package.\n\n```js\nconst { NodeTracerProvider } = require('@opentelemetry/node');\nconst { registerInstrumentations } = require('@opentelemetry/instrumentation');\nconst { ExpressInstrumentation } = require('opentelemetry-instrumentation-express');\n\nconst traceProvider = new NodeTracerProvider();\ntraceProvider.register();\n\nregisterInstrumentations({\n  traceProvider,\n  instrumentations: [\n    new ExpressInstrumentation()\n  ]\n});\n```\n\n### Express Instrumentation Options\n\nExpress instrumentation has few options available to choose from. You can set the following:\n\n| Options | Type  | Description |\n| --- | --- | --- |\n| `requestHook` | `RequestHook` (function) | Hook for adding custom attributes before express start handling the request. Receives params: `span, { moduleVersion, req, res }` |\n| `includeHttpAttributes` | `boolean` | If set to true, plugin will include semantic http attributes in each express span |\n\n## Semantic Behavior\nExpress auto instrumentation will create a single span per request with the following attributes.\nDetailed specification and cases can be found [here](./doc/attributes-specification.MD).\n\n### `http.route`\nThis is a conventional http attribute, which is collected by express instead of the http module (which is not aware of the route). It will always contain path-parameterized data with low cardinality (no ids), but might be missing parts of the path in case of early termination or middlewares that accept any path.\n\nExample: `/api/users/:id`\n\n### `express.route.full`\nThis attribute will always contain the entire path. The part of the path that has been consumed by express will be shown as is (parameterized), and the leftover will be concatenated after (due to early termination or middleware that accept any path).\n\nExample: `/api/users/:id/books/758734` (The `:id` part was consumed, but the `bookid` part was not).\n\n### `express.route.configured`\nThis attribute is relevant when user configures multi path options for the same middleware. It reduces even further the cardinality space compared to `http.route`, and supply more info about how the app routing works.\n\nExample: `/api[\"/foo\", /\"bar\"]` - meaning that the same endpoint is triggered by routes `/api/foo` and `/api/bar`.\n\n### `express.route.params`\nThis attribute holds a json stringified map, where the keys are the url path param names, and the values are the matched params from the actual url.\n\nExample: `{\"id\":\"1234\"}`. \n\n### `express.unhandled`\nSet to true when request was not handled by any middleware in express, and got fallback to the default app `finalhandler`. This can happen if client sent request with invalid path or method (resulting in 404). This can be useful to filter out requests from internet bots which try to call common routes on servers.\n\n### `express.instrumentation.errors`\nIn case of internal error in instrumentation, this attribute will contain the error description. There are no known valid use cases which are expected to produce this attribute.\n\n## Difference from [@opentelemetry/instrumentation-express](https://github.com/open-telemetry/opentelemetry-js-contrib/tree/main/plugins/node/opentelemetry-instrumentation-express)\n\n* This instrumentation is focusing on extracting the most accurate and complete `route` data, in any valid express edge case. Contrib instrumentation does a good job for common cases, but miss nuances on complex setups.\n* This instrumentation create a single span per request. Contrib instrumentation creates span per express Router/Route, which can be useful to observe express internal components, with the cost of more spans in each trace.\n* Set few alternatives for route attribute, each with different level of cardinality vs accuracy.\n* Allows to set `requestHook` for adding custom attributes to span, as well as ability to capture express version into user defined attribute.\n* Distinguish between handled requests (ended from user middleware), and unhandled (terminated from express built in 'finalhandler').\n* Option to conform with the [Semantic conventions for HTTP spans](https://github.com/open-telemetry/opentelemetry-specification/blob/master/specification/trace/semantic_conventions/http.md).\n\n\n---\n\nThis extension (and many others) was developed by [Aspecto](https://www.aspecto.io/) with ❤️","readmeFilename":"README.md","bugs":{"url":"https://github.com/aspecto-io/aspecto-opentelemetry-js/issues"},"homepage":"https://github.com/aspecto-io/aspecto-opentelemetry-js#readme","_id":"opentelemetry-instrumentation-express@0.0.0-2021-05-26--15-12","_nodeVersion":"12.22.1","_npmVersion":"lerna/3.22.1/node@v12.22.1+x64 (linux)","dist":{"integrity":"sha512-ybfwjsg3Z3w2j9Goe4X73RvrVI77VnYfykCAB999ZPnRxQHgLet2BaZ27Cz9aCD9MrSGOWSffKE9/ymL/cCxfQ==","shasum":"761395883f3a6cb29dcbf0aa8ca44a2ef7272806","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.0.0-2021-05-26--15-12.tgz","fileCount":18,"unpackedSize":49881,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJgrmWZCRA9TVsSAnZWagAAU2AP/jgLkLUIJX4zo48s/hBR\n9cklyMeh2bxQStLdUGY6bk3qtUxawWM8TFpFkgR5VJjsfH/zSSRP2FRw/Ax6\nXYZydVbRetIIZ4ewbuHmoEoJdVCNikuTeuI62urZ+hfMV6haXLEweVG+BEfZ\nt/MCh5YuK8MklB6S/ULHKY0mA+8CYpFfHHgE3dwWETW/zU27zgKBIENQ+aYd\niZ4VnVZ0Qlqpdu0hYYrKWTJnc8wBSnVaSmWWMagGHiTLDKLqIpK8BND3uPG0\nkzxwn7xoeD+Wm61pYDQhxf5XJw5qxORNJG3yZNb//1t7clvAZbt99qChVtP7\nJUlQItziMpV2IPakv/hBLyPIpn7y9hBGwxfqiYyw0H6WKOwdlsK+VMSuHwJO\nQamjjjn/UAbILiGCnTB9Yfvd2fEuQO/SWbmbqu0uG+XWz5R4r9xxnlqkYpMC\n0vWgjod1AO1G05uG1daHFR/ZOWTfs787NOKnHGLiAeq4IilJ7wmJOcVWhMsc\nNpv/qleP+Ai7+1e/QJDxnyNNnxkB5UI0ZVpJgBlKPh/4SpjIOGQ/AFtUSKpp\nc4J2QFhLxGTOobMCKBqUK70N1YH8u5kYcFZSHsviS9IOSR1XnX8k9Ob2eijd\n2jEh0ixXELNhQnVIrIdB1SSYTGLOy4GFnd8EjiSDahBe4mNS9m/VfKjCiTTu\nBJbU\r\n=cNTg\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIB5+oOdrW3CtpExDdtUDz9v/8szqD6OOuTd2HtG1sF08AiEArJX707cVK2N0smSEGfBdsY7EY6oYTMavzXdUjjvgpog="}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.0.0-2021-05-26--15-12_1622042009175_0.6187440465081777"},"_hasShrinkwrap":false},"0.4.5":{"name":"opentelemetry-instrumentation-express","version":"0.4.5","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn run build","test":"mocha","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"dependencies":{"@opentelemetry/api":"^1.0.0-rc.0","@opentelemetry/instrumentation":"^0.19.0","@opentelemetry/semantic-conventions":"^0.19.0"},"devDependencies":{"@opentelemetry/instrumentation-http":"^0.19.0","@opentelemetry/tracing":"^0.19.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","test-all-versions":"^5.0.1"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":"ts-node/register"},"gitHead":"0ffb67e586f78c6b091b3af5fad8656fde819202","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.4.5","_nodeVersion":"12.22.1","_npmVersion":"lerna/3.22.1/node@v12.22.1+x64 (linux)","dist":{"integrity":"sha512-Qa+kG5C+Gw61MLwWrAGtOTSAWPVoqtxB3YdJvw5Sj5AfVyc2nq0VHxm7Cj/axYXvwpDADPA3THnyfcsfs2GwYg==","shasum":"c51af7620713893f00cc02377666704289b44c9b","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.4.5.tgz","fileCount":18,"unpackedSize":51129,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJgtOdpCRA9TVsSAnZWagAAygYP/jbTb39LJ6sxhgEiQ42y\nf7/65apsm1iGQb/525h6p6oGBpJ/2cmJBgIKjvUrgUj/VE221R3KQK4f1bi8\n7D1Q+OHraGeB3J+n5gqt0XT2/1oMeoJn+kvS7QTC+whgz9iPqHJXu/wtLHgb\na0lwvHQ6maeULG1XebYGcLkwcAHqrR1zT9Zfn7LAVrChqn9iqK69OqQ/Whtv\nl1VNnoXsdSIH1P9w/YRSzxcW1enIhREXO01eHowwbrEHVUeY6LqYPEnsdT3c\neFhMy5BmOeDb3yTc0g6p3dlLCH1dyeIWQCfO8x2l0raiZVB3evur5JbUyRqt\nyBrxGe29APW0fmDj4zQxpWEX2XNPYwr198JxrBvgRa7oeq2wOOPheX9+nnql\n8ZqOxib+2e08pzEG99WS9H4Rw5RjBaGcO+f+vuSt3Nl0Alra6q6xvD8zIGRm\nD7cTNWtdPoPVcCB4qHuym7CFeQe7mEzL3qDOUish3WPTfZjMTfiKNvrdmXSq\nqgAVBCVZ9iUN7osr1tl16S0gFTcjEUqD7tz1tKhRZuNTYrw4FRpJmwo6JvsK\n5bNFxd1xwvpF5FRYi+yHPxuJYPxRdUDeWXnPWBFL61/blp16LRCukaeqbSyp\nNpMrJePn+F/s0b9Mpq1ZD/TxK+CgGNzdY3SGQ/6Nru7XnHGYUQDlwQIYgZJt\nr9vK\r\n=jA8l\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQDU+16eU9gT5oBXWUqBPxHn5EHC52MEXwQJg0eXJfOpVgIhAMFhUWa0BxZ3IAR42Ip082Wohqh8Xr6vWI5gUVVPqQ5f"}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.4.5_1622468456996_0.8891622338008778"},"_hasShrinkwrap":false},"0.0.0-2021-05-31--14-38":{"name":"opentelemetry-instrumentation-express","version":"0.0.0-2021-05-31--14-38","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn run build","test":"mocha","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"dependencies":{"@opentelemetry/api":"^1.0.0-rc.0","@opentelemetry/instrumentation":"^0.19.0","@opentelemetry/semantic-conventions":"^0.19.0"},"devDependencies":{"@opentelemetry/instrumentation-http":"^0.19.0","@opentelemetry/tracing":"^0.19.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","test-all-versions":"^5.0.1"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":"ts-node/register"},"gitHead":"bd5bce12191c8173f30d62733cb45d2dc0feb610","readme":"# OpenTelemetry express Instrumentation for Node.js\n[![NPM version](https://img.shields.io/npm/v/opentelemetry-instrumentation-express.svg)](https://www.npmjs.com/package/opentelemetry-instrumentation-express)\n\nThis module provide enhanced instrumentation for the `express` web framework.\n\n## Installation\n\n```\nnpm install --save opentelemetry-instrumentation-express\n```\n## Supported Versions\nThis instrumentation supports `^4.9.0`:\n\nall versions >= `4.9.0` (released 2014) and < `5.0.0` (in alpha).\n\n## Usage\nFor further automatic instrumentation instruction see the [@opentelemetry/instrumentation](https://github.com/open-telemetry/opentelemetry-js/tree/main/packages/opentelemetry-instrumentation) package.\n\n```js\nconst { NodeTracerProvider } = require('@opentelemetry/node');\nconst { registerInstrumentations } = require('@opentelemetry/instrumentation');\nconst { ExpressInstrumentation } = require('opentelemetry-instrumentation-express');\n\nconst traceProvider = new NodeTracerProvider();\ntraceProvider.register();\n\nregisterInstrumentations({\n  traceProvider,\n  instrumentations: [\n    new ExpressInstrumentation()\n  ]\n});\n```\n\n### Express Instrumentation Options\n\nExpress instrumentation has few options available to choose from. You can set the following:\n\n| Options | Type  | Description |\n| --- | --- | --- |\n| `requestHook` | `RequestHook` (function) | Hook for adding custom attributes before express start handling the request. Receives params: `span, { moduleVersion, req, res }` |\n| `includeHttpAttributes` | `boolean` | If set to true, plugin will include semantic http attributes in each express span |\n\n## Semantic Behavior\nExpress auto instrumentation will create a single span per request with the following attributes.\nDetailed specification and cases can be found [here](./doc/attributes-specification.MD).\n\n### `http.route`\nThis is a conventional http attribute, which is collected by express instead of the http module (which is not aware of the route). It will always contain path-parameterized data with low cardinality (no ids), but might be missing parts of the path in case of early termination or middlewares that accept any path.\n\nExample: `/api/users/:id`\n\n### `express.route.full`\nThis attribute will always contain the entire path. The part of the path that has been consumed by express will be shown as is (parameterized), and the leftover will be concatenated after (due to early termination or middleware that accept any path).\n\nExample: `/api/users/:id/books/758734` (The `:id` part was consumed, but the `bookid` part was not).\n\n### `express.route.configured`\nThis attribute is relevant when user configures multi path options for the same middleware. It reduces even further the cardinality space compared to `http.route`, and supply more info about how the app routing works.\n\nExample: `/api[\"/foo\", /\"bar\"]` - meaning that the same endpoint is triggered by routes `/api/foo` and `/api/bar`.\n\n### `express.route.params`\nThis attribute holds a json stringified map, where the keys are the url path param names, and the values are the matched params from the actual url.\n\nExample: `{\"id\":\"1234\"}`. \n\n### `express.unhandled`\nSet to true when request was not handled by any middleware in express, and got fallback to the default app `finalhandler`. This can happen if client sent request with invalid path or method (resulting in 404). This can be useful to filter out requests from internet bots which try to call common routes on servers.\n\n### `express.instrumentation.errors`\nIn case of internal error in instrumentation, this attribute will contain the error description. There are no known valid use cases which are expected to produce this attribute.\n\n## Difference from [@opentelemetry/instrumentation-express](https://github.com/open-telemetry/opentelemetry-js-contrib/tree/main/plugins/node/opentelemetry-instrumentation-express)\n\n* This instrumentation is focusing on extracting the most accurate and complete `route` data, in any valid express edge case. Contrib instrumentation does a good job for common cases, but miss nuances on complex setups.\n* This instrumentation create a single span per request. Contrib instrumentation creates span per express Router/Route, which can be useful to observe express internal components, with the cost of more spans in each trace.\n* Set few alternatives for route attribute, each with different level of cardinality vs accuracy.\n* Allows to set `requestHook` for adding custom attributes to span, as well as ability to capture express version into user defined attribute.\n* Distinguish between handled requests (ended from user middleware), and unhandled (terminated from express built in 'finalhandler').\n* Option to conform with the [Semantic conventions for HTTP spans](https://github.com/open-telemetry/opentelemetry-specification/blob/master/specification/trace/semantic_conventions/http.md).\n\n\n---\n\nThis extension (and many others) was developed by [Aspecto](https://www.aspecto.io/) with ❤️","readmeFilename":"README.md","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.0.0-2021-05-31--14-38","_nodeVersion":"12.22.1","_npmVersion":"lerna/3.22.1/node@v12.22.1+x64 (linux)","dist":{"integrity":"sha512-sUCaLHC0mu4v2Dvhu4oU0m2PsPX+7ffdNNlbORF/FjyZZEXHYtRGAA7ZLkHJSDg57oLnGHXfZqdmOMrusAVo0Q==","shasum":"de23e8f7ef4f9332dff094234d9f5a76fd35ad0a","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.0.0-2021-05-31--14-38.tgz","fileCount":18,"unpackedSize":51183,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJgtPUtCRA9TVsSAnZWagAAtXMP/0q/wbRF+NvrgyqdriEc\nKUFPXuj6rsENWGyRJ9Gs2fAjvT7nLUtZwmhlkKLAQBpp4zdTIj7/I7dD891k\n4WCedmkUbZRQDXSOBLJ4vBApKCsBkinl5hVhHhnYjAnNC6Fr5XoJ0xNUn93s\nZIUkH776dK+zks6QTIwSBjWpkjNXcLkv7WRgwWpv3ijZBUCwxF3Na9ew1a9H\npyto8iMDVsEIL2dW03IaTcGJIUHzFD8m0HH8Y73TqKzfuvrDxA8pXYz67rJg\ntLyLtcyI0GO8vJ1muVkR1k6P9o1oG4R7Cmeev3rkcVh3DfutDDG/jmtqWjCj\nVsEtOTDVld/uZTmcyQJlCUnBk2R5lZaENW8VAqqyxfUBs7CP/dkovFlhssuI\nwBxqkSMy3SWvNLWtMdxjl+5DZtUulHyjwLm3dFo8S6RzT6cSh3a6gKtiQGea\nir/tF5gRqbV9O/cPWeK1CHIwBgnLwUHcTbFA9CtKlAROpNR9a5F+lcBjeG26\nFmxuo1MJ2iYUkIv+DM3hXA6wqNmYMK/Jc14Ev9oSkB/yHifaQc7wW04Zk/Ri\nO5qBmcj8w1yJNozzyiBMwQD8BIWUb3nYa8c/rhyDBTrZUvcs5X8cc5nsfBIz\nKN1Le81Uas5rnsR+VEBeT60LtpB8oUV14pkT2FHtofiKJ/XOZzI3KR3GDwi+\nwvZ8\r\n=YSbl\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQDHayKhsDdPC+/V/88tZIJU3euTHuBssnMJ1Dp/2CFxfQIhAPLiAq1aZSuZGtPPgyXl9z4wPL6/Hotf9EmGnBKbu26E"}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.0.0-2021-05-31--14-38_1622471980565_0.6479961058548995"},"_hasShrinkwrap":false},"0.4.6":{"name":"opentelemetry-instrumentation-express","version":"0.4.6","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn run build","test":"mocha --require opentelemetry-instrumentation-testing-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require opentelemetry-instrumentation-testing-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"dependencies":{"@opentelemetry/api":"^1.0.0-rc.0","@opentelemetry/instrumentation":"^0.19.0","@opentelemetry/semantic-conventions":"^0.19.0"},"devDependencies":{"@opentelemetry/instrumentation-http":"^0.19.0","@opentelemetry/tracing":"^0.19.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"^0.0.1-rc.0","opentelemetry-instrumentation-testing-utils":"^0.4.1","test-all-versions":"^5.0.1"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"909b2e07091c7a7e88e29438f936bb30b6416c1f","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.4.6","_nodeVersion":"12.22.1","_npmVersion":"lerna/3.22.1/node@v12.22.1+x64 (linux)","dist":{"integrity":"sha512-6Bxp0SGnTmf+mCwDI0eXJ1LLUJdunA8Qcbly/CcsVDUCPhKek9Kh+VLk2ip8b9fHltSWv2ZEqK/EPtbJo0M9Lw==","shasum":"1a4d5f54e5bd822b69f3d472211c85da8353d564","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.4.6.tgz","fileCount":18,"unpackedSize":51771,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJgt25hCRA9TVsSAnZWagAATOcP/2Z83PjMliOw6OhL8ltP\nMOU/NrgCFhAgQ7xX7GqZMyQ1UtHPww/Q5qDEK04ZPtS72dhbBGorgHuqw9nD\nbmUPx1usVop95axyJBPtpONjjroudBSMMRfdN4D8AtKCiETK96SfVv99HvIt\n3UVmX62jLkOf0lvhfWiMaK4qjPFU25efjsfEnMHEtVNaySXTOezbQ3leI75g\n1vUGYxiOfAiECMb2DU8QLsGiqr2KdufNwpyB6QNEJxrFyqjyjUixU0BMwYPJ\nbXtNE+IsZ2x4E8rbt+MkWx3X5NOn/NRI0okjNrTIt5ewYjNQfmLjau5RCs3I\nUHm/kjPPtdXmYY4ll9zL5oNkZ27abAHp++oMaBPPsBRVNoNjfszXGazYHhRC\nVOUJtAAn/CSS1KA5WQ41XXzSnof8sUxibp5MeymyKGJXwc6G2YybnNutODB+\n0qbT+IJAkuyXdY4bR8pMKVq2fGS9XSFrSsUeLVxQMtj2Ztn7FJjOHLIBZnzR\nXhpeEoUOFXFRXMCnwYJ9p5dSrvqbK12oVG4qushz68MJR+PT3Eev7Qfwm0wl\nIKyrqBDqzg7SxMzrJA3Ksi4D9au3ITeKfaWH48LdW+0xmbJVBMizMt0PhcIQ\nWa5GnjqSmBMTT2zUlByEiDYLXt21QsiVfI4bjzsVhzWgo8cnSEGkdjDi2IeC\nTgmA\r\n=xA3c\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQC1+eikq/9f2JPfDRCToFw3IPsmielEpXYJD6juJpgL3QIhAOW/RiZl92ZaEICPNtYpQYNW3AG9h4h6WMhsX66b+Q/k"}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.4.6_1622634080648_0.4045593295832277"},"_hasShrinkwrap":false},"0.0.0-2021-06-07--07-42":{"name":"opentelemetry-instrumentation-express","version":"0.0.0-2021-06-07--07-42","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn run build","test":"mocha --require opentelemetry-instrumentation-testing-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require opentelemetry-instrumentation-testing-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"dependencies":{"@opentelemetry/api":"^0.20.0","@opentelemetry/instrumentation":"^0.20.0","@opentelemetry/semantic-conventions":"^0.20.0"},"devDependencies":{"@opentelemetry/instrumentation-http":"^0.20.0","@opentelemetry/tracing":"^0.20.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"^0.0.1-rc.0","opentelemetry-instrumentation-testing-utils":"^0.0.0-2021-06-07--07-42","test-all-versions":"^5.0.1"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"bb0e4af3e4a101755c22fdb692be07a6ddeef51d","readme":"# OpenTelemetry express Instrumentation for Node.js\n[![NPM version](https://img.shields.io/npm/v/opentelemetry-instrumentation-express.svg)](https://www.npmjs.com/package/opentelemetry-instrumentation-express)\n\nThis module provide enhanced instrumentation for the `express` web framework.\n\n## Installation\n\n```\nnpm install --save opentelemetry-instrumentation-express\n```\n## Supported Versions\nThis instrumentation supports `^4.9.0`:\n\nall versions >= `4.9.0` (released 2014) and < `5.0.0` (in alpha).\n\n## Usage\nFor further automatic instrumentation instruction see the [@opentelemetry/instrumentation](https://github.com/open-telemetry/opentelemetry-js/tree/main/packages/opentelemetry-instrumentation) package.\n\n```js\nconst { NodeTracerProvider } = require('@opentelemetry/node');\nconst { registerInstrumentations } = require('@opentelemetry/instrumentation');\nconst { ExpressInstrumentation } = require('opentelemetry-instrumentation-express');\n\nconst traceProvider = new NodeTracerProvider();\ntraceProvider.register();\n\nregisterInstrumentations({\n  traceProvider,\n  instrumentations: [\n    new ExpressInstrumentation()\n  ]\n});\n```\n\n### Express Instrumentation Options\n\nExpress instrumentation has few options available to choose from. You can set the following:\n\n| Options | Type  | Description |\n| --- | --- | --- |\n| `requestHook` | `RequestHook` (function) | Hook for adding custom attributes before express start handling the request. Receives params: `span, { moduleVersion, req, res }` |\n| `includeHttpAttributes` | `boolean` | If set to true, plugin will include semantic http attributes in each express span |\n\n## Semantic Behavior\nExpress auto instrumentation will create a single span per request with the following attributes.\nDetailed specification and cases can be found [here](./doc/attributes-specification.MD).\n\n### `http.route`\nThis is a conventional http attribute, which is collected by express instead of the http module (which is not aware of the route). It will always contain path-parameterized data with low cardinality (no ids), but might be missing parts of the path in case of early termination or middlewares that accept any path.\n\nExample: `/api/users/:id`\n\n### `express.route.full`\nThis attribute will always contain the entire path. The part of the path that has been consumed by express will be shown as is (parameterized), and the leftover will be concatenated after (due to early termination or middleware that accept any path).\n\nExample: `/api/users/:id/books/758734` (The `:id` part was consumed, but the `bookid` part was not).\n\n### `express.route.configured`\nThis attribute is relevant when user configures multi path options for the same middleware. It reduces even further the cardinality space compared to `http.route`, and supply more info about how the app routing works.\n\nExample: `/api[\"/foo\", /\"bar\"]` - meaning that the same endpoint is triggered by routes `/api/foo` and `/api/bar`.\n\n### `express.route.params`\nThis attribute holds a json stringified map, where the keys are the url path param names, and the values are the matched params from the actual url.\n\nExample: `{\"id\":\"1234\"}`. \n\n### `express.unhandled`\nSet to true when request was not handled by any middleware in express, and got fallback to the default app `finalhandler`. This can happen if client sent request with invalid path or method (resulting in 404). This can be useful to filter out requests from internet bots which try to call common routes on servers.\n\n### `express.instrumentation.errors`\nIn case of internal error in instrumentation, this attribute will contain the error description. There are no known valid use cases which are expected to produce this attribute.\n\n## Difference from [@opentelemetry/instrumentation-express](https://github.com/open-telemetry/opentelemetry-js-contrib/tree/main/plugins/node/opentelemetry-instrumentation-express)\n\n* This instrumentation is focusing on extracting the most accurate and complete `route` data, in any valid express edge case. Contrib instrumentation does a good job for common cases, but miss nuances on complex setups.\n* This instrumentation create a single span per request. Contrib instrumentation creates span per express Router/Route, which can be useful to observe express internal components, with the cost of more spans in each trace.\n* Set few alternatives for route attribute, each with different level of cardinality vs accuracy.\n* Allows to set `requestHook` for adding custom attributes to span, as well as ability to capture express version into user defined attribute.\n* Distinguish between handled requests (ended from user middleware), and unhandled (terminated from express built in 'finalhandler').\n* Option to conform with the [Semantic conventions for HTTP spans](https://github.com/open-telemetry/opentelemetry-specification/blob/master/specification/trace/semantic_conventions/http.md).\n\n\n---\n\nThis extension (and many others) was developed by [Aspecto](https://www.aspecto.io/) with ❤️","readmeFilename":"README.md","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.0.0-2021-06-07--07-42","_nodeVersion":"12.22.1","_npmVersion":"lerna/3.22.1/node@v12.22.1+x64 (linux)","dist":{"integrity":"sha512-pDLDCm8ZwiStVSV8HWv8IqVaNlrR3cQr7CsO+P/78t74rqVM3pmw0xPInWE+QJEk+Bzla4ctt7xqWLrI1uIFAg==","shasum":"8a4534f2c6323cbe4447cb139d301026c85199bc","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.0.0-2021-06-07--07-42.tgz","fileCount":18,"unpackedSize":51839,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJgvc4nCRA9TVsSAnZWagAAd1oQAKK3eYPiiuisXg61xA+7\nHRXjWQXTGeXzGJbU1cpN6ICvACkLnbDNbo+cPCwrFFrR7AptkPlZ7gAV+o3l\ncfk4nP/bhs07pWQ9u9/5FUX88t1ZasBUoCYajE1YiH0wJDw44sp7Ee3h/O39\nS71VDy0s3V3YdNnpU3ZVR+UDaoc8AUc8nBY16Sht4hwBnIaBtau2c8Kyc18y\nqLwrvPcwTDHpmqPQbjRytMQHEcPDz7pePuIArqmCDe3jmj0T6LtBuQUN9OXr\n8JrFzXqbQXhMnN1n6mBJ4oTlP+A8PDkby353uRyNAsNRQFXhUoFEsDc/Xikq\num7a8STKb3hTWkoe4STS7AGRGRhetdZarid4zd/JA9PVf7dcCzaDyijDIXK+\naCnXOm/BPOODXPcy8cmVVv4cEmZH5C+qCmXsNbw85uU/31nAVlkyV3g+mHkw\nyGaUan3f32gJXBXKuLh+Tz8Os5zH1XevjUwFyx0Wd0BuK+yWLZtpkV94IVSL\nbt+ogootylzr63BHJjES2/la9CQPOYxPSSadB1UWrviaGxvGZuXY0d+bl+NZ\nuY1/QwZhfemiKwXfxwzQxF1XjXFOkShCzsNHVhsOBNyZEHCrytCZ4oNwz3og\n17QQFjWjIY2vpmDBnFXkv4wux1vA9cV5Ai4UQmU3NktW6nA1KZk+m/lB2cOT\nACi8\r\n=0mgh\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIG8X0F9+jIMyDd5xBcCDFETUboLRDzT4QhYjJzCX2iJOAiA9OJTIDXlSDwaEzdiEXYSemBEr2fz0uaIgo21OJNrPXg=="}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.0.0-2021-06-07--07-42_1623051815365_0.8824122108866848"},"_hasShrinkwrap":false},"0.0.0-2021-06-09--06-50":{"name":"opentelemetry-instrumentation-express","version":"0.0.0-2021-06-09--06-50","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn run build","test":"mocha --require opentelemetry-instrumentation-testing-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require opentelemetry-instrumentation-testing-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"dependencies":{"@opentelemetry/api":"^0.20.0","@opentelemetry/core":"^0.20.0","@opentelemetry/instrumentation":"^0.20.0","@opentelemetry/semantic-conventions":"^0.20.0"},"devDependencies":{"@opentelemetry/instrumentation-http":"^0.20.0","@opentelemetry/tracing":"^0.20.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"^0.0.1-rc.1","opentelemetry-instrumentation-testing-utils":"^0.0.0-2021-06-09--06-50","test-all-versions":"^5.0.1"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"89781f894dff1488c9794fd361dea0b63f4c9be3","readme":"# OpenTelemetry express Instrumentation for Node.js\n[![NPM version](https://img.shields.io/npm/v/opentelemetry-instrumentation-express.svg)](https://www.npmjs.com/package/opentelemetry-instrumentation-express)\n\nThis module provide enhanced instrumentation for the `express` web framework.\n\n## Installation\n\n```\nnpm install --save opentelemetry-instrumentation-express\n```\n## Supported Versions\nThis instrumentation supports `^4.9.0`:\n\nall versions >= `4.9.0` (released 2014) and < `5.0.0` (in alpha).\n\n## Usage\nFor further automatic instrumentation instruction see the [@opentelemetry/instrumentation](https://github.com/open-telemetry/opentelemetry-js/tree/main/packages/opentelemetry-instrumentation) package.\n\n```js\nconst { NodeTracerProvider } = require('@opentelemetry/node');\nconst { registerInstrumentations } = require('@opentelemetry/instrumentation');\nconst { ExpressInstrumentation } = require('opentelemetry-instrumentation-express');\n\nconst traceProvider = new NodeTracerProvider();\ntraceProvider.register();\n\nregisterInstrumentations({\n  traceProvider,\n  instrumentations: [\n    new ExpressInstrumentation()\n  ]\n});\n```\n\n### Express Instrumentation Options\n\nExpress instrumentation has few options available to choose from. You can set the following:\n\n| Options | Type  | Description |\n| --- | --- | --- |\n| `requestHook` | `RequestHook` (function) | Hook for adding custom attributes before express start handling the request. Receives params: `span, { moduleVersion, req, res }` |\n| `includeHttpAttributes` | `boolean` | If set to true, plugin will include semantic http attributes in each express span |\n\n## Semantic Behavior\nExpress auto instrumentation will create a single span per request with the following attributes.\nDetailed specification and cases can be found [here](./doc/attributes-specification.MD).\n\n### `http.route`\nThis is a conventional http attribute, which is collected by express instead of the http module (which is not aware of the route). It will always contain path-parameterized data with low cardinality (no ids), but might be missing parts of the path in case of early termination or middlewares that accept any path.\n\nExample: `/api/users/:id`\n\n### `express.route.full`\nThis attribute will always contain the entire path. The part of the path that has been consumed by express will be shown as is (parameterized), and the leftover will be concatenated after (due to early termination or middleware that accept any path).\n\nExample: `/api/users/:id/books/758734` (The `:id` part was consumed, but the `bookid` part was not).\n\n### `express.route.configured`\nThis attribute is relevant when user configures multi path options for the same middleware. It reduces even further the cardinality space compared to `http.route`, and supply more info about how the app routing works.\n\nExample: `/api[\"/foo\", /\"bar\"]` - meaning that the same endpoint is triggered by routes `/api/foo` and `/api/bar`.\n\n### `express.route.params`\nThis attribute holds a json stringified map, where the keys are the url path param names, and the values are the matched params from the actual url.\n\nExample: `{\"id\":\"1234\"}`. \n\n### `express.unhandled`\nSet to true when request was not handled by any middleware in express, and got fallback to the default app `finalhandler`. This can happen if client sent request with invalid path or method (resulting in 404). This can be useful to filter out requests from internet bots which try to call common routes on servers.\n\n### `express.instrumentation.errors`\nIn case of internal error in instrumentation, this attribute will contain the error description. There are no known valid use cases which are expected to produce this attribute.\n\n## Difference from [@opentelemetry/instrumentation-express](https://github.com/open-telemetry/opentelemetry-js-contrib/tree/main/plugins/node/opentelemetry-instrumentation-express)\n\n* This instrumentation is focusing on extracting the most accurate and complete `route` data, in any valid express edge case. Contrib instrumentation does a good job for common cases, but miss nuances on complex setups.\n* This instrumentation create a single span per request. Contrib instrumentation creates span per express Router/Route, which can be useful to observe express internal components, with the cost of more spans in each trace.\n* Set few alternatives for route attribute, each with different level of cardinality vs accuracy.\n* Allows to set `requestHook` for adding custom attributes to span, as well as ability to capture express version into user defined attribute.\n* Distinguish between handled requests (ended from user middleware), and unhandled (terminated from express built in 'finalhandler').\n* Option to conform with the [Semantic conventions for HTTP spans](https://github.com/open-telemetry/opentelemetry-specification/blob/master/specification/trace/semantic_conventions/http.md).\n\n\n---\n\nThis extension (and many others) was developed by [Aspecto](https://www.aspecto.io/) with ❤️","readmeFilename":"README.md","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.0.0-2021-06-09--06-50","_nodeVersion":"12.22.1","_npmVersion":"lerna/3.22.1/node@v12.22.1+x64 (linux)","dist":{"integrity":"sha512-Yy/s5QKcHk9ddVNv3ZVF0Tkat4ymA7+uu887UuQm5DVeb/dcSx5Mxxo54dOrx2EN6xUbblogHGzfk0VcmdCpwg==","shasum":"2215a90523cdde453ff5ab2c295cb30e016cab59","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.0.0-2021-06-09--06-50.tgz","fileCount":18,"unpackedSize":52075,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJgwGTSCRA9TVsSAnZWagAASxkP/37CTkjltJ70rMhFXvaE\nE31qc9PKUhwY2TljnnOmex6ZXw6BxURK5YKC56RN7I256GizsdgGR6N+tvJQ\n4jOmUSv03O+8AVMKrDdl0JLQzJy07XHJ/zT/DjCdUFIwvS9LNQ9+PmGeWNsz\nF1m3W/72emuWR4pjAvr+rw2VuiNJ953e/WfmZK08RuNF77OdHamMXkpYXlxp\nqSEYH6b5/QKb9d8y/8LGQj4ENPMyXdM8+toscOB8s9MCL+UngyWBd98vEO02\nU8qGwWR8gi1+/Li431TsUuio7soNYG1Vu8MiC55eNA0uElPDKqviFTdU1r1/\n/D+ANjegDwC/pRUhhNXbv/OfsbV4K40j6ChGUjseltVDD5eD0260Dq5Jqx+0\nEKc8HuCsXJpN8M5J+Ffi/9P2P07maSTs1qJAnVWMqFIb7XNp63z5JnqXMTOy\nH/QmfLLA+86yqyzGH+cHjCdiNmprY0rVgWDNICy1qYvpbXoMopabQtOytw3w\nuOH8Z8R0Dfcb54cSjotdeD34mFjy6w83fV2CK36Y/5XTufkWAOqPwFo1UFIJ\ne8dooihjnM2TK9t7ss47lQWCdWfNJOrvO4wHUoE/RvkDV3TglPibnInUcbV6\nF1qdLBZ2CG8YYtVBaJUc6qhqYeJDs+qiX4UM8ICl5IvLC5IKSfSRuUDKgsxg\nk2hY\r\n=nkeV\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQD6EdB0RvOnSoPUpCwRqTw41VvJGOYp10CCqCBICnQ7ywIgdFz21sTRbVYZJAJV8SQsp7ODX9rF7C/O0HNGD5L3SXY="}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.0.0-2021-06-09--06-50_1623221458673_0.5732598676766532"},"_hasShrinkwrap":false},"0.5.0":{"name":"opentelemetry-instrumentation-express","version":"0.5.0","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn run build","test":"mocha --require opentelemetry-instrumentation-testing-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require opentelemetry-instrumentation-testing-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"dependencies":{"@opentelemetry/api":"^0.20.0","@opentelemetry/core":"^0.20.0","@opentelemetry/instrumentation":"^0.20.0","@opentelemetry/semantic-conventions":"^0.20.0"},"devDependencies":{"@opentelemetry/instrumentation-http":"^0.20.0","@opentelemetry/tracing":"^0.20.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"^0.0.1-rc.1","opentelemetry-instrumentation-testing-utils":"^0.5.0","test-all-versions":"^5.0.1"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"5d2d40dae3dde329743437740a7987ac53e7814d","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.5.0","_nodeVersion":"12.22.1","_npmVersion":"lerna/3.22.1/node@v12.22.1+x64 (linux)","dist":{"integrity":"sha512-gOt5UWWH947NGRcJw2kTPPmN1e7kVKdRYJbNJnuZKYIR9irxMto7jOiiSSSsZxj+RTvlZ+io/XKK98aONjQ/Vg==","shasum":"cd6e67cee5930a627c4b553dfca5fbb3d494e92b","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.5.0.tgz","fileCount":18,"unpackedSize":52260,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJgwIX7CRA9TVsSAnZWagAA+zQP+wTZ80xd2cKaxfTxy3NL\nSx0OPsdj34L62u0vy+KrsFlhcZwu483aJVjUhjUlw9/tAe+ZL01HdJ6SvT2N\ngmxGMTOMrMZAIgQDjmi8d6DgsManObBAWLOpDaI8heyqnxk4UsfnPBK0PB3s\nfpo8TXUie/gFh3gv9fAo7yu6v/5bwALUR6OyzpHtEv41c/UYFDNFDuYVwCfg\ntnSiZv6F4u86oWAUjU5GKkuiZxHaj+nbKbCtpEwyoQ/RQ5nDeOUXfFWD/HDm\nOmrl8YFk3XEKrCH4xwenb146BfTSpx2v04SinwMmxKtf+i+dd697IBiUiFUw\ndgW9psjCwece2LVLoWV5PrLnbFQerBlYheLEnidUdUAVY9qOILrTrDoO64vv\nwEJ7vHqR0HQy51XR3UkSiibKV+Sqh8F0Kux1HReYVpqxl77wk8Ay9kbjiIfh\n2BzyNtefBreinHBk3ym2NYnVBu6fs8DyNNZzIqZ6LCOw3kjgFEGzHwSeCvs7\nQ8P0tfo3z5oNoyKXYvRIKfbQmoo/axH659PIs3k4xi5HxuZJycPzsUaY7nF2\nLF32lhFcnOQVIBPGVDSBHQNTgWVpjNJuDn4SDn+Fnq0/LGuGMAufWuvr3+kd\nLOI3+zTCT2HlpCFoIeLZ4LinbsDnf9Pzzd8iDOM77IktjaWC/2JVG6H0tfVe\nONG+\r\n=hVcW\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQDDK5PUC8zpeKn9p9slo8zub/G6vQzsxrGHHFTYd/BGewIgb/2M8vmjCKMMHJlJmFEkIW3JetDdu7Tg3b24rBiaoGY="}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.5.0_1623229947461_0.04484319984536156"},"_hasShrinkwrap":false},"0.0.0-2021-06-14--13-06":{"name":"opentelemetry-instrumentation-express","version":"0.0.0-2021-06-14--13-06","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn run build","test":"mocha --require opentelemetry-instrumentation-testing-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require opentelemetry-instrumentation-testing-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"dependencies":{"@opentelemetry/api":"^0.20.0","@opentelemetry/core":"^0.20.0","@opentelemetry/instrumentation":"^0.20.0","@opentelemetry/semantic-conventions":"^0.20.0"},"devDependencies":{"@opentelemetry/instrumentation-http":"^0.20.0","@opentelemetry/tracing":"^0.20.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"^0.0.1-rc.1","opentelemetry-instrumentation-testing-utils":"^0.0.0-2021-06-14--13-06","test-all-versions":"^5.0.1"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"7c1bec0d45e4e1729da931048881068dd80a4b90","readme":"# OpenTelemetry express Instrumentation for Node.js\n[![NPM version](https://img.shields.io/npm/v/opentelemetry-instrumentation-express.svg)](https://www.npmjs.com/package/opentelemetry-instrumentation-express)\n\nThis module provide enhanced instrumentation for the `express` web framework.\n\n## Installation\n\n```\nnpm install --save opentelemetry-instrumentation-express\n```\n## Supported Versions\nThis instrumentation supports `^4.9.0`:\n\nall versions >= `4.9.0` (released 2014) and < `5.0.0` (in alpha).\n\n## Usage\nFor further automatic instrumentation instruction see the [@opentelemetry/instrumentation](https://github.com/open-telemetry/opentelemetry-js/tree/main/packages/opentelemetry-instrumentation) package.\n\n```js\nconst { NodeTracerProvider } = require('@opentelemetry/node');\nconst { registerInstrumentations } = require('@opentelemetry/instrumentation');\nconst { ExpressInstrumentation } = require('opentelemetry-instrumentation-express');\n\nconst traceProvider = new NodeTracerProvider();\ntraceProvider.register();\n\nregisterInstrumentations({\n  traceProvider,\n  instrumentations: [\n    new ExpressInstrumentation()\n  ]\n});\n```\n\n### Express Instrumentation Options\n\nExpress instrumentation has few options available to choose from. You can set the following:\n\n| Options | Type  | Description |\n| --- | --- | --- |\n| `requestHook` | `RequestHook` (function) | Hook for adding custom attributes before express start handling the request. Receives params: `span, { moduleVersion, req, res }` |\n| `includeHttpAttributes` | `boolean` | If set to true, plugin will include semantic http attributes in each express span |\n\n## Semantic Behavior\nExpress auto instrumentation will create a single span per request with the following attributes.\nDetailed specification and cases can be found [here](./doc/attributes-specification.MD).\n\n### `http.route`\nThis is a conventional http attribute, which is collected by express instead of the http module (which is not aware of the route). It will always contain path-parameterized data with low cardinality (no ids), but might be missing parts of the path in case of early termination or middlewares that accept any path.\n\nExample: `/api/users/:id`\n\n### `express.route.full`\nThis attribute will always contain the entire path. The part of the path that has been consumed by express will be shown as is (parameterized), and the leftover will be concatenated after (due to early termination or middleware that accept any path).\n\nExample: `/api/users/:id/books/758734` (The `:id` part was consumed, but the `bookid` part was not).\n\n### `express.route.configured`\nThis attribute is relevant when user configures multi path options for the same middleware. It reduces even further the cardinality space compared to `http.route`, and supply more info about how the app routing works.\n\nExample: `/api[\"/foo\", /\"bar\"]` - meaning that the same endpoint is triggered by routes `/api/foo` and `/api/bar`.\n\n### `express.route.params`\nThis attribute holds a json stringified map, where the keys are the url path param names, and the values are the matched params from the actual url.\n\nExample: `{\"id\":\"1234\"}`. \n\n### `express.unhandled`\nSet to true when request was not handled by any middleware in express, and got fallback to the default app `finalhandler`. This can happen if client sent request with invalid path or method (resulting in 404). This can be useful to filter out requests from internet bots which try to call common routes on servers.\n\n### `express.instrumentation.errors`\nIn case of internal error in instrumentation, this attribute will contain the error description. There are no known valid use cases which are expected to produce this attribute.\n\n## Difference from [@opentelemetry/instrumentation-express](https://github.com/open-telemetry/opentelemetry-js-contrib/tree/main/plugins/node/opentelemetry-instrumentation-express)\n\n* This instrumentation is focusing on extracting the most accurate and complete `route` data, in any valid express edge case. Contrib instrumentation does a good job for common cases, but miss nuances on complex setups.\n* This instrumentation create a single span per request. Contrib instrumentation creates span per express Router/Route, which can be useful to observe express internal components, with the cost of more spans in each trace.\n* Set few alternatives for route attribute, each with different level of cardinality vs accuracy.\n* Allows to set `requestHook` for adding custom attributes to span, as well as ability to capture express version into user defined attribute.\n* Distinguish between handled requests (ended from user middleware), and unhandled (terminated from express built in 'finalhandler').\n* Option to conform with the [Semantic conventions for HTTP spans](https://github.com/open-telemetry/opentelemetry-specification/blob/master/specification/trace/semantic_conventions/http.md).\n\n\n---\n\nThis extension (and many others) was developed by [Aspecto](https://www.aspecto.io/) with ❤️","readmeFilename":"README.md","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.0.0-2021-06-14--13-06","_nodeVersion":"12.22.1","_npmVersion":"lerna/3.22.1/node@v12.22.1+x64 (linux)","dist":{"integrity":"sha512-ZnSqkIxTrJna1QNv5Z6fEysZzh9egpy2DCvJdIbH/h7nm283p6FUD6rwp+VttT91yXMEmItBEtglq0R3rYur+w==","shasum":"d94b81b1ae726cd603ddb9dda46c0e8ac32ed750","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.0.0-2021-06-14--13-06.tgz","fileCount":18,"unpackedSize":52332,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJgx1R2CRA9TVsSAnZWagAAiIYQAJnTuNYqFt5cynaSGmjd\nwBp6Ly9/kkb8itUD2vjcNK3eXaqFRmQ3Ao7HA7tsx0j4Od7h9DE1v+3VTJ3O\nPD9t6wv+A+X2SN4Py+4TNCF5t+GWIKgYa4thJRqiFN/tPa+HsCFhDeH9TPvU\nj/NuJtL3ryWm7ZSaLBE+otngTDR7uDNBzdhDzWBIwR2CYBItwCq7dR319kvF\nIirrqOgLE3k/4T2G465C9Hj6KQqD0NniXxNBy/Vk6f6B7IdQc9VUGIfghZkw\nAfXecj/VpZiqIzm+ATH7l8+lUPQVvm+afglhDWTfxb9MPyjr9eNfJGCA6YW/\nzQrkQcg6jz5ALqhCkAVLQ8yOVk63JfHneZzl4ZszSlo42lrTlVFlp4RSOjH3\nhcEvjL7EnroFYFzY/8O89m7Ht/U35s8SKKuvTGaMf47CshrgEkXsCBtbiGP/\n90dSHVvxlbhT9Df7o9/STppW3X4F4X9ljzH6kJ05dxX6vkA+Rq4A7veOmJJE\nfc2W/2IGtPyKUrsL/UY2pI9d+ngAhpSoxPiILRxl0f6dvWpwTVj5EoujAAr9\nbq5wwoEsYN4isu3inZ7wwO/AWRKPz57S+eZ0aA6GG1LzyxZLzeL4uBYN2vxc\nrkmMhytG6KB/zyfoY19rZyt10Ueg2Qyl+wiF0pJ8zpp0xp15EO6THRJfy7jz\nDFIr\r\n=evWN\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQCvmw5nEDC6Z+9S+8tvH0gk5lldMCaEJzz8+C8HAgy/KgIgS9bi2BuFii868+1QR/iHH5Nl23px0VCMZu4+x2Tb0Qw="}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.0.0-2021-06-14--13-06_1623676022647_0.6945677738594147"},"_hasShrinkwrap":false},"0.5.1":{"name":"opentelemetry-instrumentation-express","version":"0.5.1","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn run build","test":"mocha --require opentelemetry-instrumentation-testing-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require opentelemetry-instrumentation-testing-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"dependencies":{"@opentelemetry/api":"^0.20.0","@opentelemetry/core":"^0.20.0","@opentelemetry/instrumentation":"^0.20.0","@opentelemetry/semantic-conventions":"^0.20.0"},"devDependencies":{"@opentelemetry/instrumentation-http":"^0.20.0","@opentelemetry/tracing":"^0.20.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"^0.0.1-rc.1","opentelemetry-instrumentation-testing-utils":"^0.5.1","test-all-versions":"^5.0.1"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"5922581fbe66f3590eeabc9e1983e33fc1ab3021","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.5.1","_nodeVersion":"12.22.1","_npmVersion":"lerna/3.22.1/node@v12.22.1+x64 (linux)","dist":{"integrity":"sha512-NttWQdZoifL9WQ9zssvVm6/EX6pMD2c8OO9RTjFD4CuI2E90ozUs1O6zej7Fnb8BV8c95bESORvunpFBWrnS2g==","shasum":"409d1f8537e9ce114eb02163b9111e6749b49bba","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.5.1.tgz","fileCount":18,"unpackedSize":52709,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJgycI+CRA9TVsSAnZWagAAdnYP/iAg9G8/m3wZPoXPq7st\n4noXxh+VZ7nffzJ51ArQFCOrdWCsLVW+oNVYth6vAOTodO1Nbi5YSBtrsUpT\nsED/0u+9ZG2Hi5bDjF6hUAUYlnaaF8ieZQqtrC2aCHbreZZXfoRCOypyqNSu\ncF/xZWJDksz/e1m2wmWIvDR6/VfHwqQaxba10rRJgFmJYrC7vN3nav0FjBUi\nRrJuqQVL7VAOzpnPD8QOtIEW49phU7eaA+fBO8/L1S9x49Ao+4vjBnaCMigw\nfPJJtg3Nr9a/S85s6bxq7WQzl1k9cJhi3fMlcbcnNdk+iepzP4NQJ2WlDxJM\n5jTJ0JUtDCUNVWhXjBOOxycSPybINP5iJd3KYHQzxqPAmpXmoLUd++KQOffU\nqeLDqa3S+QZLGkGgitL7BB4UER06pN1aiTGzT29rkIOc/pQgC9HPh3qNo+ZK\nbCnhuQ0nrEDIoSPqGinpGXhOFbs6ocB2dRIW7UO6KAahG5VNS76DYcOI+0Le\n7Esk4SCxORZW6ThXPmfWYHHtcOtZpq2hJEX8ldS/yU8Z0NGPcb6vclmrUjAV\n2NaiprLNIciCoejlvHowvnSmYXsygDO1cNla60dGgWv5dF/wtnVy7rhL+MDj\njo7z2i79Bxe9ixm3m+F979xoJN/Zd6DTmFjBu5lvZlk3CgxxNhJH7hk5OaBK\nW8Fk\r\n=AJwY\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQCzY/r1a9fMzBdZ8eTEt6SVDkrj9P3jDZW2u36pW1K3+gIgbV1gtfoXRhIX7xj78j5gA5Xes3HydagYjTfoe0jkWnk="}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.5.1_1623835198179_0.2396407153273783"},"_hasShrinkwrap":false},"0.0.0-2021-06-17--13-11":{"name":"opentelemetry-instrumentation-express","version":"0.0.0-2021-06-17--13-11","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn run build","test":"mocha --require opentelemetry-instrumentation-testing-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require opentelemetry-instrumentation-testing-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"dependencies":{"@opentelemetry/api":"^0.20.0","@opentelemetry/core":"^0.20.0","@opentelemetry/instrumentation":"^0.20.0","@opentelemetry/semantic-conventions":"^0.20.0"},"devDependencies":{"@opentelemetry/instrumentation-http":"^0.20.0","@opentelemetry/tracing":"^0.20.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"^0.0.1-rc.1","opentelemetry-instrumentation-testing-utils":"^0.0.0-2021-06-17--13-11","test-all-versions":"^5.0.1"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"394b69f3cbe81fb9c51c6571e782f08126d97735","readme":"# OpenTelemetry express Instrumentation for Node.js\n[![NPM version](https://img.shields.io/npm/v/opentelemetry-instrumentation-express.svg)](https://www.npmjs.com/package/opentelemetry-instrumentation-express)\n\nThis module provide enhanced instrumentation for the `express` web framework.\n\n## Installation\n\n```\nnpm install --save opentelemetry-instrumentation-express\n```\n## Supported Versions\nThis instrumentation supports `^4.9.0`:\n\nall versions >= `4.9.0` (released 2014) and < `5.0.0` (in alpha).\n\n## Usage\nFor further automatic instrumentation instruction see the [@opentelemetry/instrumentation](https://github.com/open-telemetry/opentelemetry-js/tree/main/packages/opentelemetry-instrumentation) package.\n\n```js\nconst { NodeTracerProvider } = require('@opentelemetry/node');\nconst { registerInstrumentations } = require('@opentelemetry/instrumentation');\nconst { ExpressInstrumentation } = require('opentelemetry-instrumentation-express');\n\nconst traceProvider = new NodeTracerProvider();\ntraceProvider.register();\n\nregisterInstrumentations({\n  traceProvider,\n  instrumentations: [\n    new ExpressInstrumentation()\n  ]\n});\n```\n\n### Express Instrumentation Options\n\nExpress instrumentation has few options available to choose from. You can set the following:\n\n| Options | Type  | Description |\n| --- | --- | --- |\n| `requestHook` | `RequestHook` (function) | Hook for adding custom attributes before express start handling the request. Receives params: `span, { moduleVersion, req, res }` |\n| `includeHttpAttributes` | `boolean` | If set to true, plugin will include semantic http attributes in each express span |\n\n## Semantic Behavior\nExpress auto instrumentation will create a single span per request with the following attributes.\nDetailed specification and cases can be found [here](./doc/attributes-specification.MD).\n\n### `http.route`\nThis is a conventional http attribute, which is collected by express instead of the http module (which is not aware of the route). It will always contain path-parameterized data with low cardinality (no ids), but might be missing parts of the path in case of early termination or middlewares that accept any path.\n\nExample: `/api/users/:id`\n\n### `express.route.full`\nThis attribute will always contain the entire path. The part of the path that has been consumed by express will be shown as is (parameterized), and the leftover will be concatenated after (due to early termination or middleware that accept any path).\n\nExample: `/api/users/:id/books/758734` (The `:id` part was consumed, but the `bookid` part was not).\n\n### `express.route.configured`\nThis attribute is relevant when user configures multi path options for the same middleware. It reduces even further the cardinality space compared to `http.route`, and supply more info about how the app routing works.\n\nExample: `/api[\"/foo\", /\"bar\"]` - meaning that the same endpoint is triggered by routes `/api/foo` and `/api/bar`.\n\n### `express.route.params`\nThis attribute holds a json stringified map, where the keys are the url path param names, and the values are the matched params from the actual url.\n\nExample: `{\"id\":\"1234\"}`. \n\n### `express.unhandled`\nSet to true when request was not handled by any middleware in express, and got fallback to the default app `finalhandler`. This can happen if client sent request with invalid path or method (resulting in 404). This can be useful to filter out requests from internet bots which try to call common routes on servers.\n\n### `express.instrumentation.errors`\nIn case of internal error in instrumentation, this attribute will contain the error description. There are no known valid use cases which are expected to produce this attribute.\n\n## Difference from [@opentelemetry/instrumentation-express](https://github.com/open-telemetry/opentelemetry-js-contrib/tree/main/plugins/node/opentelemetry-instrumentation-express)\n\n* This instrumentation is focusing on extracting the most accurate and complete `route` data, in any valid express edge case. Contrib instrumentation does a good job for common cases, but miss nuances on complex setups.\n* This instrumentation create a single span per request. Contrib instrumentation creates span per express Router/Route, which can be useful to observe express internal components, with the cost of more spans in each trace.\n* Set few alternatives for route attribute, each with different level of cardinality vs accuracy.\n* Allows to set `requestHook` for adding custom attributes to span, as well as ability to capture express version into user defined attribute.\n* Distinguish between handled requests (ended from user middleware), and unhandled (terminated from express built in 'finalhandler').\n* Option to conform with the [Semantic conventions for HTTP spans](https://github.com/open-telemetry/opentelemetry-specification/blob/master/specification/trace/semantic_conventions/http.md).\n\n\n---\n\nThis extension (and many others) was developed by [Aspecto](https://www.aspecto.io/) with ❤️","readmeFilename":"README.md","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.0.0-2021-06-17--13-11","_nodeVersion":"12.22.1","_npmVersion":"lerna/3.22.1/node@v12.22.1+x64 (linux)","dist":{"integrity":"sha512-u2pPA3dFWK+fXKL1M1v/DYVM9oS69vl4eo28Ob1/eVqNWYxZGG6+Yg/YKNF+4gTcbsZKuCnzF2UqH2HRgVl9vw==","shasum":"2168b593b03128dcdd9ab7f6ad5e2247413a2048","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.0.0-2021-06-17--13-11.tgz","fileCount":18,"unpackedSize":52781,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJgy0oqCRA9TVsSAnZWagAAFHsQAJTiEGW5bXTzIa6iIC69\n8/m4URPpwzglY/3bHI1toO5iKsHt90mM9oPT7Zyu3ue/3Pk7E4vzyI2ElDKz\nvD47GBN9aAm05KuF9RZmDGfZysydvrexUmjsZzwh9jlrTuqlmih9GPO6FaRN\nLUMSs68ppORLrF7U7IKfgOvYq0CCBm2R75MkxbSiMuflQkpR/0/+xgAkZjRH\nOYaR6/hJs71JnE9Uk1+Jj0K1Ln1bK6FpwcqLZhbll/3tUp0Hdcjnu6FNqsDX\n/TueJXA3Kdn7OoN/gosN6w9WrYlg25Zayhv032OPRix8o5J7OIFxchDOmnUj\naDkshQ9NOhetLAX3KQls9am9ql/uRbhjDdBnUw2Ch+bfTJzDQmX2LZeaY318\n50CLsxuNQi76oOZqSWlKixcDznJ9/PSkKxsPmZ6AIjM0xN7jtisBGECgEKu0\ncSY3WeIXgq4nX6aWBE8QT0q8/cCR9JbkCXUBM5/pMpLC2Z2+a4q4wQ7bVibQ\nHCAFlxeXSIOdJ/peSFSASEM5Y9+bu7qvqZTpLtLSXEpUshDPORGNQ1YPXqlY\neZDc1EeetVE2W8FewEdo13zFjFQLUt/4G8lkfuD5LwRu0jciDzjvoiQorKOx\npl/7Mu5u0h9oIV3genBZ1wqzBwW1CddgV8USAPwYuZ8jfz55fRVSwkbJZXgj\nt/UM\r\n=niEo\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIBEqxyW8VW2PTdaBakKcDcVUlAVeB9ppgekwBemdNBs8AiArPLo7XRY2dorC5kwpr2dKYYg+ldZyI/bPtlECtNZd1A=="}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.0.0-2021-06-17--13-11_1623935530501_0.7095404068497762"},"_hasShrinkwrap":false},"0.21.0":{"name":"opentelemetry-instrumentation-express","version":"0.21.0","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn run build","test":"mocha --require opentelemetry-instrumentation-testing-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require opentelemetry-instrumentation-testing-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"peerDependencies":{"@opentelemetry/api":"^0.21.0"},"dependencies":{"@opentelemetry/core":"^0.21.0","@opentelemetry/instrumentation":"^0.21.0","@opentelemetry/semantic-conventions":"^0.21.0"},"devDependencies":{"@opentelemetry/api":"^0.21.0","@opentelemetry/instrumentation-http":"^0.21.0","@opentelemetry/tracing":"^0.21.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"0.0.1-rc.2","opentelemetry-instrumentation-testing-utils":"^0.21.0","test-all-versions":"^5.0.1"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"0eb9c76b2bbcf85cb228e2301ce0cc1346076808","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.21.0","_nodeVersion":"12.22.1","_npmVersion":"lerna/3.22.1/node@v12.22.1+x64 (linux)","dist":{"integrity":"sha512-uFu6itpzkorlVcgXI99KjMSsEbZ8W82GYoPaODnEyAhqez8Olan93oPwG8Vb8hjGFwGqQ+esgOlhkAvazDvelQ==","shasum":"a187d9a7c6d4580a7de057f7583d46b21423d836","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.21.0.tgz","fileCount":18,"unpackedSize":53044,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJgzxMWCRA9TVsSAnZWagAAV4sP/AltzAjznfd778FEiauG\nhr8520uXsHC6Yy46TfegsTxCL1Sx0FQHEFwyqOx9W/GYJyeeJMYi4+gIrVfQ\nk/IGDYVldka7feIA5i5QZzL4ScwqwMF0Bn88/pn/l5VyNF4KPYNl8U9DyxbL\n4PmR/Xahndk9Dyd5VeEWluxCisXJ/XI/RoBz9FkZbFklrUJ66jq8YfC8aOVG\n03Uc5oXpiWEStZqf2olRz/C+dEshi3nkbHh1g+RjWAcUEJgmT+QzmyYKkYra\n5MySQ3GG4psaF/NJpi7ZYf0JtqQlOM0X75YXFPdBqmgZqod0DobKKenxz11o\nF2WrA+uw9fZxmduH4Kmw1Z6fwFGGRSKv4yMG8HYDz5y/lV6AboHkPUZu4i8n\nYzLTKdA6H26EBK7mEmo5hrV8nzdIxAjSTzEbmziWKbY7fUDjEVTB4FW7QRmM\nAcPYMoB5ktkk6eLle5kHqwbcOjjmDs2+2FJCGf//k8iUJOZ+R04dSUfE48ge\niUEi6MtONjGU+hpW0sFnbU5IoIVMpdphgPDyNrw5NFLvnTQSA7/UILMJ8As9\nMzgzHWYxb8092jIWNH8eHDV9aC/D+k16Ox+K75T3i5GkmFqeBXOdl7i1yaJm\nltYEYu4kGiFUN4ByZrphQxNoGpS6IEXhNlMed6IIC4gX7es4mYYDxZQJ2ryY\n00xU\r\n=i84M\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQCd1hVTYA/13OKGcNewfNfD/9dgBLIiLFQyNYu2bA0PTAIhANWNqo6DE2J3vT8Qf0441LJyX/hg/kti3Q3g5sWC04Lf"}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.21.0_1624183574526_0.7649083101441854"},"_hasShrinkwrap":false},"0.0.0-2021-06-23--07-47":{"name":"opentelemetry-instrumentation-express","version":"0.0.0-2021-06-23--07-47","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn run build","test":"mocha --require opentelemetry-instrumentation-testing-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require opentelemetry-instrumentation-testing-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"peerDependencies":{"@opentelemetry/api":"^0.21.0"},"dependencies":{"@opentelemetry/core":"^0.21.0","@opentelemetry/instrumentation":"^0.21.0","@opentelemetry/semantic-conventions":"^0.21.0"},"devDependencies":{"@opentelemetry/api":"^0.21.0","@opentelemetry/instrumentation-http":"^0.21.0","@opentelemetry/tracing":"^0.21.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"0.0.1-rc.2","opentelemetry-instrumentation-testing-utils":"^0.0.0-2021-06-23--07-47","test-all-versions":"^5.0.1"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"3aa46659e7d7b8cb0038645cab620fce3d08348d","readme":"# OpenTelemetry express Instrumentation for Node.js\n[![NPM version](https://img.shields.io/npm/v/opentelemetry-instrumentation-express.svg)](https://www.npmjs.com/package/opentelemetry-instrumentation-express)\n\nThis module provide enhanced instrumentation for the `express` web framework.\n\n## Installation\n\n```\nnpm install --save opentelemetry-instrumentation-express\n```\n## Supported Versions\nThis instrumentation supports `^4.9.0`:\n\nall versions >= `4.9.0` (released 2014) and < `5.0.0` (in alpha).\n\n## Usage\nFor further automatic instrumentation instruction see the [@opentelemetry/instrumentation](https://github.com/open-telemetry/opentelemetry-js/tree/main/packages/opentelemetry-instrumentation) package.\n\n```js\nconst { NodeTracerProvider } = require('@opentelemetry/node');\nconst { registerInstrumentations } = require('@opentelemetry/instrumentation');\nconst { ExpressInstrumentation } = require('opentelemetry-instrumentation-express');\n\nconst traceProvider = new NodeTracerProvider();\ntraceProvider.register();\n\nregisterInstrumentations({\n  traceProvider,\n  instrumentations: [\n    new ExpressInstrumentation()\n  ]\n});\n```\n\n### Express Instrumentation Options\n\nExpress instrumentation has few options available to choose from. You can set the following:\n\n| Options | Type  | Description |\n| --- | --- | --- |\n| `requestHook` | `RequestHook` (function) | Hook for adding custom attributes before express start handling the request. Receives params: `span, { moduleVersion, req, res }` |\n| `includeHttpAttributes` | `boolean` | If set to true, plugin will include semantic http attributes in each express span |\n\n## Semantic Behavior\nExpress auto instrumentation will create a single span per request with the following attributes.\nDetailed specification and cases can be found [here](./doc/attributes-specification.MD).\n\n### `http.route`\nThis is a conventional http attribute, which is collected by express instead of the http module (which is not aware of the route). It will always contain path-parameterized data with low cardinality (no ids), but might be missing parts of the path in case of early termination or middlewares that accept any path.\n\nExample: `/api/users/:id`\n\n### `express.route.full`\nThis attribute will always contain the entire path. The part of the path that has been consumed by express will be shown as is (parameterized), and the leftover will be concatenated after (due to early termination or middleware that accept any path).\n\nExample: `/api/users/:id/books/758734` (The `:id` part was consumed, but the `bookid` part was not).\n\n### `express.route.configured`\nThis attribute is relevant when user configures multi path options for the same middleware. It reduces even further the cardinality space compared to `http.route`, and supply more info about how the app routing works.\n\nExample: `/api[\"/foo\", /\"bar\"]` - meaning that the same endpoint is triggered by routes `/api/foo` and `/api/bar`.\n\n### `express.route.params`\nThis attribute holds a json stringified map, where the keys are the url path param names, and the values are the matched params from the actual url.\n\nExample: `{\"id\":\"1234\"}`. \n\n### `express.unhandled`\nSet to true when request was not handled by any middleware in express, and got fallback to the default app `finalhandler`. This can happen if client sent request with invalid path or method (resulting in 404). This can be useful to filter out requests from internet bots which try to call common routes on servers.\n\n### `express.instrumentation.errors`\nIn case of internal error in instrumentation, this attribute will contain the error description. There are no known valid use cases which are expected to produce this attribute.\n\n## Difference from [@opentelemetry/instrumentation-express](https://github.com/open-telemetry/opentelemetry-js-contrib/tree/main/plugins/node/opentelemetry-instrumentation-express)\n\n* This instrumentation is focusing on extracting the most accurate and complete `route` data, in any valid express edge case. Contrib instrumentation does a good job for common cases, but miss nuances on complex setups.\n* This instrumentation create a single span per request. Contrib instrumentation creates span per express Router/Route, which can be useful to observe express internal components, with the cost of more spans in each trace.\n* Set few alternatives for route attribute, each with different level of cardinality vs accuracy.\n* Allows to set `requestHook` for adding custom attributes to span, as well as ability to capture express version into user defined attribute.\n* Distinguish between handled requests (ended from user middleware), and unhandled (terminated from express built in 'finalhandler').\n* Option to conform with the [Semantic conventions for HTTP spans](https://github.com/open-telemetry/opentelemetry-specification/blob/master/specification/trace/semantic_conventions/http.md).\n\n\n---\n\nThis extension (and many others) was developed by [Aspecto](https://www.aspecto.io/) with ❤️","readmeFilename":"README.md","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.0.0-2021-06-23--07-47","_nodeVersion":"12.22.1","_npmVersion":"lerna/3.22.1/node@v12.22.1+x64 (linux)","dist":{"integrity":"sha512-tB6vDHuF3MyXJQYzoMb0w5xA6iUUNslIZDM97HuPDNxZj99+5n9tWen2RIjI0WgquLpYxfdYGBGjrwbxxrVlEg==","shasum":"96388e381a363eccd231c6f39e1907e78b3c91ec","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.0.0-2021-06-23--07-47.tgz","fileCount":18,"unpackedSize":53112,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJg0udeCRA9TVsSAnZWagAAz7gP/j8K/gUkJTYHzgTWKkeT\n3gEtwc9xGN/SErHI8fB1rzxBsuYcD2ix6ojtHk+J6SVWAuVjuSkkeulX0RUe\nPmQltIK2X9ATIOuhcTrMXbecpBNx0nUJBWMQV37qxfkM7wbZ2x1B6q/YVCj+\nzy6mO6aa7hwLpMCiIcdu3ykMjsoKSlCS9AN87fEUq45snShq2rbDW0hp8QXf\nKzWgX59Bl9cvRVKC3yAq9K19wvAO9sSQ06Q3NlsB211HzM8xPhpBW39K8+XO\n3tEsLvEOZVk3jQDPSCYxbKc2QF/CelGCrdY86IPCXNaJFoDJSQHiBRff525L\n8IfQTQwshXBob6r/eet9ojcs/5Vl8JMjeqte0zB8xRbNRhXFu6lxTe7lMv/z\n2QilA6uIfkBjRaRy1twfGho2THrSWi8UG/Cg6j4JDcVPGLZGvVRafhEOerKN\nn02Y8Uvxd9HGcxHGIFJb+oi1BoQEOxZZIbhqHYbMhLUejMPfsrKuUoxHJoWl\nSVPJrnCZrihwf9Uni6TtOORVt0BIQum3/+9i0J9AuSy/OO8to4o5tomKpiey\nFRCweOty0mNT7xpoEAKRjTYeXyvaVmtURvq0UU6gEAyklV/Rn3DnJilEkqqz\nhX9s/9r3HR4KbrV7DZ/QSVcJxou4a3DydcKbVv7EQL5whRRnUeqaxand1M5S\nTRB7\r\n=mhad\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQC9ntgUrK7hPGytepRzddvdY+l80Q4Rgumop+xBfc05RQIhALtFayKgdKsCbyD498iJbortHBwkfWrBmdpa6QKcNrSO"}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.0.0-2021-06-23--07-47_1624434525966_0.4458386712180624"},"_hasShrinkwrap":false},"0.0.0-2021-06-23--08-12":{"name":"opentelemetry-instrumentation-express","version":"0.0.0-2021-06-23--08-12","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn run build","test":"mocha --require opentelemetry-instrumentation-testing-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require opentelemetry-instrumentation-testing-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"peerDependencies":{"@opentelemetry/api":"^0.21.0"},"dependencies":{"@opentelemetry/core":"^0.21.0","@opentelemetry/instrumentation":"^0.21.0","@opentelemetry/semantic-conventions":"^0.21.0"},"devDependencies":{"@opentelemetry/api":"^0.21.0","@opentelemetry/instrumentation-http":"^0.21.0","@opentelemetry/tracing":"^0.21.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"0.0.1-rc.2","opentelemetry-instrumentation-testing-utils":"^0.0.0-2021-06-23--08-12","test-all-versions":"^5.0.1"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"9219abdec94e8dbeb50e61b1c289c60309c0a56c","readme":"# OpenTelemetry express Instrumentation for Node.js\n[![NPM version](https://img.shields.io/npm/v/opentelemetry-instrumentation-express.svg)](https://www.npmjs.com/package/opentelemetry-instrumentation-express)\n\nThis module provide enhanced instrumentation for the `express` web framework.\n\n## Installation\n\n```\nnpm install --save opentelemetry-instrumentation-express\n```\n## Supported Versions\nThis instrumentation supports `^4.9.0`:\n\nall versions >= `4.9.0` (released 2014) and < `5.0.0` (in alpha).\n\n## Usage\nFor further automatic instrumentation instruction see the [@opentelemetry/instrumentation](https://github.com/open-telemetry/opentelemetry-js/tree/main/packages/opentelemetry-instrumentation) package.\n\n```js\nconst { NodeTracerProvider } = require('@opentelemetry/node');\nconst { registerInstrumentations } = require('@opentelemetry/instrumentation');\nconst { ExpressInstrumentation } = require('opentelemetry-instrumentation-express');\n\nconst traceProvider = new NodeTracerProvider();\ntraceProvider.register();\n\nregisterInstrumentations({\n  traceProvider,\n  instrumentations: [\n    new ExpressInstrumentation()\n  ]\n});\n```\n\n### Express Instrumentation Options\n\nExpress instrumentation has few options available to choose from. You can set the following:\n\n| Options | Type  | Description |\n| --- | --- | --- |\n| `requestHook` | `RequestHook` (function) | Hook for adding custom attributes before express start handling the request. Receives params: `span, { moduleVersion, req, res }` |\n| `includeHttpAttributes` | `boolean` | If set to true, plugin will include semantic http attributes in each express span |\n\n## Semantic Behavior\nExpress auto instrumentation will create a single span per request with the following attributes.\nDetailed specification and cases can be found [here](./doc/attributes-specification.MD).\n\n### `http.route`\nThis is a conventional http attribute, which is collected by express instead of the http module (which is not aware of the route). It will always contain path-parameterized data with low cardinality (no ids), but might be missing parts of the path in case of early termination or middlewares that accept any path.\n\nExample: `/api/users/:id`\n\n### `express.route.full`\nThis attribute will always contain the entire path. The part of the path that has been consumed by express will be shown as is (parameterized), and the leftover will be concatenated after (due to early termination or middleware that accept any path).\n\nExample: `/api/users/:id/books/758734` (The `:id` part was consumed, but the `bookid` part was not).\n\n### `express.route.configured`\nThis attribute is relevant when user configures multi path options for the same middleware. It reduces even further the cardinality space compared to `http.route`, and supply more info about how the app routing works.\n\nExample: `/api[\"/foo\", /\"bar\"]` - meaning that the same endpoint is triggered by routes `/api/foo` and `/api/bar`.\n\n### `express.route.params`\nThis attribute holds a json stringified map, where the keys are the url path param names, and the values are the matched params from the actual url.\n\nExample: `{\"id\":\"1234\"}`. \n\n### `express.unhandled`\nSet to true when request was not handled by any middleware in express, and got fallback to the default app `finalhandler`. This can happen if client sent request with invalid path or method (resulting in 404). This can be useful to filter out requests from internet bots which try to call common routes on servers.\n\n### `express.instrumentation.errors`\nIn case of internal error in instrumentation, this attribute will contain the error description. There are no known valid use cases which are expected to produce this attribute.\n\n## Difference from [@opentelemetry/instrumentation-express](https://github.com/open-telemetry/opentelemetry-js-contrib/tree/main/plugins/node/opentelemetry-instrumentation-express)\n\n* This instrumentation is focusing on extracting the most accurate and complete `route` data, in any valid express edge case. Contrib instrumentation does a good job for common cases, but miss nuances on complex setups.\n* This instrumentation create a single span per request. Contrib instrumentation creates span per express Router/Route, which can be useful to observe express internal components, with the cost of more spans in each trace.\n* Set few alternatives for route attribute, each with different level of cardinality vs accuracy.\n* Allows to set `requestHook` for adding custom attributes to span, as well as ability to capture express version into user defined attribute.\n* Distinguish between handled requests (ended from user middleware), and unhandled (terminated from express built in 'finalhandler').\n* Option to conform with the [Semantic conventions for HTTP spans](https://github.com/open-telemetry/opentelemetry-specification/blob/master/specification/trace/semantic_conventions/http.md).\n\n\n---\n\nThis extension (and many others) was developed by [Aspecto](https://www.aspecto.io/) with ❤️","readmeFilename":"README.md","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.0.0-2021-06-23--08-12","_nodeVersion":"12.22.1","_npmVersion":"lerna/3.22.1/node@v12.22.1+x64 (linux)","dist":{"integrity":"sha512-fqwhMpF1HvqtV4XyGdO8QzRX/TipA6RPWSTmtrIvRg2F2JUxIKNJXSMWp7RVULS91xg9vI5S1q3vR3VBMQi68A==","shasum":"0b61e614bb1a193733fd89e897a87bffc8593411","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.0.0-2021-06-23--08-12.tgz","fileCount":18,"unpackedSize":53112,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJg0u0PCRA9TVsSAnZWagAA3LQP/jjwAqbfXLDOJAmCP5RW\n2BkiUZAys4/HPA+fIr50p7zOOSXSDOBamMMR9xCS+ABFtWaN16ktT2xgO44u\nHepBZT9RfuHkYfaUgA43Q99woPvAZkUpHLfbvz72hBI+UrsUqDXWAoB1VrGI\no/QEbwiFaJgqTsflNq4V8mZSrSBkx5UkEpoTvQaKK4hMNSDaWTUu/Ec0TmTT\n2UyBurTFe0LZVUmQ4OaL4NOpSaw+yxaklbgfB6a2P0Vp9huLJV/0AttW9nBh\nF5YBTMB6lKw3wpp2AdxfPUY5QS1TnmfnTpogiEYD4Mw6kKFQKGgualJenDYK\nR9JJXa+WR+TXzb9scJLlD2UVCUYSoib9iAni1PqHh2WTy8jysF6mMhqLSWbv\nw/L0aR63KHcHLQhYwKUw1wEIpk3WBnuakOl7Q/ACkfpj4qCa6r0Zo7U+rO6L\nomFV6iqURFzkjzMxJ7wSsuqoa6edEXipaXMmS5D9IC8H2OS2B0jG1/nNvu92\nGdg8RhgouoDq1fC3VQD3Z1TspI9jo7JlK4uY2tJjg4MKpB+seekUVx1ggMzz\nIb388oedzV5wtkYDepkLp9NMhs8PyXbd42ZkHtBMItEB9xE9dKlRnUJAMxPk\nTDOolrFbjEN10KL88/G7CX3B9jIr+Wu8t06/OUBiKIu/5InI2H5iUQwMXPOA\n0LMn\r\n=d8iU\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQDPQ40uSsd1vPRA9rX3VkdjmiPdSlJ1kn0zFlroJpm+LQIhAOsMZ0En9FM72VI6ev0Tc8O0Yc8FVXXfAsOeaq6qpSH1"}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.0.0-2021-06-23--08-12_1624435982877_0.4006362016034455"},"_hasShrinkwrap":false},"0.0.0-2021-06-23--15-11":{"name":"opentelemetry-instrumentation-express","version":"0.0.0-2021-06-23--15-11","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn run build","test":"mocha --require opentelemetry-instrumentation-testing-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require opentelemetry-instrumentation-testing-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"peerDependencies":{"@opentelemetry/api":"^0.21.0"},"dependencies":{"@opentelemetry/core":"^0.21.0","@opentelemetry/instrumentation":"^0.21.0","@opentelemetry/semantic-conventions":"^0.21.0"},"devDependencies":{"@opentelemetry/api":"^0.21.0","@opentelemetry/instrumentation-http":"^0.21.0","@opentelemetry/tracing":"^0.21.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"0.0.1-rc.2","opentelemetry-instrumentation-testing-utils":"^0.0.0-2021-06-23--15-11","test-all-versions":"^5.0.1"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"7faff48d9d7740fef1b799dbbaf1dddc673aa97e","readme":"# OpenTelemetry express Instrumentation for Node.js\n[![NPM version](https://img.shields.io/npm/v/opentelemetry-instrumentation-express.svg)](https://www.npmjs.com/package/opentelemetry-instrumentation-express)\n\nThis module provide enhanced instrumentation for the `express` web framework.\n\n## Installation\n\n```\nnpm install --save opentelemetry-instrumentation-express\n```\n## Supported Versions\nThis instrumentation supports `^4.9.0`:\n\nall versions >= `4.9.0` (released 2014) and < `5.0.0` (in alpha).\n\n## Usage\nFor further automatic instrumentation instruction see the [@opentelemetry/instrumentation](https://github.com/open-telemetry/opentelemetry-js/tree/main/packages/opentelemetry-instrumentation) package.\n\n```js\nconst { NodeTracerProvider } = require('@opentelemetry/node');\nconst { registerInstrumentations } = require('@opentelemetry/instrumentation');\nconst { ExpressInstrumentation } = require('opentelemetry-instrumentation-express');\n\nconst traceProvider = new NodeTracerProvider();\ntraceProvider.register();\n\nregisterInstrumentations({\n  traceProvider,\n  instrumentations: [\n    new ExpressInstrumentation()\n  ]\n});\n```\n\n### Express Instrumentation Options\n\nExpress instrumentation has few options available to choose from. You can set the following:\n\n| Options | Type  | Description |\n| --- | --- | --- |\n| `requestHook` | `RequestHook` (function) | Hook for adding custom attributes before express start handling the request. Receives params: `span, { moduleVersion, req, res }` |\n| `includeHttpAttributes` | `boolean` | If set to true, plugin will include semantic http attributes in each express span |\n\n## Semantic Behavior\nExpress auto instrumentation will create a single span per request with the following attributes.\nDetailed specification and cases can be found [here](./doc/attributes-specification.MD).\n\n### `http.route`\nThis is a conventional http attribute, which is collected by express instead of the http module (which is not aware of the route). It will always contain path-parameterized data with low cardinality (no ids), but might be missing parts of the path in case of early termination or middlewares that accept any path.\n\nExample: `/api/users/:id`\n\n### `express.route.full`\nThis attribute will always contain the entire path. The part of the path that has been consumed by express will be shown as is (parameterized), and the leftover will be concatenated after (due to early termination or middleware that accept any path).\n\nExample: `/api/users/:id/books/758734` (The `:id` part was consumed, but the `bookid` part was not).\n\n### `express.route.configured`\nThis attribute is relevant when user configures multi path options for the same middleware. It reduces even further the cardinality space compared to `http.route`, and supply more info about how the app routing works.\n\nExample: `/api[\"/foo\", /\"bar\"]` - meaning that the same endpoint is triggered by routes `/api/foo` and `/api/bar`.\n\n### `express.route.params`\nThis attribute holds a json stringified map, where the keys are the url path param names, and the values are the matched params from the actual url.\n\nExample: `{\"id\":\"1234\"}`. \n\n### `express.unhandled`\nSet to true when request was not handled by any middleware in express, and got fallback to the default app `finalhandler`. This can happen if client sent request with invalid path or method (resulting in 404). This can be useful to filter out requests from internet bots which try to call common routes on servers.\n\n### `express.instrumentation.errors`\nIn case of internal error in instrumentation, this attribute will contain the error description. There are no known valid use cases which are expected to produce this attribute.\n\n## Difference from [@opentelemetry/instrumentation-express](https://github.com/open-telemetry/opentelemetry-js-contrib/tree/main/plugins/node/opentelemetry-instrumentation-express)\n\n* This instrumentation is focusing on extracting the most accurate and complete `route` data, in any valid express edge case. Contrib instrumentation does a good job for common cases, but miss nuances on complex setups.\n* This instrumentation create a single span per request. Contrib instrumentation creates span per express Router/Route, which can be useful to observe express internal components, with the cost of more spans in each trace.\n* Set few alternatives for route attribute, each with different level of cardinality vs accuracy.\n* Allows to set `requestHook` for adding custom attributes to span, as well as ability to capture express version into user defined attribute.\n* Distinguish between handled requests (ended from user middleware), and unhandled (terminated from express built in 'finalhandler').\n* Option to conform with the [Semantic conventions for HTTP spans](https://github.com/open-telemetry/opentelemetry-specification/blob/master/specification/trace/semantic_conventions/http.md).\n\n\n---\n\nThis extension (and many others) was developed by [Aspecto](https://www.aspecto.io/) with ❤️","readmeFilename":"README.md","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.0.0-2021-06-23--15-11","_nodeVersion":"12.22.1","_npmVersion":"lerna/3.22.1/node@v12.22.1+x64 (linux)","dist":{"integrity":"sha512-NYPX3vMrmgHSGsE0WmetsTFFbG5CsuXAspKJaJhxWXtiEUCGCP1YtoVDDYHEmBixZl0A2ZcCwD27KX4+5hLqYA==","shasum":"22b1df08d0535da4091fd2156244219a613f7261","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.0.0-2021-06-23--15-11.tgz","fileCount":18,"unpackedSize":53112,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJg009fCRA9TVsSAnZWagAAJ5kP/0NSEzgYKuyUFqGmS7H+\nbnJSNJL6iI1cJkNQ88JBXMtWu+OKMuIjkI2T6Df6gTSoc2HNep7fRSC5Cjlh\nQKQHCZrz9GJZfpSppmt7zqTsuUbUn+U9s3zBmqVf0LNi395Droyr+Ceuv2uN\nTQ9eimnTmjPQyqQYmzcC22z8VHjJsjMiK/kTqPXdXHnf+6oXSnaJ/y1apBg8\nJnnD+VxDFPvEf6ghxr0kQLBAa70fLCZQNsmbEvQRqXOxFHrJTeSqZ9zO8w2P\n7wBm/P6PwpndJIs1ZFKXC3isHvah6a40ZTA2dG9I9QRGzxkK2zpgWOq+te46\n1XKABFiSkthQjVAeHV6j+w6R8uRV2GB3SWARm22tKaRImzS5/FJdV/xOsLVI\nJC9KR3UsrG+COoBjBFnatt6LnMLADfHsVkTM8IKlkkfYMojLHVX1A4Y3WuYg\nif6SXol3ENZDojDtJCTllxaSCIHmir33Ku5uOOQfxtPOLTb6nvUX3pry8AF8\nevLC2SqVRhE1gCFj+fAzj4yCk8n1709bnrkjS/QoMewoKMa0TLreZfsWiyxS\nqFQycWYDtZxeqB9N1k1h7LMuLohVIxhq7ApNZ5NzPVmYOmLNT5Y23xfj/9bp\nwAuOyuDKbg3Kp3NV83+39pLn1aGMczQ2OX9EePRWiOJP40Fm9fmMgCiZfLJt\nA+3Y\r\n=Jau4\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIBKNqp4dAdEbJpXsyN+/QTIe/h4MJuwKllExnKfR0+oNAiEA7kNURvIAGU6Jt7l+awAcums04Fo2VgdSTsYToz1HSQg="}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.0.0-2021-06-23--15-11_1624461150684_0.6409269491067402"},"_hasShrinkwrap":false},"0.21.1":{"name":"opentelemetry-instrumentation-express","version":"0.21.1","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn run build","test":"mocha --require opentelemetry-instrumentation-testing-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require opentelemetry-instrumentation-testing-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"peerDependencies":{"@opentelemetry/api":"^0.21.0"},"dependencies":{"@opentelemetry/core":"^0.21.0","@opentelemetry/instrumentation":"^0.21.0","@opentelemetry/semantic-conventions":"^0.21.0","parseurl":"~1.3.3","path-to-regexp":"0.1.7"},"devDependencies":{"@opentelemetry/api":"^0.21.0","@opentelemetry/instrumentation-http":"^0.21.0","@opentelemetry/tracing":"^0.21.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"0.0.1-rc.2","opentelemetry-instrumentation-testing-utils":"^0.21.0","test-all-versions":"^5.0.1"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"5699263e7b682ac99ad34c88c1c822ccf76216c9","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.21.1","_nodeVersion":"12.22.1","_npmVersion":"lerna/3.22.1/node@v12.22.1+x64 (linux)","dist":{"integrity":"sha512-E9cIGqlpGyVl4k8Y7neyhlJTJe0skKltisguPRmcCVMdw6J8iDg/6EqFLy5hGEPfKI24hCNTezR+qdun8DHyMw==","shasum":"b344789946de825ffdb8dd3a3f1407ab297bda5a","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.21.1.tgz","fileCount":18,"unpackedSize":53935,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJg2FfHCRA9TVsSAnZWagAAby0P/30r57aIaGWRfAAa8Z5h\nXGp49cBG9dzsd+o6NguMBhVPQQ5FUSfs4zQ1IWQE7I1K2sINSmLRtVNk565i\nkZdqjv0Dd3oOMzg41U2RHSi1ZAr6tNagSK9CGEjD0FXe3gg9/hrr1vhD0lD+\nPRY33NrFSsuFI8qrHRyVmRED87vg37nc7U5H3d+SMu4pS6fDT0uMvxcka6qJ\nFdhbN7YXnhngBD8svIK3niqPKmepwkWkG41emAbaHEr2U2EEr13ABKOwVAJU\nGjqarVmY8riHp8xouxm6SsBcwoLFCvVwO76k1XvuMKKggOF1QCPLdAV2gLNR\nkEiX6iYt38dNw0IG6+bAUwSnqfa1qaRacRaxuaskqPBzjtmlbzFjSKwZGGGV\nj2zbtqSj8vrvt5v32BaZmPQBkFbEx5uJaEIpFZsmzazwnN57CQjNB4awDaRd\nz2isVEFdiYjfNhz/Sb6quuZmKZO7y3GFTzLTcO5r/WxGNp6gg1W8r/6nofop\nXJbKnw+LuB685kJFpnQldHN1fUwuJ3vgCnuwYG4M3A3NSAT5QvXeaIJ5QOdl\n/GZyf0ei14MEvfzRmnPwB4eSb75WU1O0rR/gZr+mgiaGjvtKElvMkXbYI9gu\nK8gLKChORj1rYzZ62QyVZQ/rLtGIkEUZWB3o004zAidnxVpoMI4/LnR9U+tn\nz7lV\r\n=5sue\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIF6wblD19Gefc4qS2Fr2+NWA3JTkMMgtGmifI3dMvpvSAiEA1WR3BrOo2SBMjFp1LsjD0SfQYgAqrJJqoscaBqlu6As="}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.21.1_1624790982768_0.2839800488355544"},"_hasShrinkwrap":false},"0.22.0":{"name":"opentelemetry-instrumentation-express","version":"0.22.0","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn run build","test":"mocha --require opentelemetry-instrumentation-testing-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require opentelemetry-instrumentation-testing-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"peerDependencies":{"@opentelemetry/api":"^1.0.0"},"dependencies":{"@opentelemetry/core":"^0.22.0","@opentelemetry/instrumentation":"^0.22.0","@opentelemetry/semantic-conventions":"^0.22.0","parseurl":"~1.3.3","path-to-regexp":"0.1.7"},"devDependencies":{"@opentelemetry/api":"^1.0.0","@opentelemetry/instrumentation-http":"^0.22.0","@opentelemetry/tracing":"^0.22.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"0.0.1-rc.3","opentelemetry-instrumentation-testing-utils":"^0.22.0","test-all-versions":"^5.0.1"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"e9f830a131164f45fcfff1a527a0ade411e5e977","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.22.0","_nodeVersion":"12.22.1","_npmVersion":"lerna/3.22.1/node@v12.22.1+x64 (linux)","dist":{"integrity":"sha512-erqjY+0mmHervdIqVd/C3V4EpyFnKOat0mBEQ/rs1VnXghj5U4mfxm9jL2zg0xeSqIURZ4TWXm5+0P4eB7/vpw==","shasum":"71e746088018f32dd0e9be6736096d7349369d2c","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.22.0.tgz","fileCount":18,"unpackedSize":54193,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJg2Yg3CRA9TVsSAnZWagAAf+IP/3dLDk1M+URojHXTjeiS\n1hrRVAC3WKYee8DYTtlGDZAYUki2Bu9WqAUEV3+Moyx9iQasBV7CPCtA1DR1\nLWp04UJMWFEhIWuqOBzlRcX0sVA3pZY29ZCV3rwUtopjHILPre35019BItCc\naxRAEaDqQa0GULO6XqTO/unHiq5tOr8bP+kdLp05QLZjQgLEDKBBvGs40aWl\ner/mLEFSw4r+C5E2WrzKrW/q4gRmk+Hissyp1uCqaqfoJWNKSwOs2i4qzTSp\ncT0OyEP5TDGgbkONrWYZN1z1jS9v8BTAY5Y348jSSftfwSrM4SJrzeHukuYU\nl5dDjNsr2yZl8BNH7Hk/+XlRFkOeELDs/wnOH3GNQu6tVXbg4bPuCzZhgqf7\nY2ylUnVVxG77tSDIG3+g6rFiPBXqVcqjhfYr7xb76K3Hy4zPrFK5B5TMvtG4\ny32t+BAOT6K0FYBmQHF7L/jOgzeJkStPly7uyZ/4G3jwdp3Xq8EGmxqtkbX2\nIYX1TRO9QoaK+I83rH6fQTlR+EFV7OMXfNcGnLCJCPA1FPBDH0N+srA/1oCZ\nJ7AATWJoUqAXalNXaCiiNHcSDHGGcScW/3ybVX1jFLLSp6eo98UbXjkQTvoP\nDmnGrao1fp8IV8uV3IdEylGxLxnuXvVXl733ZuSJgzsiPQKFtMfxeylb/wfg\nZhR0\r\n=dCoV\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIDomD0T5TkaC4U4y98Pwv8i9jWJbxsNrqPKDGL7YyHw5AiEAxWmY4p5i+P4c4e6WQ8+Gj/80ldM8/bBHjYgOl36dMqM="}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.22.0_1624868918689_0.11473101115526574"},"_hasShrinkwrap":false},"0.22.1":{"name":"opentelemetry-instrumentation-express","version":"0.22.1","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn run build","test":"mocha --require opentelemetry-instrumentation-testing-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require opentelemetry-instrumentation-testing-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"peerDependencies":{"@opentelemetry/api":"^1.0.0"},"dependencies":{"@opentelemetry/core":"^0.22.0","@opentelemetry/instrumentation":"^0.22.0","@opentelemetry/semantic-conventions":"^0.22.0","parseurl":"~1.3.3","path-to-regexp":"0.1.7"},"devDependencies":{"@opentelemetry/api":"^1.0.0","@opentelemetry/instrumentation-http":"^0.22.0","@opentelemetry/tracing":"^0.22.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"0.0.1-rc.3","opentelemetry-instrumentation-testing-utils":"^0.22.1","test-all-versions":"^5.0.1","typescript":"4.3.4"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"1b95f429902c848b03570501648d88c82ce78d46","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.22.1","_nodeVersion":"12.22.1","_npmVersion":"lerna/3.22.1/node@v12.22.1+x64 (linux)","dist":{"integrity":"sha512-4XRRNsJg/n9q6KZ0xBipnN0eJwQtn99CUZT79qKEXu1KYSjbu5l/X977mQKMhCjY+AyC2bJMHiys6eRaLrIDuA==","shasum":"f1298b8b398bde2faa40983eea7fb194de7e8565","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.22.1.tgz","fileCount":25,"unpackedSize":100153,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJg4cSyCRA9TVsSAnZWagAA5h8P/0Zaq8eJ/WrHhJ91bUNz\n+TNmTuctrkcM+DZQk47RBY/lfPI5SjuLEDSWMottCgrlv/Oxdhijy8Ec1KXD\niVpwYn96UIbSHgvAPUl/UiS89tLHOZjQBuDsLc1y6Ixl5jamrMbD6ce50QX6\nPjqWKWKKmNoEslYzUoyjXOIBhmI2+c3HwyYrfRGp9aasWKUMxM/tCTwRWgrg\nkmqynPQJqePbO/xTB59XyEvTRmnN4QSTlrwxv5a/z741lSA/kmzBC7MHOGqH\nwfsdWNnA8lYHf4pmfEQ/VYSSnH47ottU0VenMwsBJ6t5pMU1PFZ4hIfpjqd2\n+yuLb3D+UINy9F5TyZ5lGPm/TLTp3VqQEbR52ucwn/C21geTvx1nkgWzXgOs\nSUpqAA5aLwyCqQsG+1GcqOz2K4azhpkQD4KLWQup9tZ+kdki5bgKXzIUiLCM\nhAlQcSvwo61NiPWhyYw8FnrUqRPlc8V1dMnK1et/dByqth3lsmoqokrJKne0\nMmaT2W4DgGHZmSbvvTnN8q4ztNuRCpXehDKPn6z/P4Jc1IA27vzT8M1wwdnD\nM8g7FBHS7IYFMhvf+d78KANJHlDCDPkSFlpsh3kjVdNc0BZClnDV91cCex/7\n34SdO+UITGD6e5bktUmeniCG0qbl8l8uNltR2D0/ZM0+hchs+Unjo5aU/qGw\nIG0A\r\n=goNU\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIFP0I0klTv3zUX2XjJBP0AyPc8kvCo5JKiHGStH2TaPIAiB4Bfkd275E9a2G0fdbgbLEgyOwuuadA0phVOWHSyQEJw=="}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.22.1_1625408690460_0.8964952574377412"},"_hasShrinkwrap":false},"0.23.0":{"name":"opentelemetry-instrumentation-express","version":"0.23.0","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn run build","test":"mocha --require opentelemetry-instrumentation-testing-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require opentelemetry-instrumentation-testing-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"peerDependencies":{"@opentelemetry/api":"^1.0.1"},"dependencies":{"@opentelemetry/core":"^0.23.0","@opentelemetry/instrumentation":"^0.23.0","@opentelemetry/semantic-conventions":"^0.23.0","parseurl":"~1.3.3","path-to-regexp":"0.1.7"},"devDependencies":{"@opentelemetry/api":"^1.0.1","@opentelemetry/instrumentation-http":"^0.23.0","@opentelemetry/tracing":"^0.23.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"0.0.1-rc.4","opentelemetry-instrumentation-testing-utils":"^0.23.0","test-all-versions":"^5.0.1","typescript":"4.3.4"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"8467cdc1e0c3192d196b26d12ff05d63d5284f72","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.23.0","_nodeVersion":"12.22.1","_npmVersion":"lerna/3.22.1/node@v12.22.1+x64 (linux)","dist":{"integrity":"sha512-YdxFEoof/Qq4j1HYgMQ57QA/IVfLzuepP/jcKLz4NC2uIPRfo72LTcU9rSA9PFdjTU8kzgT1nT21JIwlBXfUyA==","shasum":"80b09bf5d94471a53df54b01c61947829af6a85b","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.23.0.tgz","fileCount":25,"unpackedSize":100568,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJg4tbtCRA9TVsSAnZWagAAPlAP/13FxRO9K01oDhHO3O8P\nKJKVe+pfgvsp3KJbzy1W/ueH08g6h33nqrbvW9Zb7YVf30dgsa0tZBq8Wqk2\n4VB0y4TfFKRfNUNNVzD7MEVTEFxJxNc3bZfGNGzVZ8ObempG1fImEN3n0M5R\nEbqX/j41tP+Zy7X7UW5zGN8Rr5fGJfIRVTwFmA7ymSEfmjI+g+oLW6SxAhOT\naGNWcIy12SQAGBet693JxJV+YRop6mFEOmPMi8Tkru1hEDHOdjStbnS0Gus9\nb3nAeDgwJQ2jWt7DGukaJRf88w4OAhGcwTU4BEREKYkioBJjQsr5nP41AtaB\nFwVfchb6OzFgSDmPa7ZdhhR1HHd5R5ihlOiqPxISfjYJtkYDmENzBYNceor+\nBjNWghAax3pbdffO4Z+pD3qsAh0jkEOGmmiJ58DX/t6q22PqXTWr3TdcksYq\nLPVLuKYW01RWdohyLKMBo5zwMPb5DbubZBWfbhhdb+YOCoCGDxmn1NbQQDdE\n8doZ7fDC0Y6jVmIhRS84ljyg0MKzfHds5EcMuwUVl1UvVw58b2olneeMHQu/\nduCrp29ejFXe1wzttXMDtZeRBM2fMJbM7dOBUgczVk5Gcz3fMp8MPBZShOBV\nY3yXHd2hw+3DSrGmSVtWpG5pIcnh4CrzFsMeMR0SCf4/aenFnNQNnzWMLhiN\nhqff\r\n=9vvr\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQC8XoxwZfvGu+E1JbWuC1/DBVLaF7IaptBtDG0XsnHxmAIhANGejD+bigQNDvEuraW9szCyU+F0ImZ47Bj+5jG3Rzrw"}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.23.0_1625478892808_0.09488911055946714"},"_hasShrinkwrap":false},"0.0.0-2021-08-01--12-54":{"name":"opentelemetry-instrumentation-express","version":"0.0.0-2021-08-01--12-54","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn run build","test":"mocha --require opentelemetry-instrumentation-testing-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require opentelemetry-instrumentation-testing-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"peerDependencies":{"@opentelemetry/api":"^1.0.1"},"dependencies":{"@opentelemetry/core":"^0.24.0","@opentelemetry/instrumentation":"^0.24.0","@opentelemetry/semantic-conventions":"^0.24.0","parseurl":"~1.3.3","path-to-regexp":"0.1.7"},"devDependencies":{"@opentelemetry/api":"^1.0.2","@opentelemetry/instrumentation-http":"^0.24.0","@opentelemetry/tracing":"^0.24.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"0.0.1-rc.5","opentelemetry-instrumentation-testing-utils":"^0.0.0-2021-08-01--12-54","test-all-versions":"^5.0.1","typescript":"4.3.4"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"1c0b880a714e23ed5ba1ca97c35f49dc21064d8f","readme":"# OpenTelemetry express Instrumentation for Node.js\n[![NPM version](https://img.shields.io/npm/v/opentelemetry-instrumentation-express.svg)](https://www.npmjs.com/package/opentelemetry-instrumentation-express)\n\nThis module provide enhanced instrumentation for the `express` web framework.\n\n## Installation\n\n```\nnpm install --save opentelemetry-instrumentation-express\n```\n## Supported Versions\nThis instrumentation supports `^4.9.0`:\n\nall versions >= `4.9.0` (released 2014) and < `5.0.0` (in alpha).\n\n## Usage\nFor further automatic instrumentation instruction see the [@opentelemetry/instrumentation](https://github.com/open-telemetry/opentelemetry-js/tree/main/packages/opentelemetry-instrumentation) package.\n\n```js\nconst { NodeTracerProvider } = require('@opentelemetry/node');\nconst { registerInstrumentations } = require('@opentelemetry/instrumentation');\nconst { ExpressInstrumentation } = require('opentelemetry-instrumentation-express');\n\nconst traceProvider = new NodeTracerProvider();\ntraceProvider.register();\n\nregisterInstrumentations({\n  traceProvider,\n  instrumentations: [\n    new ExpressInstrumentation()\n  ]\n});\n```\n\n### Express Instrumentation Options\n\nExpress instrumentation has few options available to choose from. You can set the following:\n\n| Options | Type  | Description |\n| --- | --- | --- |\n| `requestHook` | `RequestHook` (function) | Hook for adding custom attributes before express start handling the request. Receives params: `span, { moduleVersion, req, res }` |\n| `includeHttpAttributes` | `boolean` | If set to true, plugin will include semantic http attributes in each express span |\n\n## Semantic Behavior\nExpress auto instrumentation will create a single span per request with the following attributes.\nDetailed specification and cases can be found [here](./doc/attributes-specification.MD).\n\n### `http.route`\nThis is a conventional http attribute, which is collected by express instead of the http module (which is not aware of the route). It will always contain path-parameterized data with low cardinality (no ids), but might be missing parts of the path in case of early termination or middlewares that accept any path.\n\nExample: `/api/users/:id`\n\n### `express.route.full`\nThis attribute will always contain the entire path. The part of the path that has been consumed by express will be shown as is (parameterized), and the leftover will be concatenated after (due to early termination or middleware that accept any path).\n\nExample: `/api/users/:id/books/758734` (The `:id` part was consumed, but the `bookid` part was not).\n\n### `express.route.configured`\nThis attribute is relevant when user configures multi path options for the same middleware. It reduces even further the cardinality space compared to `http.route`, and supply more info about how the app routing works.\n\nExample: `/api[\"/foo\", /\"bar\"]` - meaning that the same endpoint is triggered by routes `/api/foo` and `/api/bar`.\n\n### `express.route.params`\nThis attribute holds a json stringified map, where the keys are the url path param names, and the values are the matched params from the actual url.\n\nExample: `{\"id\":\"1234\"}`. \n\n### `express.unhandled`\nSet to true when request was not handled by any middleware in express, and got fallback to the default app `finalhandler`. This can happen if client sent request with invalid path or method (resulting in 404). This can be useful to filter out requests from internet bots which try to call common routes on servers.\n\n### `express.instrumentation.errors`\nIn case of internal error in instrumentation, this attribute will contain the error description. There are no known valid use cases which are expected to produce this attribute.\n\n## Difference from [@opentelemetry/instrumentation-express](https://github.com/open-telemetry/opentelemetry-js-contrib/tree/main/plugins/node/opentelemetry-instrumentation-express)\n\n* This instrumentation is focusing on extracting the most accurate and complete `route` data, in any valid express edge case. Contrib instrumentation does a good job for common cases, but miss nuances on complex setups.\n* This instrumentation create a single span per request. Contrib instrumentation creates span per express Router/Route, which can be useful to observe express internal components, with the cost of more spans in each trace.\n* Set few alternatives for route attribute, each with different level of cardinality vs accuracy.\n* Allows to set `requestHook` for adding custom attributes to span, as well as ability to capture express version into user defined attribute.\n* Distinguish between handled requests (ended from user middleware), and unhandled (terminated from express built in 'finalhandler').\n* Option to conform with the [Semantic conventions for HTTP spans](https://github.com/open-telemetry/opentelemetry-specification/blob/master/specification/trace/semantic_conventions/http.md).\n\n\n---\n\nThis extension (and many others) was developed by [Aspecto](https://www.aspecto.io/) with ❤️","readmeFilename":"README.md","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.0.0-2021-08-01--12-54","_nodeVersion":"12.22.3","_npmVersion":"lerna/3.22.1/node@v12.22.3+x64 (linux)","dist":{"integrity":"sha512-6MrvGiFxKNKVH1Cyn+mw+2RpwdCtYuKJ6MynJfyTurI15yq+weJ8M0qL3cxbL93xVPuXJi8K0GE4xXKnX3Sn2A==","shasum":"ec4f744cec3a56cda175d26b71ac85199b7996f5","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.0.0-2021-08-01--12-54.tgz","fileCount":25,"unpackedSize":100655,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJhBpm0CRA9TVsSAnZWagAAo6IP/1RE4kZVU7o6MfFWkuLN\nTF5K4+JnxmgiXPnjrYat5y7Q9bgw7O4upy4ypl3+++KEe7aICtMxUdDWJixC\nNb4NQaJNECpMDySvGXhdAaD1kA/WbrOiPNy5+jpn9iy0+hmS9dHZCv4A1V4P\nR4xnICZO9oaAPBqdrxTaDM24DkKTQZGEXNZTo7NIXvtW4h7yuuIDtKmcuClt\nEBUQmMA0+NyRhQ3RgysUg60kQ8FLNGPuCCB1yLC4hurEMnDvnAI1AGed0DBy\nchmyEFuPsj0UnXMgQ9rN3rsEBbcEFD9R83wW3t4hp3PYhFmAkF7N0W3F5SEg\nrQAoMaxzzi2kOI8AcC2SUki6SDspKQQTKmrRt+ihNX8N7D8awCDq+lVly+eH\nG/Gc3Gz8Gxu7NklWb3z6vMdaZtu7ioxvIYXHpnbonMkxnhFaMjJeebh+g/dI\n/UqahBBqtvqKh948lrQLBrnUejh8PXxDTXgD28MtiLp64Nci0zm0vbhHIBhR\n6Ne7LSCLmUS5duT9Z7lfeVxcw/UkqKMT1UFUudUP7SrQiQB4u3ZJ/64y6RWA\nTLjC1mYTDW1sdjmcdQ5Bq5S7VgGJCgoIZHfs4JjJkb67lP9zUea1VE6jruex\nR0gWwim+sQpdXBc7bpFQRrFtoWqNlvbJ9DcIlM2cPJ4fxJHveDkAZZSEoV0s\nwwVe\r\n=uqpl\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIEvBZnOG8iGI5x0LyfnvLBaRPgvitoRzZrDIuhXR+ASqAiEA0ZI509rKWzNCEIZcni9A6ukr0lz1xpnYelu+++ykde4="}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.0.0-2021-08-01--12-54_1627822516067_0.6820338671814921"},"_hasShrinkwrap":false},"0.24.0":{"name":"opentelemetry-instrumentation-express","version":"0.24.0","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn run build","test":"mocha --require opentelemetry-instrumentation-testing-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require opentelemetry-instrumentation-testing-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"peerDependencies":{"@opentelemetry/api":"^1.0.1"},"dependencies":{"@opentelemetry/core":"^0.24.0","@opentelemetry/instrumentation":"^0.24.0","@opentelemetry/semantic-conventions":"^0.24.0","parseurl":"~1.3.3","path-to-regexp":"0.1.7"},"devDependencies":{"@opentelemetry/api":"^1.0.2","@opentelemetry/instrumentation-http":"^0.24.0","@opentelemetry/tracing":"^0.24.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"0.0.1-rc.5","opentelemetry-instrumentation-testing-utils":"^0.24.0","test-all-versions":"^5.0.1","typescript":"4.3.4"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"f9d08fb8dd95cfad7658ed979c154cf75c979262","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.24.0","_nodeVersion":"12.22.3","_npmVersion":"lerna/3.22.1/node@v12.22.3+x64 (linux)","dist":{"integrity":"sha512-8n/x/sS/J5TTwcveA4KUz235eBmHswqroVbXdJTJdJTsvPNN85mUqlTbuuWjuhqCj4PpBh/cEzmTNmRNOfrPXA==","shasum":"f380f8fef5bc72ba98b7c618b421460db842b4cb","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.24.0.tgz","fileCount":25,"unpackedSize":100828,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJhBqy/CRA9TVsSAnZWagAA10gP/jRfwPnCDMBmcaF2wuyM\ng0wL6wZdllYeAeg7tVjMXhqsiyZi3ZHWMlZSIBJn0GFjrpx65HAQKKT3KdWd\nunBR9y6L/9aP5YcEM2Pv/EMKAJ+I6MNs8zlds0zf3TiSA+1nJ69cznuWwH6o\nDIHlnLotFASuTlAp2OYWitl6LBbbEw5TUFhqJaI9WZ3ocKfuYkUh5/PBKgYa\neCGr8Xby9nZ+lE4TzrxkP/PZOtI3u/OGX8Bi8ftY2pcHOIjphd8y3Z+2T5UU\nNdG0/VZUhZ0vZNaHvCJXHp+LLJ1HIsBVtMrGz9IWCa6R9LpLog3cQ+04PdHW\nz1hRSy1x0QSAjoP+bIQq8NSLHlqoAfERQ8grSNQ6TYD8ioeiwSLsvf30TP6q\nmjzdl7IIHKezSguBxyyT/nGnxD+O+8iohflRuFO0jtF1BNJu1bPnbBty+X+j\npGW1k+QCW1IgR1dCyakq+i3dMaiMViZomvk2pKCFmX9aHOrdXtiRzaYZA7Lx\niwlfw+4/LWM2PAA+8IkyafP17AlHqmnmEcMRqr2Kf/Gvg+9lvIOZvrhrzHIN\nuTfOfFrSjThiWliCpiOl9P+MH72iHTaHIOze7g2E3h637R+Gix16bqnf8cmh\nCOsOi9QjkaJc4IxNxSQVbeRU4LdZFZj5XtVcH6gsAOQuunRXer/91GpVIKPo\njK+H\r\n=HbDb\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQD7TZ89b0+gu17S69axaprdt/FVm4HbZNavc/oEb3bbHwIhAIw9oAdHyp5K/ytRQ169yydegviT5Bn0aBPIjW12UEAd"}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.24.0_1627827391618_0.3817239451427814"},"_hasShrinkwrap":false},"0.24.1":{"name":"opentelemetry-instrumentation-express","version":"0.24.1","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn run build","test":"mocha --require opentelemetry-instrumentation-testing-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require opentelemetry-instrumentation-testing-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"peerDependencies":{"@opentelemetry/api":"^1.0.1"},"dependencies":{"@opentelemetry/core":"^0.24.0","@opentelemetry/instrumentation":"^0.24.0","@opentelemetry/semantic-conventions":"^0.24.0","parseurl":"~1.3.3","path-to-regexp":"0.1.7"},"devDependencies":{"@opentelemetry/api":"^1.0.2","@opentelemetry/instrumentation-http":"^0.24.0","@opentelemetry/tracing":"^0.24.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"0.0.1-rc.5","opentelemetry-instrumentation-testing-utils":"^0.24.1","test-all-versions":"^5.0.1","typescript":"4.3.4"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"5ef9753bf1ab525497b2b925df0b2e2f24ae838a","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.24.1","_nodeVersion":"12.22.5","_npmVersion":"lerna/3.22.1/node@v12.22.5+x64 (linux)","dist":{"integrity":"sha512-/Y1BgXY6OSPAWGSW4vg72vwx2vgOQteLSJP+BfPjm8zfMQlx+4YMvrlB/nTmzt1717phZ+WAUGo/l3UTGRX+2g==","shasum":"03850a661b3e60b93a26485aa556d834b3954c19","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.24.1.tgz","fileCount":25,"unpackedSize":101089,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJhL3Q1CRA9TVsSAnZWagAAeAEP/R4kRmRLDddzX/Al+HaY\nXAAUim81zkbtpG8/wtB2vd+QB0OgUccs1WKnFKnr5WFpgSxjsprfxK9gd8tw\nThCDuV9BioWNELhUpGKxycLm7Q4+veZPZNO3JZ83HkbyNAyuryPX1yivVFLP\nob3m2v1Sak929BOrcZDyA934iEbNHaCE2FhNCDmvuHuu26o1z3FkXnuMN3ZV\nGBpTatMSngilouwF1fpvGuZ2OcSaVV+TexgcQegc/lCaRMGxw7GkAca8o1FC\ngCM4BwMP+ILZd4zXNHvU5soe1BLaL03DAP5mJcBqEePHuVFdIjXPjdJSTgX2\n8vmZiAXp0MpjGIzeXNm/uDBONkL0HqS1ZosR4IPUuuEoUmom9q4pIFEc39YA\nRs8u0qypPd0vDCtlZHXccf8q79IspX6tNwJ8we2YSzRp0+M5u7Ncy3mVXnEH\n4LNWmeLckisyjh7XC40mJbKFRXQvqoUzL7wcC9+yvFgBpuJI7ZZPoPJ3Gybw\nGJiegYt6tyrerZS86Mgv1hBotuh2gzVv7d7jJ2Ak+C10rhigkRTBmkQb8WQS\nSdgfZQZMN9nbwHyQy+NWRF1ulEvRKoqQEClS/VBwn9Mx7Vx3L022TEye9GrN\nt9HaPlTI5FLrqNpPnTOdzBjeQ5wCjZ32L4IV3jeX9AgWQ49tCWQ7XixodMb4\nxU3g\r\n=IUFC\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIFtewmkJSswlQyEf0+dJwdQymSbo8eQOIY4qLLYGHGsGAiEA7xR7h016d92VBcQE5w90Xk2n6tYJ5BkFH/BgfBC8z70="}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.24.1_1630499893243_0.9640556127680548"},"_hasShrinkwrap":false},"0.0.0-2021-09-19--10-26":{"name":"opentelemetry-instrumentation-express","version":"0.0.0-2021-09-19--10-26","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn run build","test":"mocha --require opentelemetry-instrumentation-testing-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require opentelemetry-instrumentation-testing-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"peerDependencies":{"@opentelemetry/api":"^1.0.1"},"dependencies":{"@opentelemetry/core":"^0.25.0","@opentelemetry/instrumentation":"^0.25.0","@opentelemetry/semantic-conventions":"^0.25.0","parseurl":"~1.3.3","path-to-regexp":"0.1.7"},"devDependencies":{"@opentelemetry/api":"^1.0.2","@opentelemetry/instrumentation-http":"^0.25.0","@opentelemetry/sdk-trace-base":"^0.25.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"0.0.1-rc.6","opentelemetry-instrumentation-testing-utils":"^0.0.0-2021-09-19--10-26","test-all-versions":"^5.0.1","typescript":"4.3.4"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"a05e1c6b765af7984ae8433da2290faf0c3387f6","readme":"# OpenTelemetry express Instrumentation for Node.js\n[![NPM version](https://img.shields.io/npm/v/opentelemetry-instrumentation-express.svg)](https://www.npmjs.com/package/opentelemetry-instrumentation-express)\n\nThis module provide enhanced instrumentation for the `express` web framework.\n\n## Installation\n\n```\nnpm install --save opentelemetry-instrumentation-express\n```\n## Supported Versions\nThis instrumentation supports `^4.9.0`:\n\nall versions >= `4.9.0` (released 2014) and < `5.0.0` (in alpha).\n\n## Usage\nFor further automatic instrumentation instruction see the [@opentelemetry/instrumentation](https://github.com/open-telemetry/opentelemetry-js/tree/main/packages/opentelemetry-instrumentation) package.\n\n```js\nconst { NodeTracerProvider } = require('@opentelemetry/sdk-trace-node');\nconst { registerInstrumentations } = require('@opentelemetry/instrumentation');\nconst { ExpressInstrumentation } = require('opentelemetry-instrumentation-express');\n\nconst traceProvider = new NodeTracerProvider();\ntraceProvider.register();\n\nregisterInstrumentations({\n  traceProvider,\n  instrumentations: [\n    new ExpressInstrumentation()\n  ]\n});\n```\n\n### Express Instrumentation Options\n\nExpress instrumentation has few options available to choose from. You can set the following:\n\n| Options | Type  | Description |\n| --- | --- | --- |\n| `requestHook` | `RequestHook` (function) | Hook for adding custom attributes before express start handling the request. Receives params: `span, { moduleVersion, req, res }` |\n| `includeHttpAttributes` | `boolean` | If set to true, plugin will include semantic http attributes in each express span |\n\n## Semantic Behavior\nExpress auto instrumentation will create a single span per request with the following attributes.\nDetailed specification and cases can be found [here](./doc/attributes-specification.MD).\n\n### `http.route`\nThis is a conventional http attribute, which is collected by express instead of the http module (which is not aware of the route). It will always contain path-parameterized data with low cardinality (no ids), but might be missing parts of the path in case of early termination or middlewares that accept any path.\n\nExample: `/api/users/:id`\n\n### `express.route.full`\nThis attribute will always contain the entire path. The part of the path that has been consumed by express will be shown as is (parameterized), and the leftover will be concatenated after (due to early termination or middleware that accept any path).\n\nExample: `/api/users/:id/books/758734` (The `:id` part was consumed, but the `bookid` part was not).\n\n### `express.route.configured`\nThis attribute is relevant when user configures multi path options for the same middleware. It reduces even further the cardinality space compared to `http.route`, and supply more info about how the app routing works.\n\nExample: `/api[\"/foo\", /\"bar\"]` - meaning that the same endpoint is triggered by routes `/api/foo` and `/api/bar`.\n\n### `express.route.params`\nThis attribute holds a json stringified map, where the keys are the url path param names, and the values are the matched params from the actual url.\n\nExample: `{\"id\":\"1234\"}`. \n\n### `express.unhandled`\nSet to true when request was not handled by any middleware in express, and got fallback to the default app `finalhandler`. This can happen if client sent request with invalid path or method (resulting in 404). This can be useful to filter out requests from internet bots which try to call common routes on servers.\n\n### `express.instrumentation.errors`\nIn case of internal error in instrumentation, this attribute will contain the error description. There are no known valid use cases which are expected to produce this attribute.\n\n## Difference from [@opentelemetry/instrumentation-express](https://github.com/open-telemetry/opentelemetry-js-contrib/tree/main/plugins/node/opentelemetry-instrumentation-express)\n\n* This instrumentation is focusing on extracting the most accurate and complete `route` data, in any valid express edge case. Contrib instrumentation does a good job for common cases, but miss nuances on complex setups.\n* This instrumentation create a single span per request. Contrib instrumentation creates span per express Router/Route, which can be useful to observe express internal components, with the cost of more spans in each trace.\n* Set few alternatives for route attribute, each with different level of cardinality vs accuracy.\n* Allows to set `requestHook` for adding custom attributes to span, as well as ability to capture express version into user defined attribute.\n* Distinguish between handled requests (ended from user middleware), and unhandled (terminated from express built in 'finalhandler').\n* Option to conform with the [Semantic conventions for HTTP spans](https://github.com/open-telemetry/opentelemetry-specification/blob/master/specification/trace/semantic_conventions/http.md).\n\n\n---\n\nThis extension (and many others) was developed by [Aspecto](https://www.aspecto.io/) with ❤️","readmeFilename":"README.md","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.0.0-2021-09-19--10-26","_nodeVersion":"12.22.6","_npmVersion":"lerna/3.22.1/node@v12.22.6+x64 (linux)","dist":{"integrity":"sha512-V5jN0tQRqNZ14FexKWicuiDXOfYzQezIfgGK5MK0H/lAg7p1rJivCGTMDFidYqoQrnHo/09ia+QViwOR/c2XLg==","shasum":"2d6ff24c364e1c3bd9ccbec80614d03a8b64b928","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.0.0-2021-09-19--10-26.tgz","fileCount":25,"unpackedSize":101193,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIFiSdo1o3SZVoQL0JgDT1AqEh7AZL2SnmwfCrSJnGRiyAiAoXeY7p1JKH3wjgGYP83LYwM+Ko/iy8+zwI+iwwU/R1Q=="}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.0.0-2021-09-19--10-26_1632047259673_0.5808959274423662"},"_hasShrinkwrap":false},"0.25.0":{"name":"opentelemetry-instrumentation-express","version":"0.25.0","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn run build","test":"mocha --require opentelemetry-instrumentation-testing-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require opentelemetry-instrumentation-testing-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"peerDependencies":{"@opentelemetry/api":"^1.0.1"},"dependencies":{"@opentelemetry/core":"^0.25.0","@opentelemetry/instrumentation":"^0.25.0","@opentelemetry/semantic-conventions":"^0.25.0","parseurl":"~1.3.3","path-to-regexp":"0.1.7"},"devDependencies":{"@opentelemetry/api":"^1.0.2","@opentelemetry/instrumentation-http":"^0.25.0","@opentelemetry/sdk-trace-base":"^0.25.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"0.0.1-rc.6","opentelemetry-instrumentation-testing-utils":"^0.25.0","test-all-versions":"^5.0.1","typescript":"4.3.4"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"c5d54414b125bbc927012c68ff19b97bcd5b3796","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.25.0","_nodeVersion":"12.22.6","_npmVersion":"lerna/3.22.1/node@v12.22.6+x64 (linux)","dist":{"integrity":"sha512-KfwM8YBU1mNsUzd+/KxW5e5aCKaIootASNxkNzqZqtrLLCaXH0S/DTFL0cb9TgiMSvLbsJZvoO+lAZnE9NqdIQ==","shasum":"690836e8d78ac44b1503805b5881b0503cdaeb00","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.25.0.tgz","fileCount":25,"unpackedSize":101366,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIA635g2eBw8wZGfoDaYJhOMQJfzSLmjNz4Qc2l6WiV2cAiEAtp6+FTs8UUNM32nNjg1hpoXsji3uedcOOS7lLICdizg="}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.25.0_1632055477444_0.686573243607566"},"_hasShrinkwrap":false},"0.0.0-2021-10-20--09-32":{"name":"opentelemetry-instrumentation-express","version":"0.0.0-2021-10-20--09-32","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn run build","test":"mocha --require opentelemetry-instrumentation-testing-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require opentelemetry-instrumentation-testing-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"peerDependencies":{"@opentelemetry/api":"^1.0.1"},"dependencies":{"@opentelemetry/core":"^1.0.0","@opentelemetry/instrumentation":"^0.26.0","@opentelemetry/semantic-conventions":"^1.0.0","parseurl":"~1.3.3","path-to-regexp":"0.1.7"},"devDependencies":{"@opentelemetry/api":"^1.0.2","@opentelemetry/instrumentation-http":"^0.25.0","@opentelemetry/sdk-trace-base":"1.0.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"0.0.1-rc.7","opentelemetry-instrumentation-testing-utils":"^0.0.0-2021-10-20--09-32","test-all-versions":"^5.0.1","typescript":"4.3.4"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"c1c35ba226e94cdc824171847a6e252e02912c55","readme":"# OpenTelemetry express Instrumentation for Node.js\n[![NPM version](https://img.shields.io/npm/v/opentelemetry-instrumentation-express.svg)](https://www.npmjs.com/package/opentelemetry-instrumentation-express)\n\nThis module provide enhanced instrumentation for the `express` web framework.\n\n## Installation\n\n```\nnpm install --save opentelemetry-instrumentation-express\n```\n## Supported Versions\nThis instrumentation supports `^4.9.0`:\n\nall versions >= `4.9.0` (released 2014) and < `5.0.0` (in alpha).\n\n## Usage\nFor further automatic instrumentation instruction see the [@opentelemetry/instrumentation](https://github.com/open-telemetry/opentelemetry-js/tree/main/packages/opentelemetry-instrumentation) package.\n\n```js\nconst { NodeTracerProvider } = require('@opentelemetry/sdk-trace-node');\nconst { registerInstrumentations } = require('@opentelemetry/instrumentation');\nconst { ExpressInstrumentation } = require('opentelemetry-instrumentation-express');\n\nconst traceProvider = new NodeTracerProvider();\ntraceProvider.register();\n\nregisterInstrumentations({\n  traceProvider,\n  instrumentations: [\n    new ExpressInstrumentation()\n  ]\n});\n```\n\n### Express Instrumentation Options\n\nExpress instrumentation has few options available to choose from. You can set the following:\n\n| Options | Type  | Description |\n| --- | --- | --- |\n| `requestHook` | `RequestHook` (function) | Hook for adding custom attributes before express start handling the request. Receives params: `span, { moduleVersion, req, res }` |\n| `includeHttpAttributes` | `boolean` | If set to true, plugin will include semantic http attributes in each express span |\n\n## Semantic Behavior\nExpress auto instrumentation will create a single span per request with the following attributes.\nDetailed specification and cases can be found [here](./doc/attributes-specification.MD).\n\n### `http.route`\nThis is a conventional http attribute, which is collected by express instead of the http module (which is not aware of the route). It will always contain path-parameterized data with low cardinality (no ids), but might be missing parts of the path in case of early termination or middlewares that accept any path.\n\nExample: `/api/users/:id`\n\n### `express.route.full`\nThis attribute will always contain the entire path. The part of the path that has been consumed by express will be shown as is (parameterized), and the leftover will be concatenated after (due to early termination or middleware that accept any path).\n\nExample: `/api/users/:id/books/758734` (The `:id` part was consumed, but the `bookid` part was not).\n\n### `express.route.configured`\nThis attribute is relevant when user configures multi path options for the same middleware. It reduces even further the cardinality space compared to `http.route`, and supply more info about how the app routing works.\n\nExample: `/api[\"/foo\", /\"bar\"]` - meaning that the same endpoint is triggered by routes `/api/foo` and `/api/bar`.\n\n### `express.route.params`\nThis attribute holds a json stringified map, where the keys are the url path param names, and the values are the matched params from the actual url.\n\nExample: `{\"id\":\"1234\"}`. \n\n### `express.unhandled`\nSet to true when request was not handled by any middleware in express, and got fallback to the default app `finalhandler`. This can happen if client sent request with invalid path or method (resulting in 404). This can be useful to filter out requests from internet bots which try to call common routes on servers.\n\n### `express.instrumentation.errors`\nIn case of internal error in instrumentation, this attribute will contain the error description. There are no known valid use cases which are expected to produce this attribute.\n\n## Difference from [@opentelemetry/instrumentation-express](https://github.com/open-telemetry/opentelemetry-js-contrib/tree/main/plugins/node/opentelemetry-instrumentation-express)\n\n* This instrumentation is focusing on extracting the most accurate and complete `route` data, in any valid express edge case. Contrib instrumentation does a good job for common cases, but miss nuances on complex setups.\n* This instrumentation create a single span per request. Contrib instrumentation creates span per express Router/Route, which can be useful to observe express internal components, with the cost of more spans in each trace.\n* Set few alternatives for route attribute, each with different level of cardinality vs accuracy.\n* Allows to set `requestHook` for adding custom attributes to span, as well as ability to capture express version into user defined attribute.\n* Distinguish between handled requests (ended from user middleware), and unhandled (terminated from express built in 'finalhandler').\n* Option to conform with the [Semantic conventions for HTTP spans](https://github.com/open-telemetry/opentelemetry-specification/blob/master/specification/trace/semantic_conventions/http.md).\n\n\n---\n\nThis extension (and many others) was developed by [Aspecto](https://www.aspecto.io/) with ❤️","readmeFilename":"README.md","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.0.0-2021-10-20--09-32","_nodeVersion":"12.22.6","_npmVersion":"lerna/3.22.1/node@v12.22.6+x64 (linux)","dist":{"integrity":"sha512-b/cMT+9LQNkg52fsvmD5kcFRP/dwMDjWlICBQAmhEyzE8Wxxpz90KA3YjpiA8+O1wb9JuJrDUemYv91K38HkEw==","shasum":"4a8944bd6c3a2f1d1d2c70c20548ced2cb0973f7","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.0.0-2021-10-20--09-32.tgz","fileCount":25,"unpackedSize":101449,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQDdnfZT5giYOBYQ62JGD6PGtNRLoAR0T9AuKEmkf4mcHQIgUKuLde1aay203nqyCi6avHAw4qk1qOOl/l4y2S5HpmU="}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.0.0-2021-10-20--09-32_1634722386766_0.7073742566237122"},"_hasShrinkwrap":false},"0.26.0":{"name":"opentelemetry-instrumentation-express","version":"0.26.0","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn run build","test":"mocha --require opentelemetry-instrumentation-testing-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require opentelemetry-instrumentation-testing-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"peerDependencies":{"@opentelemetry/api":"^1.0.1"},"dependencies":{"@opentelemetry/core":"^1.0.0","@opentelemetry/instrumentation":"^0.26.0","@opentelemetry/semantic-conventions":"^1.0.0","parseurl":"~1.3.3","path-to-regexp":"0.1.7"},"devDependencies":{"@opentelemetry/api":"^1.0.2","@opentelemetry/instrumentation-http":"^0.25.0","@opentelemetry/sdk-trace-base":"1.0.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"0.0.1-rc.7","opentelemetry-instrumentation-testing-utils":"^0.26.0","test-all-versions":"^5.0.1","typescript":"4.3.4"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"197677ba38ce47bdd7e57c9e74cc5a19fae7e8e2","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.26.0","_nodeVersion":"12.22.7","_npmVersion":"lerna/3.22.1/node@v12.22.7+x64 (linux)","dist":{"integrity":"sha512-XcD7aLGZw/Xb9BvnXUALWLSI/HdwvZxUKJI71XvewyfdkPk5bKXcOvKD/24r7uM8M/MVDjHcCqIrQSb3jawd+g==","shasum":"6d023ab4b89c6563d9690be4201b78fa2dff50fb","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.26.0.tgz","fileCount":25,"unpackedSize":101622,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQDYvtKklB5vKqU3KPJtAPkWR1zF3XsfcJqnsy9lyQGLYQIhANVGi98DfmqM32+QVHDkXltw3oADVrBpmmLJapkRV/Hx"}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.26.0_1635276583120_0.6612190197616199"},"_hasShrinkwrap":false},"0.26.1":{"name":"opentelemetry-instrumentation-express","version":"0.26.1","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn run build","test":"mocha --require opentelemetry-instrumentation-testing-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require opentelemetry-instrumentation-testing-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"peerDependencies":{"@opentelemetry/api":"^1.0.1"},"dependencies":{"@opentelemetry/core":"^1.0.0","@opentelemetry/instrumentation":"^0.26.0","@opentelemetry/semantic-conventions":"^1.0.0","parseurl":"~1.3.3","path-to-regexp":"0.1.7"},"devDependencies":{"@opentelemetry/api":"^1.0.2","@opentelemetry/instrumentation-http":"^0.25.0","@opentelemetry/sdk-trace-base":"1.0.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"0.0.1-rc.7","opentelemetry-instrumentation-testing-utils":"^0.26.0","test-all-versions":"^5.0.1","typescript":"4.3.4"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"d98dabe288b1d95ce7e3d8b9b2ccc3ed02854392","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.26.1","_nodeVersion":"12.22.7","_npmVersion":"lerna/3.22.1/node@v12.22.7+x64 (linux)","dist":{"integrity":"sha512-CYgoftL5UDZVr19RXenYJfygoW2t3dAwoB41Blt5KoQ5O94cVC/oZrrcaedUaJyqcIy7gMjCxU1LkfjpGjtIzQ==","shasum":"8718292011a3d48b12e1cd790806d986e7adbcec","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.26.1.tgz","fileCount":25,"unpackedSize":101886,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJhpLV1CRA9TVsSAnZWagAA/7kP/Rsvfo2mjxw8NBnWrISv\nz+Dz9g3FoCbCnNNxcJpYhbDm4G3NUuKjBTf0p70FrgaEXqoMZmLtYCHWECFU\nk0gPuVN8QhuJ8NvCsjPaZtsSgi5bU0jaAw6wOY7zSeD6xRJSvFvLUqxKB5m5\nTx7YZ5o754wPQQuMllEPudLqOKXUhgqxy8GriMk9x63Ac1NfcfQj/lT/6asf\neJ0tWf4MOYvsbwLbKxpXW8LihzgHxQ2zQEYL7JxRhR7QVh41TO1Tu1HLL6IN\nGiU4qa+Xhb0lYrgHlzjm/lWkpxDN3RZDPxa/KIwGttEKxGlsiK4uHki9dfil\nXYJvWViEz7A2RiHPn2AIpCqV1h/lJXeDWg0mhPRtC3qRg6C+cajKOtjzXGtg\noliZz8q1VSdnfV4Geqyl/FUiUK/cBCskKMjmn+/HXYqFxnRjWFCMQtrhwEiL\nP4xgbnXut8XPgoxQvsyYuIzg8/WH2t41do3OarfWgr0lLNclyM/F7aHRZMhO\nuxTDTTpUi1MKSKpy6+9ni/ed2twxye+V7RAehEfjItqcqYMUBR0MElG6JHKQ\nEbLOf5KNLbg/obpgKBCWzHwkhbhcGedtvllALu7muxVKVVwyVIk5OCiKvHb5\nMTbi+xIo3yshYFw0ycnSRgpJXj01Tj7H8E/qG/PIO39g7+aTyETOyTKEwwie\nlXHo\r\n=tp3N\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIBf1pxx8veqzRpbCD2bGUWPrh73Yym37bYJSmsMFEK4tAiAFZgRItQmdodUjiCVqv3SrAvRNAFdBF2ifw+h24Rm9IQ=="}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.26.1_1638184308878_0.27854435772023867"},"_hasShrinkwrap":false},"0.0.0-2021-12-15--12-47":{"name":"opentelemetry-instrumentation-express","version":"0.0.0-2021-12-15--12-47","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn run build","test":"mocha --require opentelemetry-instrumentation-testing-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require opentelemetry-instrumentation-testing-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"peerDependencies":{"@opentelemetry/api":"^1.0.1"},"dependencies":{"@opentelemetry/core":"^1.0.0","@opentelemetry/instrumentation":"^0.26.0","@opentelemetry/semantic-conventions":"^1.0.0","parseurl":"~1.3.3","path-to-regexp":"0.1.7"},"devDependencies":{"@opentelemetry/api":"^1.0.2","@opentelemetry/instrumentation-http":"^0.25.0","@opentelemetry/sdk-trace-base":"1.0.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"0.0.1-rc.7","opentelemetry-instrumentation-testing-utils":"^0.0.0-2021-12-15--12-47","test-all-versions":"^5.0.1","typescript":"4.3.4"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"d82d991f4f35f77cb8ac9071d7a43807667a17e2","readme":"# OpenTelemetry express Instrumentation for Node.js\n[![NPM version](https://img.shields.io/npm/v/opentelemetry-instrumentation-express.svg)](https://www.npmjs.com/package/opentelemetry-instrumentation-express)\n\nThis module provide enhanced instrumentation for the `express` web framework.\n\n## Installation\n\n```\nnpm install --save opentelemetry-instrumentation-express\n```\n## Supported Versions\nThis instrumentation supports `^4.9.0`:\n\nall versions >= `4.9.0` (released 2014) and < `5.0.0` (in alpha).\n\n## Usage\nFor further automatic instrumentation instruction see the [@opentelemetry/instrumentation](https://github.com/open-telemetry/opentelemetry-js/tree/main/packages/opentelemetry-instrumentation) package.\n\n```js\nconst { NodeTracerProvider } = require('@opentelemetry/sdk-trace-node');\nconst { registerInstrumentations } = require('@opentelemetry/instrumentation');\nconst { ExpressInstrumentation } = require('opentelemetry-instrumentation-express');\n\nconst tracerProvider = new NodeTracerProvider();\ntracerProvider.register();\n\nregisterInstrumentations({\n  tracerProvider,\n  instrumentations: [\n    new ExpressInstrumentation()\n  ]\n});\n```\n\n### Express Instrumentation Options\n\nExpress instrumentation has few options available to choose from. You can set the following:\n\n| Options | Type  | Description |\n| --- | --- | --- |\n| `requestHook` | `RequestHook` (function) | Hook for adding custom attributes before express start handling the request. Receives params: `span, { moduleVersion, req, res }` |\n| `includeHttpAttributes` | `boolean` | If set to true, plugin will include semantic http attributes in each express span |\n\n## Semantic Behavior\nExpress auto instrumentation will create a single span per request with the following attributes.\nDetailed specification and cases can be found [here](./doc/attributes-specification.MD).\n\n### `http.route`\nThis is a conventional http attribute, which is collected by express instead of the http module (which is not aware of the route). It will always contain path-parameterized data with low cardinality (no ids), but might be missing parts of the path in case of early termination or middlewares that accept any path.\n\nExample: `/api/users/:id`\n\n### `express.route.full`\nThis attribute will always contain the entire path. The part of the path that has been consumed by express will be shown as is (parameterized), and the leftover will be concatenated after (due to early termination or middleware that accept any path).\n\nExample: `/api/users/:id/books/758734` (The `:id` part was consumed, but the `bookid` part was not).\n\n### `express.route.configured`\nThis attribute is relevant when user configures multi path options for the same middleware. It reduces even further the cardinality space compared to `http.route`, and supply more info about how the app routing works.\n\nExample: `/api[\"/foo\", /\"bar\"]` - meaning that the same endpoint is triggered by routes `/api/foo` and `/api/bar`.\n\n### `express.route.params`\nThis attribute holds a json stringified map, where the keys are the url path param names, and the values are the matched params from the actual url.\n\nExample: `{\"id\":\"1234\"}`. \n\n### `express.unhandled`\nSet to true when request was not handled by any middleware in express, and got fallback to the default app `finalhandler`. This can happen if client sent request with invalid path or method (resulting in 404). This can be useful to filter out requests from internet bots which try to call common routes on servers.\n\n### `express.instrumentation.errors`\nIn case of internal error in instrumentation, this attribute will contain the error description. There are no known valid use cases which are expected to produce this attribute.\n\n## Difference from [@opentelemetry/instrumentation-express](https://github.com/open-telemetry/opentelemetry-js-contrib/tree/main/plugins/node/opentelemetry-instrumentation-express)\n\n* This instrumentation is focusing on extracting the most accurate and complete `route` data, in any valid express edge case. Contrib instrumentation does a good job for common cases, but miss nuances on complex setups.\n* This instrumentation create a single span per request. Contrib instrumentation creates span per express Router/Route, which can be useful to observe express internal components, with the cost of more spans in each trace.\n* Set few alternatives for route attribute, each with different level of cardinality vs accuracy.\n* Allows to set `requestHook` for adding custom attributes to span, as well as ability to capture express version into user defined attribute.\n* Distinguish between handled requests (ended from user middleware), and unhandled (terminated from express built in 'finalhandler').\n* Option to conform with the [Semantic conventions for HTTP spans](https://github.com/open-telemetry/opentelemetry-specification/blob/master/specification/trace/semantic_conventions/http.md).\n\n\n---\n\nThis extension (and many others) was developed by [Aspecto](https://www.aspecto.io/) with ❤️","readmeFilename":"README.md","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.0.0-2021-12-15--12-47","_nodeVersion":"12.22.7","_npmVersion":"lerna/3.22.1/node@v12.22.7+x64 (linux)","dist":{"integrity":"sha512-0VYOc81rKEw9yByYerej4AIuz2X0gFiMpLnH4xzqgOBcAXsJrXN9TiUY+fZMpZMECSy8njmgbk9VIbReZFz/rg==","shasum":"cc19d4ec01902ebd49c7450672521e314051629e","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.0.0-2021-12-15--12-47.tgz","fileCount":25,"unpackedSize":101973,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJhueQpCRA9TVsSAnZWagAAMPQP/3fKlXJx1CuhdEvZoZtZ\ncEWn8uswQ2Qtd5yh7YIyuIVyDnq0CNOcaXwVE18gC5b8bAmMJ+B6485aCF+F\nfPeUy1O0cwM4W4RYk8Gjq7FD4/1osOrYyGrJlvDA7EkggKaJNFoVA/ZF/v6G\ngvdKjWrthjrbAhBgNQ8FZkOXsxMG+gnf0WWBNfIzSE5z2LFQ90+TPx8nOFXV\n+v5omhn57SZnfi81/cpNSWGFRnHq7T2jfRRQLPwHwn/a/h14yLoX44D//QMM\nvuZvfG1cZmp6JcfgJ1c8lBk6SJTnLJlgZ0FLvQjaHJE9HEPUg1YXro4JpPbs\nmEo8ppfmsaqK21IwFfWtSuspYoJfOi7pNxrPVWyEJQ97xfWw8N/5K6h+HFJM\nuEPyNrM9jO8AHxZi3XB6kMFwzsabKt7+1Jg+TxzdGpLNTJOso/kh+BCJAEKD\nNx9tfGxusUEyZ7Dnn4mYRFiADj5BQ1eHAuuA6Yt9jWJIoVgP+WUQzza45fdO\nMgnyUQ908ht9dU2V0QdycEyLNu4jw+/f53TA7PZYBN3Qn8U6kYwVnyy4NlbL\niBp2tcJdmH36RFqTDSA0H3iC8Ae8Jxfc0I7VWJqBBCqKlqxCSJbovyBMrOaK\n7V/o0/pEWEp3Jz3f9quZ86Z7mK4mYpC26w9hmdQUV15T74q40oVrvbwXpedW\nxC+Z\r\n=a3S7\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIB6jsiM3nQnK3N6t16DABAhyA5AK6wXAON0TO6IMRDUuAiEAgbXSd/FHosGIpAZDvhru+7Fo4HH2NCCrz9gqTq5wAQQ="}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.0.0-2021-12-15--12-47_1639572521657_0.12676039085223167"},"_hasShrinkwrap":false},"0.0.0-2021-12-15--13-05":{"name":"opentelemetry-instrumentation-express","version":"0.0.0-2021-12-15--13-05","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn run build","test":"mocha --require opentelemetry-instrumentation-testing-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require opentelemetry-instrumentation-testing-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"peerDependencies":{"@opentelemetry/api":"^1.0.1"},"dependencies":{"@opentelemetry/core":"^1.0.0","@opentelemetry/instrumentation":"^0.26.0","@opentelemetry/semantic-conventions":"^1.0.0","parseurl":"~1.3.3","path-to-regexp":"0.1.7"},"devDependencies":{"@opentelemetry/api":"^1.0.2","@opentelemetry/instrumentation-http":"^0.25.0","@opentelemetry/sdk-trace-base":"1.0.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"0.0.1-rc.7","opentelemetry-instrumentation-testing-utils":"^0.0.0-2021-12-15--13-05","test-all-versions":"^5.0.1","typescript":"4.3.4"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"8500885ec40cd62c62efd9758ed4b005fc201674","readme":"# OpenTelemetry express Instrumentation for Node.js\n[![NPM version](https://img.shields.io/npm/v/opentelemetry-instrumentation-express.svg)](https://www.npmjs.com/package/opentelemetry-instrumentation-express)\n\nThis module provide enhanced instrumentation for the `express` web framework.\n\n## Installation\n\n```\nnpm install --save opentelemetry-instrumentation-express\n```\n## Supported Versions\nThis instrumentation supports `^4.9.0`:\n\nall versions >= `4.9.0` (released 2014) and < `5.0.0` (in alpha).\n\n## Usage\nFor further automatic instrumentation instruction see the [@opentelemetry/instrumentation](https://github.com/open-telemetry/opentelemetry-js/tree/main/packages/opentelemetry-instrumentation) package.\n\n```js\nconst { NodeTracerProvider } = require('@opentelemetry/sdk-trace-node');\nconst { registerInstrumentations } = require('@opentelemetry/instrumentation');\nconst { ExpressInstrumentation } = require('opentelemetry-instrumentation-express');\n\nconst tracerProvider = new NodeTracerProvider();\ntracerProvider.register();\n\nregisterInstrumentations({\n  tracerProvider,\n  instrumentations: [\n    new ExpressInstrumentation()\n  ]\n});\n```\n\n### Express Instrumentation Options\n\nExpress instrumentation has few options available to choose from. You can set the following:\n\n| Options | Type  | Description |\n| --- | --- | --- |\n| `requestHook` | `RequestHook` (function) | Hook for adding custom attributes before express start handling the request. Receives params: `span, { moduleVersion, req, res }` |\n| `includeHttpAttributes` | `boolean` | If set to true, plugin will include semantic http attributes in each express span |\n\n## Semantic Behavior\nExpress auto instrumentation will create a single span per request with the following attributes.\nDetailed specification and cases can be found [here](./doc/attributes-specification.MD).\n\n### `http.route`\nThis is a conventional http attribute, which is collected by express instead of the http module (which is not aware of the route). It will always contain path-parameterized data with low cardinality (no ids), but might be missing parts of the path in case of early termination or middlewares that accept any path.\n\nExample: `/api/users/:id`\n\n### `express.route.full`\nThis attribute will always contain the entire path. The part of the path that has been consumed by express will be shown as is (parameterized), and the leftover will be concatenated after (due to early termination or middleware that accept any path).\n\nExample: `/api/users/:id/books/758734` (The `:id` part was consumed, but the `bookid` part was not).\n\n### `express.route.configured`\nThis attribute is relevant when user configures multi path options for the same middleware. It reduces even further the cardinality space compared to `http.route`, and supply more info about how the app routing works.\n\nExample: `/api[\"/foo\", /\"bar\"]` - meaning that the same endpoint is triggered by routes `/api/foo` and `/api/bar`.\n\n### `express.route.params`\nThis attribute holds a json stringified map, where the keys are the url path param names, and the values are the matched params from the actual url.\n\nExample: `{\"id\":\"1234\"}`. \n\n### `express.unhandled`\nSet to true when request was not handled by any middleware in express, and got fallback to the default app `finalhandler`. This can happen if client sent request with invalid path or method (resulting in 404). This can be useful to filter out requests from internet bots which try to call common routes on servers.\n\n### `express.instrumentation.errors`\nIn case of internal error in instrumentation, this attribute will contain the error description. There are no known valid use cases which are expected to produce this attribute.\n\n## Difference from [@opentelemetry/instrumentation-express](https://github.com/open-telemetry/opentelemetry-js-contrib/tree/main/plugins/node/opentelemetry-instrumentation-express)\n\n* This instrumentation is focusing on extracting the most accurate and complete `route` data, in any valid express edge case. Contrib instrumentation does a good job for common cases, but miss nuances on complex setups.\n* This instrumentation create a single span per request. Contrib instrumentation creates span per express Router/Route, which can be useful to observe express internal components, with the cost of more spans in each trace.\n* Set few alternatives for route attribute, each with different level of cardinality vs accuracy.\n* Allows to set `requestHook` for adding custom attributes to span, as well as ability to capture express version into user defined attribute.\n* Distinguish between handled requests (ended from user middleware), and unhandled (terminated from express built in 'finalhandler').\n* Option to conform with the [Semantic conventions for HTTP spans](https://github.com/open-telemetry/opentelemetry-specification/blob/master/specification/trace/semantic_conventions/http.md).\n\n\n---\n\nThis extension (and many others) was developed by [Aspecto](https://www.aspecto.io/) with ❤️","readmeFilename":"README.md","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.0.0-2021-12-15--13-05","_nodeVersion":"12.22.7","_npmVersion":"lerna/3.22.1/node@v12.22.7+x64 (linux)","dist":{"integrity":"sha512-3IbDhrK2APSmmsslYffEeKhSFxsVvuGHY93eMZnpMkw4G3JE9yGJHgeK3Xb1X1+0bSPT7+t/oN8m1DwrkaP3UA==","shasum":"f2f29a34018c2ddda1ba8df5b8ff68116ebe8f45","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.0.0-2021-12-15--13-05.tgz","fileCount":25,"unpackedSize":101973,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJhuehrCRA9TVsSAnZWagAA5xkP+wQCk7eiQLr/KIVCLiAj\nxQJ0/IwLwU7EW5itLYS1NpCYWpAYYYdaxqRl0uRDIFeBXVYlhX9IBZK9eG+4\nDolOt7Au1ZwZhj1UwoMYWUNBalsUa6Tl8wGr4zOmTdNBiB6Xs4Z2kyFND+0D\nBPSWc6ec5nlsp78hmAganpcedb5SLJgbI+PzRklbzw7BpzKzbuNekpFVR0Eq\nUgTXUT3LxH3LILMytL/MTcWkKcSd0lpgBxVLiMucWTARMR4cKbpA5z0Bufg9\nNpgqYDTWKVbvQ626IMJK5rWHiKP0R3Bf3+2stYwtJ0Wjj7nzJyt3pSWYzwy1\nzmgVMI5F6MW7aBmwZ41D7MvVzlgVhxIVPRV5H/RcFdBIkLqaoSnIwOqTu7Fz\n/MJS8WM1PMLyPJ/M4aEOgbS2AbU+Kj78OXLohKzsePmu1X3KQHQNFtELz6ga\ntKBRMgrVgILb3hVO8b46aR1v/S4KVIio6S20zuGxBW3GRYZefDOIlBKuIlta\nwEYe2v0D6kXtWPPYoWkneGiXW0jF/3pJM1cnqRvX2mx6niwyS2MtKI18YnFC\nZMfz8Sd4/ftIF3537olQei8Z78xTZ1zFLOd72ZeRSsqq97Ll961u0hU8rgVf\nuepZMHS4KeOocK8q2HOWeMMVJaNgQWnFj0qTBgxN7kO6Cnzn+1dDu/ZLvfQG\n0rgS\r\n=njM1\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQC1vYuYpX/AZJJBr9RhRQoQVEWCnDn9kJNO8mk8r6z1iwIhAOYmxDSIjUAklpbnZZuJnKb6WSRA7E8w26590K+DQYQY"}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.0.0-2021-12-15--13-05_1639573611851_0.939546715776229"},"_hasShrinkwrap":false},"0.0.0-2021-12-15--13-29":{"name":"opentelemetry-instrumentation-express","version":"0.0.0-2021-12-15--13-29","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn run build","test":"mocha --require opentelemetry-instrumentation-testing-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require opentelemetry-instrumentation-testing-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"peerDependencies":{"@opentelemetry/api":"^1.0.1"},"dependencies":{"@opentelemetry/core":"^1.0.0","@opentelemetry/instrumentation":"^0.26.0","@opentelemetry/semantic-conventions":"^1.0.0","parseurl":"~1.3.3","path-to-regexp":"0.1.7"},"devDependencies":{"@opentelemetry/api":"^1.0.2","@opentelemetry/instrumentation-http":"^0.25.0","@opentelemetry/sdk-trace-base":"1.0.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"0.0.1-rc.7","opentelemetry-instrumentation-testing-utils":"^0.0.0-2021-12-15--13-29","test-all-versions":"^5.0.1","typescript":"4.3.4"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"f57843bf0453b8bd2aa71246bd7cbd81e82539ef","readme":"# OpenTelemetry express Instrumentation for Node.js\n[![NPM version](https://img.shields.io/npm/v/opentelemetry-instrumentation-express.svg)](https://www.npmjs.com/package/opentelemetry-instrumentation-express)\n\nThis module provide enhanced instrumentation for the `express` web framework.\n\n## Installation\n\n```\nnpm install --save opentelemetry-instrumentation-express\n```\n## Supported Versions\nThis instrumentation supports `^4.9.0`:\n\nall versions >= `4.9.0` (released 2014) and < `5.0.0` (in alpha).\n\n## Usage\nFor further automatic instrumentation instruction see the [@opentelemetry/instrumentation](https://github.com/open-telemetry/opentelemetry-js/tree/main/packages/opentelemetry-instrumentation) package.\n\n```js\nconst { NodeTracerProvider } = require('@opentelemetry/sdk-trace-node');\nconst { registerInstrumentations } = require('@opentelemetry/instrumentation');\nconst { ExpressInstrumentation } = require('opentelemetry-instrumentation-express');\n\nconst tracerProvider = new NodeTracerProvider();\ntracerProvider.register();\n\nregisterInstrumentations({\n  tracerProvider,\n  instrumentations: [\n    new ExpressInstrumentation()\n  ]\n});\n```\n\n### Express Instrumentation Options\n\nExpress instrumentation has few options available to choose from. You can set the following:\n\n| Options | Type  | Description |\n| --- | --- | --- |\n| `requestHook` | `RequestHook` (function) | Hook for adding custom attributes before express start handling the request. Receives params: `span, { moduleVersion, req, res }` |\n| `includeHttpAttributes` | `boolean` | If set to true, plugin will include semantic http attributes in each express span |\n\n## Semantic Behavior\nExpress auto instrumentation will create a single span per request with the following attributes.\nDetailed specification and cases can be found [here](./doc/attributes-specification.MD).\n\n### `http.route`\nThis is a conventional http attribute, which is collected by express instead of the http module (which is not aware of the route). It will always contain path-parameterized data with low cardinality (no ids), but might be missing parts of the path in case of early termination or middlewares that accept any path.\n\nExample: `/api/users/:id`\n\n### `express.route.full`\nThis attribute will always contain the entire path. The part of the path that has been consumed by express will be shown as is (parameterized), and the leftover will be concatenated after (due to early termination or middleware that accept any path).\n\nExample: `/api/users/:id/books/758734` (The `:id` part was consumed, but the `bookid` part was not).\n\n### `express.route.configured`\nThis attribute is relevant when user configures multi path options for the same middleware. It reduces even further the cardinality space compared to `http.route`, and supply more info about how the app routing works.\n\nExample: `/api[\"/foo\", /\"bar\"]` - meaning that the same endpoint is triggered by routes `/api/foo` and `/api/bar`.\n\n### `express.route.params`\nThis attribute holds a json stringified map, where the keys are the url path param names, and the values are the matched params from the actual url.\n\nExample: `{\"id\":\"1234\"}`. \n\n### `express.unhandled`\nSet to true when request was not handled by any middleware in express, and got fallback to the default app `finalhandler`. This can happen if client sent request with invalid path or method (resulting in 404). This can be useful to filter out requests from internet bots which try to call common routes on servers.\n\n### `express.instrumentation.errors`\nIn case of internal error in instrumentation, this attribute will contain the error description. There are no known valid use cases which are expected to produce this attribute.\n\n## Difference from [@opentelemetry/instrumentation-express](https://github.com/open-telemetry/opentelemetry-js-contrib/tree/main/plugins/node/opentelemetry-instrumentation-express)\n\n* This instrumentation is focusing on extracting the most accurate and complete `route` data, in any valid express edge case. Contrib instrumentation does a good job for common cases, but miss nuances on complex setups.\n* This instrumentation create a single span per request. Contrib instrumentation creates span per express Router/Route, which can be useful to observe express internal components, with the cost of more spans in each trace.\n* Set few alternatives for route attribute, each with different level of cardinality vs accuracy.\n* Allows to set `requestHook` for adding custom attributes to span, as well as ability to capture express version into user defined attribute.\n* Distinguish between handled requests (ended from user middleware), and unhandled (terminated from express built in 'finalhandler').\n* Option to conform with the [Semantic conventions for HTTP spans](https://github.com/open-telemetry/opentelemetry-specification/blob/master/specification/trace/semantic_conventions/http.md).\n\n\n---\n\nThis extension (and many others) was developed by [Aspecto](https://www.aspecto.io/) with ❤️","readmeFilename":"README.md","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.0.0-2021-12-15--13-29","_nodeVersion":"12.22.7","_npmVersion":"lerna/3.22.1/node@v12.22.7+x64 (linux)","dist":{"integrity":"sha512-FzdBToGxwBcdaTD3XdU9nqu2nZKklbFDVUm2CfmeTNmPNtS6oBocvsCUh8cksieNb5syzcXd+Phkmx55Jske5g==","shasum":"6cdf9c29f373f5f9aaaad9709f37da7115c5689e","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.0.0-2021-12-15--13-29.tgz","fileCount":25,"unpackedSize":101973,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJhue4YCRA9TVsSAnZWagAA5xEP/AlNSOJte+Oe4Lvv6xMd\nTiIUC7I4My9kqJVzgs1P1NWHIkOtqamKytZpS7Q/90g3a3OkVMD2C1d5SS51\ntjCd50+qO7EA6R6Mje4xsU3vPTN+5/CMV7j3kblfNK418HUFWNFthwCONVmY\nKaOufN1RJgU9zmOEXlXsIgRpourpTXw6BewGiBMG8ZBMKWC+X7kwGLrXADOg\nYrmaGC978rQp3+Ta3CSvW3GFwiTwQgkJ1kjKjkihhpmB1Vaq+0yhp1zyWYJ+\njPBVSv02nE+wJNTIj7AIoMwPeWaQ275+BFHpEeabrdSmVQmsDpZFFAmiiNzM\nzFFPUi9r9kfhVezYdHheWOuBF0qJ8T9sVKC3SZhcnKmITIT4uEQHp2kst+vi\n5w+rZEeO63ZNCOLdvj2X/+0++RwXbpFJ7u/FtzSBMHeVlNXFaMKw5aJfQV81\nT8hT+gF1GMdd/tgqUKAF2RG9dPO5g0nQeP9ygPe4VNFBCspHZVq5IZczt0Uh\nHPWOiV1rgdaL9fcPe0e/NVB0jvP6BdEp+qYhRfxp1ySXAVuv6NIORZ4qTBD0\nE71B9w2Cx6Eab+WipaERszUbqOQvUIS7OnrND7MKVDI3l6NeiwAVzv9dbEbd\nEXV99GjG7+18v/yIfnKY7GR7ucDqTqdQlU0ghLsQhAYGKF2QTHqAUf0EVFhi\nMDHt\r\n=L+rR\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIDAcaLmS1udmyUYdOBNI9JEq6X7Z3n5lCI7JKzA0WUoUAiEAhpGYmVoRdO1e2hDLYc4OOWquPFv8EBtgm3UTEP0fiA4="}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.0.0-2021-12-15--13-29_1639575064564_0.9591329897283687"},"_hasShrinkwrap":false},"0.0.0-2021-12-15--16-17":{"name":"opentelemetry-instrumentation-express","version":"0.0.0-2021-12-15--16-17","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn run build","test":"mocha --require opentelemetry-instrumentation-testing-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require opentelemetry-instrumentation-testing-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"peerDependencies":{"@opentelemetry/api":"^1.0.1"},"dependencies":{"@opentelemetry/core":"^1.0.0","@opentelemetry/instrumentation":"^0.26.0","@opentelemetry/semantic-conventions":"^1.0.0","parseurl":"~1.3.3","path-to-regexp":"0.1.7"},"devDependencies":{"@opentelemetry/api":"^1.0.2","@opentelemetry/instrumentation-http":"^0.25.0","@opentelemetry/sdk-trace-base":"1.0.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"0.0.1-rc.7","opentelemetry-instrumentation-testing-utils":"^0.0.0-2021-12-15--16-17","test-all-versions":"^5.0.1","typescript":"4.3.4"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"53721d6b1d7ef8fb79ab5167c34ee22da645bac0","readme":"# OpenTelemetry express Instrumentation for Node.js\n[![NPM version](https://img.shields.io/npm/v/opentelemetry-instrumentation-express.svg)](https://www.npmjs.com/package/opentelemetry-instrumentation-express)\n\nThis module provide enhanced instrumentation for the `express` web framework.\n\n## Installation\n\n```\nnpm install --save opentelemetry-instrumentation-express\n```\n## Supported Versions\nThis instrumentation supports `^4.9.0`:\n\nall versions >= `4.9.0` (released 2014) and < `5.0.0` (in alpha).\n\n## Usage\nFor further automatic instrumentation instruction see the [@opentelemetry/instrumentation](https://github.com/open-telemetry/opentelemetry-js/tree/main/packages/opentelemetry-instrumentation) package.\n\n```js\nconst { NodeTracerProvider } = require('@opentelemetry/sdk-trace-node');\nconst { registerInstrumentations } = require('@opentelemetry/instrumentation');\nconst { ExpressInstrumentation } = require('opentelemetry-instrumentation-express');\n\nconst tracerProvider = new NodeTracerProvider();\ntracerProvider.register();\n\nregisterInstrumentations({\n  tracerProvider,\n  instrumentations: [\n    new ExpressInstrumentation()\n  ]\n});\n```\n\n### Express Instrumentation Options\n\nExpress instrumentation has few options available to choose from. You can set the following:\n\n| Options | Type  | Description |\n| --- | --- | --- |\n| `requestHook` | `RequestHook` (function) | Hook for adding custom attributes before express start handling the request. Receives params: `span, { moduleVersion, req, res }` |\n| `includeHttpAttributes` | `boolean` | If set to true, plugin will include semantic http attributes in each express span |\n\n## Semantic Behavior\nExpress auto instrumentation will create a single span per request with the following attributes.\nDetailed specification and cases can be found [here](./doc/attributes-specification.MD).\n\n### `http.route`\nThis is a conventional http attribute, which is collected by express instead of the http module (which is not aware of the route). It will always contain path-parameterized data with low cardinality (no ids), but might be missing parts of the path in case of early termination or middlewares that accept any path.\n\nExample: `/api/users/:id`\n\n### `express.route.full`\nThis attribute will always contain the entire path. The part of the path that has been consumed by express will be shown as is (parameterized), and the leftover will be concatenated after (due to early termination or middleware that accept any path).\n\nExample: `/api/users/:id/books/758734` (The `:id` part was consumed, but the `bookid` part was not).\n\n### `express.route.configured`\nThis attribute is relevant when user configures multi path options for the same middleware. It reduces even further the cardinality space compared to `http.route`, and supply more info about how the app routing works.\n\nExample: `/api[\"/foo\", /\"bar\"]` - meaning that the same endpoint is triggered by routes `/api/foo` and `/api/bar`.\n\n### `express.route.params`\nThis attribute holds a json stringified map, where the keys are the url path param names, and the values are the matched params from the actual url.\n\nExample: `{\"id\":\"1234\"}`. \n\n### `express.unhandled`\nSet to true when request was not handled by any middleware in express, and got fallback to the default app `finalhandler`. This can happen if client sent request with invalid path or method (resulting in 404). This can be useful to filter out requests from internet bots which try to call common routes on servers.\n\n### `express.instrumentation.errors`\nIn case of internal error in instrumentation, this attribute will contain the error description. There are no known valid use cases which are expected to produce this attribute.\n\n## Difference from [@opentelemetry/instrumentation-express](https://github.com/open-telemetry/opentelemetry-js-contrib/tree/main/plugins/node/opentelemetry-instrumentation-express)\n\n* This instrumentation is focusing on extracting the most accurate and complete `route` data, in any valid express edge case. Contrib instrumentation does a good job for common cases, but miss nuances on complex setups.\n* This instrumentation create a single span per request. Contrib instrumentation creates span per express Router/Route, which can be useful to observe express internal components, with the cost of more spans in each trace.\n* Set few alternatives for route attribute, each with different level of cardinality vs accuracy.\n* Allows to set `requestHook` for adding custom attributes to span, as well as ability to capture express version into user defined attribute.\n* Distinguish between handled requests (ended from user middleware), and unhandled (terminated from express built in 'finalhandler').\n* Option to conform with the [Semantic conventions for HTTP spans](https://github.com/open-telemetry/opentelemetry-specification/blob/master/specification/trace/semantic_conventions/http.md).\n\n\n---\n\nThis extension (and many others) was developed by [Aspecto](https://www.aspecto.io/) with ❤️","readmeFilename":"README.md","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.0.0-2021-12-15--16-17","_nodeVersion":"12.22.7","_npmVersion":"lerna/3.22.1/node@v12.22.7+x64 (linux)","dist":{"integrity":"sha512-B1O0qZ/dPAh1wYFik8QT5AknOHLo/oTEs80vcIYwoTkDHSXb9Tu2gu8W8OWb4QHRfDFiA5TeJoZjLU1eJZcZdA==","shasum":"7c8f97e21218295c400f54ce8194a886317277f5","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.0.0-2021-12-15--16-17.tgz","fileCount":25,"unpackedSize":101973,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJhuhVKCRA9TVsSAnZWagAAQsgP/ixguRr1gQhniuTU3TsI\nKe+ctyUnpQLbcHYurEUs2Z+fosSVCVyLbUMgUZkRuxzCaoC6u3jPasnfPW0h\nQzQntK0mkfs7Z3TPLVJZ/8VAS3leuvk7G2YaocH2VTINmK8mtu3At3UpMbag\nCpGTuu/3I0VeuGTE5vBBxlVMqRUC51Y1ePUNDfuE79JvwGRX/kEnew04udy4\nMFNQJ+5ngaOz6BE344W4uhNhdoIiGXvKMzK/pWLC++UQiN6bXAQD3JfNVnpL\n1mGWqjbTgGGdbepBfLS4XoAuKccoCb3+c5e/fiHIoIPgclRrYKD6eP6KlT+x\nNtuXH6yniouLlOdi1QJymG7ZIyhjFtbHdM8SEIfnLJQZqFR6ICUPk159NDeP\nqcjIaYGl7gX37uaeGKe7F1NXGao9JGu5MyxHf0UYzwEJVcJ/3CClcyTgRRrn\nrHzsc8hBygQ2rziVoRKx9QVtTf7L8jX6Zq35M1wzDE97QvOjzXU81n9B8kH5\n1AREVr5vpRyxQsfEmM/7tMAlNARZze1S7Gp/HHtDuSvP0qju4GjD2vr7rbub\nC3q5kOnGFfBXRIe9OZx0Sjihhmv/UCjD27vvsZdtY9cmMgMRoEi5FC4Hg5yS\nj4r81MC+bbO8GutKdgxhTc2PJ08ylJ7yfIKHqRueMSJlou3LCOVZCGoGPm/Y\n4V4/\r\n=ubw2\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQC9wP7/hVlAMEVrVEy/MltD9tE9k8O7dyrHdJmvKS3fRQIhAMwSMwZVwxy5GHOk0fOvKk/pypT5pMigZ8JPtoto3H9K"}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.0.0-2021-12-15--16-17_1639585098270_0.07659229409655932"},"_hasShrinkwrap":false},"0.0.0-2021-12-20--13-41":{"name":"opentelemetry-instrumentation-express","version":"0.0.0-2021-12-20--13-41","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn run build","test":"mocha --require opentelemetry-instrumentation-testing-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require opentelemetry-instrumentation-testing-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"peerDependencies":{"@opentelemetry/api":"^1.0.1"},"dependencies":{"@opentelemetry/core":"^1.0.0","@opentelemetry/instrumentation":"^0.26.0","@opentelemetry/semantic-conventions":"^1.0.0","parseurl":"~1.3.3","path-to-regexp":"0.1.7"},"devDependencies":{"@opentelemetry/api":"^1.0.2","@opentelemetry/instrumentation-http":"^0.25.0","@opentelemetry/sdk-trace-base":"1.0.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"0.0.1-rc.7","opentelemetry-instrumentation-testing-utils":"^0.0.0-2021-12-20--13-41","test-all-versions":"^5.0.1","typescript":"4.3.4"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"5b751df473de22ae885ae8f740f8966736489a47","readme":"# OpenTelemetry express Instrumentation for Node.js\n[![NPM version](https://img.shields.io/npm/v/opentelemetry-instrumentation-express.svg)](https://www.npmjs.com/package/opentelemetry-instrumentation-express)\n\nThis module provide enhanced instrumentation for the `express` web framework.\n\n## Installation\n\n```\nnpm install --save opentelemetry-instrumentation-express\n```\n## Supported Versions\nThis instrumentation supports `^4.9.0`:\n\nall versions >= `4.9.0` (released 2014) and < `5.0.0` (in alpha).\n\n## Usage\nFor further automatic instrumentation instruction see the [@opentelemetry/instrumentation](https://github.com/open-telemetry/opentelemetry-js/tree/main/packages/opentelemetry-instrumentation) package.\n\n```js\nconst { NodeTracerProvider } = require('@opentelemetry/sdk-trace-node');\nconst { registerInstrumentations } = require('@opentelemetry/instrumentation');\nconst { ExpressInstrumentation } = require('opentelemetry-instrumentation-express');\n\nconst tracerProvider = new NodeTracerProvider();\ntracerProvider.register();\n\nregisterInstrumentations({\n  tracerProvider,\n  instrumentations: [\n    new ExpressInstrumentation()\n  ]\n});\n```\n\n### Express Instrumentation Options\n\nExpress instrumentation has few options available to choose from. You can set the following:\n\n| Options | Type  | Description |\n| --- | --- | --- |\n| `requestHook` | `RequestHook` (function) | Hook for adding custom attributes before express start handling the request. Receives params: `span, { moduleVersion, req, res }` |\n| `includeHttpAttributes` | `boolean` | If set to true, plugin will include semantic http attributes in each express span |\n\n## Semantic Behavior\nExpress auto instrumentation will create a single span per request with the following attributes.\nDetailed specification and cases can be found [here](./doc/attributes-specification.MD).\n\n### `http.route`\nThis is a conventional http attribute, which is collected by express instead of the http module (which is not aware of the route). It will always contain path-parameterized data with low cardinality (no ids), but might be missing parts of the path in case of early termination or middlewares that accept any path.\n\nExample: `/api/users/:id`\n\n### `express.route.full`\nThis attribute will always contain the entire path. The part of the path that has been consumed by express will be shown as is (parameterized), and the leftover will be concatenated after (due to early termination or middleware that accept any path).\n\nExample: `/api/users/:id/books/758734` (The `:id` part was consumed, but the `bookid` part was not).\n\n### `express.route.configured`\nThis attribute is relevant when user configures multi path options for the same middleware. It reduces even further the cardinality space compared to `http.route`, and supply more info about how the app routing works.\n\nExample: `/api[\"/foo\", /\"bar\"]` - meaning that the same endpoint is triggered by routes `/api/foo` and `/api/bar`.\n\n### `express.route.params`\nThis attribute holds a json stringified map, where the keys are the url path param names, and the values are the matched params from the actual url.\n\nExample: `{\"id\":\"1234\"}`. \n\n### `express.unhandled`\nSet to true when request was not handled by any middleware in express, and got fallback to the default app `finalhandler`. This can happen if client sent request with invalid path or method (resulting in 404). This can be useful to filter out requests from internet bots which try to call common routes on servers.\n\n### `express.instrumentation.errors`\nIn case of internal error in instrumentation, this attribute will contain the error description. There are no known valid use cases which are expected to produce this attribute.\n\n## Difference from [@opentelemetry/instrumentation-express](https://github.com/open-telemetry/opentelemetry-js-contrib/tree/main/plugins/node/opentelemetry-instrumentation-express)\n\n* This instrumentation is focusing on extracting the most accurate and complete `route` data, in any valid express edge case. Contrib instrumentation does a good job for common cases, but miss nuances on complex setups.\n* This instrumentation create a single span per request. Contrib instrumentation creates span per express Router/Route, which can be useful to observe express internal components, with the cost of more spans in each trace.\n* Set few alternatives for route attribute, each with different level of cardinality vs accuracy.\n* Allows to set `requestHook` for adding custom attributes to span, as well as ability to capture express version into user defined attribute.\n* Distinguish between handled requests (ended from user middleware), and unhandled (terminated from express built in 'finalhandler').\n* Option to conform with the [Semantic conventions for HTTP spans](https://github.com/open-telemetry/opentelemetry-specification/blob/master/specification/trace/semantic_conventions/http.md).\n\n\n---\n\nThis extension (and many others) was developed by [Aspecto](https://www.aspecto.io/) with ❤️","readmeFilename":"README.md","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.0.0-2021-12-20--13-41","_nodeVersion":"12.22.7","_npmVersion":"lerna/3.22.1/node@v12.22.7+x64 (linux)","dist":{"integrity":"sha512-/oxg8gaH1StIynv0sGaJHicQBKhNTOtJaLj5EnRbPQTy6XehU+pFFgGCAg52vT0G63bPjoMfV+m1aiO9mmMY5g==","shasum":"a310db9a36bce87dbea870ca8617bd43790b77e0","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.0.0-2021-12-20--13-41.tgz","fileCount":25,"unpackedSize":101973,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJhwIgzCRA9TVsSAnZWagAAkVwP/0VADYhE8yyoqd/laI3H\nKjL5Cc/vIlefhMbQvnyTBO0UsCS0vIOXB3DDPWj34eMIPOewDBwvYQqlGrzf\nTjDnEDdn9AEAQWITH3qa7CjDSIhWX2e2nAFzquzywBEkhw0YWpYhRCvRAukw\nhKNnDcNEiWXaySe5qP1XOXpOVch6gxPMZ/KGh6/QhAs8SdDvGST/p3fWacXm\nhEU2XY2jnPaE1oLLP1ruWD6BtzK0zX81Mdeus6DX5kGXZGXMB6FjPOcNJjDG\nfqMu/edrekl1uEsz2DXGtq7lH7tao6EHW1tU7X4CgzhU9Wz06L0MjbypNlts\nqGXiewQUjRk7grsEaTUEjl0Bz6gYuZQWe4KWSJHQvC6F0DXOJNK+70sUGitF\n7qI99Ri53HtvRNYLyUFivk15o54ISI1fPxprdKrPxVPOcoreTBSb1TXcsHno\nxX3EZrf9/BX0x69qteU0z8h4OeHe/PCWwEM8ORnXFynCRZ7HwVymz2BXYkNl\n7/DKnmYiB1skQ32QYGPZ83+A3zlJMX8GgPzkEKGTDo3FHxyBf1yzHYe3Q0O0\nxdRsw4GKVc7eJRx72o+qJxbyElWAlMN2X5V8iNqEBtKWUbDgIedx8cCer+hJ\n7g81/zKfDerJiOPFOuqkfe5xuyqgZA+jIOrA+Dhaow55zBmgdcvGP6BZkMVV\nCL9s\r\n=L45J\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIHkyH6Ra09zIQRV1U4ZXccqdrNg/2VtMApMjmOMaeW3hAiAW0NCY4sKdjzYB+8UQSm6kRmAGk7JL4Gf7FCaW+sAWZw=="}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.0.0-2021-12-20--13-41_1640007731457_0.6821914730133614"},"_hasShrinkwrap":false},"0.0.0-2021-12-21--15-57":{"name":"opentelemetry-instrumentation-express","version":"0.0.0-2021-12-21--15-57","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn run build","test":"mocha --require opentelemetry-instrumentation-testing-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require opentelemetry-instrumentation-testing-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"peerDependencies":{"@opentelemetry/api":"^1.0.1"},"dependencies":{"@opentelemetry/core":"^1.0.0","@opentelemetry/instrumentation":"^0.26.0","@opentelemetry/semantic-conventions":"^1.0.0","parseurl":"~1.3.3","path-to-regexp":"0.1.7"},"devDependencies":{"@opentelemetry/api":"^1.0.2","@opentelemetry/instrumentation-http":"^0.25.0","@opentelemetry/sdk-trace-base":"1.0.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"0.0.1-rc.7","opentelemetry-instrumentation-testing-utils":"^0.0.0-2021-12-21--15-57","test-all-versions":"^5.0.1","typescript":"4.3.4"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"38372fee8eae66fb9be8d9e8093823c76ba1388a","readme":"# OpenTelemetry express Instrumentation for Node.js\n[![NPM version](https://img.shields.io/npm/v/opentelemetry-instrumentation-express.svg)](https://www.npmjs.com/package/opentelemetry-instrumentation-express)\n\nThis module provide enhanced instrumentation for the `express` web framework.\n\n## Installation\n\n```\nnpm install --save opentelemetry-instrumentation-express\n```\n## Supported Versions\nThis instrumentation supports `^4.9.0`:\n\nall versions >= `4.9.0` (released 2014) and < `5.0.0` (in alpha).\n\n## Usage\nFor further automatic instrumentation instruction see the [@opentelemetry/instrumentation](https://github.com/open-telemetry/opentelemetry-js/tree/main/packages/opentelemetry-instrumentation) package.\n\n```js\nconst { NodeTracerProvider } = require('@opentelemetry/sdk-trace-node');\nconst { registerInstrumentations } = require('@opentelemetry/instrumentation');\nconst { ExpressInstrumentation } = require('opentelemetry-instrumentation-express');\n\nconst tracerProvider = new NodeTracerProvider();\ntracerProvider.register();\n\nregisterInstrumentations({\n  tracerProvider,\n  instrumentations: [\n    new ExpressInstrumentation()\n  ]\n});\n```\n\n### Express Instrumentation Options\n\nExpress instrumentation has few options available to choose from. You can set the following:\n\n| Options | Type  | Description |\n| --- | --- | --- |\n| `requestHook` | `RequestHook` (function) | Hook for adding custom attributes before express start handling the request. Receives params: `span, { moduleVersion, req, res }` |\n| `includeHttpAttributes` | `boolean` | If set to true, plugin will include semantic http attributes in each express span |\n\n## Semantic Behavior\nExpress auto instrumentation will create a single span per request with the following attributes.\nDetailed specification and cases can be found [here](./doc/attributes-specification.MD).\n\n### `http.route`\nThis is a conventional http attribute, which is collected by express instead of the http module (which is not aware of the route). It will always contain path-parameterized data with low cardinality (no ids), but might be missing parts of the path in case of early termination or middlewares that accept any path.\n\nExample: `/api/users/:id`\n\n### `express.route.full`\nThis attribute will always contain the entire path. The part of the path that has been consumed by express will be shown as is (parameterized), and the leftover will be concatenated after (due to early termination or middleware that accept any path).\n\nExample: `/api/users/:id/books/758734` (The `:id` part was consumed, but the `bookid` part was not).\n\n### `express.route.configured`\nThis attribute is relevant when user configures multi path options for the same middleware. It reduces even further the cardinality space compared to `http.route`, and supply more info about how the app routing works.\n\nExample: `/api[\"/foo\", /\"bar\"]` - meaning that the same endpoint is triggered by routes `/api/foo` and `/api/bar`.\n\n### `express.route.params`\nThis attribute holds a json stringified map, where the keys are the url path param names, and the values are the matched params from the actual url.\n\nExample: `{\"id\":\"1234\"}`. \n\n### `express.unhandled`\nSet to true when request was not handled by any middleware in express, and got fallback to the default app `finalhandler`. This can happen if client sent request with invalid path or method (resulting in 404). This can be useful to filter out requests from internet bots which try to call common routes on servers.\n\n### `express.instrumentation.errors`\nIn case of internal error in instrumentation, this attribute will contain the error description. There are no known valid use cases which are expected to produce this attribute.\n\n## Difference from [@opentelemetry/instrumentation-express](https://github.com/open-telemetry/opentelemetry-js-contrib/tree/main/plugins/node/opentelemetry-instrumentation-express)\n\n* This instrumentation is focusing on extracting the most accurate and complete `route` data, in any valid express edge case. Contrib instrumentation does a good job for common cases, but miss nuances on complex setups.\n* This instrumentation create a single span per request. Contrib instrumentation creates span per express Router/Route, which can be useful to observe express internal components, with the cost of more spans in each trace.\n* Set few alternatives for route attribute, each with different level of cardinality vs accuracy.\n* Allows to set `requestHook` for adding custom attributes to span, as well as ability to capture express version into user defined attribute.\n* Distinguish between handled requests (ended from user middleware), and unhandled (terminated from express built in 'finalhandler').\n* Option to conform with the [Semantic conventions for HTTP spans](https://github.com/open-telemetry/opentelemetry-specification/blob/master/specification/trace/semantic_conventions/http.md).\n\n\n---\n\nThis extension (and many others) was developed by [Aspecto](https://www.aspecto.io/) with ❤️","readmeFilename":"README.md","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.0.0-2021-12-21--15-57","_nodeVersion":"12.22.7","_npmVersion":"lerna/3.22.1/node@v12.22.7+x64 (linux)","dist":{"integrity":"sha512-7SHanKxle9MN/YoQU8RbqPZiRBqC9l2zNx6ApoYXyMp5HRBkf9kO+K0sbccgUnIXacuBIXvVt/71lBhHA+JXPg==","shasum":"82db8ca66c1d64a244962c39abe54f7f9826365f","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.0.0-2021-12-21--15-57.tgz","fileCount":25,"unpackedSize":101973,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJhwfmnCRA9TVsSAnZWagAATmAQAJuTjFqB2EelAso3v+EK\nf+C2Y40nQ2t4v+KUzrpnMSFzcqzvBAvc1Zcj717KHSJHEI5D1QbNYmqZGpnU\nWz0fF45mUVh/7dptpgOlKfyaOcBxYQtP/YJP+fIJJZUgGZvountw2jq0PFm/\nY0eTv1xwyirXbse5BGpgXYvmLBd6impvNZfZg2jEbnMZKtKnPk+6T2svQra9\nKcOTpbFw15WjIna3v4vFfi4jgA7T1aot4Pg1Jzi0Ke1SzdC7yVORD5usQbMd\nFFmW09UNePaPTbPxfTr77GziX6EVWMwDCEd4Br4znR8h5N9YeIVFLf06X3Nu\nsNWOHmLf2cN8i2s3Jx8Zp7jJLEnt0ylHLV7pHy6e4a+roSOU8VxALN8nBMke\notBv7T27AtKXG3QHJx4XR02ylqtfkm+aLixkUHVTXS2DlxvM0Bhwu9we1RIG\nLX1Y6T1qoh58SWNRU90/hKJi5L7G+BiOi3Ckbwm/6oYiDb5UjusL5nQytYak\nHbwGO7j+SNFuVOe4A6PvMuxT29/z84FsdeLBrvueTLgVv7fb8fN5t0fLAc53\nj158bmC67+1FxyQ2A2mhr78OJgpyl8JHfE2u8p30UT2GC4+5faQlzcgCLgym\nxPJ7UFylnqJrgmA1rEe3RgKhGG+nY04VcsvJWpeC4W34Mj2ddd/xW9xwfxpB\nC327\r\n=KWP4\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQDb4W1isRJfQQ0fPoxXHPFb5CcRHhRyKQGNpS598hcbCQIgCyFjeMc9KBDKAYlqaTgmMQo/UoERVPkliVlH5pVpaLs="}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.0.0-2021-12-21--15-57_1640102311002_0.04118098594637054"},"_hasShrinkwrap":false},"0.0.0-2021-12-22--14-33":{"name":"opentelemetry-instrumentation-express","version":"0.0.0-2021-12-22--14-33","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn run build","test":"mocha --require opentelemetry-instrumentation-testing-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require opentelemetry-instrumentation-testing-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"peerDependencies":{"@opentelemetry/api":"^1.0.1"},"dependencies":{"@opentelemetry/core":"^1.0.0","@opentelemetry/instrumentation":"^0.26.0","@opentelemetry/semantic-conventions":"^1.0.0","parseurl":"~1.3.3","path-to-regexp":"0.1.7"},"devDependencies":{"@opentelemetry/api":"^1.0.2","@opentelemetry/instrumentation-http":"^0.25.0","@opentelemetry/sdk-trace-base":"1.0.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"0.0.1-rc.7","opentelemetry-instrumentation-testing-utils":"^0.0.0-2021-12-22--14-33","test-all-versions":"^5.0.1","typescript":"4.3.4"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"7aa0240a479398d794813dc4088689d9d25bf6fc","readme":"# OpenTelemetry express Instrumentation for Node.js\n[![NPM version](https://img.shields.io/npm/v/opentelemetry-instrumentation-express.svg)](https://www.npmjs.com/package/opentelemetry-instrumentation-express)\n\nThis module provide enhanced instrumentation for the `express` web framework.\n\n## Installation\n\n```\nnpm install --save opentelemetry-instrumentation-express\n```\n## Supported Versions\nThis instrumentation supports `^4.9.0`:\n\nall versions >= `4.9.0` (released 2014) and < `5.0.0` (in alpha).\n\n## Usage\nFor further automatic instrumentation instruction see the [@opentelemetry/instrumentation](https://github.com/open-telemetry/opentelemetry-js/tree/main/packages/opentelemetry-instrumentation) package.\n\n```js\nconst { NodeTracerProvider } = require('@opentelemetry/sdk-trace-node');\nconst { registerInstrumentations } = require('@opentelemetry/instrumentation');\nconst { ExpressInstrumentation } = require('opentelemetry-instrumentation-express');\n\nconst tracerProvider = new NodeTracerProvider();\ntracerProvider.register();\n\nregisterInstrumentations({\n  tracerProvider,\n  instrumentations: [\n    new ExpressInstrumentation()\n  ]\n});\n```\n\n### Express Instrumentation Options\n\nExpress instrumentation has few options available to choose from. You can set the following:\n\n| Options | Type  | Description |\n| --- | --- | --- |\n| `requestHook` | `RequestHook` (function) | Hook for adding custom attributes before express start handling the request. Receives params: `span, { moduleVersion, req, res }` |\n| `includeHttpAttributes` | `boolean` | If set to true, plugin will include semantic http attributes in each express span |\n\n## Semantic Behavior\nExpress auto instrumentation will create a single span per request with the following attributes.\nDetailed specification and cases can be found [here](./doc/attributes-specification.MD).\n\n### `http.route`\nThis is a conventional http attribute, which is collected by express instead of the http module (which is not aware of the route). It will always contain path-parameterized data with low cardinality (no ids), but might be missing parts of the path in case of early termination or middlewares that accept any path.\n\nExample: `/api/users/:id`\n\n### `express.route.full`\nThis attribute will always contain the entire path. The part of the path that has been consumed by express will be shown as is (parameterized), and the leftover will be concatenated after (due to early termination or middleware that accept any path).\n\nExample: `/api/users/:id/books/758734` (The `:id` part was consumed, but the `bookid` part was not).\n\n### `express.route.configured`\nThis attribute is relevant when user configures multi path options for the same middleware. It reduces even further the cardinality space compared to `http.route`, and supply more info about how the app routing works.\n\nExample: `/api[\"/foo\", /\"bar\"]` - meaning that the same endpoint is triggered by routes `/api/foo` and `/api/bar`.\n\n### `express.route.params`\nThis attribute holds a json stringified map, where the keys are the url path param names, and the values are the matched params from the actual url.\n\nExample: `{\"id\":\"1234\"}`. \n\n### `express.unhandled`\nSet to true when request was not handled by any middleware in express, and got fallback to the default app `finalhandler`. This can happen if client sent request with invalid path or method (resulting in 404). This can be useful to filter out requests from internet bots which try to call common routes on servers.\n\n### `express.instrumentation.errors`\nIn case of internal error in instrumentation, this attribute will contain the error description. There are no known valid use cases which are expected to produce this attribute.\n\n## Difference from [@opentelemetry/instrumentation-express](https://github.com/open-telemetry/opentelemetry-js-contrib/tree/main/plugins/node/opentelemetry-instrumentation-express)\n\n* This instrumentation is focusing on extracting the most accurate and complete `route` data, in any valid express edge case. Contrib instrumentation does a good job for common cases, but miss nuances on complex setups.\n* This instrumentation create a single span per request. Contrib instrumentation creates span per express Router/Route, which can be useful to observe express internal components, with the cost of more spans in each trace.\n* Set few alternatives for route attribute, each with different level of cardinality vs accuracy.\n* Allows to set `requestHook` for adding custom attributes to span, as well as ability to capture express version into user defined attribute.\n* Distinguish between handled requests (ended from user middleware), and unhandled (terminated from express built in 'finalhandler').\n* Option to conform with the [Semantic conventions for HTTP spans](https://github.com/open-telemetry/opentelemetry-specification/blob/master/specification/trace/semantic_conventions/http.md).\n\n\n---\n\nThis extension (and many others) was developed by [Aspecto](https://www.aspecto.io/) with ❤️","readmeFilename":"README.md","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.0.0-2021-12-22--14-33","_nodeVersion":"12.22.8","_npmVersion":"lerna/3.22.1/node@v12.22.8+x64 (linux)","dist":{"integrity":"sha512-svI5VQu0JqC/kkI1yY7by9fR80mAkH0Fj7X6XdB6u2oyGVEYMDmC5hBMVSUvWxDzi4AIiCCxQnj/BqL/1oEeow==","shasum":"e814c0585d97a7732c8a943fa2a4990a0089f5dd","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.0.0-2021-12-22--14-33.tgz","fileCount":25,"unpackedSize":101973,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJhwzfhCRA9TVsSAnZWagAAzvsP/1H/DyIL/D0lf6TiKAuQ\nDoHR3wCFh27FQPsuZbOXI+uVwGtIY24elc6S2MTaP1yHDlw3gG6JBuCKhbgK\n39akzTvcchiXgsYWE+38os2GwPNXcFqWWGhiABw+YJyDnGa5VeoFvQ/IQfMY\nei7i25JukcKneqTIFJLeBq/zBR7iSXWIOFDAVd/tvq3qHJ6+T4Y/yQzejJDc\nswwQ80HoFEDQUpCDG/MJM45UoPiMBrnsGLQ76+oue7WCpi/p25EDmbALcu5W\nhq/XYBEiCL/y9UtahDg5X/sFLQ+Gyoqzvfp90mdcHbZ5MBDEg5KHFHe7n1Mu\nKArMWSd6TNOHY+frVrxGV+gE5k4iPBptL9w/aMjn/z9VXldtYlAbH9nmDQgP\nkDXQAkU/I/aIFBdfg66DDb5Q6NYhW9JwQwvEeD5XkYXnXIDQtxcQNcvQKh3R\neXYrBdzynZNcrVJD5PgoO4dr3lYE52bVHhzVoQkZeiPfjmBVJwFGRhY/tKxw\nVQFr8Xrb/cmGUklCfyesHeDasisFkrr+EQKt41SDwxE6uKl+kXYrpdfUgjKM\nq2rjFHyUJ92TZDe8XrR1/NqyOK+ng1w6SytQOQxulF/KwGyXYfxU4mApKhf1\nfWj5awHhu7OCmcs/uw0oQI8vjm796rsd49K/oxVDw/UNAckQvRnk37sDNr/M\nLqy2\r\n=MFI5\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQDwdObBD2dCvnWJnDf89lSW9w64lcxui8D4GapH0RfnYwIgCy5pm0mXldxcnjoq+n3qx5ZJJeqQkDzhjsM76daEMBw="}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.0.0-2021-12-22--14-33_1640183777811_0.10647285958020913"},"_hasShrinkwrap":false},"0.0.0-2021-12-26--12-22":{"name":"opentelemetry-instrumentation-express","version":"0.0.0-2021-12-26--12-22","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn run build","test":"mocha --require opentelemetry-instrumentation-testing-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require opentelemetry-instrumentation-testing-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"peerDependencies":{"@opentelemetry/api":"^1.0.1"},"dependencies":{"@opentelemetry/core":"^1.0.0","@opentelemetry/instrumentation":"^0.26.0","@opentelemetry/semantic-conventions":"^1.0.0","parseurl":"~1.3.3","path-to-regexp":"0.1.7"},"devDependencies":{"@opentelemetry/api":"^1.0.2","@opentelemetry/instrumentation-http":"^0.25.0","@opentelemetry/sdk-trace-base":"1.0.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"0.0.1-rc.7","opentelemetry-instrumentation-testing-utils":"^0.0.0-2021-12-26--12-22","test-all-versions":"^5.0.1","typescript":"4.3.4"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"faef7c8328a9ff8592347e079e5e86d0181d2d5e","readme":"# OpenTelemetry express Instrumentation for Node.js\n[![NPM version](https://img.shields.io/npm/v/opentelemetry-instrumentation-express.svg)](https://www.npmjs.com/package/opentelemetry-instrumentation-express)\n\nThis module provide enhanced instrumentation for the `express` web framework.\n\n## Installation\n\n```\nnpm install --save opentelemetry-instrumentation-express\n```\n## Supported Versions\nThis instrumentation supports `^4.9.0`:\n\nall versions >= `4.9.0` (released 2014) and < `5.0.0` (in alpha).\n\n## Usage\nFor further automatic instrumentation instruction see the [@opentelemetry/instrumentation](https://github.com/open-telemetry/opentelemetry-js/tree/main/packages/opentelemetry-instrumentation) package.\n\n```js\nconst { NodeTracerProvider } = require('@opentelemetry/sdk-trace-node');\nconst { registerInstrumentations } = require('@opentelemetry/instrumentation');\nconst { ExpressInstrumentation } = require('opentelemetry-instrumentation-express');\n\nconst tracerProvider = new NodeTracerProvider();\ntracerProvider.register();\n\nregisterInstrumentations({\n  tracerProvider,\n  instrumentations: [\n    new ExpressInstrumentation()\n  ]\n});\n```\n\n### Express Instrumentation Options\n\nExpress instrumentation has few options available to choose from. You can set the following:\n\n| Options | Type  | Description |\n| --- | --- | --- |\n| `requestHook` | `RequestHook` (function) | Hook for adding custom attributes before express start handling the request. Receives params: `span, { moduleVersion, req, res }` |\n| `includeHttpAttributes` | `boolean` | If set to true, plugin will include semantic http attributes in each express span |\n\n## Semantic Behavior\nExpress auto instrumentation will create a single span per request with the following attributes.\nDetailed specification and cases can be found [here](./doc/attributes-specification.MD).\n\n### `http.route`\nThis is a conventional http attribute, which is collected by express instead of the http module (which is not aware of the route). It will always contain path-parameterized data with low cardinality (no ids), but might be missing parts of the path in case of early termination or middlewares that accept any path.\n\nExample: `/api/users/:id`\n\n### `express.route.full`\nThis attribute will always contain the entire path. The part of the path that has been consumed by express will be shown as is (parameterized), and the leftover will be concatenated after (due to early termination or middleware that accept any path).\n\nExample: `/api/users/:id/books/758734` (The `:id` part was consumed, but the `bookid` part was not).\n\n### `express.route.configured`\nThis attribute is relevant when user configures multi path options for the same middleware. It reduces even further the cardinality space compared to `http.route`, and supply more info about how the app routing works.\n\nExample: `/api[\"/foo\", /\"bar\"]` - meaning that the same endpoint is triggered by routes `/api/foo` and `/api/bar`.\n\n### `express.route.params`\nThis attribute holds a json stringified map, where the keys are the url path param names, and the values are the matched params from the actual url.\n\nExample: `{\"id\":\"1234\"}`. \n\n### `express.unhandled`\nSet to true when request was not handled by any middleware in express, and got fallback to the default app `finalhandler`. This can happen if client sent request with invalid path or method (resulting in 404). This can be useful to filter out requests from internet bots which try to call common routes on servers.\n\n### `express.instrumentation.errors`\nIn case of internal error in instrumentation, this attribute will contain the error description. There are no known valid use cases which are expected to produce this attribute.\n\n## Difference from [@opentelemetry/instrumentation-express](https://github.com/open-telemetry/opentelemetry-js-contrib/tree/main/plugins/node/opentelemetry-instrumentation-express)\n\n* This instrumentation is focusing on extracting the most accurate and complete `route` data, in any valid express edge case. Contrib instrumentation does a good job for common cases, but miss nuances on complex setups.\n* This instrumentation create a single span per request. Contrib instrumentation creates span per express Router/Route, which can be useful to observe express internal components, with the cost of more spans in each trace.\n* Set few alternatives for route attribute, each with different level of cardinality vs accuracy.\n* Allows to set `requestHook` for adding custom attributes to span, as well as ability to capture express version into user defined attribute.\n* Distinguish between handled requests (ended from user middleware), and unhandled (terminated from express built in 'finalhandler').\n* Option to conform with the [Semantic conventions for HTTP spans](https://github.com/open-telemetry/opentelemetry-specification/blob/master/specification/trace/semantic_conventions/http.md).\n\n\n---\n\nThis extension (and many others) was developed by [Aspecto](https://www.aspecto.io/) with ❤️","readmeFilename":"README.md","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.0.0-2021-12-26--12-22","_nodeVersion":"12.22.8","_npmVersion":"lerna/3.22.1/node@v12.22.8+x64 (linux)","dist":{"integrity":"sha512-4QIjVrKcl/30R656krytdC/fIVEGn54BfDj1IVA/GIvbpZ4IUCfB12Xq2BMLkVlNup3nxfpNPBbe8zbfDQkkYw==","shasum":"d599fb76cc22b91526d13687f6f52006da312d1b","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.0.0-2021-12-26--12-22.tgz","fileCount":25,"unpackedSize":101973,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJhyF6jCRA9TVsSAnZWagAA/3AQAJ/9str1wYfxlHeT1VWW\nZ9Gq4SaNR93w5t+xis7mHbwDtT2+z6mK0aGvG6lRDOlbamazW6dRm3jVDp0L\nV8GCrRGnwawna7zpQZxq1kFBjc0W3NgartDmk4fZEhrEb7iW8dvFVwKS8RcU\nySD1Cfbuk/SMJ/zNCtysssoaki9hr+3Lpqb0tu+nGFaFo4JvvSjVz2VO9cFA\naD6FNzKcjiJrjZCNAP1YrXy6S+ZOCAftPZ6qBkEtTystOszbtdvzvWO7DrI4\ndUmnr+VwKI895tAHkfmsfgevi6pzrB+noJBB3MdFbW2l5yRtDOx0Oddd327O\nPFRmrxnCOORYcT2nnzdf3zTStiKgBdEg5ueLBR1JP+CO1xgdxNGYcxGvzswU\nUvc2tqE9HffCvfQS8PaInD7K8e68dtZtVBU9iEovsxGZvqfXUBWysloE0dxR\n4bjr8RR46Aeznp66LWuL7Hs+NdWDCUtd/xAGkd/vrFxcptCBWbSJlKsO6aaq\njGeBvFdW0g/BElfQ+fVb/MkAvfncRrlxKjBWKh6VB1LOKvA7yM8Xy6Iib4cM\nEBloPrZD9RO9ggmRuTiY5vNXn/XZs7ZTcYaYADPJDQccSceA188wObJnaJNl\nZM+NChS29HcClzPU/6cRjLZaU1eYx8/TNBzH9DVp6eU4pJ0KrcKz9hIbMuCm\nl+Cl\r\n=+u/5\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQDxdT7YiaT2wMbuXsx3Bslkc+52mrdN8Qse6P8WCwD6NwIhAMKWmlIQyMjZ04/VgCbX+IpMa/Ge9qt3T9Csm2+mA3iA"}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.0.0-2021-12-26--12-22_1640521379352_0.9399702156636032"},"_hasShrinkwrap":false},"0.0.0-2021-12-26--12-31":{"name":"opentelemetry-instrumentation-express","version":"0.0.0-2021-12-26--12-31","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn run build","test":"mocha --require opentelemetry-instrumentation-testing-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require opentelemetry-instrumentation-testing-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"peerDependencies":{"@opentelemetry/api":"^1.0.1"},"dependencies":{"@opentelemetry/core":"^1.0.0","@opentelemetry/instrumentation":"^0.26.0","@opentelemetry/semantic-conventions":"^1.0.0","parseurl":"~1.3.3","path-to-regexp":"0.1.7"},"devDependencies":{"@opentelemetry/api":"^1.0.2","@opentelemetry/instrumentation-http":"^0.25.0","@opentelemetry/sdk-trace-base":"1.0.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"0.0.1-rc.7","opentelemetry-instrumentation-testing-utils":"^0.0.0-2021-12-26--12-31","test-all-versions":"^5.0.1","typescript":"4.3.4"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"591785317c33cddbfec450849d945af05520a0f4","readme":"# OpenTelemetry express Instrumentation for Node.js\n[![NPM version](https://img.shields.io/npm/v/opentelemetry-instrumentation-express.svg)](https://www.npmjs.com/package/opentelemetry-instrumentation-express)\n\nThis module provide enhanced instrumentation for the `express` web framework.\n\n## Installation\n\n```\nnpm install --save opentelemetry-instrumentation-express\n```\n## Supported Versions\nThis instrumentation supports `^4.9.0`:\n\nall versions >= `4.9.0` (released 2014) and < `5.0.0` (in alpha).\n\n## Usage\nFor further automatic instrumentation instruction see the [@opentelemetry/instrumentation](https://github.com/open-telemetry/opentelemetry-js/tree/main/packages/opentelemetry-instrumentation) package.\n\n```js\nconst { NodeTracerProvider } = require('@opentelemetry/sdk-trace-node');\nconst { registerInstrumentations } = require('@opentelemetry/instrumentation');\nconst { ExpressInstrumentation } = require('opentelemetry-instrumentation-express');\n\nconst tracerProvider = new NodeTracerProvider();\ntracerProvider.register();\n\nregisterInstrumentations({\n  tracerProvider,\n  instrumentations: [\n    new ExpressInstrumentation()\n  ]\n});\n```\n\n### Express Instrumentation Options\n\nExpress instrumentation has few options available to choose from. You can set the following:\n\n| Options | Type  | Description |\n| --- | --- | --- |\n| `requestHook` | `RequestHook` (function) | Hook for adding custom attributes before express start handling the request. Receives params: `span, { moduleVersion, req, res }` |\n| `includeHttpAttributes` | `boolean` | If set to true, plugin will include semantic http attributes in each express span |\n\n## Semantic Behavior\nExpress auto instrumentation will create a single span per request with the following attributes.\nDetailed specification and cases can be found [here](./doc/attributes-specification.MD).\n\n### `http.route`\nThis is a conventional http attribute, which is collected by express instead of the http module (which is not aware of the route). It will always contain path-parameterized data with low cardinality (no ids), but might be missing parts of the path in case of early termination or middlewares that accept any path.\n\nExample: `/api/users/:id`\n\n### `express.route.full`\nThis attribute will always contain the entire path. The part of the path that has been consumed by express will be shown as is (parameterized), and the leftover will be concatenated after (due to early termination or middleware that accept any path).\n\nExample: `/api/users/:id/books/758734` (The `:id` part was consumed, but the `bookid` part was not).\n\n### `express.route.configured`\nThis attribute is relevant when user configures multi path options for the same middleware. It reduces even further the cardinality space compared to `http.route`, and supply more info about how the app routing works.\n\nExample: `/api[\"/foo\", /\"bar\"]` - meaning that the same endpoint is triggered by routes `/api/foo` and `/api/bar`.\n\n### `express.route.params`\nThis attribute holds a json stringified map, where the keys are the url path param names, and the values are the matched params from the actual url.\n\nExample: `{\"id\":\"1234\"}`. \n\n### `express.unhandled`\nSet to true when request was not handled by any middleware in express, and got fallback to the default app `finalhandler`. This can happen if client sent request with invalid path or method (resulting in 404). This can be useful to filter out requests from internet bots which try to call common routes on servers.\n\n### `express.instrumentation.errors`\nIn case of internal error in instrumentation, this attribute will contain the error description. There are no known valid use cases which are expected to produce this attribute.\n\n## Difference from [@opentelemetry/instrumentation-express](https://github.com/open-telemetry/opentelemetry-js-contrib/tree/main/plugins/node/opentelemetry-instrumentation-express)\n\n* This instrumentation is focusing on extracting the most accurate and complete `route` data, in any valid express edge case. Contrib instrumentation does a good job for common cases, but miss nuances on complex setups.\n* This instrumentation create a single span per request. Contrib instrumentation creates span per express Router/Route, which can be useful to observe express internal components, with the cost of more spans in each trace.\n* Set few alternatives for route attribute, each with different level of cardinality vs accuracy.\n* Allows to set `requestHook` for adding custom attributes to span, as well as ability to capture express version into user defined attribute.\n* Distinguish between handled requests (ended from user middleware), and unhandled (terminated from express built in 'finalhandler').\n* Option to conform with the [Semantic conventions for HTTP spans](https://github.com/open-telemetry/opentelemetry-specification/blob/master/specification/trace/semantic_conventions/http.md).\n\n\n---\n\nThis extension (and many others) was developed by [Aspecto](https://www.aspecto.io/) with ❤️","readmeFilename":"README.md","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.0.0-2021-12-26--12-31","_nodeVersion":"12.22.8","_npmVersion":"lerna/3.22.1/node@v12.22.8+x64 (linux)","dist":{"integrity":"sha512-bMlAal9vwqbn/f+ZpeaI44h5mbBv6WfJrW8kPTs3og246RpezO0AjolvgZYTn5j8mvqEkMhFxMFbRAzDjF6rDA==","shasum":"73a42ed41790d76a7ece8d80de4e061a798b0e08","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.0.0-2021-12-26--12-31.tgz","fileCount":25,"unpackedSize":101973,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJhyGDxCRA9TVsSAnZWagAA/hIP/Rz78j0Jwi75PqbnaLEf\nm2MMUXWR7m/SQO24WWHSutftNnUyhDrTvw6rzL0t0vIoIKDrME2FCFmWiUtP\nBztYTCB38zevlkZUqjpHip+KhOGnPP9R2VQtayEyOhGxo/mQwRkkbPh1zUCC\nw4In+aLk+k/lYYoKXr2exEahOmM44aJNdk0Cx0d3T0kWuxUGkF7Sw92YXy35\nZ0vVI7dXGMEGav7AGO0dxNtOH9HUv8lRflR79/UtipbeoIhBYuzto2S0Efee\nIaT0mGqyLwIUtolmxJUhhpUBoEJ0JlLmz8RE85dBvGY71t77hqtSlGCb5tBo\n55JFTpgYfEz5VzUwpkzaopcT/qGUHj29mR5pgoIO9W8w8PFewsS2vv0c3fGx\n1k6qVfv4rgjkfBzMWM6dnGNDLqQRXWafQlLJE2GWlUUVyB76Qfb/lwtE/gs4\ns420ZcC9WD/4uHvDjR+C1WsEWWnHZIjUbuTyzPhcfZ26hr452NrQgV26z7UY\noozdn+yK622hyba2n/HcMOkPx5QgIbaH5kBLPQoseStfvgpRRE/WqVZftWJY\nl581luq+7TudbmHTxLawosUBo/WxFmbdT7GC3/jNWWBNNVtNx34BqljWbqgX\nO0cyztbj4l0ctGB9yuxi/vGWte0GoDRbmV94pDSgL8pUbq8qdNBJDHTWTzJW\nMJ1s\r\n=2ZHf\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQDnD3ndFJKpWXAtDrGEuHV9OqhCPG0khQgq0c91lIGYtQIgA5iX+OC6NtKgJgE86zu/SIzK5NzEYRKVg9/6lFZztEk="}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.0.0-2021-12-26--12-31_1640521969229_0.7491886305211284"},"_hasShrinkwrap":false},"0.27.0":{"name":"opentelemetry-instrumentation-express","version":"0.27.0","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn run build","test":"mocha --require opentelemetry-instrumentation-testing-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require opentelemetry-instrumentation-testing-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"peerDependencies":{"@opentelemetry/api":"^1.0.1"},"dependencies":{"@opentelemetry/core":"^1.0.0","@opentelemetry/instrumentation":"^0.27.0","@opentelemetry/semantic-conventions":"^1.0.0","parseurl":"~1.3.3","path-to-regexp":"0.1.7"},"devDependencies":{"@opentelemetry/api":"^1.0.2","@opentelemetry/instrumentation-http":"^0.27.0","@opentelemetry/sdk-trace-base":"1.0.1","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"0.0.1-rc.7","opentelemetry-instrumentation-testing-utils":"^0.27.0","test-all-versions":"^5.0.1","typescript":"4.3.4"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"687393213037496a1105e522b1bc3110b11bd9c1","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.27.0","_nodeVersion":"12.22.8","_npmVersion":"lerna/3.22.1/node@v12.22.8+x64 (linux)","dist":{"integrity":"sha512-N36tOxlQcO0axyokR2BFuw7pfL538paqtil9K8CIDAzIlIZmJX/lamaSQra0NOUxNsuZUuBejboyY8jBvmDrvQ==","shasum":"3962fe85b544223c5cd68834633b71dcb53c9da5","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.27.0.tgz","fileCount":25,"unpackedSize":102146,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJhyYx+CRA9TVsSAnZWagAAtNIP/3kIMbrci48oZJXk4h3v\nTDGVv9b8rmBb2UGxocQEK6ZEhmdjQvukzTxumFNPfxpPJHmrlIsdv41IJB6C\nA9W0mSpOt1vMXMt3rzToiAJL8M+19E8n3rNYvtTwibT1NkfqfYUpV6l3AGq9\nCyzoifxlKn8bBrMTYz8lvkZeR30roWq+uWvhf9UCoH8Pk6lC79Fbmd+wROx8\nVj6JAbB3UgVxjpFWxFjeDOXzDxH5NjZwErAccZOMtxLU1XuDT0jT14HuowoA\nTswxXz0hOYiuExXHDui1/L24ip/TMscpDze+lEbLhauRvTSVWRiBvEfVpCtv\ntpGNwZrZQv7+pbHsh0r+GW53+SjtuHhRJoGPxU82e3CxscIzyoWmtud+zq8p\nemUlbqkW7ioZh4ZC2lfFLGJ92JcD43NnpxmstKAsTAZgwJPH4YyvTF82CxH0\nVSBGEsXv/1ux7RFRXD22OQ/Zn+xNivt0955to92IZ2pQ/UDQsfLnoK10OER1\nE7Fsb/uqnT5KWmcGl+Oah3djXU2QxltENDuUCVAU3SdV8W+T2QF4+lSm3JKg\nc8Ont3OoVUurKc6SknmbvgIA3jQY1HucbO1p79RLHD4DBHIGJsZqCFivP9ZC\nQkdBcIF1U1aLMIEcEOr6u/qT+Ga3bH9q5Nidxy2964QNeHmhEsC3y/plYyq+\nGd/f\r\n=pLzR\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQDAdk7AjkvTdJ5s2C0pUH9c0GQKrBC6cmNV3FsldHOXNAIhAJ5nY2DoudVTWkFVHr8SHqQ3Y/X1g89W8UlWzvm5yRrj"}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.27.0_1640598654477_0.8616653392155331"},"_hasShrinkwrap":false},"0.0.0-2022-04-13--14-32":{"name":"opentelemetry-instrumentation-express","version":"0.0.0-2022-04-13--14-32","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn run build","test":"mocha --require @opentelemetry/contrib-test-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require @opentelemetry/contrib-test-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"peerDependencies":{"@opentelemetry/api":"^1.0.1"},"dependencies":{"@opentelemetry/core":"^1.0.0","@opentelemetry/instrumentation":"^0.27.0","@opentelemetry/semantic-conventions":"^1.0.0","parseurl":"~1.3.3","path-to-regexp":"0.1.7"},"devDependencies":{"@opentelemetry/api":"1.0.2","@opentelemetry/contrib-test-utils":"^0.28.0","@opentelemetry/instrumentation-http":"^0.27.0","@opentelemetry/sdk-trace-base":"1.0.1","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"0.0.1-rc.7","test-all-versions":"^5.0.1","typescript":"4.3.4"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"2e8247578b4b9efe980868177abdd2e793ea18ee","readme":"# OpenTelemetry express Instrumentation for Node.js\n[![NPM version](https://img.shields.io/npm/v/opentelemetry-instrumentation-express.svg)](https://www.npmjs.com/package/opentelemetry-instrumentation-express)\n\nThis module provide enhanced instrumentation for the `express` web framework.\n\n## Installation\n\n```\nnpm install --save opentelemetry-instrumentation-express\n```\n## Supported Versions\nThis instrumentation supports `^4.9.0`:\n\nall versions >= `4.9.0` (released 2014) and < `5.0.0` (in alpha).\n\n## Usage\nFor further automatic instrumentation instruction see the [@opentelemetry/instrumentation](https://github.com/open-telemetry/opentelemetry-js/tree/main/packages/opentelemetry-instrumentation) package.\n\n```js\nconst { NodeTracerProvider } = require('@opentelemetry/sdk-trace-node');\nconst { registerInstrumentations } = require('@opentelemetry/instrumentation');\nconst { ExpressInstrumentation } = require('opentelemetry-instrumentation-express');\n\nconst tracerProvider = new NodeTracerProvider();\ntracerProvider.register();\n\nregisterInstrumentations({\n  tracerProvider,\n  instrumentations: [\n    new ExpressInstrumentation()\n  ]\n});\n```\n\n### Express Instrumentation Options\n\nExpress instrumentation has few options available to choose from. You can set the following:\n\n| Options | Type  | Description |\n| --- | --- | --- |\n| `requestHook` | `RequestHook` (function) | Hook for adding custom attributes before express start handling the request. Receives params: `span, { moduleVersion, req, res }` |\n| `includeHttpAttributes` | `boolean` | If set to true, plugin will include semantic http attributes in each express span |\n\n## Semantic Behavior\nExpress auto instrumentation will create a single span per request with the following attributes.\nDetailed specification and cases can be found [here](./doc/attributes-specification.MD).\n\n### `http.route`\nThis is a conventional http attribute, which is collected by express instead of the http module (which is not aware of the route). It will always contain path-parameterized data with low cardinality (no ids), but might be missing parts of the path in case of early termination or middlewares that accept any path.\n\nExample: `/api/users/:id`\n\n### `express.route.full`\nThis attribute will always contain the entire path. The part of the path that has been consumed by express will be shown as is (parameterized), and the leftover will be concatenated after (due to early termination or middleware that accept any path).\n\nExample: `/api/users/:id/books/758734` (The `:id` part was consumed, but the `bookid` part was not).\n\n### `express.route.configured`\nThis attribute is relevant when user configures multi path options for the same middleware. It reduces even further the cardinality space compared to `http.route`, and supply more info about how the app routing works.\n\nExample: `/api[\"/foo\", /\"bar\"]` - meaning that the same endpoint is triggered by routes `/api/foo` and `/api/bar`.\n\n### `express.route.params`\nThis attribute holds a json stringified map, where the keys are the url path param names, and the values are the matched params from the actual url.\n\nExample: `{\"id\":\"1234\"}`. \n\n### `express.unhandled`\nSet to true when request was not handled by any middleware in express, and got fallback to the default app `finalhandler`. This can happen if client sent request with invalid path or method (resulting in 404). This can be useful to filter out requests from internet bots which try to call common routes on servers.\n\n### `express.instrumentation.errors`\nIn case of internal error in instrumentation, this attribute will contain the error description. There are no known valid use cases which are expected to produce this attribute.\n\n## Difference from [@opentelemetry/instrumentation-express](https://github.com/open-telemetry/opentelemetry-js-contrib/tree/main/plugins/node/opentelemetry-instrumentation-express)\n\n* This instrumentation is focusing on extracting the most accurate and complete `route` data, in any valid express edge case. Contrib instrumentation does a good job for common cases, but miss nuances on complex setups.\n* This instrumentation create a single span per request. Contrib instrumentation creates span per express Router/Route, which can be useful to observe express internal components, with the cost of more spans in each trace.\n* Set few alternatives for route attribute, each with different level of cardinality vs accuracy.\n* Allows to set `requestHook` for adding custom attributes to span, as well as ability to capture express version into user defined attribute.\n* Distinguish between handled requests (ended from user middleware), and unhandled (terminated from express built in 'finalhandler').\n* Option to conform with the [Semantic conventions for HTTP spans](https://github.com/open-telemetry/opentelemetry-specification/blob/master/specification/trace/semantic_conventions/http.md).\n\n\n---\n\nThis extension (and many others) was developed by [Aspecto](https://www.aspecto.io/) with ❤️","readmeFilename":"README.md","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.0.0-2022-04-13--14-32","_nodeVersion":"12.22.11","_npmVersion":"lerna/3.22.1/node@v12.22.11+x64 (linux)","dist":{"integrity":"sha512-ibjmchlsjJAOG1vGxyOw4Yix1OoRMJmIHcwk8ddIVnX2AOIDDMPUi8i+eByl48hjfcQRnr7WcINzYZGfmaP2nA==","shasum":"53e74dd82f0f49d7e9ded60b70823021d45311fd","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.0.0-2022-04-13--14-32.tgz","fileCount":25,"unpackedSize":102321,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIH0czbLeJMOIm2k9Cc5SrC76OozL5wJgn6FYi+UQlEqBAiEA5x6ZjzQKDrql5LTaDBtFg8wNOvx1s7Kz3LdAH7gdCLU="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJiVt8TACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmphXBAApSMG7C4rWSzrmRHF8h4WuiiQXnlopwjmyJ2fUslITGCn4IdJ\r\nL9iUBkSn5EPiHCgrVfrqRi2jjuelDWqieNBzZp+/N625tKsoVWuuC0/94E2Z\r\nvUvT4Jry9cZsjo7qHDxOA7t3SP0czMCxhbDWjE26BcD5QtIcR7p0yk85K4fo\r\nVf/2kYuBryIChsK67q4Bc7VeXrXUGeNOrgGARJOA5NvN/QkLUE5Dr5tUeBJ9\r\nNknTwlCMwXJgkHD3RR+03mF+2xldLbqZGnAIHtrFE0ngPvwOdIZLJ9DBBN/v\r\nVE9stTFtJmG/BXSC0ptHD6BE5X0ObbSKvM6ndyBG5HHNzSbiVp7oDsg4UxkC\r\nNQTA0bBmNDMh6BpgDzfLUhSSKJCPqwD9rDSULFhqh296JhoFlDCsqjJiHuDO\r\nHXa+x7RiMQXhd4YjN64yIhWGRsvDZNbU0YexIf0XkC8TfA5yXEGuGh9jd1Kw\r\nvjRqY5pxmXXiwqCdYTknJRuLbbOKlvdcN/KeLLfZRtNn/o/MClscNtktfOkw\r\nux6UvoTpbV5Q9u47e+eIQ4TVZUApcUShXUiOqlo2It2xObjsvmBAYZQ+yYPs\r\nKrY5jkYKxRZAgglWYMMP7Wbm4pWJMyBaf1l+C0P83y86yEStBqWm4kKi2fnw\r\nTKgS3/U9ANohUSh7bjFlaqDfbomkI0r5Vvw=\r\n=oAOK\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.0.0-2022-04-13--14-32_1649860371815_0.6343395430079732"},"_hasShrinkwrap":false},"0.27.1":{"name":"opentelemetry-instrumentation-express","version":"0.27.1","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn run build","test":"mocha --require @opentelemetry/contrib-test-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require @opentelemetry/contrib-test-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"peerDependencies":{"@opentelemetry/api":"^1.0.1"},"dependencies":{"@opentelemetry/core":"^1.0.0","@opentelemetry/instrumentation":"^0.27.0","@opentelemetry/semantic-conventions":"^1.0.0","parseurl":"~1.3.3","path-to-regexp":"0.1.7"},"devDependencies":{"@opentelemetry/api":"1.0.2","@opentelemetry/contrib-test-utils":"^0.28.0","@opentelemetry/instrumentation-http":"^0.27.0","@opentelemetry/sdk-trace-base":"1.0.1","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"0.0.1-rc.7","test-all-versions":"^5.0.1","typescript":"4.3.4"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"e473527226dc901fc0006df49f729b9137b7323b","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.27.1","_nodeVersion":"12.22.11","_npmVersion":"lerna/3.22.1/node@v12.22.11+x64 (linux)","dist":{"integrity":"sha512-fvSzsSxWYcbcktjpF/VPq/h8vwYcAkigH5Ru9Q4ENmIqMcD7MhcXwgViHCxRGHD2EWKlLNupdzwV4w1Afl6akg==","shasum":"4b760304e76effb09eba99234f2fac05a709ba41","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.27.1.tgz","fileCount":25,"unpackedSize":102896,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIGNYC+jS3BG2T7Vp7rLDzSIlU2LcsjOreiw51xAIg5yNAiEAqkbr4VqKNXekSbG3LH6UfooKv4auYU/KCSw+QBNv5ss="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJiVu8GACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2Vmrz1Q/+LDkAQBSsuexKto/ngvN/Htbymi1oNazMzgAm8Fe6Nf38K9q1\r\nlSfOa8DedcXmd6m9ecjlv5GEejLv7P/3+sedHxiDjwYLIc/eBIqh6tYQMy+B\r\ni/ALXxwy8Mq8+PU7xVFxvdSvPOAMa2J+i+Ro9OhXRTJSLASsVWgRP4S0L6CD\r\nQP7cCCAow/x3t/2DlR0QS3LakEHpHvrgYdBzarHpwRQZmj2oEvCEZ93nSZLo\r\nGpefM13CiqsYt9SvlomUJFqMxUKACTs7cGRQCnTwJSON7k3jCXVPmooRw9r3\r\nLaiWmQ9FEGLpmnT8tXXpGXqvLjHV/Lapspe61KE+e3SijnAAg+W6zadBeRzk\r\n0eRr65m9R81/jyRUeKr2jvNc3YgbTWi4DvLZT5k31or+TBqp8zExiLwns+HV\r\nNrk4LQrvovKdJHTLjf1DYYPtHf/Z0G2HCNFxjl8q3r2oko5Q1xuP4qcuDfMJ\r\nZGw6OYafKweFy4FYNl3I00jdNC0qtxYCzqJ1s8vS4Ti4BPGvX4A+FBll+Ew1\r\n9XRSOtWCuuOZyeRkGCunZKFPhUMVQU22OK8xC9f2RTv3GDy3GjGYF2F7bvYM\r\nDLHuligaHmExfLjtvnjDgEuoxZTxehLoQuWILFhgChoLuM3BDnoN4v513V+v\r\n/Lk5gwfw7Tfz6H+vYHiGVNj/JYeS+Wq1fqA=\r\n=IM3D\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.27.1_1649864454452_0.8727475324930718"},"_hasShrinkwrap":false},"0.28.0":{"name":"opentelemetry-instrumentation-express","version":"0.28.0","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn build","test":"mocha --require @opentelemetry/contrib-test-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require @opentelemetry/contrib-test-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"peerDependencies":{"@opentelemetry/api":"^1.0.0"},"dependencies":{"@opentelemetry/core":"^1.0.0","@opentelemetry/instrumentation":"^0.28.0","@opentelemetry/semantic-conventions":"^1.0.0","parseurl":"~1.3.3","path-to-regexp":"0.1.7"},"devDependencies":{"@opentelemetry/api":"^1.0.0","@opentelemetry/contrib-test-utils":"^0.30.0","@opentelemetry/instrumentation-http":"^0.28.0","@opentelemetry/sdk-trace-base":"1.2.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"0.0.1-rc.7","test-all-versions":"^5.0.1","ts-node":"^9.1.1","typescript":"4.3.4"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"4b2ef8358671e75cda095ea22c9a73527f146395","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.28.0","_nodeVersion":"12.22.12","_npmVersion":"lerna/3.22.1/node@v12.22.12+x64 (linux)","dist":{"integrity":"sha512-kz1Ww9FnhmegpS6Pyj+4vmTBQhQn4kobTh8Rr9YPUzx43lnL/EJcVqgavd7YIfuv16cJaBYzEgpN/CnSVwj2bA==","shasum":"a13b01f122caab8201e39e58af5ac8a299e0d226","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.28.0.tgz","fileCount":25,"unpackedSize":103348,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIBr6izOrgN951UBoUeZYjrODstGeQKwfjWNQCZOyIpTkAiBCPH474nJF/3Ld+TZCZzvtYpQDSmMvV4q+HyLuol0k7Q=="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJimMtSACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2Vmp6Nw/8CB3ieQrbvH6GnWpjX+WluOyZ6iT6wC8nYmxqHkBkwGF7YBK+\r\nz01B1y+N/LVqirc68vxf1IshAE8Hner9cUbTsZGR4WgQ4z2NM+KIOHvVmyyV\r\neal8LQmuzL6Wo3sULXXdd8/TrcBZ/7X2mwvkTusvT+q889T1EO9k1rZEE+LG\r\nAVSrbDpSS9hvYWHwb5DogM//ZH1ImneV0MlQCjXp3KmePZTAiON+X/yBUZOp\r\nZ5ZlUA47gWwU6nYbE/QQ47MDoZVsJrlx72NgVeAy2heHlLGLCTEH0Yl6DK+5\r\nJB86e/aGRiL0rNpSt+4NccPEoSzli5zrdQ8p0Ngo2SYRa/uk3RGJ3Kl4k22j\r\nl226NutgQrhByYWFwtCNwqPb2WR7L9zYvlxvQUNag9K44gK4lIRmDAN11UL3\r\nccuA4b1l3GkvWRd9jjyjHnGqGxu+esKVsshnfiHIQrbZzaWKVy0iAyRGfIVB\r\ns1B31xUXAWQAkfmjxJ7n2h/n+QQ/vdXFOMjHROlktNtuO0OflQ13FzoaXttC\r\nAlLtI5U3kaphn6ZZ/kBHYs+YHUt67bc3kb0k6bgS4knKB6gHBPg+WxQ5sVql\r\n6rUJzUislfsPVMAHUOvXp31H8bbO6oolMiTYoo7kcpehFzc/VfCfOPebv4Lk\r\nKDRlB1VOY6hTzX/Mcah/udj5hyqlmNlWgYM=\r\n=33OF\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.28.0_1654180690574_0.25174723995808734"},"_hasShrinkwrap":false},"0.29.0":{"name":"opentelemetry-instrumentation-express","version":"0.29.0","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn build","test":"mocha --require @opentelemetry/contrib-test-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require @opentelemetry/contrib-test-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"peerDependencies":{"@opentelemetry/api":"^1.0.0"},"dependencies":{"@opentelemetry/core":"^1.0.0","@opentelemetry/instrumentation":"^0.29.0","@opentelemetry/semantic-conventions":"^1.0.0","parseurl":"~1.3.3","path-to-regexp":"0.1.7"},"devDependencies":{"@opentelemetry/api":"^1.0.0","@opentelemetry/contrib-test-utils":"^0.31.0","@opentelemetry/instrumentation-http":"^0.29.0","@opentelemetry/sdk-trace-base":"1.2.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"0.0.1-rc.7","test-all-versions":"^5.0.1","ts-node":"^9.1.1","typescript":"4.3.4"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"55606fc29b3e835f0b06892462c9832471dbbb3b","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.29.0","_nodeVersion":"12.22.12","_npmVersion":"lerna/3.22.1/node@v12.22.12+x64 (linux)","dist":{"integrity":"sha512-/u2HSCfaGBpVFxWLxzvTC6l2A6xP0mXynqE6voM2sloDAZkYKNbI+9D1UtyU+vt95aWoCXaKwDb+snv3H3UGwA==","shasum":"c82c97e2ae2b24f8f1f8e83b5aa8b5f542698f92","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.29.0.tgz","fileCount":25,"unpackedSize":103772,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQDdc66Cg/opUYSy3D14ghLg0rq/W9AlqOA+/pc2p4tA7AIhAPCj/8fUAJ1V5o9ULK3UXKhiawaEadmSDzkF9HUmCDFM"}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJiusv+ACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmomOhAAikZu3gHFUC5gen5iiSP5UJV6/Im/cRbOoypZmDb7J3yFOy5J\r\nn9a6gT0c2bZpHS4Lkv0TjaCkTUX2GC+avVc3618VC1pa4eTwHgrwFSqqp+YK\r\nozGEkxYhOY8kv/6uSekSvXTYe4roC9K0T+nYrkAVvX9yEn1mQTsRwGUwy5s6\r\njZDnnkmJkBuy1h421u5KtiTVCCBhNvbm88c9M2N8p/2y7biLICDG88gEf4Kx\r\nL6G/6BW9pgBy7havfeNYP6zu841ore6Nz310DSKXYWM/vV8C0+b6hiyc+snm\r\nYhfjR82ml27Brn8XSqN+G00qRuIOsvzLiFThXKuKUPlD+bVLOifUiUP7O3ll\r\nO0W/8yMfvV2cy5SxICbOC+k21XCyWv0Gtqy3SjUncATqZepHJfOGSoQAbrbW\r\nCXsqGLWzYfAvY9o21Gk51+NIKgyGs6wUivXFyOQIUFSMg7FdZ2jLxoMxOiT1\r\nWsnCtocYSUJzZwuei6Lg8HD6m5FjFK4YUseblGfQnJlxaAtI5V8umMJgU6ci\r\nmWJy2q+74pow1+/WpeX8XMEpRmVFZVoR9sVQs8MMGP0+o4jFus9X4B/0hY6m\r\n5oOtPzAmhT1dD/N5LtbNWc0Dceq6qeBVvYn7Kv64097tV8zXF11/CBF0n8UF\r\nNiHmJJ3C7/9ywJeZWnR4+VIFcriW5Fhd6DY=\r\n=y8Mm\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.29.0_1656409086285_0.7160663258426248"},"_hasShrinkwrap":false},"0.0.0-2022-07-11--08-09":{"name":"opentelemetry-instrumentation-express","version":"0.0.0-2022-07-11--08-09","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn build","test":"mocha --require @opentelemetry/contrib-test-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require @opentelemetry/contrib-test-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"peerDependencies":{"@opentelemetry/api":"^1.0.0"},"dependencies":{"@opentelemetry/core":"^1.0.0","@opentelemetry/instrumentation":"^0.29.0","@opentelemetry/semantic-conventions":"^1.0.0","parseurl":"~1.3.3","path-to-regexp":"0.1.7"},"devDependencies":{"@opentelemetry/api":"^1.0.0","@opentelemetry/contrib-test-utils":"^0.31.0","@opentelemetry/instrumentation-http":"^0.29.0","@opentelemetry/sdk-trace-base":"1.2.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"0.0.1-rc.7","test-all-versions":"^5.0.1","ts-node":"^9.1.1","typescript":"4.3.4"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"d4b1388181deeeaa3ad626524493f9e85222d13a","readme":"# OpenTelemetry express Instrumentation for Node.js\n[![NPM version](https://img.shields.io/npm/v/opentelemetry-instrumentation-express.svg)](https://www.npmjs.com/package/opentelemetry-instrumentation-express)\n\nThis module provide enhanced instrumentation for the `express` web framework.\n\n## Installation\n\n```\nnpm install --save opentelemetry-instrumentation-express\n```\n## Supported Versions\nThis instrumentation supports `^4.9.0`:\n\nall versions >= `4.9.0` (released 2014) and < `5.0.0` (in alpha).\n\n## Usage\nFor further automatic instrumentation instruction see the [@opentelemetry/instrumentation](https://github.com/open-telemetry/opentelemetry-js/tree/main/packages/opentelemetry-instrumentation) package.\n\n```js\nconst { NodeTracerProvider } = require('@opentelemetry/sdk-trace-node');\nconst { registerInstrumentations } = require('@opentelemetry/instrumentation');\nconst { ExpressInstrumentation } = require('opentelemetry-instrumentation-express');\n\nconst tracerProvider = new NodeTracerProvider();\ntracerProvider.register();\n\nregisterInstrumentations({\n  tracerProvider,\n  instrumentations: [\n    new ExpressInstrumentation()\n  ]\n});\n```\n\n### Express Instrumentation Options\n\nExpress instrumentation has few options available to choose from. You can set the following:\n\n| Options | Type  | Description |\n| --- | --- | --- |\n| `requestHook` | `RequestHook` (function) | Hook for adding custom attributes before express start handling the request. Receives params: `span, { moduleVersion, req, res }` |\n| `includeHttpAttributes` | `boolean` | If set to true, plugin will include semantic http attributes in each express span |\n\n## Semantic Behavior\nExpress auto instrumentation will create a single span per request with the following attributes.\nDetailed specification and cases can be found [here](./doc/attributes-specification.MD).\n\n### `http.route`\nThis is a conventional http attribute, which is collected by express instead of the http module (which is not aware of the route). It will always contain path-parameterized data with low cardinality (no ids), but might be missing parts of the path in case of early termination or middlewares that accept any path.\n\nExample: `/api/users/:id`\n\n### `express.route.full`\nThis attribute will always contain the entire path. The part of the path that has been consumed by express will be shown as is (parameterized), and the leftover will be concatenated after (due to early termination or middleware that accept any path).\n\nExample: `/api/users/:id/books/758734` (The `:id` part was consumed, but the `bookid` part was not).\n\n### `express.route.configured`\nThis attribute is relevant when user configures multi path options for the same middleware. It reduces even further the cardinality space compared to `http.route`, and supply more info about how the app routing works.\n\nExample: `/api[\"/foo\", /\"bar\"]` - meaning that the same endpoint is triggered by routes `/api/foo` and `/api/bar`.\n\n### `express.route.params`\nThis attribute holds a json stringified map, where the keys are the url path param names, and the values are the matched params from the actual url.\n\nExample: `{\"id\":\"1234\"}`. \n\n### `express.unhandled`\nSet to true when request was not handled by any middleware in express, and got fallback to the default app `finalhandler`. This can happen if client sent request with invalid path or method (resulting in 404). This can be useful to filter out requests from internet bots which try to call common routes on servers.\n\n### `express.instrumentation.errors`\nIn case of internal error in instrumentation, this attribute will contain the error description. There are no known valid use cases which are expected to produce this attribute.\n\n## Difference from [@opentelemetry/instrumentation-express](https://github.com/open-telemetry/opentelemetry-js-contrib/tree/main/plugins/node/opentelemetry-instrumentation-express)\n\n* This instrumentation is focusing on extracting the most accurate and complete `route` data, in any valid express edge case. Contrib instrumentation does a good job for common cases, but miss nuances on complex setups.\n* This instrumentation create a single span per request. Contrib instrumentation creates span per express Router/Route, which can be useful to observe express internal components, with the cost of more spans in each trace.\n* Set few alternatives for route attribute, each with different level of cardinality vs accuracy.\n* Allows to set `requestHook` for adding custom attributes to span, as well as ability to capture express version into user defined attribute.\n* Distinguish between handled requests (ended from user middleware), and unhandled (terminated from express built in 'finalhandler').\n* Option to conform with the [Semantic conventions for HTTP spans](https://github.com/open-telemetry/opentelemetry-specification/blob/master/specification/trace/semantic_conventions/http.md).\n\n\n---\n\nThis extension (and many others) was developed by [Aspecto](https://www.aspecto.io/) with ❤️","readmeFilename":"README.md","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.0.0-2022-07-11--08-09","_nodeVersion":"14.19.3","_npmVersion":"lerna/3.22.1/node@v14.19.3+x64 (linux)","dist":{"integrity":"sha512-2YmEGzmfBl0Uyckz3Zf4wRgJsDpWEJXg11iwGkfdhd/SCiUHQlAfiIzcRj5vGvpqUnxlZpyL9aICJeWRodAgjg==","shasum":"bf61e39c3c51f4a3d226137adb56131afd3b54c8","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.0.0-2022-07-11--08-09.tgz","fileCount":25,"unpackedSize":103842,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIFGRP0rWkXgT9p4UdwIEmx1KU1DPd+80AMpCViI4oogiAiAFXTg5OQDGylTVX4Himh4RjYlwXDGFOibgyXUoxFV6CA=="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJiy9rZACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2Vmok/A//fjA51+HrJAn06fO6QnIW5iMaMwkELhT2jSkGJqK1BUvAdpgx\r\nq55jzT+BwU5mGnq6cdncTXkU+1wvYXze3iVp0NTqa8LuctH1XCmR40gEkqqS\r\nhklAyrVUvjCHDqNpqFyyPDrb7bsq943ICpDNNiadtX/DLXKZa1BpAEjOkLxE\r\nP1Sjmtibq2Q2aJfSFDFkhB2CxR1fc6apSrjMkh3FYgkyHaqR4hqEljEtKzbt\r\nKzLGmheg3AoYxKuJjd+IimXzTOnPB+s+xQxo2RQfsb5DQZaFli3ULQB02jXs\r\nz3o9Af2NJh6Z0PWqwM7u9R/kh9YvQLqo84pTlFwTw8xrlJmkpV6Qc8UtQJ35\r\nPRL2g/f6NNT9CFO98ZoMhq8zuljuoTi++tHzgnH4fVIzjCMQ4TXRRYgC0fJq\r\nEt/tsgzN/qAdUa856aP8YJF595LKhzNoo1a+xXcjeXN1hSfPqHSihXoj9vxB\r\nzsUkNPZw2e2MAiOVq/e6uVCHDGN4VRlib3mMOXqOwlk0jT2s+0wo+ACF8V/P\r\nzhIWBShSDVxPTJ1OsDr4h5iObnzRsFssEQ04Top79dV5Bvh4JP3Fm1drKaxh\r\n2HhHUr9BqShUsHNE6DUcz6Pa3lT6vjVND4FTXG12Ruhy3hNl1eV5bvCK/x0n\r\nOXxRU58yrhZvogCyBMAbT1hEWy3hihO/wpQ=\r\n=9MyH\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.0.0-2022-07-11--08-09_1657527001118_0.7882216017169918"},"_hasShrinkwrap":false},"0.32.0":{"name":"opentelemetry-instrumentation-express","version":"0.32.0","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn build","test":"mocha --require @opentelemetry/contrib-test-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require @opentelemetry/contrib-test-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"peerDependencies":{"@opentelemetry/api":"^1.0.0"},"dependencies":{"@opentelemetry/core":"^1.0.0","@opentelemetry/instrumentation":"^0.32.0","@opentelemetry/semantic-conventions":"^1.0.0","parseurl":"~1.3.3","path-to-regexp":"0.1.7"},"devDependencies":{"@opentelemetry/api":"^1.0.0","@opentelemetry/contrib-test-utils":"^0.32.0","@opentelemetry/instrumentation-http":"^0.32.0","@opentelemetry/sdk-trace-base":"1.2.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"0.0.1-rc.7","test-all-versions":"^5.0.1","ts-node":"^9.1.1","typescript":"4.3.4"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"55e1b892a2d6ec6c9097e6e39ff69d15562b549b","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.32.0","_nodeVersion":"14.20.1","_npmVersion":"lerna/3.22.1/node@v14.20.1+x64 (linux)","dist":{"integrity":"sha512-XNC2ZvdSmbycF4PjkvsTJ5Ara0FA6a0cRZYJ7EYRz2/e80IzZQfC1NH/I0vplMen4DSt/ZguOr88bglWrFucKA==","shasum":"af2f00fedb94715c3f04f7b276367a2cb50728e4","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.32.0.tgz","fileCount":25,"unpackedSize":104196,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQC36hBDrGe32kV6uvgMwrMmKJ5/aNsfkt8xdmkcGKjrfwIgc9rPzK4q+JltMX4IEYX+HR/0LvTj8b46GCkkzTnYE6U="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJjTnyMACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmoAvg//SpBwo38eGyMTkOuNNHtmGMh/WcT84ovv3KOgQ4bWF++5q8BQ\r\neigHexHGjTa46f4cbuI0C7uaB1J6kPRMovMhBZeqTil3RAsyNwCPt4/8RMbC\r\nzVIl/PBfRQGejmmJ8vna5Kk+y7e5kQLt5Eg8tpdJpwjPuCQkoA7+6jKHBnPa\r\nR909ApWQZBUUNnom1VADfVaSyd/J9cvUDTUDzDLzstuQ5v10id/rA/i1op+g\r\nptLJl2SOJceKM/5vWwmP3mdt2ZYVcEr43DF78xHUcTK0M2BjbHwVGLkOxr5y\r\nGJISHwiQKw6yGi56iiRHs0xDpBgVtWofSP2BHtEar0TJPIPhaHHfNkn6L3iC\r\nniElt2vdmffBEFZmgdgmlmyrvjGQK01ugjAgDnq3gCpunMPCbXP/MVc2ntbV\r\nxhge6EqQUN8DYKCXw9bh2SSLkwKrxR6sqvRqeJWpv05yohvYj4ZeBKBBOoag\r\nJZviZpKk1UynskKxL4MAD5O40+AmA/CO4VzZeSbOkqiCQQeGK040+JFzlBjx\r\nfWGGpyEg0fl4rhYq5njWrH/Wbi8R5l4ovqfgJs8W0cFcO0Uz/1L6yGS5Nmrg\r\nkc2hc6coMmqCq1Heh02GxenIbyXSpzzQUCsGMzDsPCLwE8PIiWAuIdykD4au\r\n+yM0b71xUJVZh7rA4IpBSBtYD9/12w4TdO0=\r\n=Araz\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.32.0_1666088075984_0.1894894621949994"},"_hasShrinkwrap":false},"0.34.0":{"name":"opentelemetry-instrumentation-express","version":"0.34.0","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn build","test":"mocha --require @opentelemetry/contrib-test-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require @opentelemetry/contrib-test-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"peerDependencies":{"@opentelemetry/api":"^1.3.0"},"dependencies":{"@opentelemetry/core":"^1.8.0","@opentelemetry/instrumentation":"^0.34.0","@opentelemetry/semantic-conventions":"^1.8.0","parseurl":"~1.3.3","path-to-regexp":"0.1.7"},"devDependencies":{"@opentelemetry/api":"^1.3.0","@opentelemetry/contrib-test-utils":"^0.33.0","@opentelemetry/instrumentation-http":"^0.34.0","@opentelemetry/sdk-trace-base":"1.8.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"0.0.1-rc.7","test-all-versions":"^5.0.1","ts-node":"^9.1.1","typescript":"4.3.4"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"ccc45183d4f5386a4f675f2c02acd8c41a4293d9","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.34.0","_nodeVersion":"14.20.1","_npmVersion":"lerna/3.22.1/node@v14.20.1+x64 (linux)","dist":{"integrity":"sha512-NIwjPewKyXH6yyRIq2KNF+lHhlBAgRynp5f/2/TMZtobvJGiT4xR852b+aQPba2NYf2pu9BoyS8SEM6sGNM4iQ==","shasum":"8e3ab2aa18f7afb9dbdd3b709af86ff71a5302e0","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.34.0.tgz","fileCount":25,"unpackedSize":104619,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQDF5qwozC6tV9WPqXO/66VjQyR3BvTETC+vvuYj0FytXQIgeoOitZAhGCTYbRPOYzWEoW1iyz4A/0XgdwlSP4EhVTo="}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJje2D1ACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2Vmrkng//cOinLt3Q/+gcK2543EExZNHIPIcWusk69C54+9Wf3TdpsVvY\r\nEad1XCeyRplxohhQ8r27gleyl/MvwSE/ygHg30MDnmzO6Lyhy1wIbuIeoLjZ\r\ndYQgXqZvXmw8egvmx90h60BBVnCuXMEX+0Zaj5SostMbxFdpwCwpM5ErrAvt\r\n6WOlfR22DKPHZgh4vanLc/SzNY/jVDl2Z7Nc7J8R9rGrou3oCfNQqoCftYdn\r\nzvqpLpzCgHwsk66atROR2afL1pVVbyW66e6Ed8Qfs4Hn+5nS6c4QTbpwb2wi\r\ngU7Mx8tLWZpNQ2kQeS+UaqZ3yFAnkJ7MfU084NtEsn/KhDCyS2kM/q4Dunyj\r\nVxyxOx2Jo0Hu1D06ZHhl7M0xpFDyCGXLd47BOy1VmLKn+Y33Q/dkTiJ36mXv\r\nX6mXl/iNg5rNStAKp3X4nBJX9x3qaKJduLAMnHLnoFjK2rWDSWq523IV0lA9\r\n35d8+b6KQjZiptB350/wX3Iy8kZBBv9V2X3eb8YgiNOsz+dTcddldbYGfOx7\r\n246AmEjQ3ISUUX4m2scWSHd0n1NAnK4TLhZItb3De200/YGI97/QkUQNxD8x\r\ntgJTbk1WGDsMHw2mhavR7gE5pn6FqM9P/PRXWImRnZ2GY/aBJVc2/SBzQdUG\r\nwKUsE1UiA4Cr4e9hBvd4xc3zJGYd3G0LGDM=\r\n=XA9W\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.34.0_1669030133504_0.26855948958439235"},"_hasShrinkwrap":false},"0.35.0":{"name":"opentelemetry-instrumentation-express","version":"0.35.0","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn build","test":"mocha --require @opentelemetry/contrib-test-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require @opentelemetry/contrib-test-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"peerDependencies":{"@opentelemetry/api":"^1.3.0"},"dependencies":{"@opentelemetry/core":"^1.8.0","@opentelemetry/instrumentation":"^0.35.1","@opentelemetry/semantic-conventions":"^1.8.0","parseurl":"~1.3.3","path-to-regexp":"0.1.7"},"devDependencies":{"@opentelemetry/api":"^1.3.0","@opentelemetry/contrib-test-utils":"^0.33.1","@opentelemetry/instrumentation-http":"^0.35.1","@opentelemetry/sdk-trace-base":"1.8.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"0.0.1-rc.7","test-all-versions":"^5.0.1","ts-node":"^9.1.1","typescript":"4.3.4"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"c539814a11ce53629195b0c3b017ab2ab7046511","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.35.0","_nodeVersion":"14.21.3","_npmVersion":"lerna/3.22.1/node@v14.21.3+x64 (linux)","dist":{"integrity":"sha512-k/SApZZsnHriHXTIh6vG5gcrZ8arm3WCoCefgxgYsz/DLaa40k2/PjLKsFGoKTx+A2rR2v73d9634nC1MJsZfA==","shasum":"eaad96fb922959c9a1e0809ac8d36a3fd0f32200","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.35.0.tgz","fileCount":25,"unpackedSize":104879,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQCiov2yqkxqgLlok6ByuM3v9+Xcv+U4kK/8QzFkqLx9HgIhALDxai9LHTfNlzRfx83WUGGeZvU29Nz1LH1lWw+92OKv"}],"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJj/wolACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2VmrFmQ//Y4BZQwvxrj9LGF+iu8vMfpbBwbLvDoNVoXXLnOpTqcd2Gnj+\r\nXCHwCB00ylovWQT5W/pcPQ9i7DcxfbijMQoqZLP9rzOnV5+fh9d8o89bkz7x\r\np3vbluUJBLvj80ac/vuQkXIf8V9GUECgL+m2bEUZ8E0p5UP3GTJ1cRTBjeA4\r\ndGoS/E2SKSC9K40GJnU1mVgw+bh1foAz/UmInMkcksTmSUqxSorQbLdIiHYR\r\nyLJPYITDyOtQl1M3wAOrxho3K3ceekbpULJK+TwwTzxsc4C2CeBz+7Jtteyw\r\n3SN2axXof3wFSR2vCZrvmGE9U5EbOwKPRKVdNVROVYvPN7YKXJA4pT0aVP1L\r\naUCtwZuV/pOQqUEgSv0f3nCBrFJ4G7VICcqsBgHzprRsnosBAwPd6xb+80Qn\r\nFqWAYqJyXu6G3eY3impbFMgjm6PjY3Uqb5TN5XTP+lLUa1sUpimgLvIEF84u\r\njrrdusu9eeoRy+sIG4P1eJhPPnIXqKtasMQcMZ6QTRghkYOCqZZpyWuv8RrD\r\n6KlmVhfbupR8AjXlIPgqioHxJ9TppYIZQEQ0GQ6Dn3u2kTB5kBsehmQKV5OQ\r\nTKjDiuKGUTS9dUSILDxOfcIVfLRyiTCrBZ5JkzHK0j7M62ueHXruYaFLBNLt\r\nHO6x8+9Amg07yzynFsfjKtd0jH1d8mNkAHo=\r\n=HJdD\r\n-----END PGP SIGNATURE-----\r\n"},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.35.0_1677658660750_0.6986166694290423"},"_hasShrinkwrap":false},"0.0.0-2023-07-26--14-48":{"name":"opentelemetry-instrumentation-express","version":"0.0.0-2023-07-26--14-48","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn build","test":"mocha --require @opentelemetry/contrib-test-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require @opentelemetry/contrib-test-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"peerDependencies":{"@opentelemetry/api":"^1.3.0"},"dependencies":{"@opentelemetry/core":"^1.13.0","@opentelemetry/instrumentation":"^0.41.0","@opentelemetry/semantic-conventions":"^1.13.0","parseurl":"~1.3.3","path-to-regexp":"0.1.7"},"devDependencies":{"@opentelemetry/api":"^1.3.0","@opentelemetry/contrib-test-utils":"^0.34.0","@opentelemetry/instrumentation-http":"^0.39.1","@opentelemetry/sdk-trace-base":"^1.8.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"0.0.1-rc.7","test-all-versions":"^5.0.1","ts-node":"^9.1.1","typescript":"4.3.4"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"67eb37b2cfe933c3a1b9dacec4691403e5b4b240","readme":"# OpenTelemetry express Instrumentation for Node.js\n[![NPM version](https://img.shields.io/npm/v/opentelemetry-instrumentation-express.svg)](https://www.npmjs.com/package/opentelemetry-instrumentation-express)\n\nThis module provide enhanced instrumentation for the `express` web framework.\n\n## Installation\n\n```\nnpm install --save opentelemetry-instrumentation-express\n```\n## Supported Versions\nThis instrumentation supports `^4.9.0`:\n\nall versions >= `4.9.0` (released 2014) and < `5.0.0` (in alpha).\n\n## Usage\nFor further automatic instrumentation instruction see the [@opentelemetry/instrumentation](https://github.com/open-telemetry/opentelemetry-js/tree/main/packages/opentelemetry-instrumentation) package.\n\n```js\nconst { NodeTracerProvider } = require('@opentelemetry/sdk-trace-node');\nconst { registerInstrumentations } = require('@opentelemetry/instrumentation');\nconst { ExpressInstrumentation } = require('opentelemetry-instrumentation-express');\n\nconst tracerProvider = new NodeTracerProvider();\ntracerProvider.register();\n\nregisterInstrumentations({\n  tracerProvider,\n  instrumentations: [\n    new ExpressInstrumentation()\n  ]\n});\n```\n\n### Express Instrumentation Options\n\nExpress instrumentation has few options available to choose from. You can set the following:\n\n| Options | Type  | Description |\n| --- | --- | --- |\n| `requestHook` | `RequestHook` (function) | Hook for adding custom attributes before express start handling the request. Receives params: `span, { moduleVersion, req, res }` |\n| `includeHttpAttributes` | `boolean` | If set to true, plugin will include semantic http attributes in each express span |\n\n## Semantic Behavior\nExpress auto instrumentation will create a single span per request with the following attributes.\nDetailed specification and cases can be found [here](./doc/attributes-specification.MD).\n\n### `http.route`\nThis is a conventional http attribute, which is collected by express instead of the http module (which is not aware of the route). It will always contain path-parameterized data with low cardinality (no ids), but might be missing parts of the path in case of early termination or middlewares that accept any path.\n\nExample: `/api/users/:id`\n\n### `express.route.full`\nThis attribute will always contain the entire path. The part of the path that has been consumed by express will be shown as is (parameterized), and the leftover will be concatenated after (due to early termination or middleware that accept any path).\n\nExample: `/api/users/:id/books/758734` (The `:id` part was consumed, but the `bookid` part was not).\n\n### `express.route.configured`\nThis attribute is relevant when user configures multi path options for the same middleware. It reduces even further the cardinality space compared to `http.route`, and supply more info about how the app routing works.\n\nExample: `/api[\"/foo\", /\"bar\"]` - meaning that the same endpoint is triggered by routes `/api/foo` and `/api/bar`.\n\n### `express.route.params`\nThis attribute holds a json stringified map, where the keys are the url path param names, and the values are the matched params from the actual url.\n\nExample: `{\"id\":\"1234\"}`. \n\n### `express.unhandled`\nSet to true when request was not handled by any middleware in express, and got fallback to the default app `finalhandler`. This can happen if client sent request with invalid path or method (resulting in 404). This can be useful to filter out requests from internet bots which try to call common routes on servers.\n\n### `express.instrumentation.errors`\nIn case of internal error in instrumentation, this attribute will contain the error description. There are no known valid use cases which are expected to produce this attribute.\n\n## Difference from [@opentelemetry/instrumentation-express](https://github.com/open-telemetry/opentelemetry-js-contrib/tree/main/plugins/node/opentelemetry-instrumentation-express)\n\n* This instrumentation is focusing on extracting the most accurate and complete `route` data, in any valid express edge case. Contrib instrumentation does a good job for common cases, but miss nuances on complex setups.\n* This instrumentation create a single span per request. Contrib instrumentation creates span per express Router/Route, which can be useful to observe express internal components, with the cost of more spans in each trace.\n* Set few alternatives for route attribute, each with different level of cardinality vs accuracy.\n* Allows to set `requestHook` for adding custom attributes to span, as well as ability to capture express version into user defined attribute.\n* Distinguish between handled requests (ended from user middleware), and unhandled (terminated from express built in 'finalhandler').\n* Option to conform with the [Semantic conventions for HTTP spans](https://github.com/open-telemetry/opentelemetry-specification/blob/master/specification/trace/semantic_conventions/http.md).\n\n\n---\n\nThis extension (and many others) was developed by [Aspecto](https://www.aspecto.io/) with ❤️","readmeFilename":"README.md","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.0.0-2023-07-26--14-48","_nodeVersion":"14.21.3","_npmVersion":"lerna/3.22.1/node@v14.21.3+x64 (linux)","dist":{"integrity":"sha512-m/5x/2nJetNP6N2ApZqCGxskjiWRqc2nwNFZ59w/EFl7ZI297asCx/FhiB2YZV64ol3FnZ6TwCtW9ST0XFraFQ==","shasum":"1a54deaffe843209405d5454e973ded90f6bfa69","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.0.0-2023-07-26--14-48.tgz","fileCount":25,"unpackedSize":104952,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIGnweAZNbyjmhBmRE0CpzKahniXy9CAX7XSf+XkYKvloAiEAl59WqlC97U7fiaQ+2g00or4jWzlwVB48ELWwRJFpg0Y="}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.0.0-2023-07-26--14-48_1690382944657_0.755325063090879"},"_hasShrinkwrap":false},"0.35.1":{"name":"opentelemetry-instrumentation-express","version":"0.35.1","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn build","test":"mocha --require @opentelemetry/contrib-test-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require @opentelemetry/contrib-test-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"peerDependencies":{"@opentelemetry/api":"^1.3.0"},"dependencies":{"@opentelemetry/core":"^1.13.0","@opentelemetry/instrumentation":"^0.41.0","@opentelemetry/semantic-conventions":"^1.13.0","parseurl":"~1.3.3","path-to-regexp":"0.1.7"},"devDependencies":{"@opentelemetry/api":"^1.3.0","@opentelemetry/contrib-test-utils":"^0.34.0","@opentelemetry/instrumentation-http":"^0.39.1","@opentelemetry/sdk-trace-base":"^1.8.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"0.0.1-rc.7","test-all-versions":"^5.0.1","ts-node":"^9.1.1","typescript":"4.3.4"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"7a6ce9bbc0917c740a78637e97a5eeeca21c441a","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.35.1","_nodeVersion":"14.21.3","_npmVersion":"lerna/3.22.1/node@v14.21.3+x64 (linux)","dist":{"integrity":"sha512-JxWZCT+6O45rUe2d2IWYpUUE2BmBod8N2nWcdW4bEY13gI6IvmtLuArRjQ7eNBhJmjx3wwzO8AZaS9OAEz2mGw==","shasum":"a4a7b81acb6f8bd291aec84e375b784a682fc614","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.35.1.tgz","fileCount":25,"unpackedSize":105143,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQCWp6Xb9s4vJ/puhNFtkq45hW8bnIOS7DOmkz0PDx/d9wIhAO8QccFqI+qUympY9O1KMADGASBbvTYW5fLVL8txjJEh"}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.35.1_1690457702069_0.3650114822679662"},"_hasShrinkwrap":false},"0.39.1":{"name":"opentelemetry-instrumentation-express","version":"0.39.1","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn build","test":"mocha --require @opentelemetry/contrib-test-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require @opentelemetry/contrib-test-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"peerDependencies":{"@opentelemetry/api":"^1.3.0"},"dependencies":{"@opentelemetry/core":"^1.13.0","@opentelemetry/instrumentation":"^0.41.0","@opentelemetry/semantic-conventions":"^1.13.0","parseurl":"~1.3.3","path-to-regexp":"0.1.7"},"devDependencies":{"@opentelemetry/api":"^1.3.0","@opentelemetry/contrib-test-utils":"^0.34.0","@opentelemetry/instrumentation-http":"^0.39.1","@opentelemetry/sdk-trace-base":"^1.8.0","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"0.0.1-rc.7","test-all-versions":"^5.0.1","ts-node":"^9.1.1","typescript":"4.3.4"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"8083e6c2c9a25ef82bd43a766d93732c60dbd674","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.39.1","_nodeVersion":"14.21.3","_npmVersion":"lerna/3.22.1/node@v14.21.3+x64 (linux)","dist":{"integrity":"sha512-OSTnGrEwqrnGvjB3La3/3maMKfM5AAgYea233LopEl3vSFi31F4iEaldPGTMR7IOaLSAKsbI0+kRN6RV3UNklQ==","shasum":"900c8c6466a0c81f1777b0fbd6276bf5ebb9eb32","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.39.1.tgz","fileCount":25,"unpackedSize":105404,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQC1LZx814l3UthmfAxNegk1XbubKWZnS5eLvUmqbNrZBwIhAN29dsDb1PAjn47fCJZPhSiToGB/XKAoXEMvErxgPUWJ"}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.39.1_1690459767796_0.058349358694510745"},"_hasShrinkwrap":false},"0.0.0-2023-10-17--13-06":{"name":"opentelemetry-instrumentation-express","version":"0.0.0-2023-10-17--13-06","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn build","test":"mocha --require @opentelemetry/contrib-test-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require @opentelemetry/contrib-test-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"peerDependencies":{"@opentelemetry/api":"^1.6.0"},"dependencies":{"@opentelemetry/core":"^1.17.1","@opentelemetry/instrumentation":"^0.44.0","@opentelemetry/semantic-conventions":"^1.17.1","parseurl":"~1.3.3","path-to-regexp":"0.1.7"},"devDependencies":{"@opentelemetry/api":"^1.6.0","@opentelemetry/contrib-test-utils":"^0.34.2","@opentelemetry/instrumentation-http":"^0.44.0","@opentelemetry/sdk-trace-base":"^1.17.1","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"0.0.7-alpha.1","test-all-versions":"^5.0.1","ts-node":"^9.1.1","typescript":"4.3.4"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"f8da552adae250e08f2062df741972440df3ac97","readme":"# OpenTelemetry express Instrumentation for Node.js\n[![NPM version](https://img.shields.io/npm/v/opentelemetry-instrumentation-express.svg)](https://www.npmjs.com/package/opentelemetry-instrumentation-express)\n\nThis module provide enhanced instrumentation for the `express` web framework.\n\n## Installation\n\n```\nnpm install --save opentelemetry-instrumentation-express\n```\n## Supported Versions\nThis instrumentation supports `^4.9.0`:\n\nall versions >= `4.9.0` (released 2014) and < `5.0.0` (in alpha).\n\n## Usage\nFor further automatic instrumentation instruction see the [@opentelemetry/instrumentation](https://github.com/open-telemetry/opentelemetry-js/tree/main/packages/opentelemetry-instrumentation) package.\n\n```js\nconst { NodeTracerProvider } = require('@opentelemetry/sdk-trace-node');\nconst { registerInstrumentations } = require('@opentelemetry/instrumentation');\nconst { ExpressInstrumentation } = require('opentelemetry-instrumentation-express');\n\nconst tracerProvider = new NodeTracerProvider();\ntracerProvider.register();\n\nregisterInstrumentations({\n  tracerProvider,\n  instrumentations: [\n    new ExpressInstrumentation()\n  ]\n});\n```\n\n### Express Instrumentation Options\n\nExpress instrumentation has few options available to choose from. You can set the following:\n\n| Options | Type  | Description |\n| --- | --- | --- |\n| `requestHook` | `RequestHook` (function) | Hook for adding custom attributes before express start handling the request. Receives params: `span, { moduleVersion, req, res }` |\n| `includeHttpAttributes` | `boolean` | If set to true, plugin will include semantic http attributes in each express span |\n\n## Semantic Behavior\nExpress auto instrumentation will create a single span per request with the following attributes.\nDetailed specification and cases can be found [here](./doc/attributes-specification.MD).\n\n### `http.route`\nThis is a conventional http attribute, which is collected by express instead of the http module (which is not aware of the route). It will always contain path-parameterized data with low cardinality (no ids), but might be missing parts of the path in case of early termination or middlewares that accept any path.\n\nExample: `/api/users/:id`\n\n### `express.route.full`\nThis attribute will always contain the entire path. The part of the path that has been consumed by express will be shown as is (parameterized), and the leftover will be concatenated after (due to early termination or middleware that accept any path).\n\nExample: `/api/users/:id/books/758734` (The `:id` part was consumed, but the `bookid` part was not).\n\n### `express.route.configured`\nThis attribute is relevant when user configures multi path options for the same middleware. It reduces even further the cardinality space compared to `http.route`, and supply more info about how the app routing works.\n\nExample: `/api[\"/foo\", /\"bar\"]` - meaning that the same endpoint is triggered by routes `/api/foo` and `/api/bar`.\n\n### `express.route.params`\nThis attribute holds a json stringified map, where the keys are the url path param names, and the values are the matched params from the actual url.\n\nExample: `{\"id\":\"1234\"}`. \n\n### `express.unhandled`\nSet to true when request was not handled by any middleware in express, and got fallback to the default app `finalhandler`. This can happen if client sent request with invalid path or method (resulting in 404). This can be useful to filter out requests from internet bots which try to call common routes on servers.\n\n### `express.instrumentation.errors`\nIn case of internal error in instrumentation, this attribute will contain the error description. There are no known valid use cases which are expected to produce this attribute.\n\n## Difference from [@opentelemetry/instrumentation-express](https://github.com/open-telemetry/opentelemetry-js-contrib/tree/main/plugins/node/opentelemetry-instrumentation-express)\n\n* This instrumentation is focusing on extracting the most accurate and complete `route` data, in any valid express edge case. Contrib instrumentation does a good job for common cases, but miss nuances on complex setups.\n* This instrumentation create a single span per request. Contrib instrumentation creates span per express Router/Route, which can be useful to observe express internal components, with the cost of more spans in each trace.\n* Set few alternatives for route attribute, each with different level of cardinality vs accuracy.\n* Allows to set `requestHook` for adding custom attributes to span, as well as ability to capture express version into user defined attribute.\n* Distinguish between handled requests (ended from user middleware), and unhandled (terminated from express built in 'finalhandler').\n* Option to conform with the [Semantic conventions for HTTP spans](https://github.com/open-telemetry/opentelemetry-specification/blob/master/specification/trace/semantic_conventions/http.md).\n\n\n---\n\nThis extension (and many others) was developed by [Aspecto](https://www.aspecto.io/) with ❤️","readmeFilename":"README.md","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.0.0-2023-10-17--13-06","_nodeVersion":"14.21.3","_npmVersion":"lerna/3.22.1/node@v14.21.3+x64 (linux)","dist":{"integrity":"sha512-p7/fOiwzWCt6L3KZZvOarLjaoSs5gwsuRAovxKwoIEfW/kCN/oXlhZxKS+OrVvFK2eOw+1hGSoH5OEcgvMkk4A==","shasum":"356a843f4df4eb1e236586c2eb85a3373f67a470","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.0.0-2023-10-17--13-06.tgz","fileCount":25,"unpackedSize":105478,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIARpbfHRnscP6xD24wMfxsNjgxU7vYBZe9kIGiF7/UcLAiAS7msaFx2X8j9/HvR1zuhJYqBTh9i/sDEec1WQFzLyFw=="}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.0.0-2023-10-17--13-06_1697548067371_0.7657395065692489"},"_hasShrinkwrap":false},"0.40.0":{"name":"opentelemetry-instrumentation-express","version":"0.40.0","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn build","test":"mocha --require @opentelemetry/contrib-test-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require @opentelemetry/contrib-test-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"peerDependencies":{"@opentelemetry/api":"^1.6.0"},"dependencies":{"@opentelemetry/core":"^1.17.1","@opentelemetry/instrumentation":"^0.44.0","@opentelemetry/semantic-conventions":"^1.17.1","parseurl":"~1.3.3","path-to-regexp":"0.1.7"},"devDependencies":{"@opentelemetry/api":"^1.6.0","@opentelemetry/contrib-test-utils":"^0.34.2","@opentelemetry/instrumentation-http":"^0.44.0","@opentelemetry/sdk-trace-base":"^1.17.1","@types/express":"4.17.8","@types/mocha":"^8.2.2","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","opentelemetry-instrumentation-mocha":"0.0.7-alpha.1","test-all-versions":"^5.0.1","ts-node":"^9.1.1","typescript":"4.3.4"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","opentelemetry-instrumentation-mocha"]},"gitHead":"3be217b8c6c8a6ae41486c51453781732c2c3ea3","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.40.0","_nodeVersion":"14.21.3","_npmVersion":"lerna/3.22.1/node@v14.21.3+x64 (linux)","dist":{"integrity":"sha512-eTo8md9aSM8odt5cqsDD9ZKJ0gX9U/YUYeRbkWAERMobnmF3EaHCu2uw5vduh+Ew3LChoo4DUyx2+wsjzDKVJw==","shasum":"9d10bf3badee2184235a5bb81bc2ee6755b41cc4","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.40.0.tgz","fileCount":25,"unpackedSize":105668,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIByzeqj44RTKBBBkbDrpjbDFgdUFiULIWF/DKuYmyZc6AiB9OzvhvoHsQjvu4qSxyVS0OqJ5gLB1ht4+AGfeeBcyiQ=="}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.40.0_1697549244997_0.5206688468004215"},"_hasShrinkwrap":false},"0.0.0-2024-05-16--12-47":{"name":"opentelemetry-instrumentation-express","version":"0.0.0-2024-05-16--12-47","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn build","test":"mocha --require @opentelemetry/contrib-test-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require @opentelemetry/contrib-test-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"peerDependencies":{"@opentelemetry/api":"^1.8.0"},"dependencies":{"@opentelemetry/core":"^1.24.1","@opentelemetry/instrumentation":"^0.51.1","@opentelemetry/semantic-conventions":"^1.24.1","parseurl":"~1.3.3","path-to-regexp":"0.1.7"},"devDependencies":{"@opentelemetry/api":"^1.8.0","@opentelemetry/contrib-test-utils":"^0.39.0","@opentelemetry/instrumentation-http":"^0.44.0","@opentelemetry/sdk-trace-base":"^1.24.1","@types/express":"4.17.8","@types/mocha":"^8.2.2","aspecto-opentelemetry-instrumentation-mocha":"0.0.9-alpha.0","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","test-all-versions":"^5.0.1","ts-node":"^10.9.2","typescript":"5.4.5"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","aspecto-opentelemetry-instrumentation-mocha"]},"gitHead":"0f32591c71be0933eae844b744a70f9c9aedb84d","readme":"# OpenTelemetry express Instrumentation for Node.js\n[![NPM version](https://img.shields.io/npm/v/opentelemetry-instrumentation-express.svg)](https://www.npmjs.com/package/opentelemetry-instrumentation-express)\n\nThis module provide enhanced instrumentation for the `express` web framework.\n\n## Installation\n\n```\nnpm install --save opentelemetry-instrumentation-express\n```\n## Supported Versions\nThis instrumentation supports `^4.9.0`:\n\nall versions >= `4.9.0` (released 2014) and < `5.0.0` (in alpha).\n\n## Usage\nFor further automatic instrumentation instruction see the [@opentelemetry/instrumentation](https://github.com/open-telemetry/opentelemetry-js/tree/main/packages/opentelemetry-instrumentation) package.\n\n```js\nconst { NodeTracerProvider } = require('@opentelemetry/sdk-trace-node');\nconst { registerInstrumentations } = require('@opentelemetry/instrumentation');\nconst { ExpressInstrumentation } = require('opentelemetry-instrumentation-express');\n\nconst tracerProvider = new NodeTracerProvider();\ntracerProvider.register();\n\nregisterInstrumentations({\n  tracerProvider,\n  instrumentations: [\n    new ExpressInstrumentation()\n  ]\n});\n```\n\n### Express Instrumentation Options\n\nExpress instrumentation has few options available to choose from. You can set the following:\n\n| Options | Type  | Description |\n| --- | --- | --- |\n| `requestHook` | `RequestHook` (function) | Hook for adding custom attributes before express start handling the request. Receives params: `span, { moduleVersion, req, res }` |\n| `includeHttpAttributes` | `boolean` | If set to true, plugin will include semantic http attributes in each express span |\n\n## Semantic Behavior\nExpress auto instrumentation will create a single span per request with the following attributes.\nDetailed specification and cases can be found [here](./doc/attributes-specification.MD).\n\n### `http.route`\nThis is a conventional http attribute, which is collected by express instead of the http module (which is not aware of the route). It will always contain path-parameterized data with low cardinality (no ids), but might be missing parts of the path in case of early termination or middlewares that accept any path.\n\nExample: `/api/users/:id`\n\n### `express.route.full`\nThis attribute will always contain the entire path. The part of the path that has been consumed by express will be shown as is (parameterized), and the leftover will be concatenated after (due to early termination or middleware that accept any path).\n\nExample: `/api/users/:id/books/758734` (The `:id` part was consumed, but the `bookid` part was not).\n\n### `express.route.configured`\nThis attribute is relevant when user configures multi path options for the same middleware. It reduces even further the cardinality space compared to `http.route`, and supply more info about how the app routing works.\n\nExample: `/api[\"/foo\", /\"bar\"]` - meaning that the same endpoint is triggered by routes `/api/foo` and `/api/bar`.\n\n### `express.route.params`\nThis attribute holds a json stringified map, where the keys are the url path param names, and the values are the matched params from the actual url.\n\nExample: `{\"id\":\"1234\"}`. \n\n### `express.unhandled`\nSet to true when request was not handled by any middleware in express, and got fallback to the default app `finalhandler`. This can happen if client sent request with invalid path or method (resulting in 404). This can be useful to filter out requests from internet bots which try to call common routes on servers.\n\n### `express.instrumentation.errors`\nIn case of internal error in instrumentation, this attribute will contain the error description. There are no known valid use cases which are expected to produce this attribute.\n\n## Difference from [@opentelemetry/instrumentation-express](https://github.com/open-telemetry/opentelemetry-js-contrib/tree/main/plugins/node/opentelemetry-instrumentation-express)\n\n* This instrumentation is focusing on extracting the most accurate and complete `route` data, in any valid express edge case. Contrib instrumentation does a good job for common cases, but miss nuances on complex setups.\n* This instrumentation create a single span per request. Contrib instrumentation creates span per express Router/Route, which can be useful to observe express internal components, with the cost of more spans in each trace.\n* Set few alternatives for route attribute, each with different level of cardinality vs accuracy.\n* Allows to set `requestHook` for adding custom attributes to span, as well as ability to capture express version into user defined attribute.\n* Distinguish between handled requests (ended from user middleware), and unhandled (terminated from express built in 'finalhandler').\n* Option to conform with the [Semantic conventions for HTTP spans](https://github.com/open-telemetry/opentelemetry-specification/blob/master/specification/trace/semantic_conventions/http.md).\n\n\n---\n\nThis extension (and many others) was developed by [Aspecto](https://www.aspecto.io/) with ❤️","readmeFilename":"README.md","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.0.0-2024-05-16--12-47","_nodeVersion":"18.20.2","_npmVersion":"lerna/8.1.3/node@v18.20.2+x64 (linux)","dist":{"integrity":"sha512-qBs4+yolUlAGahqETiJvJZ2/Ft2INiAA+4F9DiJk+VsBCg2TuBwdF7ns1C00O/Nz0GlAJ35wZah6LU7CuOveBg==","shasum":"6f49623cf1048f0504201ee63d0f32605ff1a84d","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.0.0-2024-05-16--12-47.tgz","fileCount":24,"unpackedSize":97000,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIFusilqEujXehI3BS1tkIaiej+ry9Q7gjKEOJjslsvtSAiEAuBinqj9NQdn7siilrC42UCwXaAzoD9tXeLbLWc5Lsqs="}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.0.0-2024-05-16--12-47_1715863693377_0.3822316094935132"},"_hasShrinkwrap":false},"0.41.0":{"name":"opentelemetry-instrumentation-express","version":"0.41.0","description":"enhanced open telemetry instrumentation for the `express` web framework","author":{"name":"Aspecto.io"},"license":"Apache-2.0","main":"dist/src/index.js","types":"dist/src/index.d.js","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"scripts":{"build":"tsc","prepare":"yarn build","test":"mocha --require @opentelemetry/contrib-test-utils","test:jaeger":"OTEL_EXPORTER_JAEGER_AGENT_HOST=localhost mocha --require @opentelemetry/contrib-test-utils","watch":"tsc -w","version:update":"node ../../scripts/version-update.js","version":"yarn run version:update","test-all-versions":"tav","test:ci":"yarn test-all-versions"},"publishConfig":{"access":"public"},"peerDependencies":{"@opentelemetry/api":"^1.8.0"},"dependencies":{"@opentelemetry/core":"^1.24.1","@opentelemetry/instrumentation":"^0.51.1","@opentelemetry/semantic-conventions":"^1.24.1","parseurl":"~1.3.3","path-to-regexp":"0.1.7"},"devDependencies":{"@opentelemetry/api":"^1.8.0","@opentelemetry/contrib-test-utils":"^0.39.0","@opentelemetry/instrumentation-http":"^0.44.0","@opentelemetry/sdk-trace-base":"^1.24.1","@types/express":"4.17.8","@types/mocha":"^8.2.2","aspecto-opentelemetry-instrumentation-mocha":"0.0.9-alpha.0","axios":"0.21.1","body-parser":"^1.19.0","expect":"^26.6.2","express":"4.17.1","mocha":"^8.4.0","test-all-versions":"^5.0.1","ts-node":"^10.9.2","typescript":"5.4.5"},"mocha":{"extension":["ts"],"spec":"test/**/*.spec.ts","require":["ts-node/register","aspecto-opentelemetry-instrumentation-mocha"]},"gitHead":"6fd75bf4b1355485542c31e4f9322d70af8fe27d","bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","_id":"opentelemetry-instrumentation-express@0.41.0","_nodeVersion":"18.20.2","_npmVersion":"lerna/8.1.3/node@v18.20.2+x64 (linux)","dist":{"integrity":"sha512-Rrku+V+rtgJjlSbsX2JJEVwdOkApLyV6q9rdmm5bF2aW7eN6r0hfZyEnBLAEW0OggIQcKDjZmYQwxaR8ljdmzg==","shasum":"b7897dc6b51ca3d9d406054012b4a29279dc9065","tarball":"https://registry.npmjs.org/opentelemetry-instrumentation-express/-/opentelemetry-instrumentation-express-0.41.0.tgz","fileCount":24,"unpackedSize":96930,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIFXnBz+vqHTvasojvpJN2gWvIC4bDrYquwy1uDSC8jKwAiEAkoI+TNb4WfzWBiM8eMdbVJ8TOUuI8Fg3pphM/3gXBBI="}]},"_npmUser":{"name":"aspecto-release-bot","email":"dev@aspecto.io"},"directories":{},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/opentelemetry-instrumentation-express_0.41.0_1716291582180_0.6220853380742097"},"_hasShrinkwrap":false}},"time":{"created":"2021-05-03T10:42:13.067Z","0.4.1":"2021-05-03T10:42:13.301Z","modified":"2024-05-21T11:39:42.528Z","0.4.2":"2021-05-04T14:24:21.744Z","0.4.3":"2021-05-19T12:00:48.196Z","0.4.4":"2021-05-19T14:17:21.403Z","0.0.0-2021-05-25--13-03":"2021-05-25T13:04:31.514Z","0.0.0-2021-05-26--07-22":"2021-05-26T07:23:06.845Z","0.0.0-2021-05-26--15-12":"2021-05-26T15:13:29.340Z","0.4.5":"2021-05-31T13:40:57.192Z","0.0.0-2021-05-31--14-38":"2021-05-31T14:39:40.750Z","0.4.6":"2021-06-02T11:41:20.799Z","0.0.0-2021-06-07--07-42":"2021-06-07T07:43:35.496Z","0.0.0-2021-06-09--06-50":"2021-06-09T06:50:58.878Z","0.5.0":"2021-06-09T09:12:27.609Z","0.0.0-2021-06-14--13-06":"2021-06-14T13:07:02.757Z","0.5.1":"2021-06-16T09:19:58.341Z","0.0.0-2021-06-17--13-11":"2021-06-17T13:12:10.652Z","0.21.0":"2021-06-20T10:06:14.651Z","0.0.0-2021-06-23--07-47":"2021-06-23T07:48:46.137Z","0.0.0-2021-06-23--08-12":"2021-06-23T08:13:03.032Z","0.0.0-2021-06-23--15-11":"2021-06-23T15:12:30.807Z","0.21.1":"2021-06-27T10:49:42.968Z","0.22.0":"2021-06-28T08:28:38.859Z","0.22.1":"2021-07-04T14:24:50.591Z","0.23.0":"2021-07-05T09:54:52.946Z","0.0.0-2021-08-01--12-54":"2021-08-01T12:55:16.178Z","0.24.0":"2021-08-01T14:16:31.729Z","0.24.1":"2021-09-01T12:38:13.401Z","0.0.0-2021-09-19--10-26":"2021-09-19T10:27:39.815Z","0.25.0":"2021-09-19T12:44:37.622Z","0.0.0-2021-10-20--09-32":"2021-10-20T09:33:07.059Z","0.26.0":"2021-10-26T19:29:43.328Z","0.26.1":"2021-11-29T11:11:49.035Z","0.0.0-2021-12-15--12-47":"2021-12-15T12:48:41.813Z","0.0.0-2021-12-15--13-05":"2021-12-15T13:06:51.970Z","0.0.0-2021-12-15--13-29":"2021-12-15T13:31:04.708Z","0.0.0-2021-12-15--16-17":"2021-12-15T16:18:18.433Z","0.0.0-2021-12-20--13-41":"2021-12-20T13:42:11.680Z","0.0.0-2021-12-21--15-57":"2021-12-21T15:58:31.163Z","0.0.0-2021-12-22--14-33":"2021-12-22T14:36:17.979Z","0.0.0-2021-12-26--12-22":"2021-12-26T12:22:59.507Z","0.0.0-2021-12-26--12-31":"2021-12-26T12:32:49.370Z","0.27.0":"2021-12-27T09:50:54.620Z","0.0.0-2022-04-13--14-32":"2022-04-13T14:32:51.968Z","0.27.1":"2022-04-13T15:40:54.593Z","0.28.0":"2022-06-02T14:38:10.723Z","0.29.0":"2022-06-28T09:38:06.448Z","0.0.0-2022-07-11--08-09":"2022-07-11T08:10:01.287Z","0.32.0":"2022-10-18T10:14:36.123Z","0.34.0":"2022-11-21T11:28:53.653Z","0.35.0":"2023-03-01T08:17:41.108Z","0.0.0-2023-07-26--14-48":"2023-07-26T14:49:04.815Z","0.35.1":"2023-07-27T11:35:02.295Z","0.39.1":"2023-07-27T12:09:27.958Z","0.0.0-2023-10-17--13-06":"2023-10-17T13:07:47.698Z","0.40.0":"2023-10-17T13:27:25.215Z","0.0.0-2024-05-16--12-47":"2024-05-16T12:48:13.617Z","0.41.0":"2024-05-21T11:39:42.376Z"},"maintainers":[{"name":"aspecto-release-bot","email":"dev@aspecto.io"}],"description":"enhanced open telemetry instrumentation for the `express` web framework","homepage":"https://github.com/aspecto-io/opentelemetry-ext-js#readme","repository":{"type":"git","url":"git+https://github.com/aspecto-io/opentelemetry-ext-js.git"},"author":{"name":"Aspecto.io"},"bugs":{"url":"https://github.com/aspecto-io/opentelemetry-ext-js/issues"},"license":"Apache-2.0","readme":"# OpenTelemetry express Instrumentation for Node.js\n[![NPM version](https://img.shields.io/npm/v/opentelemetry-instrumentation-express.svg)](https://www.npmjs.com/package/opentelemetry-instrumentation-express)\n\nThis module provide enhanced instrumentation for the `express` web framework.\n\n## Installation\n\n```\nnpm install --save opentelemetry-instrumentation-express\n```\n## Supported Versions\nThis instrumentation supports `^4.9.0`:\n\nall versions >= `4.9.0` (released 2014) and < `5.0.0` (in alpha).\n\n## Usage\nFor further automatic instrumentation instruction see the [@opentelemetry/instrumentation](https://github.com/open-telemetry/opentelemetry-js/tree/main/packages/opentelemetry-instrumentation) package.\n\n```js\nconst { NodeTracerProvider } = require('@opentelemetry/sdk-trace-node');\nconst { registerInstrumentations } = require('@opentelemetry/instrumentation');\nconst { ExpressInstrumentation } = require('opentelemetry-instrumentation-express');\n\nconst tracerProvider = new NodeTracerProvider();\ntracerProvider.register();\n\nregisterInstrumentations({\n  tracerProvider,\n  instrumentations: [\n    new ExpressInstrumentation()\n  ]\n});\n```\n\n### Express Instrumentation Options\n\nExpress instrumentation has few options available to choose from. You can set the following:\n\n| Options | Type  | Description |\n| --- | --- | --- |\n| `requestHook` | `RequestHook` (function) | Hook for adding custom attributes before express start handling the request. Receives params: `span, { moduleVersion, req, res }` |\n| `includeHttpAttributes` | `boolean` | If set to true, plugin will include semantic http attributes in each express span |\n\n## Semantic Behavior\nExpress auto instrumentation will create a single span per request with the following attributes.\nDetailed specification and cases can be found [here](./doc/attributes-specification.MD).\n\n### `http.route`\nThis is a conventional http attribute, which is collected by express instead of the http module (which is not aware of the route). It will always contain path-parameterized data with low cardinality (no ids), but might be missing parts of the path in case of early termination or middlewares that accept any path.\n\nExample: `/api/users/:id`\n\n### `express.route.full`\nThis attribute will always contain the entire path. The part of the path that has been consumed by express will be shown as is (parameterized), and the leftover will be concatenated after (due to early termination or middleware that accept any path).\n\nExample: `/api/users/:id/books/758734` (The `:id` part was consumed, but the `bookid` part was not).\n\n### `express.route.configured`\nThis attribute is relevant when user configures multi path options for the same middleware. It reduces even further the cardinality space compared to `http.route`, and supply more info about how the app routing works.\n\nExample: `/api[\"/foo\", /\"bar\"]` - meaning that the same endpoint is triggered by routes `/api/foo` and `/api/bar`.\n\n### `express.route.params`\nThis attribute holds a json stringified map, where the keys are the url path param names, and the values are the matched params from the actual url.\n\nExample: `{\"id\":\"1234\"}`. \n\n### `express.unhandled`\nSet to true when request was not handled by any middleware in express, and got fallback to the default app `finalhandler`. This can happen if client sent request with invalid path or method (resulting in 404). This can be useful to filter out requests from internet bots which try to call common routes on servers.\n\n### `express.instrumentation.errors`\nIn case of internal error in instrumentation, this attribute will contain the error description. There are no known valid use cases which are expected to produce this attribute.\n\n## Difference from [@opentelemetry/instrumentation-express](https://github.com/open-telemetry/opentelemetry-js-contrib/tree/main/plugins/node/opentelemetry-instrumentation-express)\n\n* This instrumentation is focusing on extracting the most accurate and complete `route` data, in any valid express edge case. Contrib instrumentation does a good job for common cases, but miss nuances on complex setups.\n* This instrumentation create a single span per request. Contrib instrumentation creates span per express Router/Route, which can be useful to observe express internal components, with the cost of more spans in each trace.\n* Set few alternatives for route attribute, each with different level of cardinality vs accuracy.\n* Allows to set `requestHook` for adding custom attributes to span, as well as ability to capture express version into user defined attribute.\n* Distinguish between handled requests (ended from user middleware), and unhandled (terminated from express built in 'finalhandler').\n* Option to conform with the [Semantic conventions for HTTP spans](https://github.com/open-telemetry/opentelemetry-specification/blob/master/specification/trace/semantic_conventions/http.md).\n\n\n---\n\nThis extension (and many others) was developed by [Aspecto](https://www.aspecto.io/) with ❤️","readmeFilename":"README.md"}