@instana/azure-container-services/src/index.js

Instana tracing and monitoring for Node.js based Azure Container Services

/*
 * (c) Copyright IBM Corp. 2023
 */

'use strict';

const { esm, nodeJsVersionCheck } = require('@instana/core/src/util');

// As of now, Azure App Service supports Node.js versions 16-lts,18-lts and 20-lts. However, for existing services,
// older Node.js versions might still be supported. You can find more information about configuring Node.js on Azure
// App Service at: https://learn.microsoft.com/en-us/azure/app-service/configure-language-nodejs?pivots=platform-linux

if (nodeJsVersionCheck.isNodeJsTooOld()) {
  // eslint-disable-next-line no-console
  console.error(
    'The package @instana/azure-container-services requires at least Node.js ' +
      `${nodeJsVersionCheck.minimumNodeJsVersion} but this process is running on Node.js ${process.version}. ` +
      'This Azure Container Service will not be monitored by Instana. For more information, see: ' +
      // eslint-disable-next-line max-len
      'https://www.ibm.com/docs/en/instana-observability/current?topic=nodejs-support-information#breaking-changes-in-nodejs-collector-upgrade'
  );
  return;
}

if (esm.hasExperimentalLoaderFlag()) {
  // eslint-disable-next-line no-console
  console.error(
    "Node.js 18.19.0 and later no longer support the '--experimental-loader' flag for ESM. " +
      `Your current version is ${process.version}. To ensure tracing by Instana, ` +
      "please use the '--import' flag instead. For more information, refer to the Instana documentation: " +
      'https://www.ibm.com/docs/en/instana-observability/current?topic=nodejs-collector-installation.'
  );
  return;
}

// This loader worked with '--experimental-loader' in Node.js versions below 18.19.
// TODO: Remove 'esm-loader.mjs' file and this log in the next major release (v6).
if (esm.hasEsmLoaderFile()) {
  // eslint-disable-next-line no-console
  console.error(
    "Importing 'esm-loader.mjs' is not supported and will be removed in next major release. " +
      'This process will not be monitored by Instana. ' +
      "Use 'esm-register.mjs' with '--import' to enable tracing.  For more information, " +
      'refer to the Instana documentation: ' +
      'https://www.ibm.com/docs/en/instana-observability/current?topic=nodejs-collector-installation.'
  );
  return;
}

const { util: coreUtil } = require('@instana/core');
const { environment: environmentUtil, consoleLogger: log } = require('@instana/serverless');

// TODO: we currently call "log.init()" twice. Once here
//       and once in the activate.js. Please merge.
const logger = log.init();
environmentUtil.init({ logger });

const isExcludedFromInstrumentation = coreUtil.excludedFromInstrumentation && coreUtil.excludedFromInstrumentation();

if (!isExcludedFromInstrumentation) {
  environmentUtil.validate();
}

if (!isExcludedFromInstrumentation && environmentUtil.isValid()) {
  module.exports = exports = require('./activate');
} else {
  module.exports = exports = require('./noop');
}