Instrumentación basada en SDK

Para instrumentar su Lambda en lenguaje Go:

1. Descargue nuestro paquete de agente Go y colóquelo en el mismo directorio que su función.

   1. Instale el agente ejecutando:

      bash

      Copia

      $
      go get -u github.com/newrelic/go-agent/v3/newrelic

   2. Instale la integración nrlambda ejecutando:

      bash

      Copia

      $
      go get -u github.com/newrelic/go-agent/v3/integrations/nrlambda

2. En su código Lambda, importe nuestros componentes, cree una aplicación y actualice cómo inicia su Lambda. Vea nuestros ejemplos de instrumentación:

   • Repositorio de extensiones
   • Repositorio de agente Go

3. Opcionalmente, agregue un evento personalizado que se asociará con su invocación de Lambda mediante la APIRecordCustomEvent . Por ejemplo:

   func handler(ctx context.Context) {
     if txn := newrelic.FromContext(ctx); nil != txn {
       txn.Application().RecordCustomEvent("MyEvent", map[string]interface{}{
         "zip": "zap",
       })
     }
     fmt.Println("hello world!")
   }

   Copia

4. Cree y comprima su función Lambda y cárguela en AWS.

   Comprime y sube recomendaciones

   Aquí hay sugerencias para comprimir y cargar Lambda:

   1. Compile el binario para su ejecución en Linux. Esto produce un archivo binario llamado main. Puedes usar:

      bash

      Copia

      $
      GOOS=linux go build -o main

   2. Comprima el binario en un paquete desplegable usando:

      bash

      Copia

      $
      zip deployment.zip main

   3. Cargue el archivo zip en AWS mediante la consola de AWS Lambda o la CLI de AWS. Nombra el controlador main (para que coincida con el nombre dado durante la compilación binaria).

5. Para habilitar el rastreo distribuido y configurar las variables ambientales, consulte la documentación de variables ambientales .

6. Invoque Lambda al menos una vez. Esto crea un grupo log de CloudWatch, que debe estar presente para que funcione el siguiente paso.

   Nuestro contenedor recopila datos sobre la ejecución de Lambda, genera un mensaje JSON y lo registra en el log de CloudWatch. A continuación, configurará CloudWatch para enviar esos logs a New Relic.

El monitoreo para AWS Lambda en Java no utiliza nuestro APM agente de Java. En su lugar, utiliza estas dos dependencias de OpenTracing:

• AWS Lambda OpenTracing Java SDK: instrumentación de OpenTracing para AWS Lambda RequestHandler y RequestStreamHandler.

• Nuestro rastreador AWS Lambda OpenTracing: una implementación de rastreador OpenTracing diseñada para monitor AWS Lambda. Genera spans, evento de error, evento de transacción, error traza y brinda soporte de rastreo distribuido.

  Importante

  La versión 3.0.0 de la biblioteca New Relic AWS Lambda OpenTracing Java SDK realizó cambios en las versiones de dependencia de AWS. Actualmente se emplean las siguientes dependencias:

  • com.amazonaws:aws-lambda-java-core:1.2.3 (versión anterior: 1.1.0)

  • com.amazonaws:aws-lambda-java-events:3.15.0 (versión anterior: 2.2.7)

  • software.amazon.awssdk:s3:2.31.43 (reemplaza com.amazonaws:AWS-java-sdk-s3:1.12.771)

  • software.amazon.awssdk:s3-event-notifications:2.31.43 (reemplaza com.amazonaws:AWS-java-sdk-s3:1.12.771)

    Se recomienda que las funciones que emplean el New Relic AWS SDK OpenTracing Lambda de Java empleen las mismas versiones (o superiores) de la AWS biblioteca subyacente como se indicó anteriormente. Las funciones que no se pueden actualizar deben permanecer en la versión 2.2.0 de esta biblioteca.

  Sugerencia

  Supported OpenTracing Versions

  • OpenTracing 0.31.0:

    • Lambda rastreador: com.newrelic.opentracing:newrelic-java-lambda:1.1.1
    • SDK de Lambda: com.newrelic.opentracing:java-aws-lambda:1.0.0

  • OpenTracing 0.32.0, 0.33.0:

    • Lambda rastreador: com.newrelic.opentracing:newrelic-java-lambda:2.2.3
    • Lambda SDK: com.newrelic.opentracing:java-AWS Lambda:2.1.1

  Para instrumentar su Java Lambda:

