Instale el agente Node.js para docker

Puede utilizar nuestro agente Node.js para implementar la aplicación Node.js en el contenedor docker . Este documento explica cómo construir, configurar y desplegar su aplicación Dockerizada Node.js que ha sido instrumentada con New Relic.

Instrumento tu contenedor

Con solo unas pocas adiciones, su Dockerfile existente se puede utilizar con nuestro agente Node.js. Configurará el agente ejecutando su nueva imagen docker con las variables de entorno configuradas.

1. Añade newrelic a tu package.json:

   "newrelic": "latest",

   Copia

   Instale una versión específica o utilice cualquiera de las otras opciones proporcionadas por el formatopackage.json . Consulte las notas de la versión del agente Node.js para obtener información sobre versiones anteriores del agente.

2. Dependiendo de cómo esté configurado su contenedor, puede editar el ENTRYPOINT para incluir el módulo newrelic primero con el indicador -r/--require de Node.js ejecutando node -r newrelic YOUR_PROGRAM.js. Si no puede controlar cómo se ejecuta su programa, puede cargar el módulo newrelic antes que cualquier otro módulo en su programa agregando require('newrelic').

   Para Next.js utilice @newrelic/next en lugar de newrelic.

   Sugerencia

   Si tiene un script npm para ejecutar su programa, como npm start, puede modificar este script mediante programación ejecutando npm pkg set scripts.start="node -r newrelic your-program.js".

   Importante

   Si su agente Node.js es anterior a la versión 7.2.0 , deberá agregar la variable de entorno NEW_RELIC_NO_CONFIG_FILE=true a su Dockerfile para que el agente pueda ejecutarse sin un archivo de configuración. Puede encontrar más información sobre nuestros ajustes de configuración y el orden de precedencia aquí.

3. Cree su imagen docker como lo hace normalmente.

4. Para ejecutar su aplicación docker con el agente habilitado, agregue su clave de licenciay el nombre de la aplicación a su comando docker run como variables de entorno:

   bash

   Copia

   $
   docker run -e NEW_RELIC_LICENSE_KEY=YOUR_LICENSE_KEY \
   >
          -e NEW_RELIC_APP_NAME="YOUR_APP_NAME" \
   >
          YOUR_IMAGE_NAME:latest

Otras opciones de configuración

Además de configurar el nombre de su aplicación o la clave de licencia, puede configurar otras opciones de configuración iniciando su contenedor con la opción -e . Por ejemplo, para habilitar rastreo distribuido, use:

$
docker run -e NEW_RELIC_LICENSE_KEY=YOUR_LICENSE_KEY \
>
        -e NEW_RELIC_APP_NAME="YOUR_APP_NAME" \
>
        -e NEW_RELIC_DISTRIBUTED_TRACING_ENABLED=true \
>
        YOUR_IMAGE_NAME:latest

También puede establecer opciones de configuración en su Dockerfile usando directivas ENV :

ENV NEW_RELIC_DISTRIBUTED_TRACING_ENABLED=true \
    NEW_RELIC_LOG=stdout
    # etc.