Selecione suas preferências de cookies

Usamos cookies essenciais e ferramentas semelhantes que são necessárias para fornecer nosso site e serviços. Usamos cookies de desempenho para coletar estatísticas anônimas, para que possamos entender como os clientes usam nosso site e fazer as devidas melhorias. Cookies essenciais não podem ser desativados, mas você pode clicar em “Personalizar” ou “Recusar” para recusar cookies de desempenho.

Se você concordar, a AWS e terceiros aprovados também usarão cookies para fornecer recursos úteis do site, lembrar suas preferências e exibir conteúdo relevante, incluindo publicidade relevante. Para aceitar ou recusar todos os cookies não essenciais, clique em “Aceitar” ou “Recusar”. Para fazer escolhas mais detalhadas, clique em “Personalizar”.

Tipos de métricas para funções do Lambda

Modo de foco
Tipos de métricas para funções do Lambda - AWS Lambda

Esta seção descreve os tipos de métricas do Lambda disponíveis no console do CloudWatch.

Métricas de invocação

As métricas de invocação são indicadores binários do resultado de uma invocação da função do Lambda. Confira essas métricas com a estatística Sum. Por exemplo, se a função retornar um erro, o Lambda enviará a métrica Errors com um valor de 1. Para obter uma contagem do número de erros de função que ocorrem a cada minuto, visualize o Sum da métrica Errors com o período de 1 minuto.

  • Invocations: o número de vezes em que o código da sua função foi chamado, incluindo invocações bem-sucedidas e invocações que resultem em um erro de função. As invocações não serão registradas se a solicitação de invocação tiver controle de utilização ou se resultar em erro de invocação. O valor de Invocations é igual ao número de solicitações faturadas.

  • Errors: o número de invocações que resultam em um erro de função. Os erros de função incluem exceções emitidas pelo código e exceções emitidas pelo runtime do Lambda. O runtime retorna um erro para problemas como tempos limite e erros de configuração. Para calcular a taxa de erro, divida o valor de Errors pelo valor de Invocations. Observe que o timestamp em uma métrica de erro reflete quando a função foi chamada, não quando o erro ocorreu.

  • DeadLetterErrors: para a invocação assíncrona, o número de vezes em que o Lambda tenta enviar um evento para uma fila de mensagens não entregues (DLQ), mas falha. Os erros de mensagens não entregues podem ocorrer devido a recursos configurados incorretamente ou limites de tamanho.

  • DestinationDeliveryFailures: para invocação assíncrona e mapeamentos da origem do evento compatíveis, o número de vezes em que o Lambda tenta enviar um evento a um destino, mas falha. Para mapeamentos da origem do evento, o Lambda oferece suporte a origens de fluxo (DynamoDB e Kinesis). Os erros de entrega podem ocorrer devido a erros de permissão, recursos configurados incorretamente ou limites de tamanho. Os erros também podem acontecer se o destino que você configurou incluir um tipo incompatível, como uma fila do Amazon SQS FIFO ou um tópico do Amazon SNS FIFO.

  • Throttles: o número de solicitações de invocação que são limitadas. Quando todas as instâncias da função estão processando solicitações e nenhuma simultaneidade está disponível para aumento de escala vertical, o Lambda rejeita solicitações adicionais com um erro TooManyRequestsException. As solicitações limitadas e outros erros de invocação não contam como Invocations ou Errors.

  • OversizedRecordCount: para origens de eventos do Amazon DocumentDB, o número de eventos que sua função recebe do stream de alterações com mais de 6 MB de tamanho. O Lambda descarta a mensagem e emite essa métrica.

  • ProvisionedConcurrencyInvocations: o número de vezes em que o código da sua função é invocado em simultaneidade provisionada.

  • ProvisionedConcurrencySpilloverInvocations: o número de vezes em que o código da sua função é invocado usando a simultaneidade padrão quando toda a simultaneidade provisionada está em uso.

  • RecursiveInvocationsDropped: o número de vezes em que o Lambda interrompeu a invocação da função porque detectou que ela faz parte de um loop recursivo infinito. A detecção de loop recursivo monitora quantas vezes uma função é invocada como parte de uma cadeia de solicitações rastreando os metadados adicionados pelos AWS SDKs compatíveis. Por padrão, se a função for invocada aproximadamente 16 vezes como parte de uma cadeia de solicitações, o Lambda descartará a próxima invocação. Se você desativar a detecção de loop recursivo, essa métrica não será emitida. Para obter mais informações sobre esse atributo, consulte Usar a detecção de loop recursivo do Lambda para evitar loops infinitos.

