Install the agent

  1. Add repository and gpg key

    Execute the following command to add the gpg key.

    copy
    icon/buttons/copy
    curl https://s3.amazonaws.com/atatus-artifacts/gpg/atatus.gpg | sudo apt-key add -
    

    Execute the following command to add the debian repository.

    copy
    icon/buttons/copy
    echo "deb https://s3.amazonaws.com/atatus-artifacts/atatus-php/debian stable main" | sudo tee -a /etc/apt/sources.list.d/atatus-php-agent.list
    
  2. Install php agent

    copy
    icon/buttons/copy
    sudo apt-get update
    
    copy
    icon/buttons/copy
    sudo ATATUS_LICENSE_KEY="APM_LIC_KEY" ATATUS_APP_NAME="YOUR_APP_NAME" apt-get install atatus-php-agent -y
    

    APM_LIC_KEY - add the Atatus APM License key in this line of code.

    YOUR_APP_NAME - add the application name in this line of code.

  3. Stop and Start your PHP services.

    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.

Upgrade the agent (to the next version)

Execute the following command to upgrade to the latest version.

copy
icon/buttons/copy
sudo apt-get update
copy
icon/buttons/copy
apt policy atatus-php-agent
sudo apt-get install --only-upgrade atatus-php-agent

Install specific version of agent

  • Remove Atatus agent completely.
sudo apt-get purge atatus-php-agent
  • Check list of available Atatus versions.
apt policy atatus-php-agent

(or)

apt-cache policy atatus-php-agent
# Sample output for apt-cache policy

atatus-php-agent:
  Installed: 1.14.0-1
  Candidate: 1.14.0-1
  Version table:
 *** 1.14.0-1 500
        500 https://s3.amazonaws.com/atatus-artifacts/atatus-php/debian stable/main amd64 Packages
        100 /var/lib/dpkg/status

In above output you can see the version as 1.14.0-1. Keep in mind that the version number always ends with suffix like -1.

  • Install specific version of Atatus agent.
sudo ATATUS_LICENSE_KEY="APM_LIC_KEY" ATATUS_APP_NAME="YOUR_APP_NAME" apt-get install atatus-php-agent="SPECIFIC_VERSION" -y

# Install specific version 1.14.0
sudo ATATUS_LICENSE_KEY="APM_LIC_KEY" ATATUS_APP_NAME="YOUR_APP_NAME" apt-get install atatus-php-agent="1.14.0-1" -y