1. En el archivo build.gradle de su proyecto, incluya nuestro rastreador OpenTracing AWS Lambda y la dependencia del SDK de AWS Lambda OpenTracing:

   dependencies {
       compile("com.newrelic.opentracing:java-aws-lambda:2.1.1")
       compile("com.newrelic.opentracing:newrelic-java-lambda:2.2.3")
       compile("io.opentracing:opentracing-util:0.33.0")
   }

   Copia

2. Implemente la interfaz AWS Lambda RequestHandler como se muestra en el ejemplo de Java Lambda y anule el método doHandleRequest .

3. En el método doHandleRequest , llame a la API LambdaTracing.instrument(...) para crear un intervalo de raíz para trazar la ejecución de la función Lambda. Aquí también es donde definirá su lógica de negocios para la función Lambda.

4. Registre un LambdaTracer.INSTANCE como rastreador de OpenTracing Global, como se muestra en el ejemplo de Java Lambda.

5. Cree un paquete ZIP desplegable y cárguelo en AWS Lambda. O desplegarlo por otros medios.

6. En la consola de AWS Lambda, configure el controlador. Para el ejemplo Java Lambda, el controlador sería com.handler.example.MyLambdaHandler::handleRequest. Como se supone handleRequest , también puedes usar com.handler.example.MyLambdaHandler.

7. Para habilitar el rastreo distribuido y configurar las variables ambientales, consulte la documentación de variables ambientales .

8. Invoque Lambda al menos una vez. Esto crea un grupo log de CloudWatch, que debe estar presente para que funcione el siguiente paso.

   Nuestro contenedor recopila datos sobre la ejecución de Lambda, genera un mensaje JSON y lo registra en el log de CloudWatch. A continuación, configurará CloudWatch para enviar esos logs a New Relic.

   Consulte el ejemplo de rastreo distribuido de AWS Lambda para ver un proyecto completo que ilustra casos de uso comunes como:

• Rastreo distribuido entre función Lambda
• Creación manual de tramos (también conocida como instrumentación personalizada)
• Seguimiento de llamadas externas
• Agregar atributo personalizado (también conocido como etiqueta) a los tramos

Para instrumentar su Lambda Node.js:

1. Descargue nuestro paquete de agente Node.js y colóquelo en el mismo directorio que su función, asegurándose de que el agente esté instalado como una dependencia en el directorio node_modules . Utilice el Nodo administrador de paquetes:

   bash

   Copia

   $
   npm install newrelic --save

2. En su código Lambda, requiera el módulo del agente en la parte superior del archivo y envuelva la función del controlador con newrelic setLambdaHandler. Por ejemplo:

   • Código de muestra para CommonJS:

   const newrelic = require('newrelic');
   
   // Other module loads go under the require statement above
   
   module.exports.handler = newrelic.setLambdaHandler((event, context, callback) => {
     // This is your handler function code
     console.log('Lambda executed');
     callback();
   });

   Copia
   • Código de muestra para el módulo ES:

   import newrelic from 'newrelic';
      // Other module loads go under the require statement above
   
      export const handler = newrelic.setLambdaHandler((event, context, callback) => {
      // This is your handler function code
      console.log('Lambda executed');
      callback();
    });

   Copia

3. Opcional: también puede agregar un evento personalizado a su Lambda mediante la APIrecordCustomEvent . Por ejemplo:

   • Código de muestra para CommonJS:

   module.exports.handler = newrelic.setLambdaHandler((event, context, callback) => {
     newrelic.recordCustomEvent('MyEventType', { foo: 'bar' });
     console.log('Lambda executed');
     callback();
   });

   Copia
   • Código de muestra para el módulo ES:

   export const lambdaHandler = newrelic.setLambdaHandler((event, context, callback) => {
   newrelic.recordCustomEvent('MyEventType', { foo: 'bar' });
   console.log('Lambda executed');
   callback();
   });

   Copia

4. Comprima su función Lambda y la carpeta del agente Node.js juntas. Requisitos y recomendaciones:

   • No es necesario incluir los archivos de New Relic fuera de la carpeta del agente de New Relic.
   • Si el nombre de su archivo de función Lambda es, por ejemplo, lambda_function.node, le recomendamos nombrar su archivo zip lambda_function.zip. No utilice un tarball.
   • Su Lambda y sus módulos asociados deben estar en el directorio raíz del archivo zip. Esto significa que si comprime una carpeta que contiene los archivos, no funcionará.

