Troubleshoot Sqreen


Info

This is a non an exhaustive list of problems or troubleshooting strategies. If you need help please email us at support@sqreen.io or through our web chat. Please don't hesitate, we're here to help!

For guidance on troubleshooting language-specific issues, refer to the relevant troubleshooting pages:

Increase log verbosity

The Sqreen agent can log messages to a text file. These messages contain warnings about possible abnormal behavior and describe some actions the agent is executing.

Two values in Sqreen configuration control the logging:

Env variable name Role Default value Options
SQREEN_LOG_LOCATION Specify a custom file to write Sqreen logs The terminal Custom filepath
SQREEN_LOG_LEVEL Sqreen logging level WARN INFO, DEBUG

The INFO level is reasonably verbose but still suitable for production environments. DEBUG should only be used for short periods of time due to the amount of data it generates

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 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 agent.

No data appears in my dashboard

Problem

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

Solution

To troubleshoot missing data:

  1. Ensure your config file is installed within your application directory, that your config file is valid, and it contains 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 agent.

Access the agent logs

Problem

You cannot locate a 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 agent.

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 agent.