

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# CloudWatch Métricas disponíveis para o Amazon SQS
<a name="sqs-available-cloudwatch-metrics"></a>

O Amazon SQS envia as seguintes métricas para. CloudWatch

**nota**  
Para algumas métricas, o resultado é aproximado por causa da arquitetura distribuída do Amazon SQS. Na maioria dos casos, a contagem deve ser próxima da quantidade real de mensagens na fila.

## Métricas do Amazon SQS
<a name="sqs-metrics"></a>

O Amazon SQS publica automaticamente métricas operacionais na [Amazon CloudWatch sob o namespace](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html). `AWS/SQS` Essas métricas ajudam a monitorar a integridade e o desempenho da fila. Devido à natureza distribuída do SQS, muitos valores são aproximados, mas precisos o suficiente para a maioria das decisões operacionais.

**nota**  
Todas as métricas emitem valores não negativos somente quando a fila está ativa.
Algumas métricas (como `SentMessageSize`) não são emitidas até que pelo menos uma mensagem seja enviada.


| Métrica | Description | Unidades | Relatório resultante | Notas principais | 
| --- | --- | --- | --- | --- | 
| ApproximateAgeOfOldestMessage | A idade da mensagem não processada mais antiga na fila. | Segundos | Relatado se a fila contém pelo menos uma mensagem ativa. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-available-cloudwatch-metrics.html) | 
| ApproximateNumberOfGroupsWithInflightMessages | Somente para FIFO. O número de grupos de mensagens com uma ou mais mensagens em trânsito. | Contagem | Relatado se a fila FIFO está ativa. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-available-cloudwatch-metrics.html) | 
| ApproximateNumberOfMessagesDelayed |  O número de mensagens na fila que estão atrasadas e não disponíveis imediatamente para recuperação.  | Contagem | Relatado se existem mensagens atrasadas na fila. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-available-cloudwatch-metrics.html) | 
| ApproximateNumberOfMessagesNotVisible | O número de mensagens em trânsito que foram recebidas, mas ainda não excluídas ou expiradas. | Contagem | Relatado se existirem mensagens em trânsito. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-available-cloudwatch-metrics.html) | 
| ApproximateNumberOfMessagesVisible | O número de mensagens atualmente disponíveis para recuperação e processamento. | Contagem | Relatado se a fila está ativa. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-available-cloudwatch-metrics.html) | 
| NumberOfEmptyReceives¹ | O número de chamadas de [ReceiveMessage](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_ReceiveMessage.html)API que não retornaram mensagens. | Contagem | Relatado durante as operações de recebimento. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-available-cloudwatch-metrics.html) | 
| NumberOfDeduplicatedSentMessages | Somente para FIFO. O número de mensagens enviadas que foram desduplicadas e não adicionadas à fila. | Contagem | Relatado se valores ou conteúdo MessageDeduplicationId duplicados forem detectados. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-available-cloudwatch-metrics.html) | 
| NumberOfMessagesDeleted¹ |  O número de mensagens excluídas com êxito da fila.  | Contagem | Relatado para cada solicitação de exclusão com um identificador de recibo válido. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-available-cloudwatch-metrics.html) | 
| NumberOfMessagesReceived¹ | O número de mensagens retornadas pela [ReceiveMessage](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_ReceiveMessage.html)API. | Contagem | Relatado durante as operações de recebimento. |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-available-cloudwatch-metrics.html)  | 
|  NumberOfMessagesSent¹ | O número de mensagens adicionadas com êxito a uma fila. | Contagem | Relatado para cada envio manual bem-sucedido. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-available-cloudwatch-metrics.html) | 
|  SentMessageSize¹  |  O tamanho das mensagens enviadas com sucesso para a fila.  | Bytes | Não emitido até que pelo menos uma mensagem seja enviada. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-available-cloudwatch-metrics.html) | 
|  ApproximateNumberOfNoisyGroups | O número de grupos de mensagens que são considerados barulhentos em uma fila justa. Um grupo de mensagens barulhentas representa um locatário barulhento de uma fila multilocatário. | Contagem | Um valor não negativo é relatado [se a fila estiver ativa](monitoring-using-cloudwatch.md). | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-available-cloudwatch-metrics.html) | 
|  ApproximateNumberOfMessagesVisibleInQuietGroups | O número de mensagens visíveis, excluindo mensagens de grupos de mensagens barulhentos. | Contagem | Um valor não negativo é relatado [se a fila estiver ativa](monitoring-using-cloudwatch.md). | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-available-cloudwatch-metrics.html) | 
|  ApproximateNumberOfMessagesNotVisibleInQuietGroups | O número de mensagens em trânsito, excluindo mensagens de grupos de mensagens barulhentos. | Contagem | Um valor não negativo é relatado [se a fila estiver ativa](monitoring-using-cloudwatch.md). | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-available-cloudwatch-metrics.html) | 
|  ApproximateNumberOfMessagesDelayedInQuietGroups | O número de mensagens, excluindo mensagens de grupos barulhentos que estão atrasadas e indisponíveis para leitura imediata. Isso pode acontecer quando a fila tem a configuração de [fila com atraso](sqs-delay-queues.md) ou quando uma mensagem foi enviada com um parâmetro de atraso. | Contagem | Um valor não negativo é relatado [se a fila estiver ativa](monitoring-using-cloudwatch.md). | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-available-cloudwatch-metrics.html) | 
|  ApproximateAgeOfOldestMessageInQuietGroups | A idade da mensagem mais antiga não excluída na fila, excluindo mensagens de grupos de mensagens barulhentas. | Segundos | Um valor não negativo é relatado [se a fila estiver ativa](monitoring-using-cloudwatch.md). | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-available-cloudwatch-metrics.html) | 

