Instrumentação baseada em SDK

Para instrumentar seu Lambda da linguagem Go:

1. Baixe nosso pacote de agente Go e coloque-o no mesmo diretório da sua função.

   1. Instale o agente executando:

      bash

      Copiar

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

   2. Instale a integração nrlambda executando:

      bash

      Copiar

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

2. Em seu código Lambda, importe nossos componentes, crie um aplicativo e atualize como você inicia seu Lambda. Veja nossos exemplos de instrumentação:

   • Repositório de extensão
   • Repositório do agente Go

3. Opcionalmente, adicione o evento personalizado que será associado à invocação do Lambda usando a APIRecordCustomEvent . Por exemplo:

   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!")
   }

   Copiar

4. Crie e compacte sua função do Lambda e carregue-a na AWS.

   Recomendações de compactação e upload

   Aqui estão sugestões para compactar e fazer upload do Lambda:

   1. Construa o binário para execução no Linux. Isso produz um arquivo binário chamado main. Você pode usar:

      bash

      Copiar

      $
      GOOS=linux go build -o main

   2. Compacte o binário em um pacote de implantação usando:

      bash

      Copiar

      $
      zip deployment.zip main

   3. Faça upload do arquivo zip para a AWS usando o console do AWS Lambda ou a AWS CLI. Nomeie o manipulador main (para corresponder ao nome fornecido durante a compilação binária).

5. Para habilitar distributed tracing e configurar variáveis de ambiente, consulte a documentação das variáveis de ambiente .

6. Invoque o Lambda pelo menos uma vez. Isso cria um grupo log do CloudWatch, que deve estar presente para que a próxima etapa funcione.

   Nosso wrapper coleta dados sobre a execução do Lambda, gera uma mensagem JSON e registra-a no log do CloudWatch. A seguir, você configurará o CloudWatch para enviar esses logs para o New Relic.

O monitoramento do AWS Lambda em Java não usa nosso agente Java APM. Em vez disso, ele usa estas duas dependências do OpenTracing:

• AWS Lambda OpenTracing Java SDK: instrumentação OpenTracing para AWS Lambda RequestHandler e RequestStreamHandler.

• Nosso tracer AWS Lambda OpenTracing: uma implementação tracer OpenTracing projetada para monitor o AWS Lambda. Ele gera spans, eventos de erro, eventos de transação, rastreamento de erros e fornece suporte distributed tracing .

  Importante

  A versão 3.0.0 da biblioteca New Relic AWS Lamdba OpenTracing Java SDK fez alterações nas versões de dependência de AWS. As seguintes dependências são usadas agora:

  • com.amazonaws:aws-lambda-java-core:1.2.3 (versão anterior: 1.1.0)

  • com.amazonaws:aws-lambda-java-events:3.15.0 (versão anterior: 2.2.7)

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

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

    É recomendável que as funções que utilizam o New Relic AWS Lamdba OpenTracing Java SDK utilizem as mesmas versões (ou versões superiores) da biblioteca subjacente AWS , conforme observado acima. As funções que não podem ser atualizadas devem permanecer na versão 2.2.0 desta biblioteca.

  Dica

  Supported OpenTracing Versions

  • OpenTracing 0.31.0:

    • Tracer Lambda: com.newrelic.opentracing:newrelic-java-lambda:1.1.1
    • SDK do Lambda: com.newrelic.opentracing:java-AWS Lambda:1.0.0

  • OpenTracing 0.32.0, 0.33.0:

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

  Para instrumentar seu Java Lambda:

1. No arquivo build.gradle do seu projeto, inclua nosso tracer OpenTracing AWS Lambda e a dependência do AWS Lambda OpenTracing SDK:

   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")
   }

   Copiar

2. Implemente a interface RequestHandler do AWS Lambda conforme mostrado no exemplo do Java Lambda e substitua o método doHandleRequest .

3. No método doHandleRequest, chame a API LambdaTracing.instrument(...) para criar um intervalo raiz para trace a execução da função do Lambda. É aqui também que você definirá sua lógica de negócio para a função do Lambda.

4. Registre um LambdaTracer.INSTANCE como o rastreador OpenTracing Global, conforme mostrado no exemplo do Java Lambda.

5. Crie um pacote de implantação ZIP e carregue-o no AWS Lambda. Ou implantá-lo por outros meios.

6. No console do AWS Lambda, defina o manipulador. Para o exemplo Java Lambda, o manipulador seria com.handler.example.MyLambdaHandler::handleRequest. Como handleRequest é assumido, você também pode usar com.handler.example.MyLambdaHandler.

7. Para habilitar distributed tracing e configurar variáveis de ambiente, consulte a documentação das variáveis de ambiente .

8. Invoque o Lambda pelo menos uma vez. Isso cria um grupo log do CloudWatch, que deve estar presente para que a próxima etapa funcione.

   Nosso wrapper coleta dados sobre a execução do Lambda, gera uma mensagem JSON e registra-a no log do CloudWatch. A seguir, você configurará o CloudWatch para enviar esses logs para o New Relic.

   Consulte o exemplo distributed tracing do AWS Lambda para ver um projeto completo que ilustra casos de uso comuns, como:

