NodeJS
Code Execution Monitoring for NodeJS applications.
Install
Install the latest version using the npm command below:
1
npm install @inspector-apm/inspector-nodejs --save
Copied!
Configure the Ingestion Key
You need an Ingestion Key to create an Inspector instance.
You can obtain a key creating a new project in your Inspector dashboard.
If you use
dotenv you can configure the Inspector Ingestion Key in your environment file:1
INSPECTOR_INGESTION_KEY=[ingestion key]
Copied!
Initialization
It’s important that Inspector is started before you require any other modules in your NodeJS application - i.e. before,
http, mysql, etc. This means that you should probably require Inspector in your application’s main file (usually
index.js, server.js or app.js).Here’s a code example of how Inspector is normally initialized in a NodeJS script:
1
/* -------------------------------------------
2
* Initialize Inspector with the Ingestion Key.
3
--------------------------------------------- */
4
const inspector = require('@inspector-apm/inspector-nodejs')({
5
ingestionKey: 'xxxxxxxxxxxxx'
6
})
Copied!
HTTP Request Monitoring
Inspector wrap incoming http requests in an entity called "Transaction". To create a real picture of what happen in your application during an http request you should start the transaction as soon as possible in the web server.
Take a look on the example below where a custom web server use patterns to route requests to handlers.
1
/* -------------------------------------------
2
* Initialize Inspector with the Ingestion Key.
3
--------------------------------------------- */
4
const inspector = require('@inspector-apm/inspector-nodejs')({
5
ingestionKey: 'xxxxxxxxxxxxx682eedcce097b64b'
6
})
7
​
8
var http = require('http')
9
var patterns = require('patterns')()
10
​
11
// Setup routes and their respective route handlers
12
patterns.add('GET /posts/{id}', require('./routes/posts').show)
13
​
14
// Start web server
15
http.createServer(function (req, res) {
16
// Check if we have a route matching the incoming request
17
var match = patterns.match(req.method + ' ' + req.url);
18
​
19
// If no match is found, respond with a 404. Elastic APM will in
20
// this case use the default transaction name "unknown route"
21
if (!match) {
22
res.writeHead(404)
23
res.end()
24
return
25
}
26
​
27
// The patterns module exposes the pattern used to match the
28
// request on the `pattern` property, e.g. `GET /posts/{id}`
29
inspector.startTransaction(match.pattern)
30
​
31
req.params = match.params
32
match.value(req, res)
33
}).listen(3000)
Copied!
If the transaction is sterted correctly, Inspector will automatically monitor all other task based on supported modules like
mysql2, pg, mongodb, etc.If you are using Express framework, transactions are automatically labeled based on the names of your routes. You should follow the specific express documentation.
Instrument a CLI script
A NodeJS application that run by the command line can start the transaction immediately after initialization:
1
/*
2
* Initialize Inspector with the Ingestion Key.
3
*/
4
const inspector = require('@inspector-apm/inspector-nodejs')({
5
ingestionKey: 'xxxxxxxxxxxxx682eedcce097b64b'
6
})
7
​
8
/*
9
* Immediately start the transaction.
10
*/
11
inspector.startTransaction(__filename)
12
​
13
// Continue with rest of the application...
Copied!
Custom Segments
By default Inspector will report many different tasks based on the application's dependencies, but you are free to "wrap" some parts of your code that you consider relevant to create a more complete picture of what statements are executed during an execution cycle and its performance.
Last modified 9mo ago