Docker y otros entornos de contenedores: instale el agente PHP

Puede instalar el agente PHP en un contenedor Docker u otro contenedor para monitor una o más de sus aplicaciones PHP. Esto es compatible con contenedores que cumplen con los requisitos y la compatibilidad del agente PHP estándar.

Opciones de contenedor

El agente PHP requiere dos componentes para funcionar: el agente PHP (uno para cada aplicación) y un daemon, que agrega datos enviados desde uno o más agentes y los envía a New Relic. Por este motivo, existen dos opciones para habilitar el agente PHP para entornos contenedor:

• Instale el agente y daemon en contenedores diferentes. Esta es la configuración recomendada.
• Instale el agente y daemon en el mismo contenedor. Esto puede resultar útil si desea reducir el número de contenedores.

Instale el agente y daemon en contenedores diferentes

La instalación del agente y daemon en contenedores diferentes se admite en las versiones PHP Agnet 9.2 y superiores.

Para ver una aplicación de ejemplo, vaya al Foro de soporte de New Relic. Si está utilizando contenedores de aplicaciones de corta duración, le recomendamos que utilice un contenedor separado para el daemon del agente PHP.

Configurar el contenedor daemon

Si usa Docker, puede extraer nuestra imagen de daemon desde docker Hub:

1. Ejecute este comando: docker pull newrelic/php-daemon.
2. Para personalizar la imagen, siga los pasos en Docker Hub.

También puedes crear tu propia imagen daemon :

1. Para instalar el daemon, descargue el paquete del agente PHP desde el sitio de descarga de archivos tar de New Relic y ejecute el script newrelic-install con el argumento install_daemon.
2. Inicie el daemon usando los argumentos --address y --watchdog-foreground.

El argumento --address establece un puerto para que el daemon acepte conexiones. El argumento --watchdog-foreground garantiza que el daemon se ejecute en primer plano.

Configurar el contenedor del agente PHP

Para configurar el contenedor del agente PHP para Docker:

1. Asegúrese de que haya una instalación de PHP disponible en el contenedor. Por ejemplo, utilice una imagen Docker publicada como php:7.1.

2. Para instalar el agente, descargue el paquete del agente PHP desde el sitio de descarga de archivos tar de New Relic y ejecute el script newrelic-install con el argumento install .

3. En el archivo newrelic.ini , configure el nombre de la aplicación y

   clave de licencia

   con las entradas newrelic.appname y newrelic.license .

4. Dirija al agente al daemon configurando la opción newrelic.daemon.address en el archivo newrelic.ini. Asegúrese de que el valor de esta opción sea HOST:PORT, donde HOST es el nombre o la dirección IP del host donde se ejecuta el daemon y PORT es el número de puerto donde el daemon está escuchando.

Instalar agente y daemon en el mismo contenedor

Para configurar el agente PHP y daemon en el mismo contenedor Docker :

1. Asegúrese de que haya una instalación de PHP disponible en el contenedor. Por ejemplo: podrías usar una imagen Docker publicada como php:7.1.

2. Para instalar el agente, descargue el paquete del agente PHP desde el sitio de descarga de archivos tar de New Relic y ejecute el script newrelic-install con el argumento install .

3. Establezca el nombre de la aplicación y

   clave de licencia

   mediante las entradas newrelic.license y newrelic.appname en el archivo newrelic.ini .

FROM php:7.1

RUN \
  curl -L PHP_AGENT_URL | tar -C /tmp -zx && \
  export NR_INSTALL_USE_CP_NOT_LN=1 && \
  export NR_INSTALL_SILENT=1 && \
  /tmp/newrelic-php5-*/newrelic-install install && \
  rm -rf /tmp/newrelic-php5-* /tmp/nrinstall* && \
  sed -i \
      -e 's/"REPLACE_WITH_REAL_KEY"/"YOUR_LICENSE_KEY"/' \
      -e 's/newrelic.appname = "PHP Application"/newrelic.appname = "YOUR_APPLICATION_NAME"/' \
      -e 's/;newrelic.daemon.app_connect_timeout =.*/newrelic.daemon.app_connect_timeout=15s/' \
      -e 's/;newrelic.daemon.start_timeout =.*/newrelic.daemon.start_timeout=5s/' \
      /usr/local/etc/php/conf.d/newrelic.ini