Instrumentación en contenedores

Agregue New Relic a su Dockerfile

New Relic ofrece imágenes prediseñadas que incluyen los diferentes tiempos de ejecución de nuestra capa: Java, Node.js, Python y solo extensión.

1. Seleccione la capa compatible con la región y el tiempo de ejecución de su función Lambda específica:

   • Java
   • Node.js
   • Python
   • Ruby
   • .NET
   • Sólo extensión

2. En su Dockerfile de varias etapas, use la imagen prediseñada de New Relic como etapa de compilación intermedia. Luego, copie el agente y la extensión de New Relic de nuestra imagen prediseñadas en su etapa de compilación final.

   Ejemplos de Dockerfile basados en tiempo de ejecución

   JavaPythonNode.jsRuby.NETSólo extensión

   Java

   Python

   Node.js

   Ruby

   .NET

   Sólo extensión

   # Define the New Relic pre-built image
   FROM public.ecr.aws/newrelic-lambda-layers-for-docker/newrelic-lambda-layers-java:21 AS layer
   
   # Define the base image
   FROM public.ecr.aws/lambda/java:21
   
   # Copy New Relic Layer code
   COPY --from=layer /opt/ /opt/
   
   # Rest of your Dockerfile...
   
   # CMD override to one of New Relic's handler wrappers
   CMD [ "com.newrelic.java.HandlerWrapper::handleRequest" ]
   # CMD [ "com.newrelic.java.HandlerWrapper::handleStreamsRequest" ]

   Copia

   Pruebe un ejemplo práctico de una función Lambda en contenedor de Java empleando SAM.

   # Define the New Relic pre-built image
   FROM public.ecr.aws/newrelic-lambda-layers-for-docker/newrelic-lambda-layers-python:311 AS layer
   
   # Define the base image
   FROM public.ecr.aws/lambda/python:3.11
   
   # Copy New Relic Layer code
   COPY --from=layer /opt/ /opt/
   
   # Rest of your Dockerfile...
   
   # CMD override to New Relic's handler wrapper
   CMD [ "newrelic_lambda_wrapper.handler" ]

   Copia

   Pruebe un ejemplo práctico de una función Lambda en contenedor de Python usando SAM.

   # Define the New Relic pre-built image
   FROM public.ecr.aws/newrelic-lambda-layers-for-docker/newrelic-lambda-layers-nodejs:20 AS layer
   
   # Define the base image
   FROM public.ecr.aws/lambda/nodejs:20
   
   # Copy New Relic Layer code
   COPY --from=layer /opt/ /opt/
   
   # Rest of your Dockerfile...
   
   # CMD override to New Relic's handler wrapper
   CMD [ "newrelic-lambda-wrapper.handler" ]
   # If your lambda function is ESM, use the New Relic's Node.js ESM handler wrapper
   # CMD ["/opt/nodejs/node_modules/newrelic-esm-lambda-wrapper/index.handler"]

   Copia

   Pruebe un ejemplo práctico de una función Lambda en contenedor de Node.js usando SAM.

   # Define the New Relic pre-built image
   FROM public.ecr.aws/newrelic-lambda-layers-for-docker/newrelic-lambda-layers-ruby:33 AS layer
   
   # Define the base image
   FROM public.ecr.aws/lambda/ruby:3.3
   
   # Copy New Relic Layer code
   COPY --from=layer /opt/ /opt/
   
   # Rest of your Dockerfile...
   
   # CMD override to New Relic's handler wrapper
   CMD [ "newrelic_lambda_wrapper.handler" ]

   Copia

   FROM public.ecr.aws/newrelic-lambda-layers-for-docker/newrelic-lambda-layers-dotnet:x86_64 AS layer
   
   # Define the base image
   FROM public.ecr.aws/lambda/dotnet:8
   
   # Copy New Relic Layer code
   COPY --from=layer /opt/ /opt/
   
   # Rest of your Dockerfile...
   
   # CMD override not needed since the dotnet layer does not have a handler wrapper

   Copia

   FROM public.ecr.aws/newrelic-lambda-layers-for-docker/newrelic-lambda-layers-lambdaextension:x86 as layer
   
   # Any lambda base image can be used
   
   # Copy New Relic Layer code
   COPY --from=layer /opt/ /opt/
   
   # Rest of your Dockerfile...
   
   # CMD override not needed since the extension layer does not have an agent

   Copia

Crear una imagen

1. Luego de agregar la referencia a la imagen prediseñada de New Relic a su Dockerfile, deberá crear una nueva imagen a partir del Dockerfile modificado. Esta nueva imagen tendrá su código original y la imagen prediseñadas de New Relic. Para hacer esto, recomendamos seguir los pasos enumerados en la guía de AWS, Crear una función Lambda usando una imagen de contenedor.
2. Envíe la nueva imagen a su repositorio de registro AWS Elastic Container para que la emplee su función.

Crear una nueva función Lambda

Usando la imagen que envió a AWS ECR, cree una nueva función Lambda. Para obtener más información sobre la creación de esta función, recomendamos volver a la guía de AWS: Crear una función Lambda.

Configure su función Lambda

2. Configure la función Lambda con la misma configuración que su función original, pero cerciorar de agregar todas las variables de entorno necesarias para el monitoreo Lambda de New Relic. Consulte nuestras variables de entorno para obtener más información.

3. Actualice el controlador de su función para que apunte a la capa recién anexa en la anulación cmd para su función. Puede hacerlo siguiendo las instrucciones de estos dos documentos:

   • Instrumentación en capas
   • Instrumentación basada en SDK

Buscar y utilizar datos

Luego de instrumentar su función Lambda AWS, puede buscar y usar los datos en la interfaz New Relic APM. Los datos están organizados en varias áreas clave, cada una de las cuales proporciona información valiosa sobre el rendimiento y el estado de su función Lambda.

En la interfaz APM, puede explorar varios aspectos de su función Lambda, incluido el rastreo distribuido, los mapas de servicios, las transacciones y el análisis de errores, y muchos más. Cada una de estas áreas proporciona información detallada y valiosa sobre el rendimiento, la latencia y la tasa de errores de su función Lambda, lo que le permite identificar y resolver problemas rápidamente.

Para ver su función Lambda en la interfaz New Relic APM :

1. Vaya a https://one.newrelic.com > APM & Services.
2. Establezca los criterios de búsqueda como isLambdaFunction = true.
3. De la lista mostrada, seleccione su función Lambda para ver los datos.