How to deploy the Site24x7 PHP agent in a Kubernetes environment?

For PHP version 7.0 and above

The PHP agent (PHP version 7.0 and above) can be deployed in a Kubernetes environment using any of the following methods.

You can also keep the license keys in a configmap to avoid using them in the deployment files.

Using InitContainers

Refer to this help page to understand the process of integrating the APM Insight PHP agent into your Kubernetes deployment using Init Containers.

Modifying the Dockerfile

Follow the steps given in this help page to achieve the following:

1. Install the PHP agent and S247DataExporter in the same docker container during the image build.
2. Start the DataExporter using an Entry Point Script.

  Instead of using an Entry Point Script, you can modify the Helm chart to start the S247DataExporter.

Helm chart modification to start the S247DataExporter:

1. lifecycle:
2.       postStart:
3.             exec:
4.                   command: ["/bin/bash", "-c", "/opt/S247DataExporter/bin/service.sh start"]

Without modifying the Dockerfile

1. Download and install the PHP agent and S247DataExporter in the postStart lifecycle hook without modifying the Dockerfile.
   
2. Restart the web server and FastCGI Process Manager (FPM).
   
   Note: To restart the web server, use the command /etc/init.d/apache2 reload or kill -USR1 1 for Apache-based servers. If you are using NGINX- or FPM-based servers, include the command kill -USR2 1.
   
   Example:

1. lifecycle:
2.         postStart:
3.             exec:
4.                 command: ["/bin/bash", "-c", "wget -O InstallAgentPHP.sh https://staticdownloads.site24x7.com/apminsight/agents/AgentPHP/linux/InstallAgentPHP.sh && sh InstallAgentPHP.sh -license.key \"licensekey\" -zpa.application_name \"PHP-Application\" && wget -O InstallDataExporter.sh https://staticdownloads.site24x7.com/apminsight/S247DataExporter/linux/InstallDataExporter.sh && sh InstallDataExporter.sh -root -nsvc -license.key \"licensekey\" && pkill -o -USR2 php-fpm"]

For PHP version below 7.0

The PHP agent (PHP version below 7.0) can be deployed in a Kubernetes environment using the following method.

With Helm charts

If you are deploying with Helm, you can include the installation script in the Helm charts file.

Add the following to the template folder or deployment.yaml, or if you prefer to use values.yaml, configure as follows:

1. site24x7:
2.   apikey: <site24x7 license key>
3.   appname: <App name to be shown in APM>
   

Use the following configuration in lifecycle hooks:

1. lifecycle:
2.       preStop:
3.          exec:
4.              command: ["/bin/bash", "-c", "service zpdpsvc stop;"]
5.       postStart:
6.           exec:
7.                command: ["/bin/bash", "-c", "wget https://staticdownloads.site24x7.com/apminsight/scripts/s247apmphpinstall.sh && ./s247apmphpinstall.sh -key={{ .Values.site24x7.apikey }} -appname={{ .Values.site24x7.appname }} ; /etc/init.d/apache2 reload ;" ]

Related articles

How to install various APM Insight agents in a Docker container

Java | .NET | PHP | Node.js | Python

How to install various APM Insight agents in a Kubernetes environment

Java | .NET | Node.js | Python

• Related Articles

• Troubleshooting steps if you don't see any data after installing the PHP agent

  Problem statement: The APM Insight PHP agent has been installed, but no data is displayed in the Site24x7 web client. Troubleshooting steps: Ensure that you have installed both the PHP agent and the S247DataExporter. Check that you have restarted the ...

• Reconfigure APM Insight PHP agent during PHP version upgrade

  If you have upgraded your PHP version and face problems in monitoring after the upgrade, here's how you can resolve it.  In general, APM Insight PHP agent registers with the PHP version present in the server at the time of installation.  So when you ...

• Adding APM Insight Node.js agent in Kubernetes via InitContainers

  To integrate the APM Insight Node.js agent into your Kubernetes applications using InitContainers, follow the steps given below: Step 1: Create an empty volume that will be used to copy the agent files during the initContainers process. Example: ...

• Adding APM Insight Java agent in Kubernetes via InitContainers

  Step 1: Create a secret for the Site24x7 license key in your application namespace. You can obtain the license key from your site24x7 account by navigating to Admin > Developer > Device Key. Example: kubectl create secret generic app-secret ...

• How to uninstall the Site24x7 Kubernetes monitoring agent

  Execute the below commands to uninstall the Site24x7 Kubernetes monitoring agent from your cluster: Deletion command for the DaemonSet agent deployed using a YAML file: kubectl delete -f site24x7-agent.yaml or kubectl delete ds,sa site24x7-agent -n ...