Métricas de performance

As métricas de performance fornecem detalhes de performance sobre uma única invocação de função. Por exemplo, a métrica Duration indica a quantidade de tempo, em milissegundos, que a função gasta processando um evento. Para ter uma ideia da velocidade de processamento de eventos da função, visualize essas métricas com a estatística Average ou Max.

  • Duration: quantidade de tempo que o código da função gasta processando um evento. A duração faturada de uma invocação é o valor da Duration arredondado para o milissegundo mais próximo. A Duration não inclui o tempo de inícialização a frio.

  • PostRuntimeExtensionsDuration: a quantidade cumulativa de tempo que o runtime gasta executando o código para extensões após a conclusão do código de função.

  • IteratorAge: para origens de eventos do DynamoDB, Kinesis e Amazon DocumentDB, a data do último registro no evento em milissegundos. Essa métrica mede o tempo transcorrido entre quando um  stream recebe o registro e quando o mapeamento da origem do evento envia o evento à função.

  • OffsetLag: para origens de eventos do Apache Kafka autogerenciado e do Amazon Managed Streaming for Apache Kafka (Amazon MSK), a diferença de deslocamento entre o último registro gravado em um tópico e o último registro que o grupo de consumidores da sua função processou. Embora um tópico do Kafka possa ter várias partições, essa métrica mensura o atraso de deslocamento no nível do tópico.

Duration também é compatível com estatísticas de percentil (p). Use os percentis para excluir valores discrepantes que distorcem estatísticas Average e Maximum. Por exemplo, a estatística p95 mostra a duração máxima de 95% das invocações, excluindo as 5% mais lentas. Para obter mais informações, consulte Percentis no Guia do usuário do Amazon CloudWatch.

Métricas de simultaneidade

O Lambda relata métricas de simultaneidade como uma contagem agregada do número de instâncias que estão processando eventos em uma função, uma versão, um alias ou uma Região da AWS. Para ver se você está próximo de atingir os limites de simultaneidade, visualize essas métricas com a estatística Max.

  • ConcurrentExecutions: o número de instâncias da função que estão processando eventos. Se esse número atingir a cota de execuções simultâneas para a região ou o limite de simultaneidade reservada na função, o Lambda controlará a utilização de solicitações de invocação adicionais.

  • ProvisionedConcurrentExecutions: o número de instâncias da função que estão processando eventos usando a simultaneidade provisionada. Para cada invocação de um alias ou versão com simultaneidade provisionada, o Lambda emite a contagem atual. Se sua função estiver inativa ou não estiver recebendo solicitações, o Lambda não emitirá essa métrica.

  • ProvisionedConcurrencyUtilization: para uma versão ou um alias, o valor de ProvisionedConcurrentExecutions dividido pela quantidade total de simultaneidade provisionada configurada. Por exemplo, se você configurar uma simultaneidade provisionada de 10 para sua função e seu ProvisionedConcurrentExecutions for 7, seu ProvisionedConcurrencyUtilization será 0,7.

    Se sua função estiver inativa ou não estiver recebendo solicitações, o Lambda não emitirá essa métrica porque ela se baseia em ProvisionedConcurrentExecutions. Lembre-se disso se você usa ProvisionedConcurrencyUtilization como base para os alarmes do CloudWatch.

  • UnreservedConcurrentExecutions: para uma região, o número de eventos que estão sendo processados por funções que não tenham simultaneidade reservada.

  • ClaimedAccountConcurrency: para uma região, quantidade de simultaneidade que não está disponível para invocações sob demanda. ClaimedAccountConcurrency é igual a UnreservedConcurrentExecutions mais a quantidade de simultaneidade alocada (ou seja, a simultaneidade total reservada mais a simultaneidade total provisionada). Para ter mais informações, consulte Trabalhar com a métrica ClaimedAccountConcurrency.

Métricas de invocação assíncrona

