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á.

# Monitorando a Amazon EventBridge
<a name="eb-monitoring"></a>

EventBridge [envia métricas para a Amazon a CloudWatch cada minuto para tudo, desde o número de [eventos](eb-events.md) correspondentes até o número de vezes que um [alvo](eb-targets.md) é invocado por uma regra.](eb-rules.md)

 O vídeo a seguir analisa o EventBridge comportamento de monitoramento e auditoria por meio CloudWatch de:




**Topics**
+ [EventBridge métricas](#eb-metrics)
+ [Dimensões para EventBridge métricas](#eb-metrics-dimensions)
+ [Melhores práticas para monitorar a entrega de eventos na Amazon EventBridge](eb-monitoring-events-best-practices.md)
+ [O EventBridge é a evolução do Amazon CloudWatch Events.](eb-cwe-now-eb.md)

## EventBridge métricas
<a name="eb-metrics"></a>

O namespace `AWS/Events` inclui as métricas a seguir.

Para as métricas que usam a contagem como uma unidade, soma e SampleCount tendem a ser as estatísticas mais úteis.

As métricas que especificam somente a dimensão `RuleName` se referem ao barramento de eventos padrão. As métricas que especificam as dimensões `EventBusName` e `RuleName` se referem a um barramento de eventos personalizado. 


| Métrica | Description | Dimensões | Unidades | 
| --- | --- | --- | --- | 
|  DeadLetterInvocations  |  O número de vezes em que um destino de uma regra não é invocado em resposta a um evento. Inclui as invocações que causariam o acionamento da mesma regra novamente, resultando em um loop infinito.  | RuleName | Contagem | 
|  Events  |  O número de eventos de parceiros ingeridos pelo EventBridge.  | EventSourceName | Contagem | 
|  FailedInvocations  |  O número de invocações que apresentaram falha permanentemente. Não inclui as invocações que foram repetidas ou que tiveram êxito após uma tentativa repetida. Também não considera invocações com falha que são consideradas em `DeadLetterInvocations`.  EventBridge só envia essa métrica para CloudWatch se ela não for zero.   | RuleName | Contagem | 
|  Invocations  |  O número de vezes em que um destino é invocado por uma regra em resposta a um evento. Isso inclui invocações com êxito e com falha, mas não inclui tentativas limitadas ou repetidas até que elas apresentem falha permanentemente. Não inclui `DeadLetterInvocations`.  EventBridge só envia essa métrica para CloudWatch se ela não for zero.   | Nenhum, RuleName | Contagem | 
| InvocationAttempts | Número de vezes que EventBridge tentou invocar um alvo.  | EventBusName, Nenhuma, RuleName | Contagem | 
|  InvocationsCreated  |  O número total de invocações criadas em resposta a cada evento.  [Essa métrica é frequentemente usada para monitorar a utilização do **limite de aceleração de invocações em transações por segundo da cota** de serviço. EventBridge ](eb-quota.md#eb-limits)  | Nenhum | Contagem | 
|  InvocationsFailedToBeSentToDlq  |  O número de invocações que não puderam ser movidas para uma fila de mensagens não entregues. Os erros de fila de mensagens não entregues podem ocorrer devido a erros de permissões, recursos indisponíveis ou limites de tamanho.  EventBridge só envia essa métrica para CloudWatch se ela não for zero.   | RuleName | Contagem | 
|  IngestiontoInvocationCompleteLatency  |  O tempo gasto desde a ingestão do evento até a conclusão da primeira tentativa de invocação.   | EventBusName, Nenhuma, RuleName | Milissegundos | 
| IngestionToInvocationSuccessLatency | O tempo gasto desde a ingestão do evento até a entrega bem-sucedida ao destino, usando o horário de término da invocação como limite. Esta métrica só é emitida após a primeira tentativa bem-sucedida de entrega ao destino. | EventBusName, Nenhuma, RuleName | Milissegundos | 
|  IngestiontoInvocationStartLatency  |  O tempo para processar eventos, medido desde o momento em que um evento é ingerido até EventBridge a primeira invocação de um alvo.   | EventBusName, Nenhuma, RuleName | Milissegundos | 
|  InvocationsSentToDlq  |  O número de invocações que são movidas para uma fila de mensagens não entregues.  EventBridge só envia essa métrica para CloudWatch se ela não for zero.   | RuleName | Contagem | 
|  MatchedEvents  |  Se EventBusName ou EventSourceName for especificado, o número de eventos que corresponderam a qualquer regra. Se RuleName for especificado, o número de eventos que corresponderam a uma regra específica.  | EventBusName, EventSourceName, RuleName | Contagem | 
| RetryInvocationAttempts | Número de vezes que a invocação do destino foi repetida. EventBridge só envia essa métrica para CloudWatch se ela não for zero.  | EventBusName, Nenhuma, RuleName | Contagem | 
| SuccessfulInvocationAttempts | O número de vezes que o destino foi invocado com êxito.  | EventBusName, Nenhuma, RuleName | Contagem | 
|  ThrottledRules  |  O número de vezes que a execução da regra foi limitada. As invocações dessas regras podem ser adiadas. Para obter mais informações, consulte **Limite de controle de utilização de invocações em transações por segundo** em [EventBridge cotas de ônibus para eventos](eb-quota.md#eb-limits).  | EventBusName, Nenhuma, RuleName | Contagem | 
|  TriggeredRules  |  O número de regras que foram executadas e corresponderam a qualquer evento. Você não verá essa métrica CloudWatch até que uma regra seja acionada.  | EventBusName, Nenhuma, RuleName | Contagem | 
|  EventBusEncryptionStarted  |  O número de vezes que uma operação de recriptografia foi iniciada para um barramento de eventos. A atualização da configuração do barramento de eventos aciona uma recriptografia da configuração estática armazenada pelo. EventBridge  | EventBusName | Contagem | 
|  EventBusEncryptionCompleted  |  O número de vezes que uma operação de recriptografia foi concluída com êxito em um barramento de eventos. A atualização da configuração do barramento de eventos aciona uma recriptografia da configuração estática armazenada pelo. EventBridge  | EventBusName | Contagem | 
|  EventBusEncryptionFailed  |  O número de vezes que uma operação de recriptografia falhou em um barramento de eventos. A atualização da configuração do barramento de eventos aciona uma recriptografia da configuração estática armazenada pelo. EventBridge  EventBridge só envia essa métrica para CloudWatch se ela não for zero.   | EventBusName | Contagem | 

### EventBridge PutEvents métricas
<a name="eb-metrics-putevents"></a>

O namespace `AWS/Events` inclui as métricas a seguir que pertencem às solicitações de API `[PutEvents](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutEvents.html)`.

Para as métricas que usam a contagem como uma unidade, soma e SampleCount tendem a ser as estatísticas mais úteis.


| Métrica | Description | Dimensões | Unidades | 
| --- | --- | --- | --- | 
| PutEventsApproximateCallCount | O número aproximado de solicitações `[PutEvents](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutEvents.html)` recebidas.  | Nenhum | Contagem | 
|  PutEventsApproximateFailedCount  | O número aproximado de solicitações `[PutEvents](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutEvents.html)` com falha.  | Nenhum | Contagem | 
|  PutEventsApproximateSuccessCount  | O número de solicitações `[PutEvents](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutEvents.html)` recebidas com êxito.  | Nenhum | Contagem | 
|  PutEventsApproximateThrottledCount  |  Número de solicitações `[PutEvents](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutEvents.html)` rejeitadas devido ao controle de utilização.  | Nenhum | Contagem | 
| PutEventsEntriesCount |  O número de entradas de eventos contidas em uma solicitação `[PutEvents](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutEvents.html)`.  | Nenhum | Contagem | 
| PutEventsFailedEntriesCount |  O número de entradas de eventos contidas em uma solicitação `[PutEvents](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutEvents.html)` que não foi ingerida.  | Nenhum | Contagem | 
|  PutEventsLatency  |  O tempo gasto por solicitação `[PutEvents](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutEvents.html)`.  | Nenhum | Milissegundos | 
|  PutEventsRequestSize  |  O tamanho da solicitação `[PutEvents](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutEvents.html)`.  | Nenhum | Bytes | 

### EventBridge PutPartnerEvents métricas
<a name="eb-metrics-putpartnerevents"></a>

O namespace `AWS/Events` inclui as métricas a seguir que pertencem às solicitações de API `[PutPartnerEvents](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutPartnerEvents.html)`.

**nota**  
EventBridge inclui apenas métricas relacionadas a [PutPartnerEvents](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutPartnerEvents.html)solicitações em contas de parceiros de SaaS que enviam eventos. Para obter mais informações, consulte [Recebendo eventos de um parceiro SaaS com a Amazon EventBridge](eb-saas.md).

Para as métricas que usam a contagem como uma unidade, soma e SampleCount tendem a ser as estatísticas mais úteis.


| Métrica | Description | Dimensões | Unidades | 
| --- | --- | --- | --- | 
| PutPartnerEventsApproximateCallCount | O número aproximado de solicitações `[PutPartnerEvents](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutPartnerEvents.html)` recebidas.  | Nenhum | Contagem | 
|  PutPartnerEventsApproximateFailedCount  | O número aproximado de solicitações `[PutPartnerEvents](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutPartnerEvents.html)` com falha.  | Nenhum | Contagem | 
|  PutPartnerEventsApproximateThrottledCount  |  Número de solicitações `[PutPartnerEvents](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutPartnerEvents.html)` rejeitadas devido ao controle de utilização.  | Nenhum | Contagem | 
|  PutPartnerEventsApproximateSuccessCount  | O número de solicitações `[PutPartnerEvents](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutPartnerEvents.html)` recebidas com êxito.  | Nenhum | Contagem | 
| PutPartnerEventsEntriesCount |  O número de entradas de eventos contidas em uma solicitação `[PutPartnerEvents](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutPartnerEvents.html)`.  | Nenhum | Contagem | 
| PutPartnerEventsFailedEntriesCount |  O número de entradas de eventos contidas em uma solicitação `[PutPartnerEvents](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutPartnerEvents.html)` que não foi ingerida.  | Nenhum | Contagem | 
|  PutPartnerEventsLatency  |  O tempo gasto por solicitação `[PutPartnerEvents](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutPartnerEvents.html)`.  | Nenhum | Milissegundos | 

## Dimensões para EventBridge métricas
<a name="eb-metrics-dimensions"></a>

EventBridge as métricas têm *dimensões* ou atributos classificáveis, listados abaixo.


|  Dimensão  |  Description  | 
| --- | --- | 
|  EventBusName  |  Filtra as métricas disponíveis pelo nome do barramento de eventos.  | 
|  EventSourceName  |  Filtra as métricas disponíveis pelo nome da origem de eventos do parceiro.  | 
|  RuleName  |  Filtra as métricas disponíveis pelo nome da regra.  | 

# Melhores práticas para monitorar a entrega de eventos na Amazon EventBridge
<a name="eb-monitoring-events-best-practices"></a>

Para garantir que a lógica de negócios em seus aplicativos orientados a eventos seja executada de forma confiável, é essencial monitorar seu comportamento de entrega de eventos. EventBridge fornece métricas que permitem monitorar, detectar e mitigar problemas com antecedência para garantir a entrega confiável de eventos. Dentre estas métricas:
+ Métricas baseadas em contadores, como `InvocationAttempts`, `SuccessfulInvocationAttempts`, `RetryInvocationAttempts` e `FailedInvocations`, para permitir que você observe o controle de utilização do destino e calcule as taxas de erro.
+ Métricas baseadas em latência, como `IngestionToInvocationSuccessLatency`, para fornecer insights sobre entrega de eventos e atrasos.

Essas métricas permitem que você monitore a integridade de suas arquiteturas orientadas a eventos e compreenda e mitigue os problemas de entrega de eventos causados por destinos de baixo desempenho, subdimensionados ou que não respondem. Por exemplo, um destino permanentemente subescalado ou com controle de utilização pode levar a tentativas excessivas, atrasos na entrega de eventos e falhas permanentes na entrega.

Recomendamos que você combine várias métricas para obter uma visão geral completa e monitorá-las de perto. A configuração de alarmes e painéis adequados permite que você resolva problemas persistentes com antecedência.

Para obter informações sobre métricas específicas, consulte [EventBridge métricas](eb-monitoring.md#eb-metrics).

## Detectar falhas na entrega de eventos
<a name="eb-monitoring-events-best-practices-delivery-failures"></a>

EventBridge inclui métricas que você pode configurar para relatar invocações de destino, ou seja, tentativas de entrega de eventos, por regra.

Recomendamos que você monitore as seguintes métricas em nível de regra:
+ `InvocationAttempts`para observar o número total de EventBridge tentativas de invocar o alvo, incluindo novas tentativas de entrega de eventos. 
+ `SuccessfulInvocationAttempts`para o número de tentativas de invocação em que o evento foi entregue EventBridge com sucesso ao alvo.
+ `RetryInvocationAttempts` para o número de tentativas que representam novas tentativas de entrega de eventos.

  Um aumento em `RetryInvocationAttempts` pode indicar com antecedência se um destino está subdimensionado.

Além disso, como o aumento de tentativas pode ser o primeiro sinal de problemas de entrega, também recomendamos criar uma única métrica que rastreie a porcentagem de invocações bem-sucedidas ao destino em todas as respectivas invocações. Por exemplo, CloudWatch você pode usar a matemática métrica para criar essa métrica, chamada`SuccessfulInvocationRate`, usando a seguinte fórmula:

`SuccessfulInvocationRate` = `SuccessfulInvocationAttempts` / ` InvocationAttempts`

Então, dependendo de seus requisitos, você pode configurar CloudWatch os alarmes para criar notificações quando um determinado limite for atingido. 

Embora uma diminuição ocasional em `SuccessfulInvocationRate` devido a picos temporários de tráfego ou erros de invocação possa ser considerada normal, uma incompatibilidade constante indica um destino configurado incorretamente e precisa ser tratada como parte do Modelo de Responsabilidade Compartilhada.

Para obter mais informações sobre matemática métrica, consulte [Uso de expressões matemáticas com CloudWatch métricas](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html) no *Guia CloudWatch do usuário da Amazon*. 

Por padrão, EventBridge tenta entregar um evento novamente por 24 horas e até 185 vezes. Depois de EventBridge esgotar essas tentativas de repetição, EventBridge cancela o evento ou o envia para uma fila de mensagens mortas, se uma tiver sido especificada. Para obter mais informações, consulte [Tentar entregar eventos novamente](eb-rule-retry-policy.md). Para evitar a perda de eventos, caso eles não sejam entregues, recomendamos que você configure uma fila de mensagens não entregues para cada destino da regra. Para obter mais informações, consulte [Usar filas de mensagens não entregues](eb-rule-dlq.md).

Os eventos que EventBridge não são entregues ao alvo especificado são relatados na `FailedInvocations` métrica e na `InvocationsSentToDlq` métrica se você tiver configurado uma fila de mensagens mortas para o destino. Se sua aplicação estiver recebendo um grande número de relatórios de `FailedInvocations` ou `InvocationsSentToDlq`, recomendamos que você investigue se o destino está escalado corretamente e consegue receber o tráfego fornecido.

## Detectar atrasos na entrega de eventos
<a name="eb-monitoring-events-best-practices-delivery-latency"></a>

EventBridge também fornece uma métrica que permite observar a end-to-end latência, ou seja, o tempo que leva desde a ingestão do evento até a entrega bem-sucedida ao alvo. Isso pode ser feito com a métrica `IngestionToInvocationSuccessLatency`. Essa métrica mostra os efeitos de novas tentativas e atrasos na entrega devido, por exemplo, a tempos limite de execução e respostas lentas dos destinos. `IngestionToInvocationSuccessLatency` inclui o tempo que o destino leva para responder com êxito à entrega do evento. Isso permite que você monitore a end-to-end latência entre EventBridge e seu alvo e detecte variações de desempenho e degradações dos alvos, mesmo quando não há limitação ou erros no alvo.

# O EventBridge é a evolução do Amazon CloudWatch Events.
<a name="eb-cwe-now-eb"></a>

Anteriormente, o EventBridge era chamado de Amazon CloudWatch Events. O barramento de eventos padrão e as regras criadas no CloudWatch Events também são exibidos no console do EventBridge. O EventBridge usa a mesma API do CloudWatch Events para que seu código que usa a API do CloudWatch Events permaneça o mesmo.

O EventBridge se baseia nos recursos do CloudWatch Events com atributos como eventos de parceiros, Schema Registry e EventBridge Pipes. Novos atributos adicionados ao EventBridge não são adicionados ao CloudWatch Events. Para obter mais informações, consulte [O que é o Amazon EventBridge?](eb-what-is.md).

Todos os atributos de costume no CloudWatch Events também estão presentes no EventBridge, incluindo:
+ [Ônibus para eventos na Amazon EventBridge](eb-event-bus.md)
+ [Regras na Amazon EventBridge](eb-rules.md)
+ [Eventos na Amazon EventBridge](eb-events.md)
+ [Eventos de AWS serviços](eb-events.md#eb-service-event)

Os atributos do EventBridge que se baseiam e expandem as capacidades dos eventos incluem: 
+ [Recebendo eventos de um parceiro SaaS com a Amazon EventBridge](eb-saas.md)
+ [Amazon EventBridge Pipes](eb-pipes.md)
+ [Esquemas do Amazon EventBridge](eb-schema.md)
+ [Amazon EventBridge Scheduler](using-eventbridge-scheduler.md)