@unito/integration-sdk 5.0.0 → 5.1.1

package/dist/src/handler.js

@@ -103,6 +103,7 @@ export class Handler {
                     filters: res.locals.filters,
                     logger: res.locals.logger,
                     signal: res.locals.signal,
+                    requestMetrics: res.locals.requestMetrics,
                     params: req.params,
                     query: req.query,
                     relations: res.locals.relations,
@@ -124,6 +125,7 @@ export class Handler {
                     body: req.body,
                     logger: res.locals.logger,
                     signal: res.locals.signal,
+                    requestMetrics: res.locals.requestMetrics,
                     params: req.params,
                     query: req.query,
                 });
@@ -164,6 +166,7 @@ export class Handler {
                             body,
                             logger: res.locals.logger,
                             signal: res.locals.signal,
+                            requestMetrics: res.locals.requestMetrics,
                             params: req.params,
                             query: req.query,
                         });
@@ -196,6 +199,7 @@ export class Handler {
                     secrets: res.locals.secrets,
                     logger: res.locals.logger,
                     signal: res.locals.signal,
+                    requestMetrics: res.locals.requestMetrics,
                     params: req.params,
                     query: req.query,
                 });
@@ -216,6 +220,7 @@ export class Handler {
                     body: req.body,
                     logger: res.locals.logger,
                     signal: res.locals.signal,
+                    requestMetrics: res.locals.requestMetrics,
                     params: req.params,
                     query: req.query,
                 });
@@ -234,6 +239,7 @@ export class Handler {
                     secrets: res.locals.secrets,
                     logger: res.locals.logger,
                     signal: res.locals.signal,
+                    requestMetrics: res.locals.requestMetrics,
                     params: req.params,
                     query: req.query,
                 });
@@ -252,6 +258,7 @@ export class Handler {
                     secrets: res.locals.secrets,
                     logger: res.locals.logger,
                     signal: res.locals.signal,
+                    requestMetrics: res.locals.requestMetrics,
                     params: req.params,
                     query: req.query,
                 });
@@ -287,6 +294,7 @@ export class Handler {
                     secrets: res.locals.secrets,
                     logger: res.locals.logger,
                     signal: res.locals.signal,
+                    requestMetrics: res.locals.requestMetrics,
                     params: req.params,
                     query: req.query,
                 });
