A full access to Blackfire is bundled with your PHP and Python Upsun projects.
Blackfire has built-in support for Upsun projects. The integration is made simpler as Blackfire agent and probe are installed and enabled by default on all Upsun projects.
Blackfire server credentials are automatically configured on all PHP and Python Upsun projects. The Blackfire integration appears in the project settings in Upsun console.
Blackfire monitoring is enabled by default on your production environment.
To enable Blackfire monitoring on your development or staging environments, go to your organization menu and click Organization Monitoring Usage
HTTP requests can be profiled without any extra configuration, but the client credentials are required to trigger profiles with the CLI from your Upsun environments.
Set the client credentials as environment variables (run this command from the root directory of your project):
Recommended: To explicitly define which
environment the profile must be sent
to, use the --env=<ENV_UUID> parameter.
Blackfire Agent uses the BLACKFIRE_SERVER_ID environment variable to
determine where to send the profile.
When no target environment is specified or implicitly discovered, the profile
is sent to the personal sandbox environment of the user whose
personal credentials (BLACKFIRE_CLIENT_ID
and BLACKFIRE_CLIENT_TOKEN) were used. Only that user can then access
the profile from /my/profiles.
To explicitly specify your personal sandbox environment, use
--env="My Environment"
Here is a full video tutorial to get you started with the integration of the three services: