Skip to main content

Running a Diagnostic Report

Posit Support
  • Updated

 

If you are experiencing difficulties with a Posit product please open a ticket and send a diagnostics report. This will help us be able to further investigate the problem. Please note that we recommend the latest versions of the Posit product you are using, to ensure that you are taking advantage of the most recent features and bug fixes. You can upgrade to recent versions of our products here.

We also recommend that you check through the diagnostic after it has been generated, and ensure that you have removed or redacted any sensitive information.

Posit Team Products

To run the diagnostics report, for Posit Workbench, Posit Connect or Posit Package Manager, please see the relevant section for your product here: https://docs.posit.co/support.html#open-a-support-ticket 

RStudio Desktop Pro

To run a diagnostics report you can do the following:

From within RStudio Desktop:

Help Menu -> Diagnostics -> Write Diagnostics Report

If the product is not starting, you can use the following method to run a diagnostics report. Note that you need to also show us the contents of the terminal session that is started.

Windows:

You can run a diagnostics report by typing the following command into Start -> Run:

"C:\Program Files\RStudio\rstudio.exe" --run-diagnostics

The diagnostics report will be placed in your user Documents folder under a folder called rstudio-diagnostics (e.g. C:\Users\Username\Documents\rstudio-diagnostics\diagnostics-report.txt)

Note If you installed RStudio to a different location than C:\Program Files make sure to specify this location in the command.

Mac OS X:

You can run a diagnostics report by typing the following command at the Terminal:

/Applications/RStudio.app/Contents/MacOS/RStudio --run-diagnostics

The diagnostics report will be placed in your user home directory (e.g. ~/rstudio-diagnostics/diagnostics-report.txt).

Linux:

You can run a diagnostics report by typing the following command at the Terminal:

rstudio --run-diagnostics

The diagnostics report will be placed in your user home directory (e.g. ~/rstudio-diagnostics/diagnostics-report.txt).

See also: Troubleshooting Guide: Using RStudio

Shiny Server Pro

There is no script to generate a diagnostic file for Shiny Server Pro, but if you provide the following information, it will greatly aid our investigation of your issue.

  • General description
  • Error messages
  • Attempted steps taken to fix
  • Linux distribution and version
  • Host environment: hardware, local VM, hosted VM (e.g., AWS EC2 instance)
  • Version of Shiny Server Pro (run this command: shiny-server --version)
  • Your /etc/shiny-server/shiny-server.conf file
  • Your server log file: /var/log/shiny-server.log
  • System log file
  • Check that permissions have been correctly set as described here: http://docs.posit.co/shiny-server/#running-shiny-server-with-root-privileges 

If the issue is specific to applications:

  • Versions of Shiny package and other related packages
  • Application log file (you may need to set preserve_logs true; in your shiny-server.conf file): http://docs.rstudio.com/shiny-server/#application-error-logs
  • Application code (or a minimal code that reproduces the issue)
  • A HAR file of the network activity that happens when the problem occurs. This article describes how to open a Javascript console and generate the HAR file from the browser, if you're not familiar with the tool: https://support.posit.co/hc/en-us/articles/4413166624279

 

Related articles