@@ -302,6 +310,7 @@ export class Handler {
                     secrets: res.locals.secrets,
                     logger: res.locals.logger,
                     signal: res.locals.signal,
+                    requestMetrics: res.locals.requestMetrics,
                     params: req.params,
                     query: req.query,
                     body: req.body,
@@ -318,6 +327,7 @@ export class Handler {
                     secrets: res.locals.secrets,
                     logger: res.locals.logger,
                     signal: res.locals.signal,
+                    requestMetrics: res.locals.requestMetrics,
                     params: req.params,
                     query: req.query,
                     body: req.body,
@@ -339,6 +349,7 @@ export class Handler {
                     body: req.body,
                     logger: res.locals.logger,
                     signal: res.locals.signal,
+                    requestMetrics: res.locals.requestMetrics,
                     params: req.params,
                     query: req.query,
                 });

package/dist/src/index.cjs

@@ -4,6 +4,7 @@ var integrationApi = require('@unito/integration-api');
 var cachette = require('cachette');
 var crypto = require('crypto');
 var util = require('util');
+var tracer = require('dd-trace');
 var express = require('express');
 var busboy = require('busboy');
 var fs = require('fs');
@@ -299,6 +300,51 @@ function create(redisUrl) {
 }
 const Cache = { create };
 
+if (process.env.NODE_ENV === 'production' && process.env.DD_TRACE_ENABLED === 'true') {
+    // List of options available to the tracer: https://datadoghq.dev/dd-trace-js/interfaces/export_.TracerOptions.html
+    const apmConfig = { logInjection: false, profiling: false, sampleRate: 0 };
+    if (process.env.DD_APM_ENABLED == 'true') {
+        apmConfig.logInjection = true;
+        apmConfig.sampleRate = 1;
+    }
+    else {
+        // The "enable tracing" boolean is not exposed as part of the TracerOptions so we
+        // have to do so through env vars. Setting here instead of in services' config
+        // to avoid too many env vars to "flip" when enabling / disabling APM.
+        process.env.DD_TRACING_ENABLED = 'false';
+    }
+    // Profiling is extra $$$ so we're setting it as an "extra" when needed
+    if (process.env.DD_APM_PROFILING_ENABLED == 'true') {
+        apmConfig.profiling = true;
+    }
+    const tags = {};
+    // Using DD_TRACE_AGENT_URL as a hack to know if we're running inside of Kubernetes
+    // since this variable is not needed in Elastic Beanstalk of Lambda
+    if (process.env.DD_TRACE_AGENT_URL) {
+        tags.pod_name = process.env.HOSTNAME;
+    }
+    tracer.init({
+        ...apmConfig, // Conditionally enable APM tracing & profiling
+        runtimeMetrics: true, // Always enable runtime metrics https://docs.datadoghq.com/tracing/metrics/runtime_metrics/nodejs/?tab=environmentvariables
+        tags,
+    }); // initialized in a different file to avoid hoisting.
+}
+/**
+ * WARNING to projects importing this
+ * Even if dd-tracer documents that instrumentation happens at **.init() time**
+ * (see https://docs.datadoghq.com/tracing/trace_collection/automatic_instrumentation/dd_libraries/nodejs/#import-and-initialize-the-tracer ),
+ *   1. dd-tracer has no choice but to do some stuff **at import time**
+ *   2. dd-tracer is not exempt from bugs, like https://github.com/DataDog/dd-trace-js/issues/5211
+ *
+ * So, do not assume that dd-trace is *fully off* by default! Some of it runs!
+ * If you want to entirely disable all of dd-trace (e.g. during unit tests),
+ * then you must set `DD_TRACE_ENABLED=false`
+ *
+ * Q: Why not move the dd-trace import inside the `if DD_TRACE_ENABLED` condition, then?
+ * A: Because the future is ESM, and ESM imports must be static and top-level.
+ */
+const DD_TRACER = tracer;
+
 /**
  * Error class meant to be returned by integrations in case of exceptions. These errors will be caught and handled
  * appropriately. Any other error would result in an unhandled server error accompanied by a 500 status code.
@@ -552,6 +598,7 @@ class Handler {
                     filters: res.locals.filters,
                     logger: res.locals.logger,
                     signal: res.locals.signal,
+                    requestMetrics: res.locals.requestMetrics,
                     params: req.params,
                     query: req.query,
                     relations: res.locals.relations,
@@ -573,6 +620,7 @@ class Handler {
                     body: req.body,
                     logger: res.locals.logger,
                     signal: res.locals.signal,
+                    requestMetrics: res.locals.requestMetrics,
                     params: req.params,
                     query: req.query,
                 });
@@ -613,6 +661,7 @@ class Handler {
                             body,
                             logger: res.locals.logger,
                             signal: res.locals.signal,
+                            requestMetrics: res.locals.requestMetrics,
                             params: req.params,
                             query: req.query,
                         });
@@ -645,6 +694,7 @@ class Handler {
                     secrets: res.locals.secrets,
                     logger: res.locals.logger,
                     signal: res.locals.signal,
+                    requestMetrics: res.locals.requestMetrics,
                     params: req.params,
                     query: req.query,
                 });
@@ -665,6 +715,7 @@ class Handler {
                     body: req.body,
                     logger: res.locals.logger,
                     signal: res.locals.signal,
+                    requestMetrics: res.locals.requestMetrics,
                     params: req.params,
                     query: req.query,
                 });
@@ -683,6 +734,7 @@ class Handler {
                     secrets: res.locals.secrets,
                     logger: res.locals.logger,
                     signal: res.locals.signal,
+                    requestMetrics: res.locals.requestMetrics,
                     params: req.params,
                     query: req.query,
                 });
@@ -701,6 +753,7 @@ class Handler {
                     secrets: res.locals.secrets,
                     logger: res.locals.logger,
                     signal: res.locals.signal,
+                    requestMetrics: res.locals.requestMetrics,
                     params: req.params,
                     query: req.query,
                 });
@@ -736,6 +789,7 @@ class Handler {
                     secrets: res.locals.secrets,
                     logger: res.locals.logger,
                     signal: res.locals.signal,
+                    requestMetrics: res.locals.requestMetrics,
                     params: req.params,
                     query: req.query,
                 });
@@ -751,6 +805,7 @@ class Handler {
                     secrets: res.locals.secrets,
                     logger: res.locals.logger,
                     signal: res.locals.signal,
+                    requestMetrics: res.locals.requestMetrics,
                     params: req.params,
                     query: req.query,
                     body: req.body,
@@ -767,6 +822,7 @@ class Handler {
                     secrets: res.locals.secrets,
                     logger: res.locals.logger,
                     signal: res.locals.signal,
+                    requestMetrics: res.locals.requestMetrics,
                     params: req.params,
                     query: req.query,
                     body: req.body,
@@ -788,6 +844,7 @@ class Handler {
                     body: req.body,
                     logger: res.locals.logger,
                     signal: res.locals.signal,
+                    requestMetrics: res.locals.requestMetrics,
                     params: req.params,
                     query: req.query,
                 });
@@ -887,11 +944,14 @@ function onFinish(req, res, next) {
     res.on('finish', function () {
         const logger = res.locals.logger ?? new Logger();
         const error = res.locals.error;
-        const durationInNs = Number(process.hrtime.bigint() - res.locals.requestStartTime);
+        const endMetrics = res.locals.requestMetrics.endRequest();
+        const durationInNs = Number(endMetrics.durationNs);
         const durationInMs = (durationInNs / 1_000_000) | 0;
         const message = `${req.method} ${req.originalUrl} ${res.statusCode} - ${durationInMs} ms`;
         const metadata = {
             duration: durationInNs,
+            externalApiCount: endMetrics.apiCallCount,
+            externalApiTotalDuration: endMetrics.totalApiDurationNs,
             // Use reserved and standard attributes of Datadog
             // https://app.datadoghq.com/logs/pipelines/standard-attributes
             http: { method: req.method, status_code: res.statusCode, url_details: { path: req.originalUrl } },
@@ -944,8 +1004,42 @@ function injectLogger(req, res, next) {
     next();
 }
 
+/**
+ * Accumulates per-request metrics for Provider API calls.
+ *
+ * Created once per incoming request (in the start middleware), threaded through Context and RequestOptions,
+ * incremented by Provider on each API call, and logged by the finish middleware.
+ */
+class RequestMetrics {
+    _apiCallCount = 0;
+    _totalApiDurationNs = 0;
+    _requestStartTime;
+    constructor() {
+        this._requestStartTime = process.hrtime.bigint();
+    }
+    static startRequest() {
+        return new RequestMetrics();
+    }
+    endRequest() {
+        return {
+            durationNs: process.hrtime.bigint() - this._requestStartTime,
+            apiCallCount: this._apiCallCount,
+            totalApiDurationNs: this._totalApiDurationNs,
+        };
+    }
+    /**
+     * Record a completed API call.
+     * Computes the duration from the given start timestamp, increments the call counter,
+     * and accumulates the duration.
+     */
+    recordExternalApiCall(startTime) {
+        this._apiCallCount++;
+        this._totalApiDurationNs += Number(process.hrtime.bigint() - startTime);
+    }
+}
+
 function start(_, res, next) {
-    res.locals.requestStartTime = process.hrtime.bigint();
+    res.locals.requestMetrics = RequestMetrics.startRequest();
     next();
 }
 
@@ -1014,6 +1108,7 @@ function onHealthCheck(_req, res) {
     res.status(200).json({});
 }
 
+// Must be the very first import so dd-trace instruments all subsequent modules.
 function printErrorMessage(message) {
     console.error();
     console.error(`\x1b[31m Oops! Something went wrong! \x1b[0m`);
@@ -1352,7 +1447,7 @@ class Provider {
                 }
             });
         };
