Install the agent

  1. Add repository

    Execute the following command to add the redhat repository.

    copy
    icon/buttons/copy
    sudo curl -o /etc/yum.repos.d/atatus-php-agent.repo https://s3.amazonaws.com/atatus-artifacts/atatus-php/rpm/x86_64/atatus-php-agent.repo
    
    copy
    icon/buttons/copy
    sudo yum -q makecache -y --disablerepo='*' --enablerepo='atatus-php-agent'
    
  2. Install php agent

    copy
    icon/buttons/copy
    sudo ATATUS_LICENSE_KEY="APM_LIC_KEY" ATATUS_APP_NAME="YOUR_APP_NAME" yum 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)

To upgrade to the latest version, execute the following command.

copy
icon/buttons/copy
sudo yum -q makecache -y --disablerepo='*' --enablerepo='atatus-php-agent'
yum --showduplicates list atatus-php-agent
copy
icon/buttons/copy
sudo yum update atatus-php-agent -y

Install specific version of agent

  • Remove Atatus agent completely.
sudo yum remove atatus-php-agent -y
  • Check list of available Atatus versions.
yum --showduplicates list atatus-php-agent
# Sample output for yum --showduplicates list

Available Packages
atatus-php-agent.x86_64           1.14.0-1           atatus-php-agent

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" yum 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" yum install atatus-php-agent-"1.14.0-1" -y