Troubleshooting

Occasionally, you may encounter issues with your workspace. This guide outlines common troubleshooting problems and recommended solutions.

Invalid site URL warning

If you receive an alert stating that your site URL is invalid, it means that the URL of your site does not match the URL you are trying to access. This discrepancy can lead to issues with loading assets in Rocket.Chat. This problem typically arises when someone modifies the settings.

To fix this issue, you will need to update the site URL by setting the following environment variables:

OVERWRITE_SETTING_Site_Url=https://the-address-you-use-to-access
ROOT_URL=https://the-address-you-use-to-access

Refer to the Deployment Environment Variables guide to learn more.

Logging and reporting options

Rocket.Chat offers various options for you to monitor and analyze your workspace operations.

  • The workspace Reports menu displays the workspace logs and analytics reports. The Logs settings allow you to update how the server logs are received.

  • You can set up Prometheus to monitor your workspace and store metrics data from Rocket.Chat,  and visualize this data using apps like Grafana.