• Distributed tracing entre função do Lambda
• Criação manual de span (também conhecida como instrumentação personalizada)
• Rastreando chamadas externas
• Adicionando atributo personalizado (também conhecido como tag) aos spans

Para instrumentar seu Node.js Lambda:

1. Faça download do nosso pacote de agente Node.js e coloque-o no mesmo diretório da sua função, garantindo que o agente seja instalado como uma dependência no diretório node_modules . Use o gerenciador de pacote Node:

   bash

   Copiar

   $
   npm install newrelic --save

2. No seu código Lambda, exija o módulo do agente no topo do arquivo e envolva a função do manipulador com o newrelic setLambdaHandler. Por exemplo:

   • Código de exemplo 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();
   });

   Copiar
   • Código de exemplo para ES Module:

   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();
    });

   Copiar

3. Opcional: você também pode adicionar eventos personalizados ao seu Lambda usando a APIrecordCustomEvent . Por exemplo:

   • Código de exemplo para CommonJS:

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

   Copiar
   • Código de exemplo para o ES Module:

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

   Copiar

4. Compacte sua função do Lambda e a pasta do agente Node.js. Requisitos e recomendações:

   • Os arquivos New Relic fora da pasta do agente New Relic não precisam ser incluídos.
   • Se o nome do arquivo da função do Lambda for, por exemplo, lambda_function.node, recomendamos nomear seu arquivo zip lambda_function.zip. Não use um tarball.
   • Seu Lambda e seus módulos associados devem estar todos no diretório raiz do arquivo zip. Isso significa que se você compactar uma pasta que contém os arquivos, não funcionará.

5. Carregue o arquivo compactado em sua conta do AWS Lambda.

6. Para habilitar distributed tracing e configurar variáveis de ambiente, consulte a documentação das variáveis de ambiente .

7. Para concluir a instrumentação, siga uma das seguintes etapas para enviar os dados de telemetria para o New Relic:

   • Use o Lambda New Relic Extension layer. Você pode obter a camada mais recente (NewRelicLambdaExtension) arn. Você pode usar a AWS CLI para instalar a camada ou adicioná-la manualmente ao seu Lambda.
   bash

   Copiar

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

• Use o newrelic-log-ingestion. Você pode consultar o fallback do CloudWatch para obter etapas detalhadas.

Para instrumentar seu Python Lambda:

1. Baixe os pacotes do agente Python e do wrapper lambda do Python e coloque-os no mesmo diretório do código de função. Para fazer isso, use pip:

   bash

   Copiar

   $
   pip install -t . newrelic newrelic-lambda

   Importante

   Se você usa o Homebrew, poderá receber este erro: DistutilsOptionError: must supply either home or prefix/exec-prefix -- not both. Para obter detalhes, consulte a postagem do Homebrew GitHub.

2. No seu código Lambda, importe o módulo do agente Python e o módulo wrapper lambda do Python.

3. Decore a função do manipulador usando o decorador New Relic. O pacote New Relic deve ser importado primeiro em seu código. Aqui está um exemplo:

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

   Copiar

4. Opcional: você também pode adicionar eventos personalizados ao seu Lambda usando a APIrecord_custom_event . Aqui está um exemplo:

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

   Copiar

5. Compacte suas pastas lambda_function.py e newrelic/ usando estas diretrizes:

   • Os arquivos New Relic fora da pasta newrelic/ não precisam ser incluídos.
   • Se o nome do arquivo da função do Lambda for, por exemplo, lambda_function.py, nomeie seu arquivo zip lambda_function.zip. Não use um tarball.
   • Seu Lambda e seus módulos associados devem estar todos no diretório raiz do arquivo zip. Isso significa que se você compactar uma pasta que contém os arquivos, não funcionará.

6. Carregue o arquivo compactado em sua conta do AWS Lambda.

7. Para habilitar distributed tracing e configurar variáveis de ambiente, consulte a documentação das variáveis de ambiente .

8. Invoque o Lambda pelo menos uma vez. Isso cria um grupo log do CloudWatch, que deve estar presente para que a próxima etapa funcione.

   O decorador New Relic coleta dados sobre a execução do Lambda, gera uma mensagem JSON e registra-a no log do CloudWatch. Em seguida, configure o CloudWatch para enviar esses logs para o New Relic.

Na maioria dos casos, o agente .NET irá instrumentar automaticamente sua função AWS do Lambda e mudar para um "modo serverless" que desabilitará o envio de dados diretamente para o New Relic bem como algum outro recurso. Você deve usar a extensão Lambda da New Relic ou o método lambda newrelic-log-ingestion para enviar dados para a New Relic.

Para instrumentar seu .NET Lambda:

1. Adicione o pacote nuget NewRelic.Agente ao seu projeto AWS Lambda . Para obter mais informações, consulte nosso guia de instalação.
2. Para habilitar distributed tracing e configurar variáveis de ambiente, consulte a documentação das variáveis de ambiente .
3. Publique o projeto em sua conta do AWS Lambda.
4. Configure a extensão New Relic Lambda ou o lambda newrelic-log-ingestion .
5. Invoque o Lambda pelo menos uma vez para verificar se há erros e garantir que os dados estejam visíveis na interface New Relic .