How to enable dtHealthCheck

[HannahM]

• Abstract
• What is dtHealthCheck?
• Limitations
• How to enabledtHealthCheck
• Step 1: Open Chrome or Edge Developer Tools
• Step 2: AccessNetwork Conditions
• Step 3: Add custom User Agent
• Step 4: Open the webpage and record Har file
• Step 5: Export the HAR File

Abstract

When investigating injection issues, it can be helpful to enable dtHealthCheck to gather diagnostic information. This article provides more information on this and how to enable this feature.

What is dtHealthCheck?

dtHealthCheck is a diagnostic feature, enabled by adding the User-Agent header value dtHealthCheck. Responses to any requests made with this header contain additional headers, and sometimes an HTML marker in the body. If injection problems occur, these headers provide diagnostic details, which may help identify the issue.

Limitations

• dtHealthCheck is only available in Google Chrome and Microsoft Edge.
• dtHealthCheck will only show results if the OneAgent is working on the web server, and is not available for Agentless injection.

How to enable dtHealthCheck

Step 1: Open Chrome or Edge Developer Tools

Open Developer Tools using one of the options below:

• Open the Browser and press F12 on your keyboard, or
• Right-click anywhere on the page and select "Inspect" or "Inspect Element", or
• On Chrome, you can also use the three-dot menu in the top-right corner of the browser > More tools > Developer tools.
  
  

Step 2: Access Network Conditions 

Open Network Conditions using one of the options below:

1. Using the Network tab
   1. In the Developer Tools menu bar, click on the "Network" tab.
   2. In the additional settings bar, click the "More network conditions..." icon , and the Network conditions pane will open.
      
      or
2. Using More Tools menu 
   1. In the Developer Tools pane, locate and click the three vertical dots (Options) in the top-right corner of the pane.
   2. Click on the "More Tools" option.
   3. Click on  "Network conditions".
      

Step 3: Add custom User Agent

1. In the "Network conditions" pane > User agent section, Untick the "Use browser default" checkbox
2. In the dropdown box, select "Custom..."
3. Enter "dtHealthCheck" into the text field.
   

Step 4: Open the webpage and record Har file

In the same tab that you have set the User-Agent to "dtHealthCheck" in the "Network Conditions" settings, open or reload the webpage and create the session.

Note: the actions must be completed in the same tab as the Network Conditions setting is made, as otherwise the option will be reset to the default.

It can be confirmed that the dtHealthCheck User Agent has been applied by checking for it in the response headers of resources

For further information on creating har files see How to generate a HAR file

Step 5: Export the HAR File

Export the HAR file using one of the methods below:

1. In Network Requests
   1. Right-click anywhere in the list of network requests.
   2. Select Copy >  "Copy All as HAR (sanitized)".
   3. Choose a location on your computer to save the HAR file, give it a descriptive name, and click "Save."
      or
2. From Network settings bar
   1. Click "Export HAR (sanitized)"
   2. Choose a location on your computer to save the HAR file, give it a descriptive name, and click "Save."

[AntonPineiro]

Thank you!