Troubleshooting


Info

This is a non-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!

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

Installation errors on Alpine Linux

On Alpine Linux, installation may fail with the error ERROR: Failed to build gem native extension. This usually happen because the build system packages are not included by default on Alpine. You can install them using apk add build-base.