5. Cargue el archivo comprimido en su cuenta de AWS Lambda.

6. Para habilitar el rastreo distribuido y configurar las variables ambientales, consulte la documentación de variables ambientales .

7. Para completar la instrumentación, siga uno de los siguientes pasos para enviar los telemetry data a New Relic:

   • Emplee la New Relic Lambda Extension layer. Puede obtener la última capa arn (NewRelicLambdaExtension) . Puede emplear AWS CLI para instalar la capa o agregarla manualmente a su Lambda.
   bash

   Copia

   $
   aws lambda update-function-configuration --function-name <your-lambda-function-name> --layers arn:aws:lambda:<aws-region>:451483290750:layer:NewRelicLambdaExtension:<version>

• Emplee el newrelic-log-ingestion. Puede consultar la solución alternativa de CloudWatch para conocer los pasos detallados.

Para instrumentar su Python Lambda:

1. Descargue los paquetes del agente Python y del contenedor Python lambda y colóquelos en el mismo directorio que su código de función. Para hacer esto, emplea pip:

   bash

   Copia

   $
   pip install -t . newrelic newrelic-lambda

   Importante

   Si utiliza Homebrew, puede recibir este error: DistutilsOptionError: must supply either home or prefix/exec-prefix -- not both. Para obtener más información, consulte la publicación de Homebrew en GitHub.

2. En su código Lambda, importe tanto el módulo del agente de Python como el módulo contenedor de Lambda de Python.

3. Decora la función del controlador empleando el decorador New Relic. El paquete New Relic debe importar primero en su código. He aquí un ejemplo:

   import newrelic.agent
   from newrelic_lambda.lambda_handler import lambda_handler
   
   newrelic.agent.initialize()
   
   @lambda_handler()
   def handler(event, context):
     ...

   Copia

4. Opcional: también puede agregar un evento personalizado a su Lambda mediante la APIrecord_custom_event . He aquí un ejemplo:

   @lambda_handler()
   def handler(event, context):
     newrelic.agent.record_custom_event('CustomEvent', {'foo': 'bar'})
     ...

   Copia

5. Comprima sus carpetas lambda_function.py y newrelic/ juntas siguiendo estas pautas:

   • No es necesario incluir los archivos New Relic fuera de la carpeta newrelic/ .
   • Si el nombre de su archivo de función Lambda es, por ejemplo, lambda_function.py, asigne a su archivo zip el nombre lambda_function.zip. No utilice un tarball.
   • Su Lambda y sus módulos asociados deben estar en el directorio raíz del archivo zip. Esto significa que si comprime una carpeta que contiene los archivos, no funcionará.

6. Cargue el archivo comprimido en su cuenta de AWS Lambda.

7. Para habilitar el rastreo distribuido y configurar las variables ambientales, consulte la documentación de variables ambientales .

8. Invoque Lambda al menos una vez. Esto crea un grupo log de CloudWatch, que debe estar presente para que funcione el siguiente paso.

   El decorador de New Relic recopila datos sobre la ejecución de Lambda, genera un mensaje JSON y lo registra en el log de CloudWatch. A continuación, configure CloudWatch para enviar esos logs a New Relic.

En la mayoría de los casos, el agente .NET activará automáticamente su función Lambda AWS y cambiará a un "modo sin servidor" que deshabilitará el envío de datos directamente a New Relic , así como alguna otra característica. Debe emplear la extensión Lambda de New Relic o el método lambda newrelic-log-ingestion para enviar datos a New Relic.

Para instrumentar su .NET Lambda:

1. Agregue el paquete nuget NewRelic.Agente a su proyecto AWS Lambda . Para obtener más información, consulte nuestra guía de instalación.
2. Para habilitar el rastreo distribuido y configurar las variables ambientales, consulte la documentación de variables ambientales .
3. Publique el proyecto en su cuenta de AWS Lambda.
4. Configure la extensión New Relic Lambda o la lambda newrelic-log-ingestion .
5. Invoque Lambda al menos una vez para comprobar si hay errores y cerciorar de que los datos sean visibles en la New Relic UI.