`. É possível pode fazer referência a essas variáveis ao criar o *modelo de entrada*.
**nota**
Os destinos Amazon CloudWatch Logs e SSM não suportam o uso de `Input` e `InputPath` em seus transformadores de entrada.
### Modelo de entrada
O *modelo de entrada* é um modelo para as informações que você deseja passar para seu destino. É possível criar um modelo que transmita uma string ou JSON para o destino. Usando o evento anterior e o *caminho de entrada*, os exemplos de *modelo de entrada* a seguir transformarão o evento na saída de exemplo antes de fazer o roteamento dele para um destino.
| Description | Modelo | Output |
| --- | --- | --- |
| String simples | "instance is in "
| "instance i-0123456789 is in RUNNING"
|
| **String com aspas de escape** | "instance \"\" is in "
| "instance \"i-0123456789\" is in RUNNING"
Observe que esse é o comportamento no EventBridge console. A AWS CLI faz o escape dos caracteres de barra e o resultado é `"instance "i-0123456789" is in RUNNING"`. |
| **JSON simples** | {
"instance" : ,
"state":
} | {
"instance" : "i-0123456789",
"state": "RUNNING"
} |
| **JSON com strings e variáveis** | {
"instance" : ,
"state": "",
"instanceStatus": "instance \"\" is in "
} | {
"instance" : "i-0123456789",
"state": "RUNNING",
"instanceStatus": "instance \"i-0123456789\" is in RUNNING"
} |
| **JSON com uma mistura de variáveis e informações estáticas** | {
"instance" : ,
"state": [ 9, , true ],
"Transformed" : "Yes"
}
| {
"instance" : "i-0123456789",
"state": [
9,
"RUNNING",
true
],
"Transformed" : "Yes"
} |
| **Incluir variáveis reservadas no JSON** | {
"instance" : ,
"state": ,
"ruleArn" : ,
"ruleName" : ,
"originalEvent" :
} | {
"instance" : "i-0123456789",
"state": "RUNNING",
"ruleArn" : "arn:aws:events:us-east-2:123456789012:rule/example",
"ruleName" : "example",
"originalEvent" : {
... // commented for brevity
}
} |
| **Incluir variáveis reservadas em uma string** | " triggered"
| "example triggered"
|
| **Grupo de CloudWatch registros da Amazon** | {
"timestamp" : ,
"message": "instance \"\" is in "
} | {
"timestamp" : 2015-11-11T21:29:54Z,
"message": "instance "i-0123456789" is in RUNNING
} |
## Transformando a entrada usando a API EventBridge
Para obter informações sobre como usar a EventBridge API para transformar a entrada, consulte [Usar o Input Transformer para extrair dados de um evento e inserir esses dados no destino](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutTargets.html#API_PutTargets_Example_2).
## Transformando a entrada usando AWS CloudFormation
Para obter informações sobre como usar AWS CloudFormation para transformar a entrada, consulte [AWS::Events::Rule InputTransformer](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-events-rule-inputtransformer.html).
## Problemas comuns com a transformação de entrada
Esses são alguns problemas comuns ao transformar a entrada em: EventBridge
+ Para strings, as aspas são necessárias.
+ Não há validação ao criar o caminho JSON para o modelo.
+ Se especificar uma variável para corresponder a um caminho JSON que não existe no evento, essa variável não será criada e não aparecerá na saída.
+ Propriedades JSON, como `aws.events.event.json`, só podem ser usadas como o valor de um campo JSON, não embutidas em outras strings.
+ EventBridge não escapa dos valores extraídos pelo *caminho de entrada*, ao preencher o *modelo de entrada de* um destino.
+ Se um caminho JSON fizer referência a um objeto ou matriz JSON, mas a variável for referenciada em uma string, EventBridge removerá todas as aspas internas para garantir uma string válida. Por exemplo, para uma variável `` apontada`$.detail`, “Detalhe é” resultaria na EventBridge remoção de aspas do objeto.
Portanto, se quiser gerar um objeto JSON com base em uma única variável de caminho JSON, deverá colocá-lo como uma chave. Neste exemplo, `{"detail": }`.
+ As aspas não são necessárias para variáveis que representam cadeias de caracteres. Elas são permitidas, mas adicionam EventBridge automaticamente aspas aos valores das variáveis de string durante a transformação, para garantir que a saída da transformação seja um JSON válido. EventBridge não adiciona aspas às variáveis que representam objetos ou matrizes JSON. Não adicione aspas para variáveis que representem objetos ou matrizes JSON.
Por exemplo, o seguinte modelo de entrada inclui variáveis que representam cadeias de caracteres e objetos JSON:
```
{
"ruleArn" : ,
"ruleName" : ,
"originalEvent" :
}
```
Resultando em JSON válido com cotação adequada:
```
{
"ruleArn" : "arn:aws:events:us-east-2:123456789012:rule/example",
"ruleName" : "example",
"originalEvent" : {
... // commented for brevity
}
}
```
+ Para saída de texto (não JSON) como strings de várias linhas, coloque cada linha separada em seu modelo de entrada entre aspas duplas.
Por exemplo, se estiver fazendo a correspondência de eventos de [descoberta do Amazon Inspector](https://docs.aws.amazon.com/inspector/latest/user/eventbridge-integration.html#event-finding) com o seguinte padrão de eventos:
```
{
"detail": {
"severity": ["HIGH"],
"status": ["ACTIVE"]
},
"detail-type": ["Inspector2 Finding"],
"source": ["inspector2"]
}
```
E usando o seguinte caminho de entrada:
```
{
"account": "$.detail.awsAccountId",
"ami": "$.detail.resources[0].details.awsEc2Instance.imageId",
"arn": "$.detail.findingArn",
"description": "$.detail.description",
"instance": "$.detail.resources[0].id",
"platform": "$.detail.resources[0].details.awsEc2Instance.platform",
"region": "$.detail.resources[0].region",
"severity": "$.detail.severity",
"time": "$.time",
"title": "$.detail.title",
"type": "$.detail.type"
}
```
Você pode usar o modelo de entrada abaixo para gerar uma saída de string de várias linhas:
```
" severity finding "
"Description: <description>"
"ARN: \"<arn>\""
"Type: <type>"
"AWS Account: <account>"
"Region: <region>"
"EC2 Instance: <instance>"
"Platform: <platform>"
"AMI: <ami>"
```
# Configurando um transformador de entrada ao criar uma regra no EventBridge
<a name="eb-transform-input-rule"></a>
Como parte da criação de uma regra, você pode especificar um transformador de entrada EventBridge para usar no processamento de eventos correspondentes antes de enviar esses eventos para o destino especificado. Você pode configurar transformadores de entrada para destinos que sejam AWS serviços ou destinos de API.
**Para criar um transformador de entrada de destino como parte de uma regra**
1. Siga as etapas para criar uma regra, conforme detalhado em [Criação de regras na Amazon EventBridge](eb-create-rule-visual.md).
1. Na **Etapa 3: selecione os destinos**, expanda **Configurações adicionais**.
1. Em **Configurar entrada de destino**, escolha **Transformador de entrada** na lista suspensa.
Clique em **Configurar transformador de entrada**.
EventBridge exibe a caixa de diálogo **Configurar transformador de entrada**.
1. Na seção **Evento de amostra**, escolha um **Tipo de evento de amostra** com o qual deseja testar seu padrão de evento. Você pode escolher um AWS evento, um evento de parceiro ou inserir seu próprio evento personalizado.
------
#### [ AWS events ]
Selecione entre os eventos emitidos pelos Serviços da AWS compatíveis.
1. Selecione **Eventos da AWS **.
1. Em **Eventos de amostra**, escolha o AWS evento desejado. Os eventos são organizados por AWS serviço.
Quando você seleciona um evento, EventBridge preenche o evento de amostra.
Por exemplo, se você escolher **S3 Object Created**, EventBridge exibirá um exemplo do evento S3 Object Created.
1. (Opcional) Também é possível selecionar **Copiar** para copiar o evento de amostra para a área de transferência do seu dispositivo.
------
#### [ Partner events ]
Selecione entre os eventos emitidos por serviços terceirizados que oferecem suporte EventBridge, como o Salesforce.
1. Selecione **eventos de EventBridge parceiros**.
1. Em **Exemplos de eventos**, escolha o evento do parceiro desejado. Os eventos são organizados pelo parceiro.
Quando você seleciona um evento, EventBridge preenche o evento de amostra.
1. (Opcional) Também é possível selecionar **Copiar** para copiar o evento de amostra para a área de transferência do seu dispositivo.
------
#### [ Enter your own ]
Insira o seu próprio evento em texto JSON.
1. Selecione **Inserir seu próprio**.
1. EventBridge preenche o evento de amostra com um modelo de atributos de evento necessários.
1. Edite e adicione ao evento de amostra conforme desejado. O evento de amostra deve ser JSON válido.
1. (Opcional) Também é possível escolher uma das seguintes opções:
+ **Copiar**: copie o evento de amostra para a área de transferência do seu dispositivo.
+ **Aprimorar:** facilita a leitura do texto JSON adicionando quebras de linha, tabulações e espaços.
------
1. (Opcional) Expanda a seção **Exemplos de caminhos de entrada, modelos e saídas** para ver exemplos de:
+ Como os caminhos JSON são usados para definir variáveis que representam dados de eventos
+ Como essas variáveis podem ser usadas em um modelo de transformador de entrada
+ A saída resultante que é EventBridge enviada para o destino
Para obter exemplos mais detalhados de transformações de entrada, consulte [Exemplos de transformação de entrada](eb-transform-target-input.md#eb-transform-input-examples).
1. Na seção **Transformador de entrada de destino**, defina as variáveis que deseja usar no modelo de entrada.
Variáveis usam caminho JSON para fazer referência a valores na origem do evento original. Em seguida, você pode referenciar essas variáveis no modelo de entrada para incluir dados do evento de origem original no evento transformado que EventBridge passa para o destino. É possível definir até 100 variáveis. O transformador de entrada deve ser um JSON válido.
Por exemplo, suponha que você tenha escolhido o AWS evento **S3 Object Created** como seu evento de amostra para esse transformador de entrada. É possível definir as seguintes variáveis para uso em seu modelo:
```
{
"requester": "$.detail.requester",
"key": "$.detail.object.key",
"bucket": "$.detail.bucket.name"
}
```
(Opcional) Também é possível escolher **Copiar** para copiar o transformador de entrada para a área de transferência do seu dispositivo.
1. Na seção **Modelo**, componha o modelo que você deseja usar para determinar o que EventBridge passa para o alvo.
É possível usar JSON, strings, informações estáticas, variáveis que você definiu, bem como variáveis reservadas. Para obter exemplos mais detalhados de transformações de entrada, consulte [Exemplos de transformação de entrada](eb-transform-target-input.md#eb-transform-input-examples).
Por exemplo, suponha que tenha definido as variáveis no exemplo anterior. O modelo a seguir poderia ser composto, que faz referência a essas variáveis, bem como às variáveis reservadas e às informações estáticas.
```
{
"message": "<requester> has created the object \"<key>\" in the bucket \"<bucket>\"",
"RuleName": <aws.events.rule-name>,
"ruleArn" : <aws.events.rule-arn>,
"Transformed": "Yes"
}
```
(Opcional) Também é possível escolher **Copiar** para copiar o modelo para a área de transferência do seu dispositivo.
1. Para testar seu modelo, selecione **Gerar saída**.
EventBridge processa o evento de amostra com base no modelo de entrada e exibe a saída transformada gerada em **Saída**. Essas são as informações que EventBridge passarão para o destino no lugar do evento de origem original.
A saída gerada para o modelo de entrada de exemplo descrito acima seria a seguinte:
```
{
"message": "123456789012 has created the object "example-key" in the bucket "amzn-s3-demo-bucket"",
"RuleName": rule-name,
"ruleArn" : arn:aws:events:us-east-1:123456789012:rule/rule-name,
"Transformed": "Yes"
}
```
(Opcional) Também é possível escolher **Copiar** para copiar a saída gerada para a área de transferência do seu dispositivo.
1. Selecione **Confirmar**.
1. Siga o restante das etapas para criar uma regra, conforme detalhado em [Criação de regras na Amazon EventBridge](eb-create-rule-visual.md).
# Testando um transformador de entrada de destino usando o Sandbox EventBridge
<a name="eb-sandbox-input-trans"></a>
Você pode usar transformadores de entrada para personalizar o texto de um [evento](eb-events.md) antes de EventBridge passar as informações para o [destino](eb-targets.md) de uma [regra](eb-rules.md).
A configuração de um transformador de entrada normalmente faz parte de um processo maior de especificar um destino ao [criar uma nova regra](eb-create-rule-visual.md) ou editar uma existente. No entanto EventBridge, usando o Sandbox in, você pode configurar rapidamente um transformador de entrada e usar um evento de amostra para confirmar que está obtendo a saída desejada, sem precisar criar ou editar uma regra.
Para obter mais informações sobre a transformação de entrada, consulte [Transformação EventBridge de insumos da Amazon](eb-transform-target-input.md).
**Para testar um transformador de entrada de destino**
1. Abra o EventBridge console da Amazon em [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. Em **Recursos do desenvolvedor**, escolha **Sandbox** e, na página **Sandbox**, escolha a guia **Transformador de entrada de destino**.
1. Na seção **Evento de amostra**, escolha um **Tipo de evento de amostra** com o qual deseja testar seu padrão de evento. Você pode escolher um AWS evento, um evento de parceiro ou inserir seu próprio evento personalizado.
------
#### [ AWS events ]
Selecione entre os eventos emitidos pelos Serviços da AWS compatíveis.
1. Selecione **Eventos da AWS **.
1. Em **Eventos de amostra**, escolha o AWS evento desejado. Os eventos são organizados por AWS serviço.
Quando você seleciona um evento, EventBridge preenche o evento de amostra.
Por exemplo, se você escolher **S3 Object Created**, EventBridge exibirá um exemplo do evento S3 Object Created.
1. (Opcional) Também é possível selecionar **Copiar** para copiar o evento de amostra para a área de transferência do seu dispositivo.
------
#### [ Partner events ]
Selecione entre os eventos emitidos por serviços terceirizados que oferecem suporte EventBridge, como o Salesforce.
1. Selecione **eventos de EventBridge parceiros**.
1. Em **Exemplos de eventos**, escolha o evento do parceiro desejado. Os eventos são organizados pelo parceiro.
Quando você seleciona um evento, EventBridge preenche o evento de amostra.
1. (Opcional) Também é possível selecionar **Copiar** para copiar o evento de amostra para a área de transferência do seu dispositivo.
------
#### [ Enter your own ]
Insira o seu próprio evento em texto JSON.
1. Selecione **Inserir seu próprio**.
1. EventBridge preenche o evento de amostra com um modelo de atributos de evento necessários.
1. Edite e adicione ao evento de amostra conforme desejado. O evento de amostra deve ser JSON válido.
1. (Opcional) Também é possível escolher uma das seguintes opções:
+ **Copiar**: copie o evento de amostra para a área de transferência do seu dispositivo.
+ **Aprimorar:** facilita a leitura do texto JSON adicionando quebras de linha, tabulações e espaços.
------
1. (Opcional) Expanda a seção **Exemplos de caminhos de entrada, modelos e saídas** para ver exemplos de:
+ Como os caminhos JSON são usados para definir variáveis que representam dados de eventos
+ Como essas variáveis podem ser usadas em um modelo de transformador de entrada
+ A saída resultante que é EventBridge enviada para o destino
Para obter exemplos mais detalhados de transformações de entrada, consulte [Exemplos de transformação de entrada](eb-transform-target-input.md#eb-transform-input-examples).
1. Na seção **Transformador de entrada de destino**, defina as variáveis que deseja usar no modelo de entrada.
Variáveis usam caminho JSON para fazer referência a valores na origem do evento original. Em seguida, você pode referenciar essas variáveis no modelo de entrada para incluir dados do evento de origem original no evento transformado que EventBridge passa para o destino. É possível definir até 100 variáveis. O transformador de entrada deve ser um JSON válido.
Por exemplo, suponha que você tenha escolhido o AWS evento **S3 Object Created** como seu evento de amostra para esse transformador de entrada. É possível definir as seguintes variáveis para uso em seu modelo:
```
{
"requester": "$.detail.requester",
"key": "$.detail.object.key",
"bucket": "$.detail.bucket.name"
}
```
(Opcional) Também é possível escolher **Copiar** para copiar o transformador de entrada para a área de transferência do seu dispositivo.
1. Na seção **Modelo**, componha o modelo que você deseja usar para determinar o que EventBridge passa para o alvo.
É possível usar JSON, strings, informações estáticas, variáveis que você definiu, bem como variáveis reservadas. Para obter exemplos mais detalhados de transformações de entrada, consulte [Exemplos de transformação de entrada](eb-transform-target-input.md#eb-transform-input-examples).
Por exemplo, suponha que tenha definido as variáveis no exemplo anterior. O modelo a seguir poderia ser composto, que faz referência a essas variáveis, bem como às variáveis reservadas e às informações estáticas.
```
{
"message": "<requester> has created the object \"<key>\" in the bucket \"<bucket>\"",
"RuleName": <aws.events.rule-name>,
"ruleArn" : <aws.events.rule-arn>,
"Transformed": "Yes"
}
```
(Opcional) Também é possível escolher **Copiar** para copiar o modelo para a área de transferência do seu dispositivo.
1. Para testar seu modelo, selecione **Gerar saída**.
EventBridge processa o evento de amostra com base no modelo de entrada e exibe a saída transformada gerada em **Saída**. Essas são as informações que EventBridge passarão para o destino no lugar do evento de origem original.
A saída gerada para o modelo de entrada de exemplo descrito acima seria a seguinte:
```
{
"message": "123456789012 has created the object "example-key" in the bucket "amzn-s3-demo-bucket"",
"RuleName": rule-name,
"ruleArn" : arn:aws:events:us-east-1:123456789012:rule/rule-name,
"Transformed": "Yes"
}
```
(Opcional) Também é possível escolher **Copiar** para copiar a saída gerada para a área de transferência do seu dispositivo.
# Arquivando e reproduzindo eventos na Amazon EventBridge
<a name="eb-archive"></a>
Em EventBridge, você pode criar um arquivo de eventos para poder *reproduzi-los* facilmente ou reenviá-los para o ônibus de eventos que os recebeu originalmente, posteriormente. Por exemplo, convém reproduzir eventos para se recuperar de erros ou validar uma nova funcionalidade no aplicativo.
## Como arquivar eventos
<a name="eb-archive-archive"></a>
Ao criar um arquivamento, você pode especificar:
+ Quais eventos enviar para o arquivo.
Você pode especificar um padrão de evento EventBridge para usar ao filtrar os eventos que ele envia para o arquivo.
+ Por quanto tempo reter eventos no arquivo.
Você pode especificar o número de dias para reter eventos no arquivamento. Por padrão, EventBridge armazena eventos em um arquivo indefinidamente.
Cada arquivamento recebe eventos de um único barramento de eventos de *origem*. Você não poderá alterar o barramento de eventos de origem depois que um arquivamento for criado. Você pode criar vários arquivos para um determinado barramento de eventos.
![\[Os eventos são filtrados por um padrão de evento e enviados para um arquivo, a partir do qual eles podem ser reproduzidos.\]](http://docs.aws.amazon.com/pt_br/eventbridge/latest/userguide/images/archive_eventbridge_conceptual.svg)
EventBridge cobranças se aplicam aos arquivos. Consulte os [ EventBridge preços da Amazon](https://aws.amazon.com/eventbridge/pricing/) para obter detalhes.
### Criptografia dos eventos de arquivamento
<a name="eb-archive-encryption"></a>
Por padrão, EventBridge criptografa dados de eventos em um arquivamento usando o Advanced Encryption Standard (AES-256) de 256 bits sob uma [CMK AWS própria](https://docs.aws.amazon.com//kms/latest/developerguide/concepts.html#aws-owned-cmk), o que ajuda a proteger seus dados contra acesso não autorizado.
### Entrega de eventos
<a name="eb-archive-timing"></a>
Lembre-se das seguintes considerações sobre como EventBridge entrega eventos aos arquivos:
+ Talvez haja um atraso entre um evento ser recebido em um barramento de eventos e o evento chegando no arquivamento. É recomendado adiar a repetição dos eventos arquivados por 10 minutos para garantir que todos os eventos sejam repetidos.
+ Os valores `EventCount` e `SizeBytes` da operação [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_DescribeArchive.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_DescribeArchive.html) têm um período de reconciliação de 24 horas. Portanto, quaisquer eventos expirados recentemente ou recém-arquivados podem não estar refletidos de imediato nesses valores.
### Como evitar que eventos repetidos sejam entregues para um arquivamento
<a name="eb-archive-managed-rule"></a>
Quando você cria um arquivamento, EventBridge gera uma [regra gerenciada](eb-rules.md#eb-rules-managed) no barramento de eventos de origem que impede que eventos repetidos sejam enviados para o arquivamento. A regra gerenciada adiciona o seguinte padrão de evento, que filtra os eventos com base no fato de conterem um `replay-name` campo. (EventBridgeadiciona esse campo aos eventos quando os reproduz.)
```
{
"replay-name": [{
"exists": false
}]
}
```
## Reprodução dos eventos de um arquivamento
<a name="eb-archive-replay"></a>
Depois de criar um arquivo, é possível reproduzir eventos do arquivo. Por exemplo, se atualizar uma aplicação com funcionalidades adicionais, poderá reproduzir eventos históricos para garantir que os eventos sejam reprocessados para manter a aplicação consistente. Também é possível usar um arquivo para reproduzir eventos para novas funcionalidades.
Ao reproduzir eventos de um arquivo, você especifica:
+ O período do qual selecionar eventos a serem reproduzidos.
+ Opcionalmente, regras específicas no barramento de eventos para as quais os eventos selecionados EventBridge devem ser reproduzidos.
Os eventos de arquivo só podem ser reproduzidos para o barramento de eventos de origem.
Você pode ter no máximo dez replays simultâneos ativos por conta e por AWS região.
A reprodução de eventos não os remove do arquivo. Você pode repetir eventos em vários replays. EventBridge só remove eventos quando eles excedem o período de retenção do arquivo, ou você exclui o próprio arquivo.
EventBridge exclui repetições após 90 dias.
Você poderá cancelar reproduções enquanto o status for `Starting` ou `Running`. Para obter mais informações, consulte [Cancelamento de reproduções de eventos](eb-replay-cancel.md).
### Identificação de eventos que foram reproduzidos
<a name="eb-archive-replay-event-transform"></a>
Quando EventBridge envia um evento de um arquivo para o barramento de eventos de origem durante uma repetição, ele adiciona um campo de metadados ao evento,`replay-name`, que contém o nome da repetição. Você pode usar esse campo para identificar eventos reproduzidos quando eles são entregues em um destino.
EventBridge também usa esse campo para garantir que os eventos repetidos não sejam enviados para os arquivos.
### Considerações durante a reprodução de eventos a partir de um arquivo
<a name="eb-archive-replay-considerations"></a>
Tenha em mente as seguintes considerações ao reproduzir eventos de um arquivo:
+ Talvez haja um atraso entre um evento ser recebido em um barramento de eventos e o evento chegando no arquivamento. É recomendado adiar a repetição dos eventos arquivados por 10 minutos para garantir que todos os eventos sejam repetidos.
+ Os eventos não são necessariamente reproduzidos na mesma ordem em que foram adicionados ao arquivo. Uma repetição processa eventos em repetições com base na hora do evento e os reproduz em intervalos de um minuto. Se você especificar uma hora de início e uma hora de término do evento que cubra um intervalo de 20 minutos, os eventos serão reproduzidos primeiro a partir do primeiro minuto desse intervalo de 20 minutos. Em seguida, os eventos do segundo minuto são repetidos.
+ Você pode usar a `DescribeReplay` operação da EventBridge API para determinar o progresso de uma repetição. `EventLastReplayedTime`retorna a data e hora do último evento repetido.
+ Os eventos são reproduzidos com base no limite de `PutEvents` transações por segundo da AWS conta, mas separados dele. Você pode solicitar um aumento no limite para PutEvents. Para obter mais informações, consulte [Amazon EventBridge Quotas](https://docs.aws.amazon.com/eventbridge/latest/userguide/cloudwatch-limits-eventbridge.html).
O seguinte vídeo demonstra o uso do Arquivamento e Rreprodução:
# Criação de arquivamentos de eventos no Amazon EventBridge
<a name="eb-archive-event"></a>
Ao criar um arquivamento no EventBridge, você pode determinar quais eventos são enviados para o arquivo especificando um [padrão de evento](eb-event-patterns.md). O EventBridge envia eventos que correspondem ao padrão do evento para o arquivo. Também é definido o período de retenção para armazenar eventos no arquivo antes que eles sejam descartados.
Você também pode criar arquivamentos como parte da [criação de um barramento de eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-event-bus.html). Esses arquivamentos têm uma política de retenção indefinida e nenhum filtro de eventos, embora isso possa ser [atualizado](https://docs.aws.amazon.com/eventbridge/latest/userguide/event-bus-update-archive.html) assim que o arquivamento é criado.
**Topics**
+ [Definir o arquivo](#eb-create-archive-define)
+ [Criar o padrão de eventos (opcional)](#eb-create-archive-event-pattern)
## Definir o arquivo
<a name="eb-create-archive-define"></a>
Primeiro, insira um nome e uma descrição para o arquivamento e especifique o barramento de eventos do qual ele recebe eventos. Você também pode definir por quanto tempo reter eventos no arquivamento.
**Para definir o arquivamento**
1. Abra o console do Amazon EventBridge em [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. Navegue até o barramento de eventos de origem ou crie diretamente o arquivamento:
+ No painel de navegação, selecione **Event buses (Barramentos de eventos)**.
Na página de detalhes do barramento de eventos, selecione a guia **Arquivos**.
+ No painel de navegação, selecione **Arquivos**.
1. Escolha **Criar arquivo**.
1. Em **Detalhe do arquivo**, insira um nome e, como opção, uma descrição para o arquivamento.
O nome deve ser exclusivo na sua conta na sua região selecionada. Não é possível alterar o nome depois de criar o conjunto de IP.
1. Para **Origem**, selecione o barramento de eventos cujos eventos você deseja enviar para o arquivamento
Se você tiver navegado em uma página de detalhes do barramento de eventos existente, o nome desse barramento de eventos será exibido por padrão.
Você não poderá alterar o barramento de eventos de origem depois de ter criado o arquivamento.
1. Para **Período de retenção**, especifique por quanto tempo reter os eventos no arquivamento:
+ Escolha **Indefinido** para reter os eventos no arquivo e nunca excluí-los.
+ Para um período de retenção definido, insira o número de dias após os quais o EventBridge deve excluir os eventos do arquivo.
1. Para **Criptografia**, escolha a chave KMS para o EventBridge usar ao criptografar os eventos armazenados no arquivamento.
**Importante**
Se você tiver especificado que o EventBridge use uma chave gerenciada pelo cliente para criptografar o barramento de eventos de origem, será altamente recomendável você também especificar uma chave gerenciada pelo cliente para qualquer arquivo do barramento de eventos.
+ Escolha **Usar Chave pertencente à AWS** para o EventBridge criptografar os dados usando uma Chave pertencente à AWS.
Esta Chave pertencente à AWS é uma chave KMS de propriedade do EventBridge e que gerencia para uso em várias contas da AWS. Em geral, a menos que seja necessário auditar ou controlar a chave de criptografia que protege os recursos, uma Chave pertencente à AWS é uma boa escolha.
Esse é o padrão.
+ Escolha **Usar chave gerenciada pelo cliente** para o EventBridge criptografar os dados usando a chave gerenciada pelo cliente especificada ou criada por você.
As chaves gerenciadas pelo cliente são KMS na conta da AWS que você cria, detém e gerencia. Você tem controle total sobre essas chaves KMS.
1. Especifique uma chave gerenciada pelo cliente existente ou escolha **Criar uma nova chave KMS**.
O EventBridge exibe o status da chave e todos os aliases de chave que tenham sido associados à chave gerenciada pelo cliente especificada.
1. Escolha **Próximo**.
## Criar o padrão de eventos (opcional)
<a name="eb-create-archive-event-pattern"></a>
Em seguida, como uma etapa opcional, você poderá criar um padrão de evento para filtrar quais eventos o EventBridge envia para o arquivamento. Para fazer isso, especifique a origem do evento, escolha a base para o padrão do evento e defina os atributos e valores aos quais corresponder. Também é possível gerar o padrão de evento em JSON e testá-lo em um evento de amostra.
Para obter mais informações sobre padrões de eventos, consulte [](eb-event-patterns.md).
**Para criar o padrão de eventos**
1. Em **Origem do evento**, escolha **Eventos da AWS ou eventos de parceiro do EventBridge**.
1. (Opcional) Na seção **Eventos de amostra**, escolha um **Tipo de evento de amostra** com o qual deseja testar seu padrão de evento.
Os seguintes tipos de eventos estão disponíveis:
+ **Eventos da AWS**: selecione entre os eventos emitidos pelos Serviços da AWS compatíveis.
+ **Eventos de parceiros do EventBridge**: selecione entre os eventos emitidos por serviços de terceiros que são compatíveis com o EventBridge, como o Salesforce.
+ **Inserir o meu próprio**: insira o seu próprio evento em texto JSON.
Também é possível usar um evento da AWS ou um evento de um parceiro como ponto de partida para criar seu próprio evento personalizado.
1. Selecione **Eventos da AWS** ou **Eventos de parceiros do EventBridge**.
1. Use o menu suspenso **Exemplos de eventos** para selecionar o evento que deseja usar como ponto de partida para seu evento personalizado.
O EventBridge exibe o evento de amostra.
1. Selecione **Copiar**.
1. Selecione **Inserir meu próprio** para o **Tipo de evento**.
1. Exclua a estrutura de eventos de amostra no painel de edição JSON e cole o evento da AWS ou do parceiro no lugar.
1. Edite o JSON do evento para criar seu próprio evento de amostra.
1. Escolha um **Método de criação**. Também é possível criar um padrão de evento a partir de um esquema ou modelo do EventBridge ou criar um padrão de evento personalizado.
------
#### [ Existing schema ]
Para usar um esquema do EventBridge existente para criar o padrão de evento, faça o seguinte:
1. Na seção **Método de criação**, em **Método**, selecione **Usar esquema**.
1. Na seção **Padrão de evento**, em **Tipo de esquema**, selecione **Selecionar esquema do registro do esquema**.
1. Em **Registro do esquema**, escolha a caixa suspensa e insira o nome de um registro do esquema, como `aws.events`. Também é possível selecionar uma opção na lista suspensa que aparece.
1. Em **Esquema**, escolha a caixa suspensa e insira o nome do esquema a ser usado. Por exemplo, `aws.s3@ObjectDeleted`. Também é possível selecionar uma opção na lista suspensa que aparece.
1. Na seção **Modelos**, escolha o botão **Editar** ao lado de qualquer atributo para abrir suas propriedades. Defina os campos **Relacionamento** e **Valor** conforme necessário e escolha **Definir** para salvar o atributo.
**nota**
Para obter informações sobre a definição de um atributo, escolha o ícone **Informações** ao lado do nome do atributo. Para obter uma referência sobre como definir propriedades de atributos em seu evento, abra a seção **Observação** da caixa de diálogo de propriedades de atributos.
Para excluir as propriedades de um atributo, escolha o botão **Editar** para esse atributo e escolha **Limpar**.
1. Escolha **Gerar padrão de evento em JSON** para gerar e validar seu padrão de evento como texto JSON.
1. (Opcional) Para testar o evento de amostra em relação ao seu padrão de teste, escolha **Padrão de teste**.
O EventBridge exibe uma caixa de mensagem informando se seu evento de amostra corresponde ao padrão do evento.
Também é possível escolher uma das seguintes opções:
+ **Copiar**: copie o padrão do evento para a área de transferência do seu dispositivo.
+ **Aprimorar:** facilita a leitura do texto JSON adicionando quebras de linha, tabulações e espaços.
------
#### [ Custom schema ]
Para escrever um esquema personalizado e convertê-lo em um padrão de evento, faça o seguinte:
1. Na seção **Método de criação**, em **Método**, escolha **Usar esquema**.
1. Na seção **Padrão de evento**, em **Tipo de esquema**, escolha **Inserir esquema**.
1. Insira o seu esquema na caixa de texto. É preciso formatar o esquema como texto JSON válido.
1. Na seção **Modelos**, escolha o botão **Editar** ao lado de qualquer atributo para abrir suas propriedades. Defina os campos **Relacionamento** e **Valor** conforme necessário e escolha **Definir** para salvar o atributo.
**nota**
Para obter informações sobre a definição de um atributo, escolha o ícone **Informações** ao lado do nome do atributo. Para obter uma referência sobre como definir propriedades de atributos em seu evento, abra a seção **Observação** da caixa de diálogo de propriedades de atributos.
Para excluir as propriedades de um atributo, escolha o botão **Editar** para esse atributo e escolha **Limpar**.
1. Escolha **Gerar padrão de evento em JSON** para gerar e validar seu padrão de evento como texto JSON.
1. (Opcional) Para testar o evento de amostra em relação ao seu padrão de teste, escolha **Padrão de teste**.
O EventBridge exibe uma caixa de mensagem informando se seu evento de amostra corresponde ao padrão do evento.
Também é possível escolher uma das seguintes opções:
+ **Copiar**: copie o padrão do evento para a área de transferência do seu dispositivo.
+ **Aprimorar:** facilita a leitura do texto JSON adicionando quebras de linha, tabulações e espaços.
------
#### [ Event pattern ]
Para escrever um padrão de evento personalizado no formato JSON, faça o seguinte:
1. Na seção **Método de criação**, em **Método**, escolha **Padrão personalizado (editor JSON)**.
1. Em **Padrão de evento**, insira seu padrão de evento personalizado em texto formatado em JSON.
1. (Opcional) Para testar o evento de amostra em relação ao seu padrão de teste, escolha **Padrão de teste**.
O EventBridge exibe uma caixa de mensagem informando se seu evento de amostra corresponde ao padrão do evento.
Também é possível escolher uma das seguintes opções:
+ **Copiar**: copie o padrão do evento para a área de transferência do seu dispositivo.
+ **Aprimorar:** facilita a leitura do texto JSON adicionando quebras de linha, tabulações e espaços.
+ **Formulário de padrão de evento**: abre o padrão de evento no Criador de padrões. Se o padrão não puder ser renderizado no Criador do Padrão no estado em que se encontra, o EventBridge avisará antes de abrir o Criador do Padrão.
------
1. Escolha **Criar arquivo**.
Para confirmar se os eventos foram enviados com êxito para o arquivamento, você pode usar a operação [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_DescribeArchive.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_DescribeArchive.html) da API do EventBridge para ver se a `EventCount` reflete o número de eventos no arquivamento. Se for 0, não há eventos no arquivo.
# Atualização de arquivos nos ônibus de EventBridge eventos da Amazon
<a name="event-bus-update-archive"></a>
Você pode atualizar o seguinte:
+ Descrição do arquivo
+ Um padrão de evento usado para filtrar quais eventos são enviados para o arquivamento.
+ O período de retenção dos eventos.
+ O AWS KMS key usado para criptografia de eventos.
Para obter mais informações, consulte [Criptografia de arquivamentos](encryption-archives.md).
Você não poderá alterar o nome ou o barramento de eventos de origem de um arquivamento depois que ele tiver sido criado.
**nota**
A descoberta de esquemas não é compatível com barramentos de eventos criptografados que usem uma chave gerenciada pelo cliente. Para habilitar a descoberta de esquemas em um barramento de eventos, opte por usar uma Chave pertencente à AWS. Para obter mais informações, consulte [Opções de chave KMS](eb-encryption-at-rest-key-options.md).
**Para atualizar um arquivo (console)**
1. Abra o EventBridge console da Amazon em [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. Navegue diretamente até o arquivo ou a partir do barramento de eventos de origem:
+ No painel de navegação, selecione **Event buses (Barramentos de eventos)**.
Na página de detalhes do barramento de eventos, selecione a guia **Arquivos**.
+ No painel de navegação, selecione **Arquivos**.
1. Selecione o arquivamento e **Editar**.
1. Atualize o arquivamento.
**Para atualizar um arquivamento para um barramento de eventos (AWS CLI)**
+ Use [update-archive](https://docs.aws.amazon.com/cli/latest/reference/events/update-archive.html).
# Excluindo arquivos de eventos na Amazon EventBridge
<a name="eb-archive-delete"></a>
Quando você exclui um arquivo, EventBridge exclui os seguintes recursos:
+ O arquivamento e todos os eventos que ele contém.
+ O padrão do evento, se houver, especificado para o arquivamento.
+ A regra EventBridge gerenciada gerada para o arquivamento.
**Para excluir um arquivamento de um barramento de eventos (console)**
1. Abra o EventBridge console da Amazon em [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. Navegue diretamente até o arquivo ou a partir do barramento de eventos de origem:
+ No painel de navegação, selecione **Event buses (Barramentos de eventos)**.
Na página de detalhes do barramento de eventos, selecione a guia **Arquivos**.
+ No painel de navegação, selecione **Arquivos**.
1. Escolha o barramento de eventos que contém o arquivamento que você deseja excluir.
1. Na página de detalhes do barramento de eventos, selecione a guia **Arquivamentos**.
1. Selecione o arquivamento e **Excluir**.
**Para excluir um arquivo (AWS CLI)**
+ Use [delete-archive](https://docs.aws.amazon.com/cli/latest/reference/events/delete-archive.html).
# Criação de replays de eventos arquivados na Amazon EventBridge
<a name="eb-replay-archived-event"></a>
Ao iniciar uma nova repetição, você especifica um período de tempo para o evento que deseja reenviar EventBridge para o barramento de eventos de origem. Você também pode especificar EventBridge para enviar os eventos para regras específicas.
**Para iniciar a reprodução de um evento (console)**
1. Abra o EventBridge console da Amazon em [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. Navegue diretamente até as reproduções ou pelo arquivamento que você deseja reproduzir:
+ No painel de navegação, selecione **Arquivos**.
Na página **Arquivos**, escolha o arquivamento e **Reproduzir**.
+ No painel de navegação, escolha **Reproduções**.
Escolha **Iniciar nova repetição**.
1. Informe um **Nome** para a reprodução e, opcionalmente, uma **Descrição**.
1. Em **Origem**, selecione o arquivo do qual reproduzir eventos.
1. Para o destino, é possível reproduzir eventos somente no mesmo barramento de eventos que emitiu os eventos.
1. Em **Especificar regras**, especifique uma das seguintes:
+ Escolha **Todas as regras** para repetir os eventos de acordo com todas as regras.
+ Escolha **Especificar regras** e selecione a regra ou as regras para as quais reproduzir os eventos.
1. Em **Período de tempo de repetição**, especifique a **data**, a **hora** e o **fuso horário** para a **hora de início** e a **hora de término**.
Somente eventos que ocorreram entre a hora de **início e a hora** de **hora de término** são reproduzidos.
1. Selecione **Iniciar repetição**.
**Para iniciar uma reprodução (AWS CLI)**
+ Use [start-replay](https://docs.aws.amazon.com/cli/latest/reference/events/start-replay.html).
# Cancelamento de repetições de eventos arquivados na Amazon EventBridge
<a name="eb-replay-cancel"></a>
Se iniciar uma reprodução e depois quiser pará-la, você poderá cancelá-la com o status `Starting` ou `Running`.
**Para cancelar uma reprodução (console)**
1. Abra o EventBridge console da Amazon em [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. No painel de navegação à esquerda, escolha **Reproduções**.
1. Escolha a reprodução a ser cancelada.
1. Escolha **Cancelar**.
**Para cancelar uma reprodução (AWS CLI)**
+ Use [cancel-replay](https://docs.aws.amazon.com/cli/latest/reference/events/cancel-replay.html).
# Tornando os aplicativos tolerantes a falhas regionais com endpoints globais em EventBridge
<a name="eb-global-endpoints"></a>
Você pode melhorar a disponibilidade do seu aplicativo com os endpoints EventBridge globais da Amazon. Os endpoints globais ajudam a tornar sua aplicação tolerante a falhas regionais sem custo adicional. Para começar, atribuia uma verificação de integridade do Amazon Route 53 ao endpoint. Quando o failover é iniciado, a verificação de integridade relata um estado "não íntegro". Poucos minutos após o início do failover, todos os [eventos](eb-events.md) personalizados são roteados para um [barramento de eventos](eb-event-bus.md) na região secundária e processados por esse barramento de eventos. Depois que a verificação de integridade relata um estado "saudável", os eventos são processados pelo barramento de eventos na região principal.
Ao usar endpoints globais, é possível ativar a [replicação de eventos](#eb-ge-event-replication). A replicação de eventos envia todos os eventos personalizados para os barramentos de eventos nas regiões primária e secundária usando regras gerenciadas.
**nota**
Se estiver usando barramentos personalizados, será preciso ter um barramento personalizado em cada região com o mesmo nome e na mesma conta para que o failover funcione corretamente.
## Objetivos de tempo de recuperação e ponto de recuperação
<a name="eb-ge-rpo-rto"></a>
O objetivo de tempo de recuperação (RTO) é o tempo necessário para que a região secundária comece a receber eventos após uma falha. Para o RTO, o tempo inclui o período para acionar CloudWatch alarmes e atualizar os status das verificações de saúde do Route 53. O objetivo de ponto de recuperação (RPO) é a medida dos dados que não serão processados durante uma falha. No RPO, o tempo inclui eventos que não são replicados para a região secundária e ficam presos na região primária até que o serviço ou a região se recuperem. Com endpoints globais, se seguir nossa orientação prescritiva para configuração de alarmes, poderá esperar que o RTO e o RPO sejam de 360 segundos com um máximo de 420 segundos.
## Replicação de eventos
<a name="eb-ge-event-replication"></a>
Os eventos são processados na região secundária de forma assíncrona. Isto significa que não é garantido que os eventos sejam processados ao mesmo tempo nas duas regiões. Quando o failover é acionado, os eventos são processados pela região secundária e serão processados pela região primária quando estiverem disponíveis. Habilitar a replicação de eventos aumentará seus custos mensais. Para obter mais informações, consulte os [ EventBridgepreços da Amazon](https://aws.amazon.com/eventbridge/pricing)
É recomendado ativar a replicação de eventos ao configurar endpoints globais pelos seguintes motivos:
+ A replicação de eventos ajuda a verificar se seus endpoints globais estão configurados corretamente. Isto ajuda a garantir que você esteja coberto em caso de failover.
+ A replicação de eventos é necessária para se recuperar automaticamente de um evento de failover. Se não tiver a replicação de eventos ativada, precisará redefinir manualmente a verificação de integridade do Route 53 para "íntegra" antes que os eventos retornem à região principal.
### Carga útil de eventos replicada
<a name="eb-ge-event-replication-ep"></a>
A seguir, um exemplo de carga útil de evento replicado.
**nota**
Em `region`, a região da qual o evento foi replicado é listada.
```
{
"version": "0",
"id": "a908baa3-65e5-ab77-367e-527c0e71bbc2",
"detail-type": "Test",
"source": "test.service.com",
"account": "0123456789",
"time": "1900-01-01T00:00:00Z",
"region": "us-east-1",
"resources": [
"arn:aws:events:us-east-1:0123456789:endpoint/MyEndpoint"
],
"detail": {
"a": "b"
}
}
```
## Trabalhando com endpoints globais usando um SDK AWS
<a name="eb-ge-sdk-update"></a>
**nota**
Em breve, compatibilidade com C\$1\$1.
Ao usar um AWS SDK para trabalhar com endpoints globais, lembre-se do seguinte:
+ Você precisará ter a biblioteca AWS Common Runtime (CRT) instalada para seu SDK específico. Se não tiver o CRT instalado, receberá uma mensagem de exceção indicando o que precisa ser instalado. Para saber mais, consulte:
+ [Bibliotecas do AWS Common Runtime (CRT)](https://docs.aws.amazon.com/sdkref/latest/guide/common-runtime.html)
+ [lajes/aws-crt-java](https://github.com/awslabs/aws-crt-java)
+ [lajes/aws-crt-nodejs](https://github.com/awslabs/aws-crt-nodejs)
+ [lajes/aws-crt-python](https://github.com/awslabs/aws-crt-python)
+ Depois de criar um endpoint global, será preciso adicionar o `endpointId` e o `EventBusName` a todas as chamadas `PutEvents` que usar.
+ Endpoints globais são compatíveis com o Signature versão 4A. Esta versão do SigV4 permite que as solicitações sejam assinadas para várias Regiões da AWS. Isso é útil em operações de API que podem resultar em acesso a dados de uma das várias regiões. Ao usar o AWS SDK, você fornece suas credenciais e as solicitações para endpoints globais usarão o Signature versão 4A sem configuração adicional. Para obter mais informações sobre SigV4A, consulte [Assinatura de solicitações de API da AWS](https://docs.aws.amazon.com/general/latest/gr/signing_aws_api_requests.html ) na * Referência geral da AWS *.
Se você solicitar credenciais temporárias do AWS STS endpoint global (sts.amazonaws.com), vende credenciais que, por padrão, não são AWS STS compatíveis com SigV4a. Consulte [Gerenciando AWS STS em uma AWS região](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_enable-regions.html) no *Guia do AWS Identity and Access Management usuário* para obter mais informações.
## Regiões disponíveis
<a name="eb-ge-avail-regions"></a>
As seguintes regiões são compatíveis com endpoints globais:
+ Leste dos EUA (Norte da Virgínia)
+ Leste dos EUA (Ohio)
+ Oeste dos EUA (N. da Califórnia)
+ Oeste dos EUA (Oregon)
+ Canadá (Central)
+ Europa (Frankfurt)
+ Europa (Irlanda)
+ Europa (Londres)
+ Europa (Milão)
+ Europa (Paris)
+ Europa (Estocolmo)
+ Ásia-Pacífico (Mumbai)
+ Ásia-Pacífico (Osaka)
+ Ásia-Pacífico (Seul)
+ Ásia-Pacífico (Singapura)
+ Ásia-Pacífico (Sydney)
+ Ásia-Pacífico (Tóquio)
+ América do Sul (São Paulo)
# Criação de um endpoint global na Amazon EventBridge
<a name="eb-ge-create-endpoint"></a>
Para configurar um endpoint global, conclua as seguintes etapas:
1. Verifique se você tem barramentos e regras de eventos correspondentes na região primária e secundária.
1. Crie uma [verificação de integridade do Route 53](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/health-checks-creating.html) para monitorar seus barramentos de eventos. Para obter ajuda na criação de sua verificação de integridade, escolha **Nova verificação de integridade** ao criar seu endpoint global.
1. Crie seu endpoint global.
Depois de configurar a verificação de integridade do Route 53, é possível criar um endpoint global.
## Para criar um endpoint global usando o console
<a name="eb-ge-create-endpoint-console"></a>
1. Abra o EventBridge console da Amazon em [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. No painel de navegação, escolha **Endpoints globais**.
1. Escolha **Criar endpoint**.
1. Insira um nome e uma descrição para o endpoint.
1. Em **Barramento de eventos na região principal**, escolha o barramento de eventos ao qual deseja que o endpoint fosse associado.
1. Em **Região secundária**, escolha a região para a qual gostaria de direcionar os eventos no caso de um failover.
**nota**
O **barramento de eventos na região secundária** é preenchido automaticamente e não é editável.
1. Na **verificação de integridade do Route 53 para acionar o failover e a recuperação**, escolha a verificação de integridade que o endpoint monitorará. Se você ainda não tiver uma verificação de saúde, escolha **Nova verificação de integridade** para abrir o CloudFormation console e criar uma verificação de saúde usando um CloudFormation modelo.
**nota**
A falta de dados fará com que a verificação de integridade falhe. Se você só precisar enviar eventos de forma intermitente, considere usar um mais longo **MinimumEvaluationPeriod**ou tratar os dados perdidos como “ausentes” em vez de “violados”.
1. (Opcional) Para **Replicação de eventos**, faça o seguinte:
1. Selecione **Replicação de eventos ativada**.
1. Em **Perfil de execução**, escolha se deseja criar um novo perfil do AWS Identity and Access Management ou usar um perfil existente. Faça o seguinte:
+ Escolha **Create a new role for this specific resource (Criar uma função para este recurso específico)**. Opcionalmente, você pode atualizar o **nome do perfil** para criar um novo perfil.
+ Escolha **Usar perfil existente**. Em **Perfil de execução**, escolha o perfil desejado a ser usado.
1. Escolha **Criar**.
## Para criar um endpoint global usando a API
<a name="eb-ge-create-endpoint-api"></a>
Para criar um endpoint global usando a EventBridge API, consulte [CreateEndpoint](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_CreateEndpoint.html)na Amazon EventBridge API Reference.
## Para criar um endpoint global usando CloudFormation
<a name="eb-ge-create-endpoint-cfn"></a>
Para criar um endpoint global usando a AWS CloudFormation API, consulte [AWS::Events::Endpoints](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-events-endpoint.html)o Guia do AWS CloudFormation usuário.
# Práticas recomendadas para endpoints globais do Amazon EventBridge
<a name="eb-ge-best-practices"></a>
As práticas recomendadas a seguir são aconselháveis ao configurar endpoints globais.
## Habilitar a replicação de eventos
<a name="eb-ge-bp-enable-replication"></a>
É altamente recomendável que ativar a replicação e processar seus eventos na região secundária atribuída ao seu endpoint global. Isto garante que sua aplicação na região secundária seja configurada corretamente. Também é preciso ativar a replicação para garantir a recuperação automática na região principal após a mitigação de um problema.
Os IDs de eventos podem mudar nas chamadas de API. Portanto, correlacionar eventos entre regiões exige que exista um identificador exclusivo e imutável. Os consumidores também devem ser projetados com a idempotência em mente. Dessa forma, se estiver replicando eventos ou reproduzindo-os de arquivos, não haverá efeitos colaterais do processamento dos eventos nas duas regiões.
## Como evitar o controle de utilização de eventos
<a name="eb-ge-bp-throttling"></a>
Para evitar que os eventos sejam limitados, é recomendado atualizar seus limites `PutEvents` e os limites de destino para que sejam consistentes em todas as regiões.
## Como usar métricas de assinantes nas verificações de integridade do Amazon Route 53
<a name="eb-ge-bp-sub-metrics"></a>
Evite incluir métricas de assinantes em suas verificações de integridade do Amazon Route 53. Incluir essas métricas pode fazer com que seu publicador faça failover para as regiões secundárias se um assinante encontrar um problema, apesar de todos os outros assinantes permanecerem saudáveis na região primária. Se um de seus assinantes não conseguir processar eventos na região principal, a replicação deve ser ativada para garantir que seu assinante na região secundária possa processar eventos com êxito.
# Configurar a verificação de integridade do Route 53 para endpoints globais do EventBridge
<a name="eb-ge-cfn"></a>
Ao usar endpoints globais, você precisa fazer uma verificação de integridade do Route 53 para monitorar o status de suas regiões. O modelo a seguir define um alarme do [Amazon CloudWatch](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cw-alarm.html) e o usa para definir [uma verificação de integridade do Route 53](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-route53-healthcheck.html).
**Topics**
+ [Modelo do CloudFormation para definir uma verificação de integridade do Route 53](#eb-ge-cfn-template)
+ [Propriedades do modelo de alarmes do CloudWatch](#eb-ge-cfn-cw-alarm-definitions)
+ [Propriedades do modelo de verificações de integridade do Route 53](#eb-ge-cfn-health-check-definitions)
## Modelo do CloudFormation para definir uma verificação de integridade do Route 53
<a name="eb-ge-cfn-template"></a>
Use o modelo a seguir para definir sua verificações de integridade do Route 53.
```
Description: |-
Global endpoints health check that will fail when the average Amazon EventBridge
latency is above 30 seconds for a duration of 5 minutes. Note, missing data will
cause the health check to fail, so if you only send events intermittently, consider
changing the heath check to use a longer evaluation period or instead treat missing
data as 'missing' instead of 'breaching'.
Metadata:
AWS::CloudFormation::Interface:
ParameterGroups:
- Label:
default: "Global endpoint health check alarm configuration"
Parameters:
- HealthCheckName
- HighLatencyAlarmPeriod
- MinimumEvaluationPeriod
- MinimumThreshold
- TreatMissingDataAs
ParameterLabels:
HealthCheckName:
default: Health check name
HighLatencyAlarmPeriod:
default: High latency alarm period
MinimumEvaluationPeriod:
default: Minimum evaluation period
MinimumThreshold:
default: Minimum threshold
TreatMissingDataAs:
default: Treat missing data as
Parameters:
HealthCheckName:
Description: Name of the health check
Type: String
Default: LatencyFailuresHealthCheck
HighLatencyAlarmPeriod:
Description: The period, in seconds, over which the statistic is applied. Valid values are 10, 30, 60, and any multiple of 60.
MinValue: 10
Type: Number
Default: 60
MinimumEvaluationPeriod:
Description: The number of periods over which data is compared to the specified threshold. You must have at least one evaluation period.
MinValue: 1
Type: Number
Default: 5
MinimumThreshold:
Description: The value to compare with the specified statistic.
Type: Number
Default: 30000
TreatMissingDataAs:
Description: Sets how this alarm is to handle missing data points.
Type: String
AllowedValues:
- breaching
- notBreaching
- ignore
- missing
Default: breaching
Mappings:
"InsufficientDataMap":
"missing":
"HCConfig": "LastKnownStatus"
"breaching":
"HCConfig": "Unhealthy"
Resources:
HighLatencyAlarm:
Type: AWS::CloudWatch::Alarm
Properties:
AlarmDescription: High Latency in Amazon EventBridge
MetricName: IngestionToInvocationStartLatency
Namespace: AWS/Events
Statistic: Average
Period: !Ref HighLatencyAlarmPeriod
EvaluationPeriods: !Ref MinimumEvaluationPeriod
Threshold: !Ref MinimumThreshold
ComparisonOperator: GreaterThanThreshold
TreatMissingData: !Ref TreatMissingDataAs
LatencyHealthCheck:
Type: AWS::Route53::HealthCheck
Properties:
HealthCheckTags:
- Key: Name
Value: !Ref HealthCheckName
HealthCheckConfig:
Type: CLOUDWATCH_METRIC
AlarmIdentifier:
Name:
Ref: HighLatencyAlarm
Region: !Ref AWS::Region
InsufficientDataHealthStatus: !FindInMap [InsufficientDataMap, !Ref TreatMissingDataAs, HCConfig]
Outputs:
HealthCheckId:
Description: The identifier that Amazon Route 53 assigned to the health check when you created it.
Value: !GetAtt LatencyHealthCheck.HealthCheckId
```
Os IDs de eventos podem mudar nas chamadas de API. Portanto, correlacionar eventos entre regiões exige que exista um identificador exclusivo e imutável. Os consumidores também devem ser projetados com a idempotência em mente. Dessa forma, se estiver replicando eventos ou reproduzindo-os de arquivos, não haverá efeitos colaterais do processamento dos eventos nas duas regiões.
## Propriedades do modelo de alarmes do CloudWatch
<a name="eb-ge-cfn-cw-alarm-definitions"></a>
**nota**
Para todos os campos **editable**, considere seu throughput por segundo. Se só envia eventos de forma intermitente, considere alterar a verificação de integridade para usar um período de avaliação mais longo ou, em vez disso, tratar os dados ausentes como se fossem `missing` em vez de `breaching`.
As seguintes propriedades são usadas na seção de alarme do CloudWatch do modelo:
| Métrica | Descrição |
| --- | --- |
| `AlarmDescription` | A descrição do alarme. Padrão: **High Latency in Amazon EventBridge** |
| `MetricName` | O nome da métrica associada ao alarme. Isso é necessário para um alarme com base em uma métrica. Para um alarme com base em uma expressão matemática, use `Metrics`, e você não pode especificar `MetricName`. Padrão: IngestionToInvocationStartLatency |
| `Namespace` | O namespace da métrica associada ao alarme. Isso é necessário para um alarme com base em uma métrica. Para um alarme com base em uma expressão matemática, não é possível especificar `Namespace`, em vez disso, use `Metrics`. Padrão: `AWS/Events` |
| `Statistic` | A estatística da métrica associada ao alarme, diferente do percentil. Padrão: médio |
| `Period` | O período, em segundos, durante o qual a estatística é aplicada. Isso é necessário para um alarme com base em uma métrica. Os valores válidos são 10, 30, 60 e qualquer múltiplo de 60. Padrão: **60** |
| `EvaluationPeriods` | O número de períodos com os quais os dados são comparados ao limite especificado. Se você estiver configurando um alarme que exija que vários pontos de dados consecutivos estejam em violação para acionar o alarme, esse valor especificará esse número. Se você estiver definindo um alarme “M de N”, esse valor será o N e `DatapointsToAlarm` será o M. Padrão: **5** |
| `Threshold` | O valor para comparar com a estatística especificada. Padrão: **30,000** |
| `ComparisonOperator` | A operação aritmética a ser usada ao comparar a estatística e o limite especificados. O valor da estatística especificada é usado como o primeiro operando. Padrão: `GreaterThanThreshold` |
| `TreatMissingData` | Define como esse alerta deve lidar com pontos de dados ausentes. Valores válidos: `breaching`, `notBreaching`, `ignore` e `missing` Padrão: `breaching` |
## Propriedades do modelo de verificações de integridade do Route 53
<a name="eb-ge-cfn-health-check-definitions"></a>
**nota**
Para todos os campos **editable**, considere seu throughput por segundo. Se só envia eventos de forma intermitente, considere alterar a verificação de integridade para usar um período de avaliação mais longo ou, em vez disso, tratar os dados ausentes como se fossem `missing` em vez de `breaching`.
As seguintes propriedades são usadas na seção de verificação de integridade do Route 53 do modelo:
| Métrica | Descrição |
| --- | --- |
| `HealthCheckName` | O nome da verificação de integridade. Padrão: **LatencyFailuresHealthCheck** |
| `InsufficientDataHealthStatus` | Quando o CloudWatch tem dados insuficientes sobre a métrica para determinar o estado do alarme, o status que você deseja que o Amazon Route 53 atribua à verificação de integridade Valores válidos: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/eventbridge/latest/userguide/eb-ge-cfn.html) Padrão: não íntegro Este campo é atualizado com base na entrada do campo `TreatMissingData`. If `TreatingMissingData` for definido como `Missing`, será atualizado para `LastKnownStatus`. Se `TreatingMissingData` for definido como `Breaching`, será atualizado para `Unhealthy`. |
# Configurando registros para ônibus de EventBridge eventos da Amazon
<a name="eb-event-bus-logs"></a>
Você pode configurar EventBridge para enviar registros detalhando como um barramento de eventos está processando eventos, para ajudar na solução de problemas e na depuração.
Você pode selecionar os seguintes AWS serviços como *destinos de registro* para os quais EventBridge entregam registros para o barramento de eventos especificado:
+ CloudWatch Registros da Amazon
EventBridge entrega registros para o grupo de CloudWatch registros de registros especificado.
Use o CloudWatch Logs para centralizar os registros de todos os seus sistemas, aplicativos e AWS serviços que você usa, em um único serviço altamente escalável. Para obter mais informações, consulte Como [trabalhar com grupos e fluxos de registros](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html) no *Guia do usuário do Amazon CloudWatch Logs*.
+ Amazon Data Firehose
EventBridge entrega registros para um stream de entrega do Firehose.
O Amazon Data Firehose é um serviço totalmente gerenciado para fornecer dados de streaming em tempo real para destinos como determinados AWS serviços, bem como qualquer endpoint HTTP personalizado ou endpoints HTTP de propriedade de provedores de serviços terceirizados compatíveis. Para obter mais informações, consulte [Creating an Amazon Data Firehose delivery stream](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html) no *Guia do desenvolvedor do Amazon Data Firehose*.
+ Amazon S3
EventBridge entrega registros como objetos do Amazon S3 para o bucket especificado.
O Amazon S3 é um serviço de armazenamento de objetos que oferece escalabilidade, disponibilidade de dados, segurança e performance líderes do setor. Para obter mais informações, consulte [Fazer upload, baixar e trabalhar com objetos no Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/uploading-downloading-objects.html) no *Manual do usuário do Amazon Simple Storage Service*.
## Como funciona o registro em log para barramentos de eventos
<a name="eb-event-logs-overview"></a>
EventBridge gera registros para:
+ Qualquer evento AWS de serviço que corresponda a uma regra no barramento de eventos
+ Qualquer evento entregue pelos seguintes métodos, independentemente do evento ter sido ingerido com êxito ou corresponder a alguma regra:
+ Eventos das [fontes de eventos de parceiro](eb-saas.md)
+ Eventos [reproduzidos de um arquivo](eb-archive.md)
+ Eventos enviados para o barramento por meio de [`PutEvents`](eb-putevents.md)
EventBridge não registra eventos que correspondam apenas às [regras gerenciadas](eb-rules.md#eb-rules-managed).
Os dados de log enviados para cada destino de log selecionado são iguais.
Você pode personalizar os registros EventBridge enviados para os destinos selecionados da seguinte forma:
+ Você pode especificar o *nível do registro*, que determina as etapas para as quais os registros são EventBridge enviados para os destinos selecionados. Para obter mais informações, consulte [Especificação do nível de log do barramento de eventos](#eb-event-bus-logs-level).
+ Você pode especificar se EventBridge inclui mais informações granulares quando relevante, incluindo:
+ Detalhes do evento
+ Informações de entrada do destino
+ Informações de solicitação do destino
Para obter mais informações, consulte [Inclusão de dados detalhados em logs do barramento de eventos](#eb-event-logs-data).
### Considerações da entrega de log
<a name="eb-event-logs-delivery"></a>
Tenha as seguintes considerações em mente ao configurar o registro em log para barramentos de eventos:
+ Os registros de log do barramento de eventos são entregues com base no melhor esforço. A maioria das solicitações para um barramento de eventos devidamente configurada para registro em log resulta em um registro de log entregue. A integralidade e a pontualidade do registro em log do barramento de eventos não são garantidas.
+ Em algumas circunstâncias, a entrega de registros de log do barramento de eventos por si só gera eventos que são enviados para EventBridge, o que pode causar interrupções na entrega dos registros de log. Por esse motivo, EventBridge não registra os seguintes eventos:
+ AWS KMS `[Decrypt](https://docs.aws.amazon.com/kms/latest/APIReference/API_Decrypt.html)`e `[GenerateDataKey](https://docs.aws.amazon.com/kms/latest/APIReference/API_GenerateDataKey.html)` eventos gerados quando registros de log criptografados usando uma chave gerenciada pelo cliente são entregues a um destino de log.
+ Os eventos `[PutRecordBatch](https://docs.aws.amazon.com/firehose/latest/APIReference/API_PutRecordBatch.html)` no Firehose gerados pela entrega dos logs do barramento de eventos.
+ Para destinos de log do S3, não é recomendável especificar um bucket de destino com a [notificação de eventos EventBridge](https://docs.aws.amazon.com/AmazonS3/latest/userguide/enable-event-notifications-eventbridge.html) ativada, pois isso pode resultar em interrupção na entrega de seus registros.
### Registro em log da criptografia
<a name="eb-event-logs-encryption"></a>
Ao enviar registros, EventBridge criptografa as `error` seções `detail` e de cada registro de log com a chave KMS especificada para o barramento de eventos. Depois de entregue, o registro será descriptografado e, em seguida, recriptografado com a chave KMS especificada para o destino do log.
Para obter mais informações, consulte [Criptografia de logs do barramento de eventos](encryption-bus-logs.md).
### Especificação das permissões do registro em log do barramento de eventos
<a name="eb-event-logs-permission"></a>
Para habilitar o registro a partir de um barramento de eventos, você deve conceder permissões EventBridge para enviar registros desse barramento. Adicione uma política que conceda subsídios **AllowVendedLogDeliveryForResource**ao ônibus do evento.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "ServiceLevelAccessForLogDelivery",
"Effect": "Allow",
"Action": [
"events:AllowVendedLogDeliveryForResource"
],
"Resource": "arn:aws:events:us-east-1:123456789012:event-bus/my-event-bus*"
}
]
}
```
------
Para obter mais informações, consulte [Permissões específicas do serviço no Guia](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html#AWS-vended-logs-permissions) do *usuário de CloudWatch registros*.
## Especificação do nível de log do barramento de eventos
<a name="eb-event-bus-logs-level"></a>
Você pode especificar os tipos de etapas de processamento de eventos que são EventBridge registrados nos destinos de log selecionados.
Escolha um dentre os níveis de detalhe a seguir para incluir em logs. O nível de log se aplica a todos os destinos de log especificados para o barramento de eventos. Cada nível de log inclui as etapas dos níveis de log anteriores.
+ **DESLIGADO** — EventBridge não envia nenhum registro. Esse é o padrão.
+ **ERRO** — EventBridge envia todos os registros relacionados aos erros gerados durante o processamento do evento e a entrega do alvo.
+ **INFO** — EventBridge envia todos os registros relacionados a erros, bem como as principais etapas executadas durante o processamento do evento.
+ **TRACE** — EventBridge envia todos os registros gerados durante todas as etapas do processamento do evento.
A tabela a seguir lista as etapas de processamento de eventos inclusas em cada nível do log.
| Etapa | RASTREAR | INFO | ERRO | DESL. |
| --- | --- | --- | --- | --- |
| Evento ingerido | x | x | | |
| Falha na ingestão de eventos | x | x | x | |
| Evento recebido | x | | | |
| Tentativa de invocação iniciada | x | | | |
| Falha permanente na tentativa de invocação | x | x | x | |
| Falha na nova tentativa de invocação | x | x | x | |
| Tentativa de invocação com êxito | x | | | |
| Tentativa de invocação com controle de utilização | x | x | x | |
| DLQ de invocação | x | x | x | |
| Falha na invocação | x | x | x | |
| Invocação iniciada | x | x | | |
| Invocação bem-sucedida | x | x | | |
| Invocação iniciada com controle de utilização | x | x | x | |
| Nenhuma regra correspondente | x | x | | |
| Regra correspondente | x | x | | |
| Combinação de regras iniciada | x | | | |
## Inclusão de dados detalhados em logs do barramento de eventos
<a name="eb-event-logs-data"></a>
Você pode especificar EventBridge para incluir informações mais granulares nos registros que ele gera. Esses dados podem ser úteis para solução de problemas e depuração. Se você selecionar essa opção, EventBridge inclua esses dados nos registros relevantes para todos os destinos de log especificados.
As informações detalhadas incluem os seguintes campos:
+ `event_detail`: os detalhes do próprio evento.
+ `target_input`: a solicitação é EventBridge enviada para o destino.
+ `target_properties`:
## Truncamento de dados em logs do barramento de eventos
<a name="eb-event-logs-data-truncation"></a>
Devido às restrições de destino do log, EventBridge limita os registros de log a 1 MB. Se um registro de log exceder esse limite, EventBridge truncará o registro removendo os seguintes campos na seguinte ordem:
+ `target_input`
+ `target_properties`
+ `target_response_body`
EventBridge remove o `event_detail` campo dos seguintes tipos de registro de log, se necessário:
+ `EVENT_RECEIVED`
+ `EVENT_INGESTED`
+ `EVENT_INGESTED_FAILED`
+ `RULE_MATCH_STARTED`
Se o truncamento for necessário, EventBridge remove o campo inteiro.
Se EventBridge truncar campos no evento, o `dropped_fields` campo incluirá uma lista dos campos de dados excisados.
## Relatório de erros em logs do barramento de eventos
<a name="eb-event-logs-errors"></a>
EventBridge também inclui dados de erro, quando disponíveis, em etapas que representam estados de falha. Essas etapas incluem:
+ `EVENT_INGEST_FAILURE`
+ `INVOCATION_THROTTLE_START`
+ `INVOCATION_ATTEMPT_THROTTLE`
+ `INVOCATION_ATTEMPT_RETRYABLE_FAILURE`
+ `INVOCATION_ATTEMPT_PERMANENT_FAILURE`
+ `INVOCATION_FAILURE`
+ `INVOCATION_DLQ`
# O que a Amazon EventBridge registra para ônibus de eventos
<a name="eb-event-logs-execution-steps"></a>
Entender como EventBridge os eventos de processos podem ajudar você a usar registros para solucionar ou depurar problemas de barramento de eventos.
Se o registro estiver ativado, EventBridge gerará vários registros de registro à medida que um evento for processado.
Aqui estão as principais etapas EventBridge executadas ao processar um evento:
+ Um evento é enviado para um barramento de eventos
EventBridge gera registros de eventos enviados de fontes parceiras, reproduzidos de arquivos ou enviados usando`PutEvents`, independentemente de corresponderem ou não a alguma regra.
+ EventBridge determina se o evento corresponde a alguma regra no ônibus.
Se o evento corresponder a uma ou mais regras, EventBridge prossiga para a próxima etapa.
Se um AWS evento não corresponder a nenhuma regra, EventBridge descarta-o e não gera nenhum registro.
+ EventBridge invoca o alvo.
EventBridge tenta invocar o alvo novamente conforme necessário até:
+ O evento ter sido entregue com êxito.
+ Falha na entrega do evento, como se a política de nova tentativa expira ou ocorre uma falha permanente.
Se a entrega falhar, EventBridge envia o evento para uma fila de cartas mortas (DLQ), se uma for especificada, ou descarta o evento se nenhuma DLQ for especificada.
O diagrama abaixo apresenta uma exibição detalhada do fluxo de processamento de eventos, com todas as etapas possíveis representadas, com o nível de log de cada etapa.
Para obter uma lista completa de etapas, consulte [Como especificar o nível do log](eb-event-bus-logs.md#eb-event-bus-logs-level).
![\[EventBridge prossegue com as etapas para processar cada evento enviado ao ônibus.\]](http://docs.aws.amazon.com/pt_br/eventbridge/latest/userguide/images/bus_logging_eventbridge_conceptual.svg)
# Esquema de registro de ônibus de EventBridge eventos da Amazon
<a name="eb-event-logs-schema"></a>
A referência a seguir detalha o esquema dos registros de log EventBridge do barramento de eventos. Cada registro representa uma etapa que EventBridge executa o processamento de um evento específico.
Para obter mais informações, consulte [Registro em log dos barramentos de eventos ](eb-event-bus-logs.md).
```
{
"resource\$1arn": "arn:aws:events:region:account:event-bus/bus-name",
"request\$1id": "guid",
"event\$1id": "guid",
"invocation\$1id": "guid",
"message\$1timestamp\$1ms": "date_time",
"message\$1type": "step",
"log\$1level": "TRACE | INFO | ERROR",
"details": {
},
"error": {
"http\$1status\$1code": code,
"error\$1message": "error_message",
"aws\$1service": "service_name",
"request\$1id": "service_request_id"
}
}
```
**resource\$1arn** <a name="event-log-schema-resource-arn"></a>
O nome do recurso da Amazon (ARN) do barramento de eventos.
**request\$1id** <a name="event-log-schema-request-id"></a>
O ID da solicitação.
**event\$1id** <a name="event-log-schema-event-id"></a>
O ID do evento que está sendo processado.
**invocation\$1id** <a name="event-log-schema-invocation-id"></a>
O ID da invocação do evento.
**message\$1timestamp\$1ms** <a name="event-log-schema-timestamp"></a>
A data e a hora em que o evento de log foi emitido.
Unidade: milissegundo
**message\$1type** <a name="event-log-schema-message-type"></a>
A etapa de processamento do evento para a qual o registro de log foi gerado.
Para obter mais informações sobre as etapas EventBridge executadas ao processar um evento, consulte[O que a Amazon EventBridge registra para ônibus de eventos](eb-event-logs-execution-steps.md).
*Valores válidos:*
+ `EVENT_INGEST_FAILURE`
+ `EVENT_INGEST_SUCCESS`
+ `EVENT_RECEIPT`
+ `INVOCATION_ATTEMPT_PERMANENT_FAILURE`
+ `INVOCATION_ATTEMPT_RETRYABLE_FAILURE`
+ `INVOCATION_ATTEMPT_START`
+ `INVOCATION_ATTEMPT_SUCCESS`
+ `INVOCATION_ATTEMPT_THROTTLE`
+ `INVOCATION_DLQ`
+ `INVOCATION_FAILURE`
+ `INVOCATION_START`
+ `INVOCATION_SUCCESS`
+ `INVOCATION_THROTTLE_START`
+ `NO_STANDARD_RULES_MATCHED`
+ `RULE_MATCH`
+ `RULE_MATCH_START`
**log\$1level** <a name="event-log-schema-loglevel"></a>
O nível de detalhe especificado para o log do barramento de eventos.
*Valores válidos*: `ERROR` \$1 `INFO` \$1 `TRACE`
Para obter mais informações, consulte [Especificação do nível de log do barramento de eventos](eb-event-bus-logs.md#eb-event-bus-logs-level).
**detalhes** <a name="event-log-schema-details"></a>
Contém detalhes da etapa, com base no tipo de detalhe da etapa.
Os campos listados abaixo são retornados para os seguintes tipos de mensagem:
+ `EVENT_INGEST_SUCCESS`
+ `EVENT_INGEST_FAILURE`
+ `EVENT_RECEIPT`
+ `RULE_MATCH_START`
```
{
"caller_account_id": "account_id",
"source_time_ms": date_time,
"source": "source",
"detail_type": " type",
"resources": [],
"event_detail": "{}"
}
```
Os campos listados abaixo são retornados para o seguinte tipo de mensagem:
+ `RULE_MATCH`
```
{
"rule_arn": "ARN",
"target_arns": [
"ARN"
],
"invocation_ids": [
"guid"
]
}
```
Os campos listados abaixo são retornados para os seguintes tipos de mensagem:
+ `INVOCATION_ATTEMPT_START`
+ `INVOCATION_START`
+ `INVOCATION_THROTTLE_START`
```
{
"rule_arn": "ARN",
"role_arn": "ARN",
"target_arn": "ARN",
"attempt_count": Integer,
"target_input": "string",
"target_properties": "string"
}
```
Os campos listados abaixo são retornados para os seguintes tipos de mensagem:
+ `INVOCATION_DLQ`
+ `INVOCATION_FAILURE`
+ `INVOCATION_SUCCESS`
```
{
"rule_arn": "ARN",
"role_arn": "ARN",
"target_arn": "ARN",
"target_input": "string",
"target_properties": "string",
"total_attempts": Integer,
"final_invocation_status": "status",
"ingestion_to_start_latency_ms": Integer,
"ingestion_to_complete_latency_ms": Integer,
"ingestion_to_success_latency_ms": Integer,
"target_duration_ms": Integer,
"target_response_body": "string"
}
```
Os `ingestion_to_start_latency_ms` e `ingestion_to_complete_latency_ms` só são incluídos na primeira tentativa de invocação. O campo `ingestion_to_success_latency_ms` só é incluído para invocações bem-sucedidas.
Os campos listados abaixo são retornados para os seguintes tipos de mensagem:
+ `INVOCATION_ATTEMPT_PERMANENT_FAILURE`
+ `INVOCATION_ATTEMPT_RETRYABLE_FAILURE`
+ `INVOCATION_ATTEMPT_SUCCESS`
+ `INVOCATION_ATTEMPT_THROTTLE`
```
{
"rule_arn": "ARN",
"role_arn": "ARN",
"target_arn": "ARN",
"attempt_type": "FIRST | THROTTLE | RETRY",
"attempt_count": Integer,
"invocation_status": "status",
"target_duration_ms": Integer,
"target_response_body": "string"
}
```
**dropped\$1fields** <a name="event-log-schema-dropped_fields"></a>
Uma lista de todos os campos de dados EventBridge foi truncada para manter o registro abaixo do limite de tamanho de 1 MB.
EventBridge não inclui esse campo se tiver truncado quaisquer campos de detalhes.
Para obter mais informações, consulte [Truncamento de dados em logs do barramento de eventos](eb-event-bus-logs.md#eb-event-logs-data-truncation).
**erro** <a name="event-log-schema-error"></a>
Contém informações de qualquer erro gerado durante esta etapa. Para erros, o EV sempre inclui os seguintes campos:
+ `error_message`
+ `aws_service`
E os seguintes campos, se disponíveis:
+ `request_id`
+ `http_status_code`
Se nenhum erro foi gerado durante essa etapa, EventBridge não inclui esse campo no registro de log.
**http\$1status\$1code** <a name="event-log-schema-http-status-code"></a>
O código de status HTTP retornado pelo serviço chamado.
**mensagem\$1de\$1erro** <a name="event-log-schema-message"></a>
A mensagem de erro retornada pelo serviço chamado.
**aws\$1service** <a name="event-log-schema-aws-service"></a>
O nome do serviço chamado.
**identificação\$1solicitação** <a name="event-log-schema-error-request-id"></a>
O ID de solicitação para essa solicitação do serviço chamado.