How to generate HAR files and console logs

Atlan is built on REST APIs, so you can see the requests being sent by the UI to the API gateway through your browser's developer console.

To help Atlan troubleshoot issues, you may be asked to create and send a HAR file and browser console logs:

• Console or network logs frequently provide critical error details that are required to determine the underlying cause of the issue or bug that you are experiencing.
• HAR files include all the network traffic from when you started recording, including sensitive information like passwords and private keys. To avoid including such information in a HAR file, Atlan recommends using a text editor to manually edit the file and remove any sensitive content before sending it to Atlan support.

Generate a HAR file and console log in Google Chrome

1. Launch Google Chrome and navigate to the relevant webpage in Chrome.
2. In the upper-right corner of your screen, click the three vertical dots. 
3. From the Chrome menu, click More Tools and then click Developer Tools.
4. In the left menu, click on the Network tab and then select Fetch/XHR as your filtering option.
5. Under the Network tab, click Preserve log. A red circle will appear on the left to show that you have started recording the network log. If you see a black circle, click on it to turn it red and start recording.
6. To allow Google Chrome to record the interaction between the browser and website, refresh the page. Confirm if you can view new entries in the console.
7. Next to the red circle icon, click the circle slash icon to clear logs.
8. Replicate the issue that you experienced in the browser. For example, if it's a particular click that triggers an error, perform this action so that the error is recorded in the console.
9. Once the page has loaded, navigate to the Console tab and right-click in the console box. Select Save as... and enter a name for the file.
10. Return to the Network tab and right-click the element that triggered an error. This is typically marked in red in the console. Click Save as HAR with content to save the HAR file.
11. (Recommended) To remove any sensitive information from the HAR file:
    1. Open the HAR file in a text editor of your choice.
    2. Search for all instances of passwords and replace the values with a placeholder value such as *****. For example, in the following sample password content, you can replace <YourPrivateKey>and <YourPrivateKeyPassword> with placeholder values:

       "headersSize": -1,
                 "bodySize": 3762,
                 "postData": {
                   "mimeType": "application/json", "text": "{\"host\":\"<YourHostName>\",\"port\":<port>,\"authType\":\"keypair\",\"username\":\"PRD_SDCSHOP_TU_ETL_CATALOG\",\"password\":\"-----BEGIN ENCRYPTED PRIVATE KEY-----\\<YourPrivateKey>\\n-----END ENCRYPTED PRIVATE KEY-----\",\"extra\":{\"role\":\"GLOBAL_TALEND_CATALOG_DBADMIN\",\"warehouse\":\"PRD_SDCSHOP_ETL\",\"private_key_password\":\"<YourPrivateKeyPassword>\"},\"connectorConfigName\":\"atlan-connectors-snowflake\",\"query\":\"show atlan schemas\",\"schemaExcludePattern\":[\"INFORMATION_SCHEMA\"]}"
                 }
               }

    3. Save the HAR file.
12. Upload the HAR file and browser console log to your Atlan support ticket.