Skip to content

Troubleshooting Launcher and Kubernetes:
Check Log Files#

Posit Workbench, formerly RStudio Workbench, generates log files for each component, including the RStudio Server Pro service, the Launcher service, the Kubernetes plugin, and individual sessions.

You can inspect the content of these log files for any relevant messages to help you determine the underlying cause of the error or issue that you are experiencing.

Server log files#

View the contents of the following log files on the server:

  • Workbench service:


  • Launcher service:


  • Kubernetes plugin:


Session log files#

If you are able to start remote sessions in Kubernetes, you can also view the logs for individual sessions using the following steps:

  1. From the Workbench home page, click + New Session:

    Workbench Home Page - New Session Button

  2. Start a new session in Kubernetes (you may wish to clear Join session when ready):

    Workbench Home Page - New Session Dialog Box

  3. Click the Info button next to the running session:

    Workbench Home Page - Info Button

  4. In the Session Info dialog box, select the Launcher Diagnostics tab:

    Workbench Home Page - Launcher Diagnostics Tab in Session Info Dialog Box

  5. In the Launcher Diagnostics tab, click the Details link:

    Workbench Home Page - Details Link in Session Info Dialog Box

The resulting page includes the logs from the remote session in Kubernetes:

Workbench Home Page - Session Logs on \<!--Posit Question - does this remain?-->RStudio Session Page

Diagnostics report#

You can use the following command to generate a diagnostics report that includes logs for Workbench and Launcher as well as additional information about your system.

$ sudo rstudio-server run-diagnostics

The output of this command will show a location on disk where you can view the contents of the diagnostics report.

Restart services and test#

After reviewing the logs then identifying and correcting any issues, you can restart the Workbench and Launcher services:

$ sudo rstudio-server restart
$ sudo rstudio-launcher restart

Verify that the services are running and try to start a new session from the Workbench home page.

If the services are still not starting or you are still experiencing errors when starting a new session, then proceed to
Step 2 - Verify Installation.