Troubleshooting

Unable to install the Probe

We strongly recommend the use of Blackfire repositories to install the Probe.

If you ever experience difficulties while installing or running the Probe with our repositories, you can install it manually by following the manual installation guide in the Probe installation section.

Unable to Install the Agent

We strongly recommend the use of package repositories to install the Agent.

If you ever experience difficulties while installing or running the Agent with our repositories, you can install it manually by following the manual installation guide in the Agent installation section.

Are You Authorized to Profile this Page? Probe Not Found or Invalid signature.

This is the most common issue when installing the Blackfire stack. If this issue occurs, please follow these steps:

  1. Check versions

    Ensure you're using the latest Agent, Probe and Companion. This is quite easy as this page will tell you they're outdated.

  2. Make sure you selected the proper Environment

    If you are using the Premium or Enterprise Edition, you may have created and configured shared Environments. As each Environment has its own set of server credentials, specifying which Environment you are targeting when profiling will grant you the access rights. That can be done either via the drop-down box in the Chrome extension, or via specifying the --env option in the CLI.

Agent's Log Contains Error dial tcp: i/o timeout

This error occurs when a timeout happens between the Agent and the Blackire.io server. If you encounter this issue, you can increase the timeout of the Agent by appending the following line to the Agent configuration:

1
timeout=30s

I Can't Find a Solution on this Page

Please give us feedback

If you can't find a solution to your problem, please contact us. Please include the following information in your issue and we'll contact you as soon as possible:

  • Your platform (e.g. OSX x64, Debian wheezy x86, Ubuntu Precise x64, etc...)
  • The output of php -v command.
  • The output of php -d display_startup_errors=on --ri blackfire command.
  • The output of blackfire-agent -v command.
  • The content of the Probe log file.
  • The content of the Agent log file.

Here's how to get the logs:

  1. Enable logging for the agent

    Enable the Agent debug log level by configuring it with log-level=4. Default log files are /var/log/blackfire/agent.log on Linux and /usr/local/var/log/blackfire/agent.log on OSX. On Windows, simply copy/paste the console output. Refer to the Agent configuration section on how to modify them. Do not forget to restart the Agent to use the new configuration.

  2. Enable logging for the probe

    Enable the Probe debug log level by configuring it with blackfire.log_level=4 and blackfire.log_file=/tmp/blackfire.log.

  3. Use these new configurations

    Do not forget to restart your webserver or PHP-FPM to reload the configuration if needed.