-        return this.rateLimiter ? this.rateLimiter(options, callToProvider) : callToProvider();
+        return this.timedCallToProvider(callToProvider, options);
     }
     /**
      * Performs a POST request to the provider streaming a Readable directly without loading it into memory.
@@ -1462,7 +1557,7 @@ class Provider {
                 }
             });
         };
-        return this.rateLimiter ? this.rateLimiter(options, callToProvider) : callToProvider();
+        return this.timedCallToProvider(callToProvider, options);
     }
     /**
      * Performs a PUT request to the provider.
@@ -1702,7 +1797,7 @@ class Provider {
             }
             return { status: response.status, headers: Object.fromEntries(response.headers.entries()), body };
         };
-        return this.rateLimiter ? this.rateLimiter(options, callToProvider) : callToProvider();
+        return this.timedCallToProvider(callToProvider, options);
     }
     /**
      * Normalizes Node.js IncomingHttpHeaders (which may have undefined or string[] values)
@@ -1713,6 +1808,18 @@ class Provider {
             .filter((entry) => entry[1] !== undefined)
             .map(([key, value]) => [key, Array.isArray(value) ? value.join(',') : value]));
     }
+    async timedCallToProvider(callToProvider, options) {
+        const timedCall = async () => {
+            const start = process.hrtime.bigint();
+            try {
+                return await callToProvider();
+            }
+            finally {
+                options.requestMetrics?.recordExternalApiCall(start);
+            }
+        };
+        return this.rateLimiter ? this.rateLimiter(options, timedCall) : timedCall();
+    }
     handleError(responseStatus, message, options) {
         const customError = this.customErrorHandler?.(responseStatus, message, options);
         return customError ?? buildHttpError(responseStatus, message);
@@ -1770,10 +1877,12 @@ function buildCollectionQueryParams(params) {
 
 exports.Api = integrationApi__namespace;
 exports.Cache = Cache;
+exports.DD_TRACER = DD_TRACER;
 exports.Handler = Handler;
 exports.HttpErrors = httpErrors;
 exports.Integration = Integration;
 exports.NULL_LOGGER = NULL_LOGGER;
 exports.Provider = Provider;
+exports.RequestMetrics = RequestMetrics;
 exports.buildCollectionQueryParams = buildCollectionQueryParams;
 exports.getApplicableFilters = getApplicableFilters;

package/dist/src/index.d.ts

@@ -3,6 +3,7 @@ export { Cache, type CacheInstance } from './resources/cache.js';
 export { default as Integration } from './integration.js';
 export * from './handler.js';
 export { Provider, type Response as ProviderResponse, type RequestOptions as ProviderRequestOptions, type RateLimiter, } from './resources/provider.js';
+export { RequestMetrics } from './resources/requestMetrics.js';
 export type { Secrets } from './middlewares/secrets.js';
 export type { Credentials } from './middlewares/credentials.js';
 export type { Filter } from './middlewares/filters.js';
@@ -10,3 +11,4 @@ export * as HttpErrors from './httpErrors.js';
 export { buildCollectionQueryParams, getApplicableFilters } from './helpers.js';
 export * from './resources/context.js';
 export { type default as Logger, NULL_LOGGER } from './resources/logger.js';
+export { DD_TRACER } from './resources/tracer.js';

package/dist/src/index.js

@@ -4,8 +4,10 @@ export { Cache } from './resources/cache.js';
 export { default as Integration } from './integration.js';
 export * from './handler.js';
 export { Provider, } from './resources/provider.js';
+export { RequestMetrics } from './resources/requestMetrics.js';
 export * as HttpErrors from './httpErrors.js';
 export { buildCollectionQueryParams, getApplicableFilters } from './helpers.js';
 export * from './resources/context.js';
 export { NULL_LOGGER } from './resources/logger.js';
+export { DD_TRACER } from './resources/tracer.js';
 /* c8 ignore stop */

