Add Application Release Information

You can set the releaseID to the release name, ID, or version of your application containing the injected JavaScript Agent. When troubleshooting JavaScript errors, this helps map errors to the correct application source code.

There are two methods to specifying the release ID:

  1. Configure the JavaScript Agent
  2. Call the JavaScript Agent API

When a JavaScript error occurs, the JavaScript Agent sends error beacons to the Controller. If you add your application's release information, the agent will send error beacons with the release ID.

Then, when you need to troubleshoot an error, you can upload your application's source map/file, and the Controller UI will highlight the exact line of code that corresponds with that error. In the event that the source map/file name is the same for multiple application releases (i.e. the source map is named my_app_source_map.js for both 4.5.1 and 4.5.5 releases), you should specify the release ID so that error data sent to the Controller also contains the corresponding application release.

Add the Release ID to the JavaScript Agent

Add the release ID as a string to config.releaseID

For example:

<script type='text/javascript' charset='UTF-8'>
(function(config){
config.releaseId = "4.5.4";
})(window['adrum-config'] || (window['adrum-config'] = {}));
</script>
<script src='//cdn.appdynamics.com/adrum/adrum-latest.js' type='text/javascript' charset='UTF-8'></script>

Call the Release ID with the JavaScript API

Call the release ID with setAppReleaseId()

For example:

var setAppReleaseId = function () {
ADRUM.setAppReleaseId("4.5.4");
window.history.pushState("setAppReleaseID");
}