As métricas de invocação assíncrona fornecem detalhes sobre invocações assíncronas de fontes de eventos e invocações diretas. Você pode definir limites e alarmes para notificá-lo sobre determinadas alterações. Por exemplo, quando há um aumento indesejado no número de eventos enfileirados para processamento (AsyncEventsReceived). Ou quando um evento está esperando há muito tempo para ser processado (AsyncEventAge).

  • AsyncEventsReceived: o número de eventos que o Lambda enfileira com sucesso para processamento. Esta métrica fornece informações sobre o número de eventos que uma função do Lambda recebe. Monitore essa métrica e defina alarmes de limites para verificar problemas. Por exemplo, para detectar um número indesejável de eventos enviados ao Lambda e diagnosticar rapidamente problemas resultantes de configurações incorretas de gatilhos ou funções. As incompatibilidades entre os AsyncEventsReceived e as Invocations podem indicar uma disparidade no processamento, a eliminação de eventos ou um possível backlog na fila.

  • AsyncEventAge: o tempo entre o momento em que o Lambda enfileira com sucesso o evento e o momento em que a função é invocada. O valor dessa métrica aumenta quando os eventos estão sendo repetidos devido a falhas de invocação ou no controle de utilização. Monitore esta métrica e defina alarmes para limites em estatísticas diferentes para quando ocorrer um acúmulo de fila. Para solucionar um aumento nessa métrica, examine a métrica Errors para identificar erros de função e a métrica Throttles para identificar problemas de simultaneidade.

  • AsyncEventsDropped: o número de eventos que são eliminados sem executar a função com êxito. Se você configurar uma fila de mensagens não entregues (DLQ) ou um destino OnFailure, os eventos serão enviados para lá antes de serem descartados. Os eventos são encerrados por vários motivos. Por exemplo, os eventos podem exceder a idade máxima do evento, esgotar o máximo de tentativas ou a simultaneidade reservada pode ser definida como 0. Para entender por que os eventos são encerrados, confira a métrica Errors para identificar erros de função e a métrica Throttles para identificar problemas de simultaneidade.

Métricas de mapeamento da origem do evento

As métricas de mapeamento da origem de eventos fornecem informações sobre o comportamento de processamento do seu mapeamento da origem de eventos. Essas métricas ajudam você a monitorar o fluxo e o status de eventos, incluindo eventos que seu mapeamento da origem de eventos processou, filtrou ou descartou com sucesso.

Você deve habilitar o recebimento de métricas relacionadas às contagens (PolledEventCount, FilteredOutEventCount, InvokedEventCount, FailedInvokeEventCount, DroppedEventCount, OnFailureDestinationDeliveredEventCount e DeletedEventCount). Para habilitar, você pode usar o console ou a API do Lambda.

Para habilitar as métricas ou um mapeamento da origem do evento (console)
  1. Abra a página Funções do console do Lambda.

  2. Escolha a função para a qual você deseja habilitar métricas.

  3. Escolha Configuração e, em seguida, escolha Acionadores.

  4. Escolha o mapeamento da origem do evento para o qual você deseja habilitar as métricas e, em seguida, escolha Editar.

  5. Em Configuração de mapeamento da origem do evento, escolha Habilitar métricas.

  6. Escolha Salvar.

Como alternativa, você pode habilitar as métricas para o mapeamento da origem do evento de forma programática usando o objeto EventSourceMappingMetricsConfig em EventSourceMappingConfiguration. Por exemplo, o comando da CLI UpdateEventSourceMapping a seguir habilita as métricas para um mapeamento da origem de eventos:

aws lambda update-event-source-mapping \ --uuid a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \ --metrics-config Metrics=EventCount

Confira as métricas relacionadas a contagens de eventos com a estatística Sum.

Atenção

