@commercetools/ts-sdk-apm

_commercetools Typescript SDK Application Performance Monitoring._

This package is used to monitor the application performance of the Typescript SDK. It exposes a middleware creator method that accepts some options for monitoring and tracing the SDK performance.

Installation

To use this package we need to install the package and add the newrelic configuration file.

Using npm

``bash
$ npm install @commercetools/ts-sdk-apm
`

or using yarn

`bash
$ yarn add @commercetools/ts-sdk-apm
`

Usage

Import the package and add it to the SDK client using withTelemetryMiddleware() method.

`typescript
// import the @commercetools/ts-sdk-apm package
import { ClientBuilder } from '@commercetools/ts-client'
import { createTelemetryMiddleware } from '@commercetools/ts-sdk-apm'

// newrelic options
const telemetryOptions = {
createTelemetryMiddleware
}

// create the client and include the telemetry middleware
const client = new ClientBuilder()
.withClientCredentialsFlow(...)
.withHttpMiddleware(...)
.withTelemetryMiddleware(telemetryOptions) // telemetry middleware
...
.build()
...

`

Using a custom (user-defined options)

All monitoring and tracing functionality are implemented by default.
The telemetryOptions accepts four configuration options: createTelemetryMiddleware, apm, tracer and customMetrics. The createTelemetryMiddleware and tracer parameters can be custom-implemented.
Additionally, customMetrics can be included to record custom metrics based on available APM. For example, if we want to record and send custom metrics to Newrelic, we can set the newrelic field to true in the customMetrics configuration option same goes for datadog. For collecting custom metrics only Newrelic and Datadog are currently supported.

`typescript
type telemetryOptions = {
createTelemetryMiddleware: (options: Omit) => Middleware,
apm?: () => typeof require('newrelic'),
tracer?: () => typeof require('/absolute-path-to-a-tracer(opentelemetry)-module'),
customMetrics?: {
newrelic?: true;
datadog?: false; // it can be omitted
}
}
`

Example

`typescript
const telemetryOptions = {
createTelemetryMiddleware, // coming from the @commercetools/ts-sdk-apm or a custom implementation
tracer: () =>
require(
require('path').join(__dirname, '..', '..', 'custom-telemetry-module.js')
), // make sure the require takes in an absolute path to the custom tracer module.
customMetrics: {
datadog: true,
},
}
``

The tracer is responsible for tracing http` calls right from the resource request call to the external commercetools backend service and everything that goes on in-between.