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á.
# Monitoramento AWS Clean Rooms
O monitoramento é uma parte importante da manutenção da confiabilidade, disponibilidade e desempenho de AWS Clean Rooms suas outras AWS soluções. AWS fornece as seguintes ferramentas de monitoramento para observar AWS Clean Rooms, relatar quando algo está errado e realizar ações automáticas quando apropriado:
+ *O Amazon CloudWatch Logs* permite que você monitore, armazene e acesse seus arquivos de log a partir de instâncias do Amazon EC2 e de outras fontes. AWS CloudTrail O Amazon CloudWatch Logs pode monitorar as informações nos arquivos de log e notificá-lo quando determinados limites forem atingidos. É possível também arquivar seus dados de log em armazenamento resiliente. Para obter mais informações, consulte o [Guia do usuário do Amazon CloudWatch Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/).
O Clean Rooms ML possibilita trabalhos entre contas para determinadas ações de API. Conta da AWS Aquele que iniciou o trabalho recebe o evento de registro de AWS CloudTrail auditoria do trabalho. Para obter mais informações, consulte [Comportamentos do IAM para AWS Clean Rooms ML](ml-behaviors.md).
+ *AWS CloudTrail*captura chamadas de API e eventos relacionados feitos por você ou em seu nome Conta da AWS e entrega os arquivos de log em um bucket do Amazon S3 que você especificar. Você pode identificar quais usuários e contas ligaram AWS, o endereço IP de origem a partir do qual as chamadas foram feitas e quando elas ocorreram. Para obter mais informações, consulte o [Guia do usuário do AWS CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/).
+ EventBridgeA *Amazon* é um serviço de ônibus de eventos sem servidor que facilita a conexão de seus aplicativos com dados de várias fontes. EventBridge fornece um fluxo de dados em tempo real de seus próprios aplicativos, aplicativos Software-as-a-Service (SaaS) e AWS serviços e encaminha esses dados para destinos como o Lambda. Isso permite monitorar eventos que ocorram em serviços e criem arquiteturas orientadas a eventos. Para obter mais informações, consulte o [Guia EventBridge do usuário da Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/) e a [Referência de EventBridge eventos da Amazon](https://docs.aws.amazon.com/eventbridge/latest/ref/events-ref-cleanrooms.html).
+ *Gerenciamento de Faturamento e Custos da AWS*é um serviço que fornece recursos para ajudá-lo a pagar suas contas e otimizar seus custos. A Amazon Web Services fatura sua conta com base no uso, garantindo que você pague somente pelo que usa. AWS também permite que você aplique [etiquetas de alocação de custos](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/custom-tags.html) aos seus recursos para rastrear e categorizar seus custos da AWS. Por exemplo, em AWS Clean Rooms, você pode aplicar tags às associações de colaboração para rastrear os custos por colaboração. Para obter mais informações, consulte o [Guia do usuário do AWS Billing](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/).
# Login de análise AWS Clean Rooms
O *registro de análise* é um recurso do AWS Clean Rooms. Quando você [cria uma colaboração e ativa](create-collaboration.md) o **registro de análise**, os membros podem armazenar registros relevantes de consultas ou registros de trabalhos no Amazon CloudWatch Logs.
Com registros de consultas e registros de tarefas, os membros podem determinar se as consultas estão em conformidade com as regras de análise e se alinham ao contrato de colaboração. Além disso, os logs de consulta ajudam a apoiar as auditorias.
Quando a opção **Registro de análise** está ativada no AWS Clean Rooms console, os registros de consulta incluem o seguinte:
+ `analysisRule` – A regra de análise para a tabela configurada.
+ `analysisTemplateArn` – O modelo de análise que foi executado (aparece dependendo da regra de análise).
+ `collaborationId` – O identificador exclusivo para colaboração na qual a consulta foi executada.
+ `configuredTableID` – O identificador exclusivo da tabela configurada referenciada na consulta.
+ `directQueryAnalysisRulePolicy.custom.allowedAnalysis` – O modelo de análise pode ser executado na tabela configurada (aparece dependendo da regra de análise).
+ `directQueryAnalysisRulePolicy.v1.custom.allowedAnalysisProviders`: os provedores de consulta autorizados a criar uma consulta (aparece dependendo da regra de análise).
+ `errorCode`: o código de erro quando uma consulta não foi executada corretamente.
+ `errorMessage`: a mensagem de erro quando uma consulta não foi executada corretamente.
+ `eventID` – O identificador exclusivo da consulta executada. Depois de 31 de agosto de 2023, o identificador exclusivo é o mesmo que o `protectedQueryID`.
+ `eventTimestamp` – O tempo de execução da consulta.
+ `parameters.parametervalue` – Os valores dos parâmetros (aparecem dependendo do texto da consulta).
+ `queryText` – A definição SQL da execução da consulta. Se houver parâmetros, eles serão rotulados como `:parametervalue`.
+ `queryValidationErrors` – Os erros de consulta na validação da consulta.
+ `schemaName` – O nome da associação de tabela configurada referenciada na consulta.
+ `status`: o status da execução da consulta.
# Receba registros de consultas e trabalhos
Você não precisa realizar nenhuma ação externa AWS Clean Rooms para configurar registros de consultas e registros de tarefas. AWS Clean Rooms cria grupos de registros para colaborações depois que cada membro da colaboração [cria uma associação](create-membership.md).
Membros que podem consultar, membros que podem executar consultas e trabalhos, membros que podem receber resultados e membros cujas tabelas de configuração são referenciadas na consulta receberão um registro de consultas ou um registro de tarefas.
O membro que pode consultar e o membro que pode receber os resultados receberão registros de consulta para cada tabela configurada referenciada na consulta. Se eles não forem proprietários da tabela configurada, não poderão visualizar o ID da tabela configurada (`configuredTableID`).
O membro que pode executar consultas e trabalhos e o membro que pode receber resultados receberão registros de trabalhos para cada tabela configurada referenciada no trabalho. Se eles não forem proprietários da tabela configurada, não poderão visualizar o ID da tabela configurada (`configuredTableID`).
Se um membro tiver várias associações de tabela configuradas referenciadas na consulta, ele receberá um log de consulta para cada tabela configurada.
Se um membro tiver várias associações de tabelas configuradas referenciadas na tarefa, ele receberá um registro de tarefas para cada tabela configurada.
Os registros são criados para consultas que contêm SQL incompatível e compatível no AWS Clean Rooms. Para obter mais detalhes, consulte a [Referência SQL do AWS Clean Rooms](https://docs.aws.amazon.com/clean-rooms/latest/sql-reference/sql-reference.html).
Os registros também são criados quando consultas ou trabalhos fazem referência a tabelas configuradas que não estão associadas à colaboração.
Os registros podem conter informações sobre SQL incorreto.
Os registros de consultas e trabalhos indicam o status de uma consulta, mas não informam se a saída da consulta foi entregue. Eles confirmam que uma consulta ou trabalho foi enviada pelo membro que pode consultar. Os registros de consulta também confirmam que a consulta contém SQL compatível AWS Clean Rooms e faz referência às tabelas configuradas associadas à colaboração.
**Example**
Por exemplo, um registro não será produzido se a consulta for cancelada após a AWS Clean Rooms validação de sua conformidade com as regras de análise e durante o processamento da consulta.
Se você excluir o grupo de logs, deverá recriar o grupo de logs manualmente com o mesmo nome do grupo de logs (ID de colaboração da colaboração). Ou você pode desativar e ativar o log em sua assinatura.
Para obter mais informações sobre como ativar o registro de análise, consulte[Criar uma colaboração](create-collaboration.md).
Para obter mais informações sobre o Amazon CloudWatch Logs, consulte o [Guia do usuário do Amazon CloudWatch Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/WhatIsCloudWatchLogs.html).
# Ações recomendadas para registros de consultas e trabalhos
Recomendamos que os membros tomem as seguintes precauções periodicamente:
+ Para verificar se as consultas e trabalhos correspondem aos casos de uso ou consultas que foram acordados para a colaboração, revise as consultas e trabalhos que são executados na colaboração.
Para obter mais informações sobre como visualizar consultas recentes, consulte [Visualização de consultas recentes](https://docs.aws.amazon.com/clean-rooms/latest/userguide/query-data.html#view-queries-console).
Para obter mais informações sobre como visualizar trabalhos recentes, consulte[Visualizando trabalhos recentes](view-recent-jobs.md).
+ Para verificar se as colunas da tabela configurada correspondem ao que foi acordado para a colaboração, revise as colunas da tabela configurada que são usadas nas regras de análise dos membros da colaboração e nas consultas.
Para obter mais informações sobre como visualizar as colunas configuradas, consulte [Visualização de tabelas e regras de análise](https://docs.aws.amazon.com/clean-rooms/latest/userguide/manage-configured-tables.html#view-tables).
# Monitoramento detalhado CloudWatch dentro de AWS Clean Rooms
O *monitoramento detalhado* é um recurso opcional do. AWS Clean Rooms Quando você [cria uma colaboração e ativa](create-collaboration.md) o **monitoramento detalhado**, os membros que podem executar consultas e configurar pagadores podem optar por receber métricas detalhadas de observabilidade em suas contas. CloudWatch
Com o monitoramento detalhado, os membros podem monitorar o desempenho das consultas, rastrear a utilização de recursos e criar painéis para obter informações operacionais. Essas métricas ajudam no planejamento da capacidade, na análise de custos e na solução de problemas de desempenho.
**nota**
A disponibilidade métrica varia de acordo com as fontes de dados da tabela configuradas:
Para análises que fazem referência a tabelas configuradas com o Athena como fonte de dados, as `QueryFileScanned` métricas `BytesRead` e sempre retornam 0.
Para análises que fazem referência a tabelas configuradas com o Snowflake como fonte de dados, as `RecordsRead` métricas `BytesRead``QueryFileScanned`, e sempre retornam 0.
Para análises que fazem referência a várias tabelas configuradas com fontes de dados diferentes (por exemplo, tabelas baseadas em Snowflake e S3) `BytesRead` e `QueryFileScanned` retornam métricas somente para AWS Glue tabelas baseadas em S3. AWS Glue `RecordsRead`retorna métricas para AWS Glue tabelas baseadas em S3 e tabelas Athena.
## Tipos de métricas
AWS Clean Roomspublica duas categorias de métricas para CloudWatch:
### Métricas de monitoramento detalhadas agregadas
Essas métricas fornecem visibilidade em nível agregado em todas as análises:
`AnalysisRuntime`
Mostra a duração total de uma análise em milissegundos.
`CRPUConsumed`
A CRPU (Unidades de Processamento de Sala Limpa) consumida para uma análise específica. Para obter mais informações sobre o cálculo da CRPU, consulte [AWS Clean RoomsPreços](https://aws.amazon.com/clean-rooms/pricing/).
`ConcurrentVCPUs`
vCPU simultânea utilizada em um determinado momento (relacionada às cotas de serviço).
`AnalysesCount`
Número de análises executadas durante um período de tempo para uma dimensão especificada.
`ConcurrentQueries`
Contagem de consultas simultâneas em um determinado momento (relacionada às cotas de serviço).
### Métricas de monitoramento detalhadas em nível de consulta
Essas métricas fornecem informações detalhadas sobre a execução de consultas individuais:
`BytesRead`
Total de dados (em bytes) lidos das tabelas de origem para uma análise.
`BytesWritten`
Total de dados (em bytes) gravados para uma análise.
`RecordsRead`
Número total de registros lidos das tabelas de origem para uma análise.
`RecordsWritten`
Número total de registros retornados no resultado da análise.
`QueryFileScanned`
Número total de arquivos de dados digitalizados para uma análise.
`Memory utilization`
Recurso de memória usado para uma análise.
`vCPU utilization`
Recurso vCPU usado para uma análise.
`Disk utilization`
Recurso de armazenamento usado para uma análise.
## Dimensões métricas
As métricas são organizadas pelas seguintes dimensões:
+ **Status da análise**: Concluído
+ **Tipo de análise**: SparkSQL
+ **Associação**: O ID de membro
+ **Consulta**: ID de consulta individual (para métricas em nível de consulta)
+ **Conta/região**: sua e sua Conta da AWS região
Todas as métricas são publicadas no `AWS/CleanRooms` namespace em. CloudWatch
## Quem pode acessar as métricas
Métricas de monitoramento detalhadas estão disponíveis para:
+ **Executores de consultas**: membros que podem executar consultas na colaboração
+ **Pagadores configurados**: membros designados para pagar pelos custos de execução da consulta
Membros que contribuem apenas com dados não podem acessar métricas de monitoramento detalhadas.
## Preços
AWS Clean Roomsnão cobra pela publicação de métricas para CloudWatch. No entanto, CloudWatch cobranças padrão se aplicam ao armazenamento métrico, ao uso do painel e aos alarmes. Para obter mais informações, consulte [Amazon CloudWatch Pricing](https://aws.amazon.com/cloudwatch/pricing/).
# Registrando chamadas de AWS Clean Rooms API usando AWS CloudTrail
AWS Clean Rooms é integrado com AWS CloudTrail, um serviço que fornece um registro das ações realizadas por um usuário, uma função ou um AWS service (Serviço da AWS) usuário AWS Clean Rooms. CloudTrail captura todas as chamadas de API AWS Clean Rooms como eventos. As chamadas capturadas incluem chamadas do AWS Clean Rooms console e chamadas de código para as operações AWS Clean Rooms da API. Se você criar uma trilha, poderá habilitar a entrega contínua de CloudTrail eventos para um bucket do Amazon S3, incluindo eventos para. AWS Clean Rooms Se você não configurar uma trilha, ainda poderá ver os eventos mais recentes no CloudTrail console no **Histórico de eventos**. Usando as informações coletadas por CloudTrail, você pode determinar a solicitação que foi feita AWS Clean Rooms, o endereço IP do qual a solicitação foi feita, quem fez a solicitação, quando ela foi feita e detalhes adicionais.
Para saber mais sobre isso CloudTrail, consulte o [Guia AWS CloudTrail do usuário](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/).
## AWS Clean Rooms informações em CloudTrail
CloudTrail é ativado no seu Conta da AWS quando você cria a conta. Quando a atividade ocorre em AWS Clean Rooms, essa atividade é registrada em um CloudTrail evento junto com outros AWS service (Serviço da AWS) eventos no **histórico de eventos**. Você pode exibir, pesquisar e baixar eventos recentes em sua Conta da AWS. Para obter mais informações, consulte [Visualização de eventos com histórico de CloudTrail eventos](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html).
Para um registro contínuo dos eventos em sua Conta da AWS, incluindo eventos para AWS Clean Rooms, crie uma trilha. Uma *trilha* permite CloudTrail entregar arquivos de log para um bucket do Amazon S3. Por padrão, quando você cria uma trilha no console, ela é aplicada a todas as Regiões da AWS. A trilha registra eventos de todas as regiões na AWS partição e entrega os arquivos de log ao bucket do Amazon S3 que você especificar. Além disso, você pode configurar outros Serviços da AWS para analisar e agir com base nos dados do evento coletados nos CloudTrail registros. Para saber mais, consulte:
+ [Visão geral da criação de uma trilha](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [CloudTrail serviços e integrações suportados](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations)
+ [Configurando notificações do Amazon SNS para CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html)
+ [Recebendo arquivos de CloudTrail log de várias regiões](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html)
+ [Recebendo arquivos de CloudTrail log de várias contas](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)
Todas AWS Clean Rooms as ações são registradas CloudTrail e documentadas na [https://docs.aws.amazon.com/clean-rooms/latest/apireference/Welcome.html](https://docs.aws.amazon.com/clean-rooms/latest/apireference/Welcome.html).
Cada entrada de log ou evento contém informações sobre quem gerou a solicitação. As informações de identidade ajudam a determinar o seguinte:
+ Se a solicitação foi feita com credenciais de usuário raiz ou de usuário do IAM.
+ Se a solicitação foi feita com credenciais de segurança temporárias de um perfil ou de um usuário federado.
+ Se a solicitação foi feita por outro AWS service (Serviço da AWS).
Para obter mais informações, consulte [Elemento userIdentity do CloudTrail ](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html).
## Entendendo as entradas do arquivo de AWS Clean Rooms log
Uma trilha é uma configuração que permite a entrega de eventos como arquivos de log para um bucket do Amazon S3 que você especificar. CloudTrail os arquivos de log contêm uma ou mais entradas de log. Um evento representa uma única solicitação de qualquer fonte e inclui informações sobre a ação solicitada, a data e a hora da ação, os parâmetros da solicitação e assim por diante. CloudTrail os arquivos de log não são um rastreamento de pilha ordenado das chamadas públicas de API, portanto, eles não aparecem em nenhuma ordem específica.
## Exemplos de AWS Clean Rooms CloudTrail eventos
Os exemplos a seguir demonstram CloudTrail eventos para:
**Topics**
+ [StartProtectedQuery (êxito)](#startprotectedquery_successful)
+ [StartProtectedQuery (falha)](#startprotectedquery_failed)
### StartProtectedQuery (êxito)
```
{
"eventVersion": "1.08",
"userIdentity": {
"type": "AssumedRole",
"principalId": "EXAMPLE_PRINCIPAL_ID",
"arn": "arn:aws:sts::123456789012:assumed-role/query-runner/jdoe",
"accountId": "123456789012",
"accessKeyId": "EXAMPLE_KEY_ID",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "EXAMPLE_PRINCIPAL_ID",
"arn": "arn:aws:iam::123456789012:role/query-runner",
"accountId": "123456789012",
"userName": "query-runner"
},
"webIdFederationData": {},
"attributes": {
"creationDate": "2023-04-07T19:34:32Z",
"mfaAuthenticated": "false"
}
}
},
"eventTime": "2023-04-07T19:53:32Z",
"eventSource": "cleanrooms.amazonaws.com",
"eventName": "StartProtectedQuery",
"awsRegion": "us-east-2",
"sourceIPAddress": "203.0.113.1",
"userAgent": "aws-internal/3",
"requestParameters": {
"resultConfiguration": {
"outputConfiguration": {
"s3": {
"resultFormat": "CSV",
"bucket": "cleanrooms-queryresults-jdoe-test",
"keyPrefix": "test"
}
}
},
"sqlParameters": "***",
"membershipIdentifier": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"type": "SQL"
},
"responseElements": {
"Access-Control-Expose-Headers": "x-amzn-RequestId,x-amzn-ErrorType,x-amzn-ErrorMessage,Date",
"protectedQuery": {
"createTime": 1680897212.279,
"id": "f5988bf1-771a-4141-82a8-26fcc4e41c9f",
"membershipArn": "arn:aws:cleanrooms:us-east-2:123456789012:membership/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"membershipId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"resultConfiguration": {
"outputConfiguration": {
"s3": {
"bucket": "cleanrooms-queryresults-jdoe-test",
"keyPrefix": "test",
"resultFormat": "CSV"
}
}
},
"sqlParameters": "***",
"status": "SUBMITTED"
}
},
"requestID": "7464211b-2277-4b55-9723-fb4f259aefd2",
"eventID": "f7610f5e-74b9-420f-ae43-206571ebcbf7",
"readOnly": false,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "123456789012",
"eventCategory": "Management"
}
```
### StartProtectedQuery (falha)
```
{
"eventVersion": "1.08",
"userIdentity": {
"type": "AssumedRole",
"principalId": "EXAMPLE_PRINCIPAL_ID",
"arn": "arn:aws:sts::123456789012:assumed-role/query-runner/jdoe",
"accountId": "123456789012",
"accessKeyId": "EXAMPLE_KEY_ID",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "EXAMPLE_PRINCIPAL_ID",
"arn": "arn:aws:iam::123456789012:role/query-runner",
"accountId": "123456789012",
"userName": "query-runner"
},
"webIdFederationData": {},
"attributes": {
"creationDate": "2023-04-07T19:34:32Z",
"mfaAuthenticated": "false"
}
}
},
"eventTime": "2023-04-07T19:47:27Z",
"eventSource": "cleanrooms.amazonaws.com",
"eventName": "StartProtectedQuery",
"awsRegion": "us-east-2",
"sourceIPAddress": "203.0.113.1",
"userAgent": "aws-internal/3",
"errorCode": "ValidationException",
"requestParameters": {
"resultConfiguration": {
"outputConfiguration": {
"s3": {
"resultFormat": "CSV",
"bucket": "cleanrooms-queryresults-jdoe-test",
"keyPrefix": "test"
}
}
},
"sqlParameters": "***",
"membershipIdentifier": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"type": "SQL"
},
"responseElements": {
"Access-Control-Expose-Headers": "x-amzn-RequestId,x-amzn-ErrorType,x-amzn-ErrorMessage,Date",
"message": "Column(s) [identifier] is not allowed in select"
},
"requestID": "e29f9f74-8299-4a83-9d18-5ddce7302f07",
"eventID": "c8ee3498-8e4e-44b5-87e4-ab9477e56eb5",
"readOnly": false,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "123456789012",
"eventCategory": "Management"
}
```
# Integração com aplicativos AWS Clean Rooms orientados a eventos usando a Amazon EventBridge
Você pode AWS Clean Rooms incorporar aplicativos orientados a eventos (EDAs) que usam eventos que ocorrem AWS Clean Rooms para se comunicar entre os componentes do aplicativo e iniciar processos posteriores. Você faz isso usando EventBridge a Amazon para rotear eventos de AWS Clean Rooms outros componentes de software. EventBridge A Amazon é um serviço sem servidor que usa eventos para conectar componentes do aplicativo, facilitando a integração de AWS serviços, como AWS Clean Rooms em arquiteturas orientadas por eventos, sem código e operações adicionais.
A arquitetura orientada a eventos é um estilo de criação de sistemas de software com acoplamento fraco que funcionam juntos emitindo e respondendo a eventos. Nesse modelo, um evento representa uma mudança em um recurso ou ambiente.
Veja como EventBridge funciona com AWS Clean Rooms:
Como acontece com muitos AWS serviços, AWS Clean Rooms gera e envia eventos para o *barramento de eventos EventBridge * padrão. Um barramento de eventos é um roteador que recebe eventos e os roteia para *destinos* que você especifica. Os destinos podem incluir outros AWS serviços, aplicativos personalizados e aplicativos SaaS de parceiros.
EventBridge roteia os eventos de acordo com *as regras* que você cria no ônibus do evento. Para cada regra, você especifica um filtro, ou um *padrão de evento*, para selecionar apenas os eventos desejados. Sempre que um evento é enviado para o barramento de eventos, EventBridge compare-o com cada regra. Se o evento corresponder à regra, EventBridge roteará o evento para o (s) destino (s) especificado (s).
![\[AWS os serviços enviam eventos para o barramento de eventos EventBridge padrão. Se o evento corresponder ao padrão de evento de uma regra, EventBridge envia o evento para os destinos especificados para essa regra.\]](http://docs.aws.amazon.com/pt_br/clean-rooms/latest/userguide/images/eventbridge-integration-how-it-works.png)
Por exemplo, suponha que você queira saber sempre que uma nova AWS Clean Rooms colaboração for criada em sua conta. Você pode criar uma regra no barramento de eventos padrão. Na regra, você criaria um padrão de evento que especificasse eventos do AWS Clean Rooms chamados**Collaboration Created**. Sempre que EventBridge recebia um evento correspondente a essas propriedades, ele roteava o evento para o fluxo de trabalho especificado.
## AWS Clean Rooms eventos
AWS os serviços podem enviar eventos diretamente para o barramento de eventos EventBridge padrão. Além disso, também AWS CloudTrail envia eventos provenientes de vários AWS serviços. EventBridge Esses eventos podem incluir chamadas de API, logins e ações do console, eventos de serviço e CloudTrail Insights. Para obter mais informações, consulte [os eventos de AWS serviço fornecidos AWS CloudTrail](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event-cloudtrail.html) no *Guia EventBridge do usuário*.
Para obter uma lista completa dos AWS Clean Rooms eventos enviados EventBridge, consulte o AWS Clean Rooms tópico na [https://docs.aws.amazon.com/eventbridge/latest/ref/welcome.html](https://docs.aws.amazon.com/eventbridge/latest/ref/welcome.html).
| Tipo de detalhe de evento | Description |
| --- | --- |
| [Modelo de análise criado](events-detail-reference-full.md#event-detail-analysis-template-created) | O proprietário do Modelo de Análise e todos os membros ativos da colaboração são notificados quando um Modelo de Análise é criado. |
| [Modelo de análise atualizado](events-detail-reference-full.md#event-detail-analysis-template-updated) | O proprietário do modelo de análise e todos os membros ativos da colaboração que têm visibilidade da atualização são notificados quando um modelo de análise é atualizado. |
| [Modelo de análise excluído](events-detail-reference-full.md#event-detail-analysis-template-deleted) | O proprietário do modelo de análise e todos os membros ativos da colaboração são notificados quando um modelo de análise é excluído. |
| [Colaboração criada](events-detail-reference-full.md#event-detail-collaboration-created) | O proprietário da **colaboração** é notificado quando uma **colaboração** é **criada**. |
| [Colaboração atualizada](events-detail-reference-full.md#event-detail-collaboration-updated) | O proprietário da **colaboração** e todos os membros ativos da colaboração que têm visibilidade da atualização são notificados quando uma **colaboração** é **atualizada**. |
| [Solicitação de alteração de colaboração criada](events-detail-reference-full.md#event-detail-collaboration-change-request-created) | O proprietário da colaboração e todos os membros ativos da colaboração são notificados quando uma solicitação de alteração de colaboração é criada. |
| [Solicitação de alteração de colaboração aprovada](events-detail-reference-full.md#event-detail-collaboration-change-request-approved) | O proprietário da colaboração e todos os membros ativos da colaboração são notificados quando uma solicitação de alteração de colaboração é aprovada. |
| [Solicitação de alteração de colaboração cancelada](events-detail-reference-full.md#event-detail-collaboration-change-request-cancelled) | O proprietário da colaboração e todos os membros ativos da colaboração são notificados quando uma solicitação de alteração de colaboração é cancelada. |
| [Solicitação de alteração de colaboração confirmada](events-detail-reference-full.md#event-detail-collaboration-change-request-committed) | O proprietário da colaboração e todos os membros ativos da colaboração são notificados quando uma solicitação de alteração de colaboração é confirmada. |
| [Associação de tabela configurada criada](events-detail-reference-full.md#event-detail-configured-table-association-created) | O proprietário da Associação de Tabela Configurada e todos os membros ativos da colaboração são notificados quando uma Associação de Tabela Configurada é criada. |
| [Associação de tabela configurada atualizada](events-detail-reference-full.md#event-detail-configured-table-association-updated) | O proprietário da Associação de Tabela Configurada e todos os membros ativos da colaboração que têm visibilidade da atualização são notificados quando uma Associação de Tabela Configurada é atualizada. |
| [Associação de tabela configurada excluída](events-detail-reference-full.md#event-detail-configured-table-association-deleted) | O proprietário da Associação de Tabela Configurada e todos os membros ativos da colaboração são notificados quando uma Associação de Tabela Configurada é Excluída. |
| [Regra de análise de associação de tabela configurada criada](events-detail-reference-full.md#event-detail-configured-table-association-analysis-rule-created) | O proprietário da Regra de Análise de Associação de Tabela Configurada e todos os membros ativos da colaboração são notificados quando uma Regra de Análise de Associação de Tabela Configurada é criada. |
| [Regra de análise de associação de tabela configurada atualizada](events-detail-reference-full.md#event-detail-configured-table-association-analysis-rule-updated) | O proprietário da Regra de Análise de Associação de Tabela Configurada e todos os membros ativos da colaboração que têm visibilidade da atualização são notificados quando uma Regra de Análise de Associação de Tabela Configurada é atualizada. |
| [Regra de análise de associação de tabela configurada excluída](events-detail-reference-full.md#event-detail-configured-table-association-analysis-rule-deleted) | O proprietário da Regra de Análise de Associação de Tabela Configurada e todos os membros ativos da colaboração são notificados quando uma Regra de Análise de Associação de Tabela Configurada é Excluída. |
| [Tabela de mapeamento de ID criada](events-detail-reference-full.md#event-detail-id-mapping-table-created) | O proprietário da tabela de mapeamento de ID e todos os membros ativos da colaboração são notificados quando uma tabela de mapeamento de ID é criada. |
| [Tabela de mapeamento de ID atualizada](events-detail-reference-full.md#event-detail-id-mapping-table-updated) | O proprietário da tabela de mapeamento de ID e todos os membros ativos da colaboração que têm visibilidade da atualização são notificados quando uma tabela de mapeamento de ID é atualizada. |
| [Tabela de mapeamento de ID excluída](events-detail-reference-full.md#event-detail-id-mapping-table-deleted) | O proprietário da tabela de mapeamento de ID e todos os membros ativos da colaboração são notificados quando uma tabela de mapeamento de ID é excluída. |
| [Associação de namespace de ID criada](events-detail-reference-full.md#event-detail-id-namespace-association-created) | O proprietário da Id Namespace Association e todos os membros ativos da colaboração são notificados quando uma Id Namespace Association é criada. |
| [Associação de namespace de ID atualizada](events-detail-reference-full.md#event-detail-id-namespace-association-updated) | O proprietário da Id Namespace Association e todos os membros ativos da colaboração que têm visibilidade da atualização são notificados quando uma Id Namespace Association é atualizada. |
| [Associação de namespace de ID excluída](events-detail-reference-full.md#event-detail-id-namespace-association-deleted) | O proprietário da Id Namespace Association e todos os membros ativos da colaboração são notificados quando uma Id Namespace Association é excluída. |
| [Convidado para colaboração](events-detail-reference-full.md#event-detail-invited-to-collaboration) | O membro convidado é notificado quando é convidado para uma colaboração. |
| [Associação criada](events-detail-reference-full.md#event-detail-membership-created) | O proprietário da associação e todos os membros ativos da colaboração são notificados quando uma associação é criada. |
| [Adesão atualizada](events-detail-reference-full.md#event-detail-membership-updated) | O proprietário da associação é notificado quando uma associação é atualizada, a menos que a associação tenha sido removida da colaboração. Nesse caso, todos os membros ativos da colaboração são notificados. |
| [Assinatura excluída](events-detail-reference-full.md#event-detail-membership-deleted) | O proprietário da associação e todos os membros ativos da colaboração são notificados quando uma associação é excluída. |
| [Protected Job enviado](events-detail-reference-full.md#event-detail-protected-job-submitted) | O Job Runner, o Job Payer e o Results Receiver of a Protected Job são notificados quando o Protected Job é enviado. |
| [Protected Job Started](events-detail-reference-full.md#event-detail-protected-job-started) | O Job Runner, o Job Payer e o Results Receiver of a Protected Job são notificados quando o Protected Job é iniciado. |
| [Cancelamento de trabalhos protegidos](events-detail-reference-full.md#event-detail-protected-job-cancelling) | O Job Runner, o Job Payer e o Results Receiver of a Protected Job são notificados quando o Protected Job é cancelado. |
| [Protected Job cancelado](events-detail-reference-full.md#event-detail-protected-job-cancelled) | O Job Runner, o Job Payer e o Results Receiver of a Protected Job são notificados quando o Protected Job é cancelado. |
| [Protected Job foi bem-sucedido](events-detail-reference-full.md#event-detail-protected-job-succeeded) | O Job Runner, o Job Payer e o Results Receiver of a Protected Job são notificados quando o Protected Job é bem-sucedido. |
| [Falha no Protected Job](events-detail-reference-full.md#event-detail-protected-job-failed) | O Job Runner, o Job Payer e o Results Receiver of a Protected Job são notificados quando o Protected Job falhou. |
| [Consulta protegida enviada](events-detail-reference-full.md#event-detail-protected-query-submitted) | O executor da consulta, o pagador da consulta e o (s) receptor (es) dos resultados de uma consulta protegida são notificados quando a consulta protegida é enviada. |
| [Consulta protegida iniciada](events-detail-reference-full.md#event-detail-protected-query-started) | O executor da consulta, o pagador da consulta e o (s) receptor (es) dos resultados de uma consulta protegida são notificados quando a consulta protegida é iniciada. |
| [Cancelamento de consultas protegidas](events-detail-reference-full.md#event-detail-protected-query-cancelling) | O executor da consulta, o pagador da consulta e o (s) receptor (es) dos resultados de uma consulta protegida são notificados quando a consulta protegida é cancelada. |
| [Consulta protegida cancelada](events-detail-reference-full.md#event-detail-protected-query-cancelled) | O executor da consulta, o pagador da consulta e o (s) receptor (es) dos resultados de uma consulta protegida são notificados quando a consulta protegida é cancelada. |
| [Consulta protegida bem-sucedida](events-detail-reference-full.md#event-detail-protected-query-succeeded) | O executor da consulta, o pagador da consulta e o (s) receptor (es) dos resultados de uma consulta protegida são notificados quando a consulta protegida é bem-sucedida. |
| [Falha na consulta protegida](events-detail-reference-full.md#event-detail-protected-query-failed) | O executor da consulta, o pagador da consulta e o (s) receptor (es) dos resultados de uma consulta protegida são notificados quando a consulta protegida falha. |
| [O tempo limite da consulta protegida atingiu o tempo limite](events-detail-reference-full.md#event-detail-protected-query-timed-out) | O executor da consulta, o pagador da consulta e o (s) receptor (es) dos resultados de uma consulta protegida são notificados quando o tempo limite da consulta protegida atinge o tempo limite. |
## AWS Clean Rooms Eventos de roteamento usando EventBridge
Para EventBridge rotear AWS Clean Rooms eventos para um destino, você deve criar uma regra. Cada regra contém um padrão de evento, que EventBridge corresponde a cada evento recebido no barramento de eventos. Se os dados do evento corresponderem ao padrão de evento especificado, EventBridge roteará esse evento para o (s) destino (s) da regra.
Para obter instruções abrangentes de como criar regras de barramento de eventos, consulte [Criar regras que reagem a eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html) no *Guia do usuário do EventBridge *.
### Criação de padrões de eventos que correspondam aos AWS Clean Rooms eventos
Cada padrão de evento é um objeto JSON que contém:
+ (Opcional): um `source` atributo que identifica o serviço que envia o evento. Para AWS Clean Rooms eventos, a fonte é`aws.cleanrooms`.
+ (Opcional): um atributo `detail-type` que contém uma matriz dos nomes de eventos a serem correlacionados.
+ (Opcional): um atributo `detail` que contém quaisquer outros dados relacionados aos eventos a serem correlacionados.
Por exemplo, o padrão de evento a seguir corresponde a todos os eventos atualizados da Id Namespace Association dos quais a colaboração foi excluída: AWS Clean Rooms
```
{
"source": ["aws.cleanrooms"],
"detail-type": ["Id Namespace Association Updated"],
"detail": {
"status": ["COLLABORATION_DELETED"]
}
}
```
Para obter mais informações sobre como escrever padrões de eventos, consulte [Padrões de eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html) no *Guia do usuário do EventBridge *.
# AWS Clean Rooms referência de detalhes de eventos
Todos os eventos dos AWS serviços têm um conjunto comum de campos contendo metadados sobre o evento, como o AWS serviço que é a origem do evento, a hora em que o evento foi gerado, a conta e a região em que o evento ocorreu e outros. Para obter definições desses campos gerais, consulte [Estrutura de eventos na Amazon EventBridge Events](https://docs.aws.amazon.com/eventbridge/latest/ref/overiew-event-structure.html) *Reference*.
Além disso, cada evento tem um campo de `detail` que contém dados específicos desse determinado evento. A referência abaixo define os campos de detalhes dos vários eventos do AWS Clean Rooms .
Ao usar EventBridge para selecionar e gerenciar AWS Clean Rooms eventos, é útil ter em mente o seguinte:
+ O `source` campo para todos os eventos de AWS Clean Rooms está definido como`aws.cleanrooms`.
+ O campo do `detail-type` especifica o tipo de evento.
Por exemplo, .`Collaboration Created`
+ O campo de `detail` contém os dados específicos desse determinado evento.
Para obter informações sobre a construção de padrões de eventos que permitem que as regras correspondam a AWS Clean Rooms eventos, consulte [Padrões de eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html) no *Guia do EventBridge usuário da Amazon*.
## Modelo de análise Evento criado
Abaixo estão os campos de detalhes do evento `Analysis Template Created`.
```
{
"source": ["aws.cleanrooms"],
"detail-type": ["Analysis Template Created"]
}
```
## Modelo de análise Evento atualizado
Abaixo estão os campos de detalhes do evento `Analysis Template Updated`.
```
{
"source": ["aws.cleanrooms"],
"detail-type": ["Analysis Template Updated"]
}
```
## Modelo de análise Evento excluído
Abaixo estão os campos de detalhes do evento `Analysis Template Deleted`.
```
{
"source": ["aws.cleanrooms"],
"detail-type": ["Analysis Template Deleted"]
}
```
## Colaboração Criado por evento
Abaixo estão os campos de detalhes do evento `Collaboration Created`.
```
{
"source": ["aws.cleanrooms"],
"detail-type": ["Collaboration Created"]
}
```
## Colaboração Evento atualizado
Abaixo estão os campos de detalhes do evento `Collaboration Updated`.
```
{
"source": ["aws.cleanrooms"],
"detail-type": ["Collaboration Updated"]
}
```
## Solicitação de alteração de colaboração Evento criado
Abaixo estão os campos de detalhes do evento `Collaboration Change Request Created`.
```
{
"source": ["aws.cleanrooms"],
"detail-type": ["Collaboration Change Request Created"]
}
```
## Evento aprovado de solicitação de alteração de colaboração
Abaixo estão os campos de detalhes do evento `Collaboration Change Request Approved`.
```
{
"source": ["aws.cleanrooms"],
"detail-type": ["Collaboration Change Request Approved"]
}
```
## Solicitação de alteração de colaboração Evento cancelado
Abaixo estão os campos de detalhes do evento `Collaboration Change Request Cancelled`.
```
{
"source": ["aws.cleanrooms"],
"detail-type": ["Collaboration Change Request Cancelled"]
}
```
## Evento confirmado de solicitação de alteração de colaboração
Abaixo estão os campos de detalhes do evento `Collaboration Change Request Committed`.
```
{
"source": ["aws.cleanrooms"],
"detail-type": ["Collaboration Change Request Committed"]
}
```
## Evento criado por associação de tabela configurada
Abaixo estão os campos de detalhes do evento `Configured Table Association Created`.
```
{
"source": ["aws.cleanrooms"],
"detail-type": ["Configured Table Association Created"]
}
```
## Evento atualizado da Associação de Tabela Configurada
Abaixo estão os campos de detalhes do evento `Configured Table Association Updated`.
```
{
"source": ["aws.cleanrooms"],
"detail-type": ["Configured Table Association Updated"]
}
```
## Evento excluído da associação de tabela configurada
Abaixo estão os campos de detalhes do evento `Configured Table Association Deleted`.
```
{
"source": ["aws.cleanrooms"],
"detail-type": ["Configured Table Association Deleted"]
}
```
## Regra de análise de associação de tabela configurada Evento criado
Abaixo estão os campos de detalhes do evento `Configured Table Association Analysis Rule Created`.
```
{
"source": ["aws.cleanrooms"],
"detail-type": ["Configured Table Association Analysis Rule Created"]
}
```
## Evento atualizado da regra de análise de associação de tabela configurada
Abaixo estão os campos de detalhes do evento `Configured Table Association Analysis Rule Updated`.
```
{
"source": ["aws.cleanrooms"],
"detail-type": ["Configured Table Association Analysis Rule Updated"]
}
```
## Evento excluído da regra de análise de associação de tabela configurada
Abaixo estão os campos de detalhes do evento `Configured Table Association Analysis Rule Deleted`.
```
{
"source": ["aws.cleanrooms"],
"detail-type": ["Configured Table Association Analysis Rule Deleted"]
}
```
## Tabela de mapeamento de ID Evento criado
Abaixo estão os campos de detalhes do evento `Id Mapping Table Created`.
```
{
"source": ["aws.cleanrooms"],
"detail-type": ["Id Mapping Table Created"]
}
```
## Evento atualizado da tabela de mapeamento de ID
Abaixo estão os campos de detalhes do evento `Id Mapping Table Updated`.
```
{
"source": ["aws.cleanrooms"],
"detail-type": ["Id Mapping Table Updated"]
}
```
## Evento excluído da tabela de mapeamento de ID
Abaixo estão os campos de detalhes do evento `Id Mapping Table Deleted`.
```
{
"source": ["aws.cleanrooms"],
"detail-type": ["Id Mapping Table Deleted"]
}
```
## Evento criado pela Id Namespace Association
Abaixo estão os campos de detalhes do evento `Id Namespace Association Created`.
```
{
"source": ["aws.cleanrooms"],
"detail-type": ["Id Namespace Association Created"]
}
```
## Evento atualizado da Id Namespace Association
Abaixo estão os campos de detalhes do evento `Id Namespace Association Updated`.
```
{
"source": ["aws.cleanrooms"],
"detail-type": ["Id Namespace Association Updated"]
}
```
**nota**
Quando uma colaboração é excluída, o evento é capturado no evento Id Namespace Association Updated no `detail.status` campo.
```
{
"source": ["aws.cleanrooms"],
"detail-type": ["Id Namespace Association Updated"],
"detail": {
"status": ["COLLABORATION_DELETED"]
}
```
## Evento excluído da Id Namespace Association
Abaixo estão os campos de detalhes do evento `Id Namespace Association Deleted`.
```
{
"source": ["aws.cleanrooms"],
"detail-type": ["Id Namespace Association Deleted"]
}
```
## Convidado para evento de colaboração
Abaixo estão os campos de detalhes do evento `Invited To Collaboration`.
```
{
"source": ["aws.cleanrooms"],
"detail-type": ["Invited To Collaboration"]
}
```
## Membership Created Event
Abaixo estão os campos de detalhes do evento `Membership Created`.
```
{
"source": ["aws.cleanrooms"],
"detail-type": ["Membership Created"]
}
```
## Evento atualizado para membros
Abaixo estão os campos de detalhes do evento `Membership Updated`.
```
{
"source": ["aws.cleanrooms"],
"detail-type": ["Membership Updated"]
}
```
## Evento excluído da associação
Abaixo estão os campos de detalhes do evento `Membership Deleted`.
```
{
"source": ["aws.cleanrooms"],
"detail-type": ["Membership Deleted"]
}
```
## Evento Protected Job Submitted
Abaixo estão os campos de detalhes do evento `Protected Job Submitted`.
```
{
"source": ["aws.cleanrooms"],
"detail-type": ["Protected Job Submitted"]
}
```
## Evento Protected Job Started
Abaixo estão os campos de detalhes do evento `Protected Job Started`.
```
{
"source": ["aws.cleanrooms"],
"detail-type": ["Protected Job Started"]
}
```
## Evento de cancelamento de emprego protegido
Abaixo estão os campos de detalhes do evento `Protected Job Cancelling`.
```
{
"source": ["aws.cleanrooms"],
"detail-type": ["Protected Job Cancelling"]
}
```
## Evento cancelado de Protected Job
Abaixo estão os campos de detalhes do evento `Protected Job Cancelled`.
```
{
"source": ["aws.cleanrooms"],
"detail-type": ["Protected Job Cancelled"]
}
```
## Evento Protected Job Succeeded
Abaixo estão os campos de detalhes do evento `Protected Job Succeeded`.
```
{
"source": ["aws.cleanrooms"],
"detail-type": ["Protected Job Succeeded"]
}
```
## Evento Protected Job Failed
Abaixo estão os campos de detalhes do evento `Protected Job Failed`.
```
{
"source": ["aws.cleanrooms"],
"detail-type": ["Protected Job Failed"]
}
```
## Evento enviado de consulta protegida
Abaixo estão os campos de detalhes do evento `Protected Query Submitted`.
```
{
"source": ["aws.cleanrooms"],
"detail-type": ["Protected Query Submitted"]
}
```
## Evento Protected Query Started
Abaixo estão os campos de detalhes do evento `Protected Query Started`.
```
{
"source": ["aws.cleanrooms"],
"detail-type": ["Protected Query Started"]
}
```
## Evento de cancelamento de consultas protegidas
Abaixo estão os campos de detalhes do evento `Protected Query Cancelling`.
```
{
"source": ["aws.cleanrooms"],
"detail-type": ["Protected Query Cancelling"]
}
```
## Evento cancelado de consulta protegida
Abaixo estão os campos de detalhes do evento `Protected Query Cancelled`.
```
{
"source": ["aws.cleanrooms"],
"detail-type": ["Protected Query Cancelled"]
}
```
## Evento bem-sucedido de consulta protegida
Abaixo estão os campos de detalhes do evento `Protected Query Succeeded`.
```
{
"source": ["aws.cleanrooms"],
"detail-type": ["Protected Query Succeeded"]
}
```
## Evento de falha na consulta protegida
Abaixo estão os campos de detalhes do evento `Protected Query Failed`.
```
{
"source": ["aws.cleanrooms"],
"detail-type": ["Protected Query Failed"]
}
```
## Evento Protected Query Timed Out
Abaixo estão os campos de detalhes do evento `Protected Query Timed Out`.
```
{
"source": ["aws.cleanrooms"],
"detail-type": ["Protected Query Timed Out"]
}
```
# Marcação de alocação de custo
AWS Clean Rooms suporta o uso de etiquetas de alocação de custos para rastrear seus AWS custos. Você ativa essas tags no Gerenciamento de Faturamento e Custos da AWS painel. AWS usa as tags para categorizar seus custos e entregar um relatório mensal de alocação de custos para você. As etiquetas de alocação de custos definidas pelo usuário podem ser aplicadas aos AWS Clean Rooms recursos para ajudar a rastrear e alocar custos em sua colaboração.
## Recursos etiquetáveis para alocação de custos
A tabela a seguir lista os AWS Clean Rooms recursos que incorrem em cobranças e podem ser marcados com etiquetas de alocação de custos definidas pelo usuário para rastrear e organizar os custos.
| Recurso faturado | Recurso marcado |
| --- | --- |
| Consulta SQL | Associação |
| PySpark Job | Associação |
| Trabalho de treinamento em ML | Associação |
| Trabalho de inferência de ML | Associação |
| Geração de dados sintéticos | Associação |
| Treinamento de modelos semelhantes | Modelo semelhante |
| Exportação de segmentos semelhantes | Segmento semelhante |