package/dist/src/integration.d.ts

@@ -1,3 +1,4 @@
+import './resources/tracer.js';
 import { HandlersInput } from './handler.js';
 type Options = {
     port?: number;

package/dist/src/integration.js

@@ -1,3 +1,5 @@
+// Must be the very first import so dd-trace instruments all subsequent modules.
+import './resources/tracer.js';
 import express from 'express';
 import { InvalidHandler } from './errors.js';
 import { Handler } from './handler.js';

package/dist/src/middlewares/finish.d.ts

@@ -6,7 +6,6 @@ declare global {
         interface Locals {
             logger: Logger;
             error?: ApiError;
-            requestStartTime: bigint;
         }
     }
 }

package/dist/src/middlewares/finish.js

@@ -3,11 +3,14 @@ function onFinish(req, res, next) {
     res.on('finish', function () {
         const logger = res.locals.logger ?? new Logger();
         const error = res.locals.error;
-        const durationInNs = Number(process.hrtime.bigint() - res.locals.requestStartTime);
+        const endMetrics = res.locals.requestMetrics.endRequest();
+        const durationInNs = Number(endMetrics.durationNs);
         const durationInMs = (durationInNs / 1_000_000) | 0;
         const message = `${req.method} ${req.originalUrl} ${res.statusCode} - ${durationInMs} ms`;
         const metadata = {
             duration: durationInNs,
+            externalApiCount: endMetrics.apiCallCount,
+            externalApiTotalDuration: endMetrics.totalApiDurationNs,
             // Use reserved and standard attributes of Datadog
             // https://app.datadoghq.com/logs/pipelines/standard-attributes
             http: { method: req.method, status_code: res.statusCode, url_details: { path: req.originalUrl } },

package/dist/src/middlewares/start.d.ts

@@ -1,8 +1,9 @@
 import { Request, Response, NextFunction } from 'express';
+import { RequestMetrics } from '../resources/requestMetrics.js';
 declare global {
     namespace Express {
         interface Locals {
-            requestStartTime: bigint;
+            requestMetrics: RequestMetrics;
         }
     }
 }

package/dist/src/middlewares/start.js

@@ -1,5 +1,6 @@
+import { RequestMetrics } from '../resources/requestMetrics.js';
 function start(_, res, next) {
-    res.locals.requestStartTime = process.hrtime.bigint();
+    res.locals.requestMetrics = RequestMetrics.startRequest();
     next();
 }
 export default start;

package/dist/src/resources/context.d.ts

@@ -1,5 +1,6 @@
 import * as API from '@unito/integration-api';
 import Logger from './logger.js';
+import { RequestMetrics } from './requestMetrics.js';
 import { Credentials } from '../middlewares/credentials.js';
 import { Secrets } from '../middlewares/secrets.js';
 import { Filter } from '../middlewares/filters.js';
@@ -40,6 +41,11 @@ export type Context<P extends Maybe<Params> = Maybe<Params>, Q extends Maybe<Que
      * to be timed out. You can use this signal to abort any operation that would exceed this time frame.
      */
     signal: AbortSignal | undefined;
+    /**
+     * Per-request metrics accumulator for Provider API calls.
+     * Automatically populated by the SDK middleware and used by Provider to track call count and duration.
+     */
+    requestMetrics: RequestMetrics | undefined;
     /**
      * The request params.
      *

package/dist/src/resources/provider.d.ts

@@ -3,6 +3,7 @@ import * as stream from 'stream';
 import * as HttpErrors from '../httpErrors.js';
 import { Credentials } from '../middlewares/credentials.js';
 import Logger from '../resources/logger.js';
+import { RequestMetrics } from './requestMetrics.js';
 /**
  * RateLimiter is a wrapper function that you can provide to limit the rate of calls to the provider based on the
  * caller's credentials.
@@ -42,6 +43,7 @@ export type RequestOptions = {
         [key: string]: string;
     };
     rawBody?: boolean;
+    requestMetrics?: RequestMetrics;
 };
 /**
  * Response object returned by the Provider's method.
@@ -226,5 +228,6 @@ export declare class Provider {
      * into a flat Record<string, string> by joining array values and dropping undefined entries.
      */
     private static normalizeNodeHeaders;
+    private timedCallToProvider;
     private handleError;
 }

package/dist/src/resources/provider.js

@@ -181,7 +181,7 @@ export class Provider {
                 }
             });
         };
