Troubleshooting
Overview
Posit Connect includes tools to help with troubleshooting common server issues.
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:
Diagnostics
Diagnostics help Posit Support troubleshoot your specific Connect installation, and should be included when opening a support ticket. These diagnostics include information about the server, the Connect installation, and associated log files. You can generate diagnostics via the Connect UI under System > Diagnostics, or the diagnostics script provided in /opt/rstudio-connect/scripts/run-diagnostics.sh.
Before sending diagnostics to Posit Support, review the contents of the output directory, and sanitize any sensitive data.
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.
You can also schedule the internal checks to run periodically, by configuring one or both of the settings:
Server.SystemCheckOnStartupto run checks every time Posit Connect starts up, orServer.SystemCheckFrequencyto run checks periodically (in this example, every 3 days)
/etc/rstudio-connect/rstudio-connect.gcfg
[Server]
SystemCheckOnStartup = true
SystemCheckFrequency = 3d