The Atatus PHP agent helps you in troubleshooting your PHP application problems and also identify performance issues before it becomes apparent to your users. It also captures unhandled exceptions and HTTP failures and determines which part of your application is slower or causing the errors.

Create a free account to start monitoring your PHP apps.

Following are the steps to install the PHP agent.

Debian

  1. Install Atatus PHP agent:

    a.) Download the latest Debian agent from:

    copy
    icon/buttons/copy 
    // Download Debian tarball
wget https://s3.amazonaws.com/atatus-artifacts/atatus-php/downloads/atatus-php-1.18.0-x64-debian.tar.gz

    b.) Extract the agent tarball

    copy
    icon/buttons/copy 
    tar -xzvf atatus-php-1.18.0-x64-debian.tar.gz
cd atatus-php-1.18.0-x64-debian

  2. Install the php agent

    copy
    icon/buttons/copy 
    sudo ATATUS_LICENSE_KEY="APM_LIC_KEY" ATATUS_APP_NAME="YOUR_APP_NAME" bash install.sh
    Note:

    Do not change the app name. If you do, it will create a new project. For more advanced options, view PHP documentation

    Make sure that the license key and app name are set correctly in the Atatus configuration file: atatus.ini. You can find the path of atatus.ini file by running php -i | grep atatus.ini command in the shell.

  3. Restart your web server and PHP - FPM

    Stop and Start your servers such as nginx, php-fpm, apache, httpd, etc. Then you will see the performance data in a few minutes.

    Just access your server from your web app or mobile app or curl. You will visualize your application's metrics within minutes.

# Verify package installed
rpm -qa | grep atatus-php-agent

# Verify PHP extension loaded
php -i | grep atatus

Redhat

  1. Install Atatus PHP agent:

    a.) Download the latest Redhat agent from:

    copy
    icon/buttons/copy 

    // Download Redhat tarball
wget https://s3.amazonaws.com/atatus-artifacts/atatus-php/downloads/atatus-php-1.18.0-x64-redhat.tar.gz

    b.) Extract the agent tarball

    copy
    icon/buttons/copy 
    tar -xzvf atatus-php-1.18.0-x64-redhat.tar.gz
cd atatus-php-1.18.0-x64-redhat

  2. Install the php agent

    copy
    icon/buttons/copy 
    sudo ATATUS_LICENSE_KEY="APM_LIC_KEY" ATATUS_APP_NAME="YOUR_APP_NAME" bash install.sh
    Note:

    Do not change the app name. If you do, it will create a new project. For more advanced options, view PHP documentation

    Make sure that license key and app name are set correctly in the Atatus configuration file: atatus.ini. You can find the path of atatus.ini file by running php -i | grep atatus.ini command in the shell.

  3. Restart your web server and PHP - FPM

    Stop and Start your servers such as nginx, php-fpm, apache, httpd, etc. Then you will see the performance data in a few minutes.

    Just access your server from your web app or mobile app or curl. You will visualize your application's metrics within minutes.

# Verify package installed
rpm -qa | grep atatus-php-agent

# Verify PHP extension loaded
php -i | grep atatus

Musl

  1. Install Atatus PHP agent:

    a.) Download the latest musl agent from:

    copy
    icon/buttons/copy 
    // Download Musl tarball
wget https://s3.amazonaws.com/atatus-artifacts/atatus-php/downloads/atatus-php-1.18.0-x64-musl.tar.gz

    b.) Extract the agent tarball

    copy
    icon/buttons/copy 
    tar -xzvf atatus-php-1.18.0-x64-musl.tar.gz
cd atatus-php-1.18.0-x64-musl

  2. Install the php agent

    copy
    icon/buttons/copy 
    sudo ATATUS_LICENSE_KEY="APM_LIC_KEY" ATATUS_APP_NAME="YOUR_APP_NAME" bash install.sh
    Note:

    Do not change the app name. If you do, it will create a new project. For more advanced options, view PHP documentation

    Make sure that license key and app name are set correctly in the Atatus configuration file: atatus.ini. You can find the path of atatus.ini file by running php -i | grep atatus.ini command in the shell.

  3. Restart your web server and PHP - FPM

    Stop and Start your servers such as nginx, php-fpm, apache, httpd, etc. Then you will see the performance data in a few minutes.

    Just access your server from your web app or mobile app or curl. You will visualize your application's metrics within minutes.

# Verify package installed
rpm -qa | grep atatus-php-agent

# Verify PHP extension loaded
php -i | grep atatus

Mac

  1. Install Atatus PHP agent:

    a.) Download the latest Mac agent from:

    copy
    icon/buttons/copy 
    // Download Mac tarball
wget https://s3.amazonaws.com/atatus-artifacts/atatus-php/downloads/atatus-php-1.18.0-x64-osx.tar.gz

    b.) Extract the agent tarball

    copy
    icon/buttons/copy 
    tar -xzvf atatus-php-1.18.0-x64-osx.tar.gz
cd atatus-php-1.18.0-x64-osx

  2. Install the php agent

    copy
    icon/buttons/copy 
    sudo ATATUS_LICENSE_KEY="APM_LIC_KEY" ATATUS_APP_NAME="YOUR_APP_NAME" bash install.sh

Note:
Do not change the app name. If you do, it will create a new project. For more advanced options, view PHP documentation

Make sure that license key and app name are set correctly in the Atatus configuration file: atatus.ini. You can find the path of atatus.ini file by running php -i | grep atatus.ini command in the shell.

  1. Restart your web server and PHP - FPM

    Stop and Start your servers such as nginx, php-fpm, apache, httpd, etc. Then you will see the performance data in a few minutes.

    Just access your server from your web app or mobile app or curl. You will visualize your application's metrics within minutes.