Dynatrace is a LINK Certified Technology Partner of Salesforce Commerce Cloud (SCC), a cloud-based ecommerce solution. The LINK Cartridge allows SCC customers to deploy Dynatrace UEM (User Experience Management) leveraging CORS (Cross Origin Resource Sharing) technology.

Click here to view the Dynatrace page on the Salesforce Commerce Cloud Marketplace

The instructions below are broken into 3 sections.

  • Section one covers setting UEM up for CORS operation in the dynatrace server
  • Section two is tailored to experienced SCC customers and covers how to integrate the Dynatrace LINK Cartridge
  • Section three provides very detailed instructions for integrating the Dynatrace LINK Cartridge and is meant for use by either a much new SCC customer or a Dynatrace representative with little or no experience with SCC configuration.

  

Watch the Performance Clinic below to see how the integration works and witness the fastpack in action

   

Please log in to view this content

 

 

Obtain a Dynatrace instance:

We strongly recommend downloading the Dynatrace Salesforce Commerce Cloud Fastpack. It comes pre-configured for a Salesforce Commerce cloud (SCC) environment and includes several SCC oriented performance dashboards.

Cartridge integration for Dynatrace AppMon 6.5:

 

The easiest way to integrate Dynatrace is to use the pre-built cartridge. Download it from this page on xchange.demandware.com by clicking on the Latest Release link. 

  • Created or use an existing SiteGenesis sandbox storefront, or use your own storefront.
  • Open eclipse and install Demandware UX Studio if it’s not already installed
    • Import the cartridge into your project.
    • Open the dynatrace_uem.isml file in the int_dynatrace cartridge located in folder cartridge ->templates ->default
      • After the closing </iscomment> tag, insert the initcode obtained via the RestAPI as described in section 3.2 for Dynatrace AppMon 6.5.
        • Make sure the following code excerpt is in the initcode. This ensures the JavaScript will download asynchronously.  If it is not present, this indicates setup in section 3.2 was not completed properly. This step is very important as the async setting is what prevents the agent script download from blocking page operation should the external apache instance become unavailable.
          async=1
        • Save your changes
  • Open your existing storefront cartridge to add an include tag to a universal component that will render the script tag at the page. In SiteGenesis, this may be either htmlhead.isml or modules.isml, depending on the build.
    • htmlhead.isml
      • Add an include tag to the templates – default – components - header – htmlhead.isml template in the storefront cartridge, placing this line at the top. The dtagent JS file should be the first JavaScript file processed by the page.
      • <isinclude template="/dynatrace_uem"/>
      • modules.isml
        • Add an include tag to the templates – default – util - modules.isml template in the storefront cartridge, placing this line at the top. The dtagent JS file should be the first JavaScript file processed by the page.
        • <isinclude template="/dynatrace_uem"/>
  • Open the Business Manager and go to Manage Sites in the Administration section
    • Select the site you are adding UEM to and switch to Settings.
    • Append the following cartridge to the end of the Cartridges Path:
      • :int_dynatrace
      • Be sure to include the colon as a separator.
  • Confirm UEM functionality by exercising the storefront site and checking for activity in the Dynatrace client

 

Testing details are below, but a quick check can be completed by viewing the source of your storefront homepage. Search for dtagent in the page source.  This will confirm that the cartridge integration is complete.  

With Dynatrace AppMon 6.5, you can now make changes in the UEM settings in the Dynatrace Client and those settings will be dynamically updated in the agent script. For any permanent changes, however, we still recommend updating the injected initcode when time allows.

 

Cartridge integration for Dynatrace AppMon 6.3

The easiest way to integrate Dynatrace is to use the pre-built cartridge. Download it from this page on xchange.demandware.com by clicking on the Latest Release link. 

  • Created or use an existing SiteGenesis sandbox storefront, or use your own storefront.
  • Open eclipse and install Demandware UX Studio if it’s not already installed
    • Import the cartridge into your project.
    • Import the .js file that was generated in Section 3.2 Configuration: JavaScript Tag and JavaScript File, to int_dynatrace cartridge folder cartridge ->static ->default- >js .
    • Open the dynatrace_uem.isml file in the int_dynatrace cartridge located in folder cartridge ->templates ->default
      • After the closing </iscomment> tag, place the JavaScript tag copied from the Dynatrace Client as described in Section 3.2 Configuration: JavaScript Tag and JavaScript File. 
      • Modify the JavaScript as follows:
        • Change the src= path between the = sign and the actual .js file name to the path where other Demandware hosted JS files are.  You can determine this path by looking at the page source of an existing page.  This is also documented in the dynatrace_uem.isml file.
        • Example: 
          • The default path from the dynatrace client may look something like this: src="//example.domain.com/dtagent634_23ehjlpqrsx_1034.js"
          • Using the Demandware SiteGenesis demo store as an example, the path should be changed to something like: src="/on/demandware.static/Sites-SiteGenesis-Site/-/en_US/v1437664607356/js/dtagent634_23ehjlpqrsx_1034.js"
    • If using bootstrap in a non-production, non-critical environment instead, use the following tag, changing ‘example.domain.com’ for the domain where the Dynatrace apache web server agent is installed. This is also documented in the dynatrace_uem.isml file.
      • <script type="text/javascript" src='//example.domain.com/dtagent_bootstrap.js'></script>
      • When using bootstrap, there is no file to import into the cartridge as it gets served from an independent Apache instance.
    • Open your existing storefront cartridge to add an include tag to a universal component that will render the script tag at the page. In SiteGenesis, this may be either htmlhead.isml or modules.isml, depending on the build.
      • htmlhead.isml
        • Add an include tag to the templates – default – components - header – htmlhead.isml template in the storefront cartridge, placing this line at the top. The dtagent JS file should be the first JavaScript file processed by the page.
        • <isinclude template="/dynatrace_uem"/>
      • modules.isml
        • Add an include tag to the templates – default – util - modules.isml template in the storefront cartridge, placing this line at the top. The dtagent JS file should be the first JavaScript file processed by the page.
        • <isinclude template="/dynatrace_uem"/>
  • Open the Business Manager and go to Manage Sites in the Administration section
    • Select the site you are adding UEM to and switch to Settings.
    • Append the following cartridge to the end of the Cartridges Path:
      • :int_dynatrace
      • Be sure to include the colon as a separator.
  • Confirm UEM functionality by exercising the storefront site and checking for activity in the Dynatrace client 

Testing details are below, but a quick check can be completed by viewing the source of your storefront homepage. Search for dtagent in the page source.  This will confirm that the cartridge integration is complete.  

NOTE: If you already own Dynatrace, you can leverage your existing system. You will need an apache instance with a web server agent to receive the UEM data. If choosing this option, you'll set the src= tag to the apache instance you set up.

 

Please log in to view this content