Atualizar monitoramento Lambda

Depois de ativar nosso monitoramento para AWS Lambda, você deve atualizar ocasionalmente nossa função do Lambda que é usada para relatar dados de log da AWS: newrelic-log-ingestion.

Existem duas maneiras de fazer isso:

• Atualização via CLI: Use isto se você ativou nosso monitoramento Lambda usando nossa ferramenta CLI.
• Atualização via AWS Serverless Application Repository: Use isto se você habilitou usando o procedimento manual.

Atualize nossa integração Lambda via CLI

Esta seção descreve como atualizar se o monitoramento do Lambda foi ativado usando nossa ferramenta CLI recomendada.

1. Certifique-se de ter a versão mais recente da CLI:

   bash

   Copiar

   $
   pip install --upgrade newrelic-lambda-cli

2. Para cada região em que você instalou a função newrelic-log-ingestion , execute o comando a seguir, substituindo YOUR_REGION pelo identificador de sua região (por exemplo, us-west-2).

   bash

   Copiar

   $
   newrelic-lambda integrations update \
   >
       --aws-region YOUR_REGION

3. Se você não tiver nossos logs habilitados, também precisará atualizar os filtros de assinatura log do Amazon CloudWatch com o seguinte comando:

   bash

   Copiar

   $
   newrelic-lambda subscriptions install \
   >
       --function installed \
   >
       --aws-region YOUR_REGION

Atualizar camadas via CLI

Esta seção descreve como atualizar a camada da sua função se você a instalou com nossa ferramenta CLI.

1. Certifique-se de ter a versão mais recente da CLI:

   bash

   Copiar

   $
   pip install --upgrade newrelic-lambda-cli

2. Passe a sinalização --upgrade para o comando de instalação:

   bash

   Copiar

   $
   newrelic-lambda layers install \
   >
       --function installed \
   >
       --nr-account-id NR_ACCOUNT_ID \
   >
       --upgrade

Atualizar uma instalação manual do repositório de aplicativos Serverless

Se você instalou manualmente a função de ingestão do AWS Serverless Application Repository (e não usou a CLI), atualize usando este procedimento:

1. Execute o seguinte, substituindo YOUR_REGION pela sua região (por exemplo, us-west-2).

   bash

   Copiar

   $
   aws serverlessrepo create-cloud-formation-change-set \
   >
      --application-id arn:aws:serverlessrepo:us-east-1:463657938898:applications/NewRelic-log-ingestion \
   >
      --stack-name NewRelic-log-ingestion \
   >
      --capabilities CAPABILITY_RESOURCE_POLICY \
   >
      --parameter-overrides Name=NRLicenseKey,Value=<YOUR_NR_LICENSE_KEY> \
   >
      --region <YOUR_REGION>

   Este comando gera vários campos, um dos quais é ChangeSetId: um ARN para o conjunto de alterações que você acabou de criar. Copie esse ARN.

2. Use o ARN neste comando, que executa o conjunto de alterações:

   bash

   Copiar

   $
   aws cloudformation execute-change-set --change-set-name YOUR_CHANGE_SET_ARN

Habilitando gerenciamento de logs

Se você atualmente não tem gerenciamento de logsdo New Relic ativado, mas gostaria de:

1. Certifique-se de ter a versão mais recente da CLI:

   bash

   Copiar

   $
   pip install --upgrade newrelic-lambda-cli

2. Para cada região em que você instalou a função newrelic-log-ingestion , execute o comando a seguir, substituindo YOUR_REGION pela sua região (por exemplo, us-west-2).

   bash

   Copiar

   $
   newrelic-lambda integrations update \
   >
       --enable-logs \
   >
       --aws-region YOUR_REGION

3. Em seguida, execute um dos seguintes procedimentos:

   • Atualize os filtros de assinatura de log do Amazon CloudWatch para cada região com o seguinte comando:

     bash

     Copiar

     $
     newrelic-lambda subscriptions install \
     >
         --function installed \
     >
         --filter-pattern "" \
     >
         --aws-region YOUR_REGION

   • Ou você pode enviar o log de função diretamente para o New Relic, ignorando o CloudWatch e o newrelic-log-ingestion Lambda. Para fazer isso, defina a variável de ambiente NEW_RELIC_EXTENSION_SEND_FUNCTION_LOGS=true na configuração da função do Lambda.

     Depois disso, certifique-se de remover qualquer assinatura existente do New Relic Logs para essa função usando este comando:

     bash

     Copiar

     $
     newrelic-lambda subscriptions uninstall \
     >
         --function FUNCTION_NAME \
     >
         --aws-region YOUR_REGION

     Se a assinatura log estiver presente enquanto a extensão estiver enviando o log, o log será enviado duas vezes, resultando em registros log duplicados no New Relic.

     Opcionalmente, se quiser evitar as cobranças da Amazon pela ingestão log do CloudWatch, você também pode modificar a função de execução da sua função para que ela não conceda permissões log do CloudWatch. Isso impedirá que sua função faça logon no CloudWatch.

     Cuidado

     As taxas de ingestão de log do CloudWatch podem ser consideráveis, mas essa etapa deve ser tomada com cautela. Certifique-se de que a integração de ingestão do New Relic Logs esteja funcionando bem e atenda às suas necessidades antes de desabilitar o log do CloudWatch.