Data required for troubleshooting UI issues

Data required to troubleshoot UI performance and issues

Overview

This article outlines the data Codefresh Support needs to troubleshoot UI issues, such as slowness or unexpected behavior in UI components.

Details

In order to troubleshoot UI-related issues, Codefresh Support requires at minimum the following information:

  • Codefresh username of affected user
  • Link to UI page being accessed
  • Action being performed
  • Timestamp of incident

It’s also helpful to provide Codefresh Support with an HTTP Archive (HAR) file. This file is a log of network requests that occurred during a recorded period.

Important

Before capturing a HAR file, it’s important to note a few items.

  1. A HAR file can contain sensitive data, such as personal data, emails, hostnames, IP Addresses, passwords, etc. It’s highly recommended that you review the HAR file for sensitive information before uploading it to Codefresh Support.
  2. For the best results, it’s recommended that you begin the capture of the HAR file before you attempt to reproduce the issue and continue to capture it throughout the problem.
  3. (Optional) It’s also a good idea to record your screen while you are facing the issue to help give a better understanding of what you are seeing concerning the HAR file.

Capturing a HAR file

Here are instructions on how to capture a HAR file for various browsers:

Chromium-based

  1. Open Chrome, in the top right, select the vertical “Meatball” menu -> More tools -> Developer tools

Chromium: Developer tools

Chromium: Developer tools
  1. Click the Network tab.

Chromium: Network tab

Chromium: Network tab
  1. If the Record button is not active (red), go ahead and click this button.
    You are now ready to begin capture.

Chromium: Record button

Chromium: Record button
  1. Navigate to the URL where you are facing the issue and attempt to reproduce the issue.
    You should now see network requests being populated in your developer tools.
    Here is an example:

Chromium: Example of network requests in Developer tools

Chromium: Example of network requests in Developer tools
  1. Once you have reproduced the issue, stop the capture by clicking the Record button again.
  2. Click the Export HAR… button, and then download the HAR file.
    TIP: A suggested naming scheme is to use: < ZD-Case-ID>< YYYY-MM-DD>< HH-mm-ss>

Chromium: Export HAR file

Chromium: Export HAR file
  1. Upload the HAR file to your support case.
    TIP: Make sure to read the important notes mentioned above.

Safari

  1. Open Safari, in the Menu Bar, go to Develop -> Show Web Inspector.

Safari: Show Web Inspector

Safari: Show Web Inspector
  1. Navigate to the Network tab.

Safari: Network tab

Safari: Network tab
  1. You are now ready to begin capture. Navigate to the URL where you are facing the issue and attempt to reproduce the issue.
    You should now see network requests being populated in your developer tools.
    Here is an example:

Safari: Example of network requests in Developer tools

Safari: Example of network requests in Developer tools
  1. Once you have finished reproducing the issue, click the Export button to download the HAR file.
    TIP: A suggested naming scheme is to use: < ZD-Case-ID>< YYYY-MM-DD>< HH-mm-ss>

Safari: Download HAR file

Safari: Download HAR file
  1. Upload the HAR file to your support case.
    TIP: Make sure to read the important notes mentioned above.

Firefox

  1. Open Firefox, and from the top right, select the vertical “Meatball” menu -> More tools -> Web Developer Tools.

Firefox: Web Developer Tools

Firefox: Web Developer Tools
  1. Click the Network tab.

Firefox: Network tab

Firefox: Network tab
  1. You are now ready to begin capture. Please navigate to the URL where you are facing the issue and attempt to reproduce the issue.
    You should now see network requests being populated in your developer tools.
    Here is an example:

Firefox: Example of network requests in Web Developer Tools

Firefox: Example of network requests in Web Developer Tools
  1. Click Cog Wheel at the top-right of the Web Developer Tools window -> Save All as HAR!.
    TIP: A suggested naming scheme is to use: < ZD-Case-ID>< YYYY-MM-DD>< HH-mm-ss>

Firefox: Save as HAR file

Firefox: Save as HAR file
  1. Upload the HAR file to your support case.
    TIP: Make sure to read the important notes mentioned above.