appdynamics 22.7.0 → 22.11.0

package/README.md

@@ -6,14 +6,17 @@ You can monitor your Node.js applications in production with the AppDynamics Nod
 Performance issues can result in a slow or unavailable website. The Node.js Agent uses process-level visibility and proactive monitoring to reveal the internal workings of your application and infrastructure with policies, troubleshooting, and performance/capacity optimization. You can use process snapshots to examine your code execution at the multi-process level and identify the root cause of slow performance in minutes.
 
 For supported Node.js versions, operating systems, and backends, see [Node.js Supported Environments](https://docs.appdynamics.com/display/PRO21/Node.js+Supported+Environments).
-
+   
+   
+     
 Before You Begin
 --
 To start the Node.js Agent, complete the following:
 
 - Obtain an AppDynamics account with a running Controller. 
 - To sign up for a 15-day free trial, see [AppDynamics Free Trial](https://www.appdynamics.com/free-trial/). You should receive an email with your Controller host and port.
-
+      
+      
 Install the Node.js Agent
 --
 AppDynamics recommends that you update the Node.js Agent with every SaaS Controller release. To ensure that your agent contains the latest functionality and fixes, regularly update to a major Node.js Agent version.
@@ -56,4 +59,128 @@ require('appdynamics').profile({
 
 For more information, see [Install the Node.js Agent](https://docs.appdynamics.com/display/PRO21/Install+the+Node.js+Agent) and [Application Monitoring](https://docs.appdynamics.com/display/PRO21/Application+Monitoring).
 
+<br />
+<br />
+
+
+Developer Guide
+--
+<br />
+
+### How to setup project locally
+
+&emsp;Make sure you have stable node version installed ** 12 <= node <= 18 ** 
+&emsp;are current supported versions. 
+
+&emsp;We recommend using 16 or above. 
+
+```sh
+cd agent-dlnative/nodejs
+npm install
+```
+
+<br />
+
+#### Build project
+
+&emsp;We currently build the nodejs project with gradle. For more help https://docs.gradle.org/current/userguide/command_line_interface.html
+
+&emsp;The root gradle file will be one level up i.e in root of agent-dlnative project. 
+&emsp;The **nodejs build.gradle** file has all the task definitions and build logic.
+
+```sh
+../gradlew dev 
+```
+The above will build the project with local node version.
+
+```sh
+../gradlew 
+```
+To run build with configured node version in build.gradle   
+<br />
+
+#### To run agent unit tests
+```sh
+../gradlew unittests_agent --info -Dnodejs.build.debug=true -Dnodejs.coverage.enabled=false
+```
+The above is an example to run unit tests for agent with coverage disabled
+
+More example options for task are : ** unittests, integrationtests_agent, eslint **
+
+Checkout more options : **/nodejs/build.gradle**  
+
+<br />
+
+#### To create standalone build
+
+```sh
+../gradlew :nodejs:createStandAloneAgentForNodeVersion or ../gradlew createStandAloneAgentForNodeVersion
+```
+
+Other options are : **createMasterTarNpmScript, testStandalonePackage**
+
+
+<br />    
+
+#### Where are these build settings / logic
+
+&emsp;The logic to create packages and supported node versions are in **nodejs/buildScripts/src** folder.
+
+&emsp;Check package.json to see what npm-scripts are available. 
+
+&emsp;You can individually run them as a npm command `npm run-script &standAloneAgent`
+
+<br />
+
+#### How to test applications with local changes in a test application
+
+&emsp;Create an npm application 
+&emsp;Install appdynamics pointing to your local build
+```sh
+npm install appdynamics {path_to_your_local_build_folder}/appdynamics
+```
+
+&emsp;Require appdynamics as demonstrated on top section of the readme
+&emsp;example 
+
+```sh
+appd.profile({
+  accountName: 'e2e-customer',
+  accountAccessKey: 'e10aa1c5-29be-474b-bb51-ab0c56eea5e8',
+  controllerHostName: 'master-saas-controller.e2e.appd-test.com',
+  controllerPort: 8090,
+  applicationName: 'upstream-test',
+  tierName: 'enabled',
+  openTelemetry: {
+    enabled: true,
+  },
+  nodeName: 'node__gql',
+  enableGraphQL: true,
+  libagent: true,
+  debug: true,
+});
+```
+
+&emsp; 1. Run your application and make requests  
+&emsp; 2. Go to controller ui - example : https://master-saas-controller.e2e.appd-test.com    
+&emsp; 3. Search for your application - example: upstream-test  
+
+<br />
+
+### Frequently asked questions
+
+1. My Application doesn't show up in the controller  
+&emsp;You probably have to update the access key.
+
+2. My integration tests throw "not able to find a module" running locally   
+&emsp;Go to your integration test folder - find package.json and run npm install there
+<br />
+
+### How do I setup libagent locally    
+&emsp; https://confluence.corp.appdynamics.com/pages/viewpage.action?spaceKey=AMC&title=NodeJS+Agent+with+Local+Libagent      
+
+<br />
+<br />
+<br />
+
 Copyright (c) AppDynamics, Inc. 2021 CA. All rights reserved.

package/appdynamics_version.json

@@ -1,7 +1,7 @@
 {
-    "version": "22.7.0.0",
+    "version": "22.11.0.0",
     "sha": "",
     "nodeVersion": "",
-    "buildName": "8783",
+    "buildName": "8997",
     "compatibilityVersion": "4.4.1.0"
 }

package/lib/core/agent.js

@@ -158,9 +158,9 @@ Agent.computeTmpDir = function (rootTmpDir,
     nodeName.toString();
   // We don't need cryptographic security here,
   // just a unique, predictable fixed length directory name.
-  var md5 = crypto.createHash('md5');
-  md5.update(stringToHash);
-  return path.join(rootTmpDir, md5.digest('hex'));
+  var sha256 = crypto.createHash('sha256');
+  sha256.update(stringToHash);
+  return path.join(rootTmpDir, sha256.digest('hex').slice(0, 32));
 };
 
 /* istanbul ignore next -- requires too much stubbing and mocking to unit test */

package/lib/core/opentelemetry-tracer.js

@@ -13,6 +13,7 @@ const url = require('url');
 
 module.exports = TracerProvider;
 
+
 function TracerProvider(logger) {
   this.host = 'localhost';
   this.port = '4318';
@@ -38,7 +39,8 @@ TracerProvider.prototype.register = function(config) {
     }),
     resource: new Resource({
       [SemanticResourceAttributes.SERVICE_NAME]: config.tierName,
-      [SemanticResourceAttributes.SERVICE_NAMESPACE]: config.applicationName
+      [SemanticResourceAttributes.SERVICE_NAMESPACE]: config.applicationName,
+      [SemanticResourceAttributes.CONTAINER_ID]: ""
     }),
   });
 
@@ -99,3 +101,9 @@ TracerProvider.prototype.register = function(config) {
 TracerProvider.prototype.getTracer = function(name) {
   return opentelemetry_api.trace.getTracer(name);
 };
+
+TracerProvider.prototype.updateResourceAttributes = function(attrs) {
+  for(let [key, value] of Object.entries(attrs)) {
+    this.getTracer().resource.attributes[key] = value;
+  }
+};

package/lib/libagent/libagent-connector.js

@@ -107,6 +107,8 @@ LibagentConnector.prototype.init = function () {
   self.manualProcessSnapshotInProgress = false;
 
   self.libagent.init(self.agent);
+  self.agent.TracerProvider && self.agent.TracerProvider.updateResourceAttributes({ "container.id": self.getContainerId() });
+
   self.exceptionHandlers = new ExceptionHandlers();
   self.exceptionHandlers.init(
     self.agent,
@@ -596,3 +598,8 @@ LibagentConnector.prototype.setupEum = function (agent) {
     return true;
   };
 };
+
+LibagentConnector.prototype.getContainerId = function () {
+  var self = this;
+  return self.libagent.getContainerId();
+};

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "appdynamics",
-    "version": "22.7.0",
+    "version": "22.11.0",
     "description": "Performance Profiler and Monitor",
     "author": "AppDynamics, Inc.",
     "homepage": "https://www.appdynamics.com",
@@ -45,12 +45,13 @@
         "https-proxy-agent": "^5.0.0",
         "uuid": "^8.3.2",
         "y18n": "^5.0.8",
-        "appdynamics-libagent-napi": "https://cdn.appdynamics.com/packages/nodejs/22.7.0.0/appdynamics-libagent-napi-node.tgz",
-        "appdynamics-native": "https://cdn.appdynamics.com/packages/nodejs/22.7.0.0/appdynamics-native-node.tgz",
-        "appdynamics-protobuf": "https://cdn.appdynamics.com/packages/nodejs/22.7.0.0/appdynamics-protobuf-node.tgz"
+        "appdynamics-libagent-napi": "https://cdn.appdynamics.com/packages/nodejs/22.11.0.0/appdynamics-libagent-napi-node.tgz",
+        "appdynamics-native": "https://cdn.appdynamics.com/packages/nodejs/22.11.0.0/appdynamics-native-node.tgz",
+        "appdynamics-protobuf": "https://cdn.appdynamics.com/packages/nodejs/22.11.0.0/appdynamics-protobuf-node.tgz"
     },
     "engines": {
-        "node": ">=12 <=v16.*"
+        "node": ">=12 <=v18.*"
     },
-    "engine-strict": true
+    "engine-strict": true,
+    "bundleDependencies": []
 }

package/packageBck.json

@@ -1,6 +1,6 @@
 {
     "name": "appdynamics",
-    "version": "22.7.0",
+    "version": "22.11.0",
     "description": "Performance Profiler and Monitor",
     "author": "AppDynamics, Inc.",
     "homepage": "https://www.appdynamics.com",
@@ -45,12 +45,13 @@
         "https-proxy-agent": "^5.0.0",
         "uuid": "^8.3.2",
         "y18n": "^5.0.8",
-        "appdynamics-libagent-napi": "https://cdn.appdynamics.com/packages/nodejs/22.7.0.0/appdynamics-libagent-napi-node.tgz",
-        "appdynamics-native": "https://cdn.appdynamics.com/packages/nodejs/22.7.0.0/appdynamics-native-node.tgz",
-        "appdynamics-protobuf": "https://cdn.appdynamics.com/packages/nodejs/22.7.0.0/appdynamics-protobuf-node.tgz"
+        "appdynamics-libagent-napi": "https://cdn.appdynamics.com/packages/nodejs/22.11.0.0/appdynamics-libagent-napi-node.tgz",
+        "appdynamics-native": "https://cdn.appdynamics.com/packages/nodejs/22.11.0.0/appdynamics-native-node.tgz",
+        "appdynamics-protobuf": "https://cdn.appdynamics.com/packages/nodejs/22.11.0.0/appdynamics-protobuf-node.tgz"
     },
     "engines": {
-        "node": ">=12 <=v16.*"
+        "node": ">=12 <=v18.*"
     },
-    "engine-strict": true
+    "engine-strict": true,
+    "bundleDependencies": []
 }