Atatus PHP Agent in Heroku PHP apps

There are two ways to install Atatus in Heroku PHP apps.

PHP Apps with Composer

Follow the below steps to install Atatus in Heroku.

Set Atatus Heroku PHP extension repo

heroku config:set HEROKU_PHP_PLATFORM_REPOSITORIES="https://s3.amazonaws.com/atatus-php-heroku-ext/heroku/"

You need to set license key in the config to enable Atatus on Heroku.

heroku config:set ATATUS_LICENSE_KEY="lic_apm_********" ATATUS_APP_NAME="My PHP App"

Add Atatus Heroku extension in composer.json from the previous remote package repository.

{
    "require": {
        "ext-atatus": "1.18.0"
    },
    "config": {
        "platform": {
            "ext-atatus": "1.18.0"
        }
    }
}

Commit those changes to Heroku and deploy your application once again.

git add composer.json composer.lock
git commit -m 'Add ext-atatus dependency to Heroku app'
git push heroku main

For PHP apps without composer, you shall be using Atatus Heroku PHP Buildpack. Follow the below steps to install Atatus in Heroku.

Set Atatus Heroku PHP extension repo

heroku config:set HEROKU_PHP_PLATFORM_REPOSITORIES="https://s3.amazonaws.com/atatus-php-heroku-ext/heroku/"

Set Atatus Heroku PHP buildpack repo

heroku buildpacks:set https://github.com/atatus/heroku-buildpack-php-atatus.git

Go to atatus project settings, then click on Install Agent tab and copy your license key and follow below commands
heroku config:set ATATUS_LICENSE_KEY="lic_apm_********" ATATUS_APP_NAME="My PHP App"

Deploy to Heroku.

git commit --allow-empty -m "Rebuild slug"
git push heroku main