-        return this.rateLimiter ? this.rateLimiter(options, callToProvider) : callToProvider();
+        return this.timedCallToProvider(callToProvider, options);
     }
     /**
      * Performs a POST request to the provider streaming a Readable directly without loading it into memory.
@@ -291,7 +291,7 @@ export class Provider {
                 }
             });
         };
-        return this.rateLimiter ? this.rateLimiter(options, callToProvider) : callToProvider();
+        return this.timedCallToProvider(callToProvider, options);
     }
     /**
      * Performs a PUT request to the provider.
@@ -531,7 +531,7 @@ export class Provider {
             }
             return { status: response.status, headers: Object.fromEntries(response.headers.entries()), body };
         };
-        return this.rateLimiter ? this.rateLimiter(options, callToProvider) : callToProvider();
+        return this.timedCallToProvider(callToProvider, options);
     }
     /**
      * Normalizes Node.js IncomingHttpHeaders (which may have undefined or string[] values)
@@ -542,6 +542,18 @@ export class Provider {
             .filter((entry) => entry[1] !== undefined)
             .map(([key, value]) => [key, Array.isArray(value) ? value.join(',') : value]));
     }
+    async timedCallToProvider(callToProvider, options) {
+        const timedCall = async () => {
+            const start = process.hrtime.bigint();
+            try {
+                return await callToProvider();
+            }
+            finally {
+                options.requestMetrics?.recordExternalApiCall(start);
+            }
+        };
+        return this.rateLimiter ? this.rateLimiter(options, timedCall) : timedCall();
+    }
     handleError(responseStatus, message, options) {
         const customError = this.customErrorHandler?.(responseStatus, message, options);
         return customError ?? buildHttpError(responseStatus, message);

package/dist/src/resources/requestMetrics.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Accumulates per-request metrics for Provider API calls.
+ *
+ * Created once per incoming request (in the start middleware), threaded through Context and RequestOptions,
+ * incremented by Provider on each API call, and logged by the finish middleware.
+ */
+export declare class RequestMetrics {
+    private _apiCallCount;
+    private _totalApiDurationNs;
+    private _requestStartTime;
+    private constructor();
+    static startRequest(): RequestMetrics;
+    endRequest(): {
+        durationNs: bigint;
+        apiCallCount: number;
+        totalApiDurationNs: number;
+    };
+    /**
+     * Record a completed API call.
+     * Computes the duration from the given start timestamp, increments the call counter,
+     * and accumulates the duration.
+     */
+    recordExternalApiCall(startTime: bigint): void;
+}

