Troubleshooting¶

The following steps may help you troubleshooting your setup.

Check if the Sqreen extension is loaded¶

By taking a look at the phpinfo() page, the Sqreen extension section should be present. If it's not, then probably PHP was not correctly configured to load the Sqreen PHP extension. Please visit the manual installation of the php extension section guide.

The following information can be retrieved from this table:

the extension version,
the daemon version,
the connection status between the extension and the daemon (on the Connected line, in the first section).

Ensure the agent is running¶

A sqreen-agent process should be running:

Shell

$ ps aux | grep sqreen
sqreen  19456   0,0  0,0  2522856   6656 s013  S+   Ven10     0:55.18 sqreen-agent

If it's not, please ensure the sqreen-agent was installed and configured to start automatically.

Check PHP logs¶

The PHP errors (in the FPM logs or in the Apache logs) may contain Sqreen related entries.

Check the agent logs¶

The sqreen-agent logs should inform you that the agent was successfully started:

Shell

$ cat /var/log/sqreen/sqreen.log
[INFO][2017-09-04 09:42:29,013 #15348.MainThread] sqreen-agent:91 Starting up on TCP socket 0.0.0.0:7773
[INFO][2017-08-31 09:42:29,013 #15348.MainThread] sqreen-agent:104 Sqreen-agent successfully started

Check the agent debug logs¶

The agent can be configured to report debug logs as well:

Shell

$ sqreen-agent --log_level=DEBUG
[INFO][2017-09-04 09:42:29,013 #15348.MainThread] sqreen-agent:91 Starting up on TCP socket 0.0.0.0:7773
[INFO][2017-08-31 09:42:29,013 #15348.MainThread] sqreen-agent:104 Sqreen-agent successfully started

Ensure the extension can reach the daemon¶

Since the PHP extension must be able to reach the daemon, run the following command (from the PHP host if different from the daemon host) to confirm the setup is OK:

Shell

$ curl 127.0.0.1:7773

If you are using a different host for the daemon and your PHP host, replace 127.0.0.1 with the address/port of the host running the daemon.

The command will either:

timeout (the connection was successfully performed)
terminate with a Connection refused error.

In the case of a timeout, everything is fine: the daemon is listening. In case of a Connection refused error, it seems this host cannot join the daemon. Check your network configuration.

Retrieve additional logs¶

The Sqreen extension may be configured in debug mode. In the sqreen.ini file, add the following directive:

Ini

sqreen.log_level = 'debug'

Restart Apache or FPM and visit your website. The extension should create log files in the /tmp directory or the directory configured in the log_location configuration key. Please share those logs with us for further investigation.