Manual Node.js Tracing

import { H } from '@highlight-run/node'

H.init({
	projectID: '<YOUR_PROJECT_ID>',
	serviceName: '<YOUR_SERVICE_NAME>',
	environment: 'production',
})

Wrap your code using the Node.js SDK.

By wrapping your code with startSpan and endSpan, the @highlight-run/node SDK will record a span. You can create more child spans or add custom attributes to each span.


const functionToTrace = async (input int) => {
	const span = await H.startActiveSpan("functionToTrace", {custom_property: input})
	// ...
	anotherFunction()
	// ...
	span.end()
}

const anotherFunction = () => {
	const span = H.startActiveSpan("anotherFunction", {})

	// ...
	span.end()
}

module.exports = function() {
    console.log('hey there!');
    functionToTrace()
}

Pass HTTP headers to the SDK

H.runWithHeaders takes request headers and spreads them across all related spans, automatically relating spans to your session and request headers.


app.get('/', async (req, res) => {
	await H.runWithHeaders(req.headers, () => {
		const span = H.startActiveSpan("custom-span", {})
		const err = new Error('this is a test error')
		
		console.info('Sending error to highlight')
		H.consumeError(err)

		res.send('Hello World!')
		span.end()
	})
})

Verify your backend traces are being recorded.

Visit the highlight traces portal and check that backend traces are coming in.

Tracing in Node.js Next.js