Troubleshooting

Overview

Posit Connect includes tools to help with troubleshooting common server issues.

Diagnostic script

A diagnostic script is provided in /opt/rstudio-connect/scripts/run-diagnostics.sh. This script will gather information about the server, the Connect installation, and associated log files. You can run this script with this command, changing the output path as appropriate:

sudo /opt/rstudio-connect/scripts/run-diagnostics.sh \
    /full/path/to/output/directory

Review the contents of the output directory and feel free to sanitize any data you feel is sensitive.

System info

You can also find a detailed overview of your Connect system in the Connect UI by clicking System from the top menu bar and then the Info tab. The System Info section lists information about Connect, including your version and build numbers, as well as license tier and available versions of R, Python, Quarto, and TensorFlow.

This information is useful to have when submitting a Support ticket or bug report. Easily copy the information to your clipboard by clicking the copy icon next to System Info:

A screenshot of the Connect System Info heading with the copy button enclosed in a red square.

System checks

Connect system checks perform additional tests of the running Connect server and its process execution environments. Connect administrators can run these tests and view or download system check results formatted as a report. The reports are useful for troubleshooting, or when submitting a Support ticket or bug report.

Manually trigger system checks in the Connect UI by clicking System from the top menu bar, and then the System Checks tab. Then, click the Run New Report button.

A screenshot of the Connect System Checks heading with the run new report button enclosed in a red square.

You can also schedule the internal checks to run periodically, by configuring one or both of the settings:

; /etc/rstudio-connect/rstudio-connect.gcfg
[Server]
SystemCheckOnStartup = true
SystemCheckFrequency = 3d