package/dist/src/resources/requestMetrics.js

@@ -0,0 +1,33 @@
+/**
+ * Accumulates per-request metrics for Provider API calls.
+ *
+ * Created once per incoming request (in the start middleware), threaded through Context and RequestOptions,
+ * incremented by Provider on each API call, and logged by the finish middleware.
+ */
+export class RequestMetrics {
+    _apiCallCount = 0;
+    _totalApiDurationNs = 0;
+    _requestStartTime;
+    constructor() {
+        this._requestStartTime = process.hrtime.bigint();
+    }
+    static startRequest() {
+        return new RequestMetrics();
+    }
+    endRequest() {
+        return {
+            durationNs: process.hrtime.bigint() - this._requestStartTime,
+            apiCallCount: this._apiCallCount,
+            totalApiDurationNs: this._totalApiDurationNs,
+        };
+    }
+    /**
+     * Record a completed API call.
+     * Computes the duration from the given start timestamp, increments the call counter,
+     * and accumulates the duration.
+     */
+    recordExternalApiCall(startTime) {
+        this._apiCallCount++;
+        this._totalApiDurationNs += Number(process.hrtime.bigint() - startTime);
+    }
+}

package/dist/src/resources/tracer.d.ts

@@ -0,0 +1,16 @@
+import tracer from 'dd-trace';
+/**
+ * WARNING to projects importing this
+ * Even if dd-tracer documents that instrumentation happens at **.init() time**
+ * (see https://docs.datadoghq.com/tracing/trace_collection/automatic_instrumentation/dd_libraries/nodejs/#import-and-initialize-the-tracer ),
+ *   1. dd-tracer has no choice but to do some stuff **at import time**
+ *   2. dd-tracer is not exempt from bugs, like https://github.com/DataDog/dd-trace-js/issues/5211
+ *
+ * So, do not assume that dd-trace is *fully off* by default! Some of it runs!
+ * If you want to entirely disable all of dd-trace (e.g. during unit tests),
+ * then you must set `DD_TRACE_ENABLED=false`
+ *
+ * Q: Why not move the dd-trace import inside the `if DD_TRACE_ENABLED` condition, then?
+ * A: Because the future is ESM, and ESM imports must be static and top-level.
+ */
+export declare const DD_TRACER: tracer.Tracer;