Os mapeamentos da origem do evento do Lambda processam cada evento ao menos uma vez, podendo haver o processamento duplicado de registros. Por esse motivo, os eventos podem ser contados várias vezes em métricas que envolvem contagens de eventos.

  • PolledEventCount: o número de eventos que o Lambda lê com sucesso na origem do evento. Se o Lambda pesquisar eventos, mas receber uma pesquisa vazia (sem novos registros), o Lambda emitirá um valor de 0 para essa métrica. Use essa métrica para detectar se o mapeamento da origem do evento está pesquisando corretamente novos eventos.

  • FilteredOutEventCount: para o mapeamento da origem do evento com um critério de filtro, o número de eventos filtrados por esse critério de filtro. Use essa métrica para detectar se o mapeamento da origem do evento está filtrando os eventos corretamente. Para eventos que correspondem aos critérios do filtro, o Lambda emite uma métrica de 0.

  • InvokedEventCount: o número de eventos que invocaram sua função do Lambda. Use essa métrica para verificar se os eventos estão invocando sua função corretamente. Se um evento resultar em um erro de função ou de controle de utilização, InvokedEventCount pode contar várias vezes para o mesmo evento pesquisado devido a novas tentativas automáticas.

  • FailedInvokeEventCount: o número de eventos com os quais o Lambda tentou invocar sua função, mas falhou. As invocações podem falhar por motivos como problemas de configuração de rede, permissões incorretas ou a exclusão de uma versão, alias ou função do Lambda. Se o mapeamento da origem do evento tiver respostas parciais em lote habilitadas, FailedInvokeEventCount inclui qualquer evento com um valor não vazio para BatchItemFailures na resposta.

    nota

    O carimbo de data/hora da métrica FailedInvokeEventCountrepresenta o fim da invocação da função. Esse comportamento difere de outras métricas de erro de invocação do Lambda, que são registradas com um carimbo de data/hora no início da invocação da função.

  • DroppedEventCount: o número de eventos que o Lambda eliminou devido à exaustão por expiração ou por nova tentativa. Especificamente, esse é o número de registros que excedem seus valores configurados para MaximumRecordAgeInSeconds ou MaximumRetryAttempts. É importante ressaltar que isso não inclui o número de registros que expiram por excederem as configurações de retenção da origem do evento. Os eventos descartados também excluem os eventos que você envia para um destino em caso de falha. Use essa métrica para detectar um backlog crescente de eventos.

  • OnFailureDestinationDeliveredEventCount: para mapeamentos de origem de eventos com um destino em caso de falha configurado, o número de eventos enviados para esse destino. Use essa métrica para monitorar erros de função relacionados a invocações dessa origem de eventos. Se a entrega para o destino falhar, o Lambda trata as métricas da seguinte forma:

    • O Lambda não emite a métrica OnFailureDestinationDeliveredEventCount.

    • Para a métrica DestinationDeliveryFailures, o Lambda emite o valor 1.

    • Para a métrica DroppedEventCount, o Lambda emite um número igual ao número de eventos que falharam na entrega.

  • DeletedEventCount: o número de eventos que o Lambda exclui com sucesso após o processamento. Se o Lambda tentar excluir um evento, mas falhar, o Lambda vai emitir uma métrica de 0. Use essa métrica para garantir que os eventos processados com sucesso sejam excluídos da sua origem de eventos.

Se o mapeamento da origem de eventos estiver desabilitado, você não receberá métricas de mapeamento da origem de eventos. Você também pode observar a ausência de métricas se o CloudWatch ou o Lambda estiver com disponibilidade reduzida.

Nem toda métrica de mapeamento da origem de eventos está disponível para cada origem de evento. Atualmente, as métricas de mapeamento da origem de eventos estão disponíveis para origens de eventos de fluxos do Amazon SQS, Kinesis e DynamoDB. A matriz de disponibilidade a seguir resume as métricas compatíveis para cada tipo de origem de evento.

Métrica do mapeamento da origem de eventos Suporte para o Amazon SQS Suporte a fluxos do Kinesis e do DynamoDB

PolledEventCount

Sim

Sim

FilteredOutEventCount

Sim

Sim

InvokedEventCount

Sim

Sim

FailedInvokeEventCount

Sim

Sim

DroppedEventCount

Não

Sim

OnFailureDestinationDeliveredEventCount

Não

Sim

DeletedEventCount

Sim

Não

Além disso, se o mapeamento da origem de eventos estiver no modo provisionado, o Lambda fornecerá a seguinte métrica:

  • ProvisionedPollers: para mapeamentos de origem de eventos no modo provisionado, o número de pesquisadores de eventos que estão sendo executados ativamente. Confira essa métrica usando a métrica MAX.

PrivacidadeTermos do sitePreferências de cookies
© 2025, Amazon Web Services, Inc. ou suas afiliadas. Todos os direitos reservados.