The PHP agent for SixthSense does the following:
- Monitors your application to help you identify and find the root cause of performance issues.
- Extends the agent's performance by collecting and analyzing business data to help you improve customer experience.
- Helps in data-driven business decisions.
- SixthSense Agent - provided by Customer Support.
- URL/IP of the SixthSense collector (your tenant URL which will be provided by Customer Support).
- Access token from the SixthSense portal. For accessing the token, see Accessing your Access Token under Getting started with the Observability Portal.
- Variables: TOKEN from the SixthSense portal. See Accessing your Access Token under Getting started with the Observability Portal.
Requests should be handled php-fpm for the agent to intercept requests.
Installing from the Debian package
- Download the Debian package to the machine where the agent must be setup (file will be shared by Customer Support). The Debian package depends on the php version and the OS. You must install the package that is built in a similar environment (share details of architecture, os, and php version).
- Install dependency
apt install libboost-all-dev
apt install php<php-version>-curl
- Install the Debian package.
dpkg -i <sixthsense-agent-name>.deb
Deleting the Debian package
dpkg -r ss-php-agent
The package installs the php extension (.so file) and the GRPC/protobuf (.so) files in /usr/local/lib directory. Any existing GRPC, protobuf .so files will be overridden. Deleting the package will remove all the installed files.
If the above procedure doesn't work, you can use the following procedure to install it from the source.
Downloading the PHP agent
- Download the PHP agent provided by Customer Support.
- Install gPRC and Protobuf on Ubuntu.
Installing the PHP agent
PHP agent is installed as PHP extension and is responsible for instrumentation of all the incoming and outgoing calls from the system. Since PHP Agent is installed as PHP extension, you must build the PHP extension from the source files. The following procedure helps you build the agent.
Installing gPRC and Protobuf on Ubuntu
You need version 3.13 or later of cmake.
If the cmake version is not satisfied install it manually using the following command.
After installing protobuf do the following:
- Export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/lib:/usr/local/lib64
- Export LD_RUN_PATH=$LD_RUN_PATH:/usr/local/lib:/usr/local/lib64
Installing the SixthSense agent on Ubuntu
- Copy the SixthSense agent to /tmp directory to build and install the agent using the following command.
- Open the $PHP_INI_DIR/conf.d/ext-skywalking.ini file and update the following fields.
You have now installed and initialised the agent. The traffic flowing to an application will be captured and you can view it on the SixthSense dashboard.