Unity Network Reporter

Hello! You've probably been asked to generate a network report. In many cases, it's related to a problem encountered when trying to use Unity with one of our Cloud Services. Thank you for helping us understand how your local network behaves so that we can improve Unity Cloud Services.

The network reporter is a simple tool that runs in a few minutes, saving a text file with general information about your local network. The report is not automatically sent to Unity, giving you a chance to review the details. There is no personally identifiable information in the report, but it does list local network addresses and region information to help us coordinate what part of Unity Cloud Services might be in use from your location.

To keep the tool simple and small, it has no user interface. Be sure to run the reporter from the same machine or host that is experiencing the issue.

Please follow the appropriate instructions below depending on the operating system you are using.

Windows

  1. download the reporter: https://public-cdn.cloud.unity3d.com/network_reporter/unity_network_reporter.exe

  2. open a command window

  3. change to the same directory unity_network_reporter.exe was downloaded

  4. run the reporter: unity_network_reporter.exe

  5. it should present something like the following, indicating where the text report was saved:

    Inspecting interfaces...done
    Evaluating DNS resolution...done
    Evaluating TCP connectivity...done
    Evaluating HTTP connectivity...done
    Evaluating messaging...done
    
    The following tests can take a few minutes...please be patient:
      Evaluating upload bandwidth...done
      Evaluating download bandwidth...done
      Evaluating return routes...done
    
    Report saved to C:\Users\brad\Desktop\UnityNetworkReport_20170625174326.log
    
  6. review the contents and then send the file to the person at Unity asking for this report

  7. Thank you!

Mac OS X

  1. download the reporter: https://public-cdn.cloud.unity3d.com/network_reporter/unity_network_reporter_osx

  2. open a terminal window

  3. change to the same directory unity_network_reporter was downloaded

  4. make the reporter runable: chmod 755 unity_network_reporter

  5. run the reporter: ./unity_network_reporter

  6. it should present something like the following, indicating where the text report was saved:

    Inspecting interfaces...done
    Evaluating DNS resolution...done
    Evaluating TCP connectivity...done
    Evaluating HTTP connectivity...done
    Evaluating messaging...done
    
    The following tests can take a few minutes...please be patient:
      Evaluating upload bandwidth...done
      Evaluating download bandwidth...done
      Evaluating return routes...done
    
    Report saved to /Users/brad/Desktop/UnityNetworkReport_20170625174326.log
    
  7. review the contents and then send the file to the person at Unity asking for this report

  8. Thank you!

Linux

  1. download the reporter: https://public-cdn.cloud.unity3d.com/network_reporter/unity_network_reporter_linux

  2. open a terminal window

  3. change to the same directory unity_network_reporter was downloaded

  4. make the reporter runable: chmod 755 unity_network_reporter

  5. run the reporter: ./unity_network_reporter

  6. it should present something like the following, indicating where the text report was saved:

    Inspecting interfaces...done
    Evaluating DNS resolution...done
    Evaluating TCP connectivity...done
    Evaluating HTTP connectivity...done
    Evaluating messaging...done
    
    The following tests can take a few minutes...please be patient:
      Evaluating upload bandwidth...done
      Evaluating download bandwidth...done
      Evaluating return routes...done
    
    Report saved to /Users/brad/Desktop/UnityNetworkReport_20170625174326.log
    
  7. review the contents and then send the file to the person at Unity asking for this report

  8. Thank you!

Source

If you're interested in the nitty gritty details of what we're doing inside the tool, the source can be reviewed here: https://public-cdn.cloud.unity3d.com/network_reporter/network_reporter_source.html