Configuración INI por directorio de PHP

Utilice la sintaxis de los ejemplos del archivo INI cuando su servidor web ofrezca múltiples dominios. Para ver cada uno de estos dominios por separado en New Relic:

1. Para su dominio principal, establezca newrelic.appname = "My Main Domain" en su archivo INI global.

2. Anule el valor de cada uno de los hosts virtuales agregando php_value entradas como parte de la configuración de su host virtual.

   Importante

   Asegúrese de utilizar el nombre de módulo adecuado para su instalación de PHP. Reemplace PHP_MODULE en los ejemplos siguientes con el nombre del módulo PHP5 instalado. Este nombre depende de la distribución de Linux y/o PHP que se utilice. Por ejemplo, los nombres comunes incluyen php5_module, mod_php5, php_module, etc. Las mayúsculas pueden variar.

   Para los servidores Apache, puede encontrar los nombres de los módulos de una de las siguientes maneras. Cada uno generará una lista de módulos instalados.

• Desde la línea de comando, ejecute:

  bash

  Copia

  $
  apachectl -t -D DUMP_MODULES

  OR

• Desde dentro de una página web, utilice:

  <?php
    print_r(apache_get_modules());
  ?>

  Copia

  Configuración del nombre de la aplicación por dominio

  A continuación se muestra un ejemplo de separación de dominios, donde PHP_MODULE es el nombre de su módulo PHP5.

  <VirtualHost 192.168.42.43>
    ServerName www.myvhost1.com
    DocumentRoot "/path/to/vhost1/"
    ...
    <IfModule PHP_MODULE>
      php_value newrelic.appname "Virtual Host 1"
    </IfModule>
  </VirtualHost>
  
  <VirtualHost 192.168.123.45>
    ServerName www.myvhost2.com
    DocumentRoot "/path/to/vhost2/"
    ...
    <IfModule PHP_MODULE>
      php_value newrelic.appname "Virtual Host 2"
    </IfModule>
  </VirtualHost>

  Copia

  En el ejemplo anterior, newrelic.appname se establece en un valor diferente para cada host virtual.

  Para valores de cadena y numéricos, utilice php_value name VALUE, donde:

• name es el nombre de la configuración INI a modificar como se indica en la configuración INI de PHP.

• VALUE es el valor que desea establecer para ese host virtual en particular.

  Asegúrese de incluir los valores de cadena entre comillas ".

  Si desea cambiar una configuración booleana, use la sintaxis php_flag name VALUE, donde name es el nombre de la variable que figura en la configuración INI de PHP y VALUE es on o off.

  Para deshabilitar completamente el agente New Relic para un host virtual, use un indicador booleano:

  <VirtualHost 192.168.56.78>
    ServerName www.myvhost3.com
    DocumentRoot "/path/to/vhost3/"
    ...
    <IfModule PHP_MODULE>
      php_flag newrelic.enabled off
    </IfModule>
  </VirtualHost>

  Copia

Utilice la sintaxis de los ejemplos del archivo INI dentro de un archivo .htaccess . Por ejemplo:

php_value newrelic.appname "My Blog App"

Esto le permite controlar la configuración por directorio desde dentro de los directorios.

En este ejemplo, su servidor web tiene su raíz de documentos en /data/webroot. También tienes dos subdirectorios para aplicaciones especializadas:

• Su

  /data/webroot/blog

  contiene una aplicación de blog.

• Su /data/webroot/shop contiene una aplicación de carrito de compras.

Para que las tres partes de su sitio se informen como aplicaciones distintas en la UI de New Relic:

1. Establezca el nombre de su aplicación principal en su archivo INI.
2. Anule ese nombre utilizando un archivo .htaccess en cada uno de los directorios especializados.

Cualquier parte de su servidor web (por ejemplo, /data/webroot/something) que no tenga un archivo .htaccess específico utilizará el nombre de la aplicación global definido en el archivo INI.

Para obtener más información sobre el uso y la protección de archivos .htaccess , consulte el tutorial del servidor HTTP Apache.

Un pool es un conjunto dedicado de trabajadores secundarios que solo atenderá solicitudes para ese grupo. Debido a que requiere hijos trabajadores dedicados, PHP-FPM escala mal si tiene una gran cantidad de hosts virtuales o aplicaciones para las que desea configurar opciones individuales.

Para configurar PHP-FPM por directorio:

1. Establezca el nombre de la aplicación principal en el archivo INI.

2. Configure dos grupos para las dos aplicaciones adicionales.

3. Anule la configuración del nombre de la aplicación en esos grupos.

   Cada grupo debe tener un mecanismo de conexión único (para que pueda identificar qué grupo usar en el archivo de configuración de su servidor web). A continuación se muestra un ejemplo de php-fpm.conf:

   [app1]
   listen=/tmp/pool-app1.sock
   php_value[newrelic.appname] = "My App 1"
   
   [app2]
   listen=/tmp/pool-app2.sock
   php_value[newrelic.appname] = "My App 2"
   
   [app3]
   listen=/tmp/pool-app3.sock
   php_flag[newrelic.enabled] = off

   Copia

   El formato general de la configuración de las variables por grupo es php_value[name] = VALUE para variables numéricas o de cadena, o php_flag[name] = VALUE para valores booleanos. Siempre coloque los valores de cadena entre comillas ". Los valores booleanos deben ser on o off.

   Una vez configurado el archivo de configuración, se debe indicar al servidor web que utilice los diferentes grupos para diferentes partes del sitio web. Para obtener más información, consulte la documentación de su servidor web.

Puede utilizar la sintaxis del ejemplo del archivo INI para CGI/FastCGI en un archivo .user.ini . Es similar a un archivo .htaccess para Apache pero es exclusivo de PHP-FPM. El directorio en el que se ejecuta PHP se analiza en busca de un archivo .user.ini . Más información sobre esta característica está disponible en la documentación de los archivos PHP user.ini .

Cambie el nombre de la aplicación siguiendo los siguientes pasos en el directorio raíz de la página web.

1. Crea el archivo .user.ini

2. Añade la configuración que deseas cambiar
   newrelic.appname = "New Appname"

3. Guarda el archivo.

   De forma predeterminada, el .user.ini file se lee cada cinco minutos, por lo que no es necesario reiniciar

   Esto es útil en los siguientes escenarios:

4. La configuración del servidor no funciona. En la configuración NGINX/PHP-FPM, puede haber una falta de comunicación entre FastCGI y PHP y la información de
   fastcgi_param PHP_VALUE newrelic.appname="Appname"
   nunca llega a PHP.

5. El .htaccess no funciona, como cuando PHP está implementado con suPHP

Aquí hay un pequeño fragmento de un archivo de configuración de NGINX que muestra el procedimiento general para pasar valores a su administrador FastCGI en función de una ubicación de NGINX.

location /blog {
  fastcgi_param PHP_VALUE "newrelic.appname=My Blog";
  ...
}

location /shop {
  fastcgi_param PHP_VALUE "newrelic.appname=Shopping Cart";
  ...
}

location /admin{
  fastcgi_param PHP_VALUE "newrelic.enabled=false";
  ...
}