Introdução ao monitoramento do AWS Lambda

À medida que sua organização faz a transição para uma arquitetura de função como serviço (FaaS) com AWS Lambda, compreender e otimizar o desempenho da função torna-se fundamental para garantir uma experiência do usuário contínua e eficiente. Cada invocação do Lambda representa um potencial gargalo ou oportunidade de melhoria.

A instrumentação da New Relic para AWS Lambda fornece visibilidade profunda do funcionamento interno de suas funções. Ao adicionar o agente New Relic à sua função, cada vez que sua função é invocada, o New Relic também o é. Você pode obter insights sobre as principais métricas de desempenho, como duração, partidas a frio, exceções e rastreamentos.

Este documento explica a arquitetura de monitoramento Lambda da New Relic e orienta você na vinculação de suas contas da AWS e da New Relic. Você deve vincular suas contas antes de poder instrumentar suas funções.

Como funciona a instrumentação Lambda

Estes são os elementos essenciais da instrumentação AWS Lambda com New Relic:

• Sua função: sua função é o código que você deseja entender. Você quer saber quando ele encontra erros, por que está lento ou com que frequência é invocado.

• O agente ou SDK do New Relic : Dependendo da linguagem em que sua função foi escrita, New Relic fornece diferentes agentes ou SDKs. O trabalho deles é fazer o monitoramento real do seu código. Ele mede a duração das invocações de suas funções, observa os erros que ocorrem, registra detalhes sobre o evento de origem e as respostas de suas funções. Para fazer isso, ele precisa envolver sua função de manipulador de invocação do Lambda.

• A extensão New Relic Lambda: Quando você instrumenta a extensão New Relic Lambda em sua função, ela será executada dentro do ambiente de execução Lambda, junto com seu código. Ele aprimora a telemetria que o agente coleta e envia para o backend da New Relic em lotes. Ele também pode enviar o log da sua função para New Relic. Você não precisa da extensão Lambda para monitor sua função com New Relic.

Escolha seu método de envio

Existem três maneiras de enviar sua telemetria New Relic AWS Lambda. O método de envio que você escolher depende de suas necessidades de dados.

• Custo: A maneira mais econômica de usar AWS Lambda é usando qualquer uma de nossas camadas, que inclui a extensão Lambda. Por padrão, nossa extensão nunca envia dados para o AWS CloudWatch.

• Confiabilidade: você pode enviar seus dados somente pelo CloudWatch. Para fazer isso, você desabilitará a extensão Lambda do New Relic. Isso significa que sua função do Lambda será mais leve e não terá nenhum processo adicional em execução quando for invocada. Nesse caso, o log e a carga serão enviados ao New Relic por meio do CloudWatch em vez da extensão.

• O melhor dos dois mundos: usar a extensão com o AWS CloudWatch como alternativa ajuda a manter os custos baixos e, ao mesmo tempo, fornece proteção contra falhas caso haja um problema com a extensão.

Mostraremos como instrumentar sua função do Lambda usando cada método em nossos documentos de instrumentação:

• instrumento sua função conteinerizada do Lambda

• instrumento sua função não-containerizada do Lambda

• instrumento sua função layerless do Lambda

Antes de você começar

Antes de habilitar o monitoramento Serverless usando nossa camada Lambda, você precisará de:

1. Uma conta New Relic com função de administrador ou com a função complementar de gerente de infraestrutura .

2. Um chave de usuário.

3. Uma conta AWS com permissões para criar recursos IAM, segredos gerenciados e Lambdas. Você também precisa de permissões para criar pilha do CloudFormation e buckets S3.

Então você precisará concluir o seguinte:

1. Instale o AWS CLI v2 e configure usando aws configure. Você precisará de um AWS Access Key ID e de uma AWS Secret Access Key.

2. Instale o Python versão 3.3 ou superior.

3. Instale o newrelic-lambda CLI. Para instalá-lo, execute este comando:

   bash

   Copiar

   $
   pip3 install newrelic-lambda-cli

4. Por padrão, usamos a política gerenciada pela AWS ReadOnlyAccess. Isso permite que a integração da infraestrutura veja todos os recursos da sua conta, e não apenas a sua função do Lambda e as métricas do CloudWatch. New Relic recomenda este padrão, mas entendemos que algumas organizações preferem uma postura de segurança rigorosa para integração de terceiros. Se você quiser limitar o acesso do New Relic, a função IAM pode ser concedida com um mínimo destas permissões:

