Troubleshoot Sqreen


My dashboard keeps waiting for my agent’s connection

Problem

You follow the instructions provided on your user interface. After setting up Sqreen in your application, the dashboard keeps waiting for your agent’s connection.

Solution

To troubleshoot this behavior:

  1. Did you follow the Installation of the Ruby agent steps ?
  2. Is your application able to reach the Internet?
  3. Can your app talk to back.sqreen.io on in HTTPS (port 443)
  4. Restart your web server
  5. Examine the agent's log file at log/sqreen.log
  6. Try updating to the latest version of the sqreen gem

No data appears in my dashboard

Problem

After installing the Sqreen Ruby agent and waiting five minutes, no data appears in your user interface.

Solution

To troubleshoot missing data:

  1. Ensure your config file is installed at config/sqreen.yml within your application directory and that your config file is valid YML containing your token
  2. Restart your web server
  3. Examine the agent's log file at log/sqreen.log
  4. Try updating to the latest version of the sqreen gem

Access the agent logs

Problem

You cannot locate Sqreen log file in your application.

Solution

To troubleshoot this:

  1. Check file log/sqreen.log if a log directory exists in your application top level folder
  2. Check your container logs if you use containers
  3. Force a specific log location to receive logs by using SQREEN_LOG_LOCATION environment variable
export SQREEN_LOG_LOCATION=/tmp/sqreen.log

Automatic User Context - No data appears in my dashboard

Problem You are using Automatic User Context in your application settings, but no user data appears in your dashboard.

Solution

To troubleshoot missing data:

  1. Ensure that the authentication framework you are using is compatible with automatic user context. Please refer to Protect user accounts section for more information.
  2. Restart your web server
  3. Examine the agent's log file at log/sqreen.log
  4. Try updating to the latest version of the sqreen gem

Advanced User Context - No data appears in my dashboard

Problem You are using Advanced User Context in your application settings, but no user data appears in your dashboard.

Solution

To troubleshoot missing data:

  1. Ensure that you integrated Sqreen SDK in your application. Please refer to Protect user accounts section for more information.
  2. Restart your web server
  3. Examine the agent's log file at log/sqreen.log
  4. Try updating to the latest version of the sqreen gem