package/dist/src/resources/tracer.js

@@ -0,0 +1,45 @@
+import tracer from 'dd-trace';
+if (process.env.NODE_ENV === 'production' && process.env.DD_TRACE_ENABLED === 'true') {
+    // List of options available to the tracer: https://datadoghq.dev/dd-trace-js/interfaces/export_.TracerOptions.html
+    const apmConfig = { logInjection: false, profiling: false, sampleRate: 0 };
+    if (process.env.DD_APM_ENABLED == 'true') {
+        apmConfig.logInjection = true;
+        apmConfig.sampleRate = 1;
+    }
+    else {
+        // The "enable tracing" boolean is not exposed as part of the TracerOptions so we
+        // have to do so through env vars. Setting here instead of in services' config
+        // to avoid too many env vars to "flip" when enabling / disabling APM.
+        process.env.DD_TRACING_ENABLED = 'false';
+    }
+    // Profiling is extra $$$ so we're setting it as an "extra" when needed
+    if (process.env.DD_APM_PROFILING_ENABLED == 'true') {
+        apmConfig.profiling = true;
+    }
+    const tags = {};
+    // Using DD_TRACE_AGENT_URL as a hack to know if we're running inside of Kubernetes
+    // since this variable is not needed in Elastic Beanstalk of Lambda
+    if (process.env.DD_TRACE_AGENT_URL) {
+        tags.pod_name = process.env.HOSTNAME;
+    }
+    tracer.init({
+        ...apmConfig, // Conditionally enable APM tracing & profiling
+        runtimeMetrics: true, // Always enable runtime metrics https://docs.datadoghq.com/tracing/metrics/runtime_metrics/nodejs/?tab=environmentvariables
+        tags,
+    }); // initialized in a different file to avoid hoisting.
+}
+/**
+ * WARNING to projects importing this
+ * Even if dd-tracer documents that instrumentation happens at **.init() time**
+ * (see https://docs.datadoghq.com/tracing/trace_collection/automatic_instrumentation/dd_libraries/nodejs/#import-and-initialize-the-tracer ),
+ *   1. dd-tracer has no choice but to do some stuff **at import time**
+ *   2. dd-tracer is not exempt from bugs, like https://github.com/DataDog/dd-trace-js/issues/5211
+ *
+ * So, do not assume that dd-trace is *fully off* by default! Some of it runs!
+ * If you want to entirely disable all of dd-trace (e.g. during unit tests),
+ * then you must set `DD_TRACE_ENABLED=false`
+ *
+ * Q: Why not move the dd-trace import inside the `if DD_TRACE_ENABLED` condition, then?
+ * A: Because the future is ESM, and ESM imports must be static and top-level.
+ */
+export const DD_TRACER = tracer;