Resource: "*"
  Action:
    - "cloudwatch:GetMetricStatistics"
    - "cloudwatch:ListMetrics"
    - "cloudwatch:GetMetricData"
    - "lambda:GetAccountSettings"
    - "lambda:ListFunctions"
    - "lambda:ListAliases"
    - "lambda:ListTags"
    - "lambda:ListEventSourceMappings"

5. Antes de executar a CLI, você precisará conceder à New Relic um mínimo destas permissões na AWS:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "CLIAccessPolicy",
      "Action": [
        "cloudformation:CreateChangeSet",
        "cloudformation:CreateStack",
        "cloudformation:DescribeStacks",
        "cloudformation:ExecuteChangeSet",
        "iam:AttachRolePolicy",
        "iam:CreateRole",
        "iam:GetRole",
        "iam:PassRole",
        "lambda:AddPermission",
        "lambda:CreateFunction",
        "lambda:GetFunction",
        "logs:DeleteSubscriptionFilter",
        "logs:DescribeSubscriptionFilters",
        "logs:PutSubscriptionFilter",
        "s3:GetObject",
        "serverlessrepo:CreateCloudFormationChangeSet",
        "secretsmanager:CreateSecret"
      ],
      "Effect": "Allow",
      "Resource": "*"
    },
    {
      "Sid": "NRLogAccessPolicy",
      "Effect": "Allow",
      "Action": [
        "serverlessrepo:CreateCloudFormationTemplate",
        "serverlessrepo:GetCloudFormationTemplate"
      ],
      "Resource": "arn:aws:serverlessrepo:us-east-1:463657938898:applications/NewRelic-log-ingestion"
    }
  ]
}

Se quiser saber mais sobre nossa CLI, consulte nosso repositório CLI.

Tempos de execução de linguagem AWS Lambda recomendados

Recomendamos os seguintes tempos de execução:

• Node.js: nodejs16.x, nodejs18.x, nodejs20.x, nodejs22.x
• Python: python3.8, python3.9, python3.10, python3.11, python3.12, python3.13
• Vá: provided.al2, provided.al2023
• Java: java8.al2, java11, java17, java21
• Ruby: ruby3.2, ruby3.3
• .NET: dotnet6, dotnet8

Considere os custos

Ativar o monitoramento Serverless para AWS Lambda pode resultar em cobranças da Amazon Web Services. Nossa newrelic-log-ingestion função do Lambda, que nos reporta seus dados Lambda, é considerada um serviço de terceiros: as cobranças AWS resultantes de seu uso são de sua responsabilidade.

Se você usar nossa extensão newrelic-lambda incluída em nossas Camadas LambdaNew Relic , poderá evitar o envio de log e telemetria via CloudWatch e a função newrelic-log-ingestion . Também é possível configurar a função newrelic-log-ingestion como um método de fallback do CloudWatch para funções que exigem alta disponibilidade de dados de observabilidade.

Instalar monitoramento Lambda

O monitoramento Lambda inclui:

• Uma integração AWS para ingerir métricas do CloudWatch e realizar síntese de entidades dentro New Relic.
• Um agente New Relic operando no modo "sem servidor", incluído em nossas Camadas Lambda New Relic ou em sua implantação.
• Um método de envio de cargas úteis "instrumentadas" e, opcionalmente, logs para o New Relic por meio de nossa função newrelic-log-ingestion ou extensão, também incluída em nossas camadas Lambda do New Relic.

$
newrelic-lambda integrations install --nr-account-id YOUR_NR_ACCOUNT_ID \
>
--nr-api-key YOUR_NEW_RELIC_USER_KEY

Resolução de problemas

Se você tiver problemas instrumentados em sua função do Lambda, aqui estão algumas dicas comuns de resolução de problemas:

FROM AwsLambdaInvocation
SELECT count (*)
SINCE 30 days ago
WHERE entityGuid = 'ENTITY_GUID'
LIMIT 1

Failed to retrieve license key AccessDeniedException: User: <ARN> is not authorized to perform: secretsmanager:GetSecretValue on resource: <ARN>

Qual é o próximo