¹ Essas métricas refletem a atividade no nível do sistema e podem incluir novas tentativas, duplicatas ou mensagens atrasadas. Não use contagens brutas para estimar o estado da fila em tempo real sem considerar o comportamento do ciclo de vida das mensagens.

## Filas de cartas mortas () e métricas DLQs CloudWatch
<a name="dlq-cloudwatch-metrics"></a>

Ao trabalhar com DLQs, é importante entender como as métricas do Amazon SQS se comportam:
+ **`NumberOfMessagesSent`**— Essa métrica se comporta de forma diferente para: DLQs
  + **Envio manual**: as mensagens enviadas manualmente para uma DLQ são capturadas por essa métrica.
  + **Redirecionamento automático**: as mensagens movidas automaticamente para uma DLQ devido a falhas de processamento **não** são capturadas por essa métrica. Como resultado, as `NumberOfMessagesReceived` métricas `NumberOfMessagesSent` e podem mostrar discrepâncias para. DLQs
+ **Métrica recomendada para DLQs** — Para monitorar o estado de uma DLQ, use a `ApproximateNumberOfMessagesVisible` métrica. Essa métrica indica o número de mensagens atualmente disponíveis para processamento na DLQ.

## Filas e CloudWatch métricas justas
<a name="fair-queues-cloudwatch-metrics"></a>

Quando você usa [filas justas](sqs-fair-queues.md), o Amazon SQS emite as seguintes métricas adicionais:
+ `ApproximateNumberOfNoisyGroups`
+ `ApproximateNumberOfMessagesVisibleInQuietGroups`
+ `ApproximateNumberOfMessagesNotVisibleInQuietGroups`
+ `ApproximateNumberOfMessagesDelayedInQuietGroups`
+ `ApproximateAgeOfOldestMessageInQuietGroups`

**nota**  
Cada métrica `QuietGroup` é um subconjunto da métrica padrão equivalente em nível de fila `Approximate`, mas exclui mensagens de grupos vizinhos barulhentos. 

**Grupos barulhentos**  
Um grupo de mensagens barulhentas representa um locatário barulhento de uma fila multilocatário.

**Grupos silenciosos**  
Grupos de mensagens que excluem grupos barulhentos.

**Observação do comportamento das filas justas do SQS**

Para monitorar o efeito das filas justas do Amazon SQS, você pode comparar as métricas `Approximate..InQuietGroups` com métricas padrão em nível de fila. Durante picos de tráfego para um locatário específico, as métricas gerais do nível da fila podem revelar o aumento dos acúmulos ou a idade das mensagens mais antigas. No entanto, ao analisar os grupos silenciosos isoladamente, você pode identificar que a maioria dos grupos de mensagens ou locatários barulhentos não são afetados, e fornece uma estimativa do número total de grupos de mensagens impactados.

 Embora essas novas métricas forneçam uma boa visão geral do comportamento das filas justas do Amazon SQS, pode ser benéfico entender qual locatário específico está causando a carga. [O Amazon CloudWatch Contributor Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContributorInsights.html) permite que você veja métricas sobre os N principais colaboradores, o número total de colaboradores exclusivos e seu uso. Isso é especialmente útil em cenários em que você está lidando com milhares de locatários que, de outra forma, levariam a dados (e custos) de alta cardinalidade ao emitir métricas tradicionais. 

 Para ver um exemplo de configuração de monitoramento para filas justas, veja o exemplo em [GitHub](https://github.com/aws-samples/sample-amazon-sqs-fair-queues). 

## Dimensões para métricas do Amazon SQS
<a name="sqs-metric-dimensions"></a>

As métricas do Amazon SQS CloudWatch usam uma única dimensão:. **`QueueName`** Todos os dados métricos são agrupados e filtrados pelo nome da fila.

## Dicas de monitoramento
<a name="monitoring-tips"></a>

Monitore o SQS de forma eficaz usando métricas e CloudWatch alarmes importantes para detectar atrasos de filas, otimizar o desempenho e permanecer dentro dos limites do serviço.
+ Defina [CloudWatch alarmes](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html) com base em `ApproximateNumberOfMessagesVisible` para capturar o crescimento da lista de pendências.
+ Monitore `NumberOfEmptyReceives` para ajustar a frequência da pesquisa e reduzir o custo da API.
+ Use `ApproximateNumberOfGroupsWithInflightMessages` em filas FIFO para diagnosticar limites de throughput.
+ Consulte [Cotas do SQS](sqs-quotas.md) para entender os limites métricos e de serviço.