Configuración de la supervisión de PHP

Debe configurar el Monitoring Agent for PHP para que el agente pueda recopilar datos de la aplicación PHP que se está supervisando.

Antes de empezar

  1. Asegúrese de instalar el paquete php-process. Si utiliza el mandato yum install para instalar PHP, ejecute el mandato yum install php-process para instalar el paquete php-process.
  2. Asegúrese de que el servidor Apache HTTPD esté iniciado antes de configurar el agente.
    Abra el archivo de configuración httpd.conf del servidor HTTP Apache y asegúrese de que las opciones mod_status y ExtendedStatus On estén habilitadas. Por ejemplo:
    ExtendedStatus On
<Location /server-status>
		SetHandler server-status
		Order deny,allow
		Allow from all
		Allow from 127.0.0.1
</Location>
    En el ejemplo dado, http://127.0.0.1/server-status debe funcionar bien para que el agente funcione adecuadamente.
    Nota: Debe tener Lynx o Links instalado en Linux para que el agente obtenga datos de supervisión.

    Asegúrese de que el mandato apachectl status funciona bien en el servidor Apache supervisado sin cambios de código para el mandato apachectl. Lynx debe estar instalado para que el mandato apachectl status funcione adecuadamente.

Acerca de esta tarea

Para evitar problemas de permisos al configurar el agente, asegúrese de utilizar el mismo ID de usuario root o no root que se utilizó para instalarlo. Si ha instalado el agente mediante un usuario seleccionado y desea configurar el agente mediante un usuario distinto, consulte Configuración de agentes como usuarios no root. Si ha instalado y configurado el agente mediante un usuario seleccionado y desea iniciar el agente mediante un usuario distinto, consulte Inicio de agentes mediante un usuario no root.

El Agente de PHP es un agente de varias instancias; debe crear la primera instancia e iniciar el agente de forma manual. El Nombre de sistema gestionado incluye el nombre de instancia que especifique, por ejemplo, instance_name:nombre_host:pc, donde pc es el código de producto de dos caracteres. El Nombre de sistema gestionado está limitado a 32 caracteres. El nombre de instancia que especifique está limitado a 28 caracteres menos la longitud del nombre de host. Por ejemplo, si especifica PHP2 como nombre de instancia, el nombre de sistema gestionado será PHP2:nombrehost:PJ.
Importante: Si especifica un nombre de instancia largo, el Nombre de sistema gestionado queda truncado y el código de agente no se visualiza correctamente.

Procedimiento

  • Si su entorno es el mismo que los valores predeterminados, puede utilizar la vía de acceso binaria de ejecución, el archivo php.ini predeterminado y el puerto predeterminado para configurar el agente:
    1. Escriba:
      dir_instalación/bin/php-agent.sh config nombre_instancia dir_instalación/samples/php_silent_config.txt
      Donde nombre_instancia es el nombre que desea dar a la instancia y dir_instalación es el directorio de instalación de Agente de PHP. El directorio de instalación predeterminado es /opt/ibm/apm/agent.
    2. Para iniciar el agente, especifique:
      dir_instalación/bin/php-agent.sh start nombre_instancia
  • Para configurar el agente mediante la edición del archivo de respuestas silencioso y la ejecución del script sin interacción, siga estos pasos:
    1. Abra dir_instalación/samples/php_silent_config.txt en un editor de texto.
    2. En Ubicación del binario de ejecución de PHP, puede especificar el directorio en el que está ubicada la ejecución de PHP. La ubicación predeterminada es /usr/local/bin.
    3. En Ubicación del archivo INI de PHP puede especificar el directorio donde se encuentre el archivo php.ini. La ubicación predeterminada es /etc.
    4. En Puerto del , puede especificar el número de puerto del servidor web en el que ejecuta WordPress. El valor predeterminado es 80.
    5. En DocumentRoot de la aplicación, puede especificar la DocumentRoot de la aplicación PHP de WordPress. Utilice dos puntos para separar los registros. Para permitir que el agente busque todos los registros por usted, utilice el valor predeterminado ALL.
    6. Guarde y cierre el archivo php_silent_config.txt y, a continuación, especifique:
      dir_instalación/bin/php-agent.sh config nombre_instancia dir_instalación/samples/php_silent_config.txt
      Donde nombre_instancia es el nombre que desea dar a la instancia y dir_instalación es el directorio de instalación de Agente de PHP. El directorio de instalación predeterminado es /opt/ibm/apm/agent.
    7. Para iniciar el agente, especifique:
      dir_instalación/bin/php-agent.sh start nombre_instancia
  • Para configurar el agente mediante la ejecución del script y las respuestas a las solicitudes, siga estos pasos:
    1. Escriba:
      dir_instalación/bin/php-agent.sh config nombre_instancia
      Donde nombre_instancia es el nombre que desea dar a la instancia y dir_instalación es el directorio de instalación de Agente de PHP.
    2. Cuando se le solicite Editar valores de Monitoring Agent for PHP, especifique 1 para continuar.
    3. Cuando se le solicite la Ubicación del binario de ejecución de PHP, pulse Intro para aceptar la ubicación predeterminada o especifique su propia ubicación.
    4. Cuando se le solicite la Ubicación del archivo INI de PHP, pulse Intro para aceptar la ubicación predeterminada o especificar su propia ubicación.
    5. Cuando se le solicite el Puerto del servidor web, pulse Intro para aceptar el puerto predeterminado o especifique un número de puerto diferente.
    6. Cuando se le solicite la DocumentRoot de aplicación, pulse Intro para aceptar el valor predeterminado o especifique la DocumentRoot de la aplicación WordPress de PHP. Utilice dos puntos para separar los registros.
    7. Para iniciar el agente, especifique:
      dir_instalación/bin/php-agent.sh start nombre_instancia

Resultados

El agente solo evalúa el rendimiento de las peticiones PHP en aplicaciones WordPress. No se evalúan las cargas de CSS y JS. El agente no utiliza argumentos de URL para identificar los URL.

Qué hacer a continuación

Puede verificar que los datos de Agente de PHP se muestran en la Consola de Cloud APM.

Debe asegurarse de que el plugin de WordPress del agente esté activado. Para asegurar la activación, siga los pasos siguientes:
  1. En un navegador web, escriba el siguiente URL: http://nombrehost:puerto/wp-admin/.
  2. Acceda a la página de administración yendo a Plugins > Plugins instalados.
  3. Asegúrese de que el plugin de Agente de PHP esté activado. El plugin de Agente de PHP aparece listado como WordPress Agent. Normalmente el plugin ya está activado. Si no estuviera ya activado, pulse en Activar.