# Analisar a telemetria relacionada
Os sistemas de computador podem gerar uma grande quantidade de telemetria, incluindo métricas e logs, e os sistemas complexos podem gerar ainda mais. Ao analisar um conjunto específico de telemetria, pode ser um desafio encontrar outra telemetria relacionada ao conjunto inicial. Pode ser necessário treinamento avançado para adquirir as habilidades necessárias para encontrar problemas e solucioná-los. Como os sistemas são complexos, entender o que está acontecendo pode envolver a visualização de métricas e logs de vários serviços e recursos diferentes, exigindo alternância de contexto e navegação entre sistemas.
O recurso **Analisar dados relacionados** do Amazon CloudWatch oferece acesso a relações de recursos da AWS, a métricas relacionadas e a logs em todos os consoles de serviço, aprimorando a observabilidade e a eficiência para operadores de todos os níveis de habilidade. Ao visualizar alarmes ou anomalias nos painéis do CloudWatch, ou métricas na AWS, os usuários podem encontrar e visualizar rapidamente métricas e logs de recursos relacionados no sistema.
O CloudWatch fornece visibilidade de métricas e logs vinculados a recursos específicos, e o painel **Analisar dados relacionados** amplia isso, permitindo que você correlacione os recursos de infraestrutura às workloads com toda a telemetria associada. Isso lhe dá acesso rápido às informações necessárias para solucionar problemas relacionados à infraestrutura. Você visualiza a relação entre os recursos e a telemetria relacionada no painel **Analisar dados relacionados**. O painel **Analisar dados relacionados** é acessado no CloudWatch ou em outros consoles da AWS que mostram recursos ou telemetria.
**nota**
Atualmente, o painel **Analisar dados relacionados** é limitado em contas configuradas como contas de monitoramento na observabilidade entre contas do CloudWatch. Você deve acessar o painel **Analisar dados relacionados** em contas de origem em que os recursos foram originalmente criados e gerenciados. Nas contas de origem, você pode navegar entre os recursos conectados e visualizar logs e métricas relacionados.
Os tópicos a seguir discutem os detalhes da análise da telemetria relacionada.
**Topics**
+ [O que é telemetria relacionada?](#what-is-related-telemetry)
+ [Como acessar o painel Analisar dados relacionados](#access-related-telemetry)
+ [Navegar pela telemetria relacionada](#using-related-telemetry)
+ [Usar o mapa de topologia](#using-related-telemetry-map)
+ [Encontrar um recurso específico](#using-related-telemetry-find)
+ [Permissões e pré-requisitos necessários para visualizar e analisar a telemetria relacionada](#related-telemetry-permissions)
+ [Como o CloudWatch localiza a telemetria relacionada?](how-does-related-telemetry-work.md)
+ [Serviços da AWS compatíveis com a telemetria relacionada](services-with-related-telemetry.md)
+ [Como adicionar informações relacionadas à telemetria personalizada enviada ao CloudWatch](adding-your-own-related-telemetry.md)
## O que é telemetria relacionada?
A telemetria relacionada são dados de logs e métricas de recursos relacionados ao recurso ou serviço atual. Tradicionalmente, você pode analisar as métricas e os logs relacionados a um único balanceador de carga ou a toda a telemetria relacionada ao Amazon EC2. O recurso **Analisar dados relacionados** no Amazon CloudWatch adiciona um *mapa de topologia* interativo. O mapa é uma visualização centrada em recursos, em que você pode encontrar métricas e logs de um recurso específico, mas também pode ver como esse recurso está conectado a outros recursos.
Por exemplo, se você estiver analisando a telemetria de um balanceador de carga no painel **Analisar dados relacionados**, além das métricas e logs associados a esse balanceador de carga, os mapas mostrarão os grupos de destino desse balanceador de carga. Selecionar um dos grupos de destino mostrará as instâncias do Amazon EC2 associadas a esse grupo de destino. Em cada etapa desse processo, a telemetria, incluindo métricas e logs, dos recursos selecionados é exibida, facilitando a localização rápida da telemetria que você está procurando ou a sua análise na busca da causa de um problema específico.
## Como acessar o painel Analisar dados relacionados
No console do CloudWatch, há várias maneiras de acessar a telemetria relacionada à visualização atual. Por exemplo, se você estiver analisando um grafo em um painel e quiser ver a telemetria relacionada a ele ou a um aspecto dele, você pode optar por analisar dados relacionados diretamente nesse grafo. Em vários lugares no console, você pode escolher um item de menu do painel **Analisar dados relacionados**, ou pode selecionar um ícone de bússola (![\[Compass icon representing navigation or direction in a user interface.\]](http://docs.aws.amazon.com/pt_br/AmazonCloudWatch/latest/monitoring/images/compass-icon.png)) para mostrar o painel **Analisar dados relacionados**.
Você pode acessar a experiência de análise de pontos de entrada por meio do console do CloudWatch (e de outros consoles da AWS), incluindo:
+ **Navegação de métricas**: quando você escolhe **Métricas** e depois **Todas as métricas** no menu à esquerda do console do CloudWatch, o bloco de qualquer serviço ou fonte de métricas compatível mostra o ícone da bússola que exibe a telemetria relacionada no canto inferior direito.
+ **Legenda de métricas**: ao visualizar qualquer grafo de métricas (no CloudWatch ou em outros consoles da AWS), passar o mouse sobre a legenda do grafo mostra informações sobre os dados, bem como um botão **Analisar dados relacionados** que exibe a telemetria relacionada.
+ **Pontos de dados de métricas**: ao visualizar qualquer grafo de métricas, passar o mouse sobre um ponto de dados no grafo mostra informações sobre a métrica, bem como um ícone de bússola, para exibir a telemetria relacionada.
+ **Pesquisa de métricas**: ao pesquisar métricas no CloudWatch, se você escolher um nome de métrica encontrada, poderá selecionar **Analisar dados relacionados** no menu que aparece, o que exibirá a telemetria relacionada.
+ **Barra de ferramentas do console**: em muitas páginas do Console da AWS, a barra de ferramentas do console (geralmente no canto superior direito do console) inclui um ícone de serviço do CloudWatch, que exibirá as ferramentas do CloudWatch, incluindo o painel **Analisar dados relacionados**.
Dependendo de onde você acessa o painel, o contexto padrão dele mostrará um filtro apropriado, se possível.
## Navegar pela telemetria relacionada
Quando você seleciona qualquer um dos pontos de entrada para o painel **Analisar dados relacionados**, ele aparece no lado direito do console do CloudWatch. Esse painel fornece acesso para visualizar e localizar telemetria relacionada a *entidades* no sistema. Uma entidade é um recurso, como uma instância do Amazon EC2, ou um serviço, como uma aplicação que você desenvolveu. Você pode trabalhar nesse painel sem interromper o fluxo de trabalho atual, pois ele é aberto na lateral da página inicial.
A imagem a seguir mostra o painel **Analisar dados relacionados** focado em uma instância única do Amazon EC2 e nas entidades associadas.
![\[O painel Analisar dados relacionados, com uma única instância do Amazon EC2 em foco, e suas entidades associadas.\]](http://docs.aws.amazon.com/pt_br/AmazonCloudWatch/latest/monitoring/images/compass-explore-main.png)
A parte superior do painel **Analisar dados relacionados** é um *mapa de topologia* visual (mapa) da entidade atual e de outras entidades relacionadas. A entidade atualmente selecionada define o foco do painel. Há duas maneiras de selecionar uma entidade.
+ [Mapa de topologia](#using-related-telemetry-map): o *mapa* é uma exibição visual da entidade atual com foco. Ele também exibe todas as entidades relacionadas, permitindo que você navegue pelo conjunto de recursos e serviços relacionados entre si.
+ [Localizar outros recursos](#using-related-telemetry-find): você pode usar o botão **Localizar outros recursos** para filtrar e pesquisar entidades para usar como foco.
A parte inferior do painel mostra uma pesquisa automática de métricas e logs para a entidade focal atual.
Por padrão, o foco é definido como uma entidade que corresponde ao local do qual você acessou o painel **Analisar dados relacionados**. Por exemplo, se você o acessou clicando no ícone da bússola associado a uma métrica de uma instância específica do Amazon EC2, o foco será definido para essa instância do Amazon EC2.
Ao selecionar um recurso da AWS para o foco no painel **Analisar dados relacionados**, você pode navegar até o console específico do recurso selecionado. Por exemplo, caso tenha selecionado uma instância do Amazon EC2, você poderá selecionar o link **Visualizar no console do EC2** para abrir o console do Amazon EC2 com essa instância selecionada.
Quando você define um foco, as métricas e os logs são filtrados automaticamente para mostrar a telemetria relacionada ao foco.
+ **Métricas**: cada métrica é mostrada como um grafo para o período que você escolheu.
Assim como qualquer grafo de painel no CloudWatch, você pode passar o mouse sobre ele, ou selecioná-lo, para obter mais informações sobre o grafo de métricas e ver as opções, incluindo a visualização nas métricas do CloudWatch. A escolha de visualizar no CloudWatch vai abrir a visualização de métricas com o mesmo contexto de visualização do painel **Analisar dados relacionados**, incluindo recursos e intervalos de tempo.
+ **Padrões de logs**: o CloudWatch analisa os grupos de logs associados ao recurso focal e mostra padrões comuns nesses logs. Para obter mais informações sobre os padrões de logs, consulte [Pattern analysis](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_AnalyzeLogData_Patterns.html) no *Guia do usuário do Amazon CloudWatch Logs*.
Você pode selecionar **Comparar intervalos de tempo** para escolher outro intervalo de tempo e comparar os logs entre os dois intervalos de tempo.
Você pode selecionar **Visualizar no Logs Insights** para analisar os logs no CloudWatch Logs Insights com as mesmas opções da visualização atual, incluindo recurso, grupo de logs e intervalo de tempo. Para obter mais informações, consulte [Analyzing log data with CloudWatch Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html) no *Guia do usuário do Amazon CloudWatch Logs*.
+ **Grupos de logs**: os [grupos de logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html) que contêm os logs que são mostrados.
Você pode selecionar os grupos de logs e, em seguida, executar uma das seguintes ações:
+ Escolha **Comece a seguir no Live Tail** para visualizar uma lista de streaming de novos eventos de logs à medida que eles são ingeridos pelos grupos de log selecionados. A sessão do Live Tail é iniciada no console do CloudWatch. Para obter mais informações sobre o Live Tail, consulte [Troubleshoot with CloudWatch Logs LiveTail](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatchLogs_LiveTail.html) no *Guia do usuário do Amazon CloudWatch Logs*.
+ Escolha **Consultar no Logs Insights** para abrir o Logs Insights com uma consulta direcionada apenas para esses grupos de logs, aplicando o contexto atual, incluindo recursos e intervalo de tempo.
## Usar o mapa de topologia
O *mapa de topologia* (mapa) é uma exibição visual da entidade focal atual e seus recursos ou serviços relacionados. Você pode usar essa visualização interativa para ver as conexões entre diferentes recursos e serviços e analisar as relações entre os componentes no sistema. Por exemplo, se você estiver visualizando o recurso do *balanceador de carga*, o mapa mostrará os recursos do *grupo de destino* conectados. Selecionar um grupo de destino exibirá as instâncias associadas. A visualização da conectividade ajuda os operadores a entender e analisar as relações entre diferentes recursos e serviços no sistema.
Você pode arrastar o mapa e ampliá-lo e reduzi-lo para ver mais entidades associadas ou focar em menos entidades.
Quando você seleciona uma entidade associada, como um grupo de destino, o foco do painel muda para mostrar a telemetria dessa entidade. O mapa é atualizado para se concentrar no grupo de destino selecionado, exibindo suas conexões com outras entidades, como o balanceador de carga e quaisquer instâncias do Amazon EC2 especificadas nesse grupo de destino. Conforme você navega por diferentes entidades no mapa, as métricas e os logs na parte inferior do painel são atualizados dinamicamente, fornecendo telemetria relevante para os recursos recém-selecionados.
## Encontrar um recurso específico
Se um recurso não aparecer no mapa de topologia, você poderá usar o recurso **Localizar outros recursos** para localizá-lo. Você pode filtrar recursos por tag ou tipo e, em seguida, selecionar os que você está procurando. Depois de encontrar recursos nos quais se concentrar, você retornará ao mapa de topologia, com esses recursos selecionados, para procurar a telemetria e entidades associadas.
**nota**
Há muitos motivos pelos quais você pode não ver os recursos no mapa de topologia. Por exemplo:
Não está relacionado à entidade focal atual.
Você não tem [permissões](#related-telemetry-permissions) para acessar a telemetria ou as entidades associadas.
O [recurso ou serviço](services-with-related-telemetry.md) pode não ser compatível com a telemetria ou as entidades associadas.
Ao usar **Localizar outros recursos**, você pode descobrir e visualizar recursos que podem não estar diretamente conectados ou visíveis no mapa atual. Isso garante que você possa acessar e analisar todos os componentes relevantes da infraestrutura.
**Selecione um recurso com Localizar recursos.**
1. Abra o painel **Analisar dados relacionados** em qualquer um dos [pontos de entrada](#access-related-telemetry) no console do CloudWatch.
1. Escolha **Localizar recursos**.
1. Escolha o período para o qual você deseja visualizar os logs ou as métricas.
1. Escolha **Tipos de recursos** e, em seguida, selecione o tipo do recurso em que você deseja se concentrar na lista suspensa, por exemplo, **instâncias do EC2**.
1. Opcionalmente, filtre o conjunto de recursos fornecendo uma tag pela qual filtrar. Você pode fazer isso selecionando o filtro **Filtrar recursos por tags** ou escolhendo o rótulo que diz **5 tags encontradas** (o número dependerá das tags no sistema). Isso fornece uma lista de tags para você escolher.
Depois de selecionar as tags, a lista de recursos é filtrada automaticamente somente para os associados a essas tags.
1. Opcionalmente, escolha um ou mais recursos específicos dentre os encontrados que correspondam aos filtros.
1. Escolha **Mostrar no mapa** para retornar ao **Mapa de topologia** com os recursos selecionados.
A lista de **Métricas** e **Logs** agora está filtrada apenas para logs e métricas associados a esse tipo de recurso. Você pode escolher a guia **Métricas** ou **Logs** para ver o tipo de telemetria que deseja visualizar.
## Permissões e pré-requisitos necessários para visualizar e analisar a telemetria relacionada
Para analisar a telemetria relacionada, você deve obter informações da entidade com a telemetria das workloads e ter as permissões adequadas para visualizar esses dados.
Muitos serviços enviam as informações da entidade automaticamente. Para workloads que usam o agente do CloudWatch, você deve ter pelo menos a versão `1.300049.1` do agente e configurá-la corretamente. Para obter informações sobre a configuração do agente, consulte [Como adicionar informações relacionadas à telemetria personalizada enviada ao CloudWatch](adding-your-own-related-telemetry.md). Para workloads executadas no Amazon EKS, você deve ter pelo menos a versão `v2.3.1-eksbuild.1` do complemento Amazon CloudWatch Observability EKS. Para obter mais informações sobre esse complemento, consulte [Introdução ao complemento Amazon CloudWatch Observability do EKS](Container-Insights-setup-EKS-addon.md).
Para analisar a telemetria relacionada, você primeiro deve fazer login com determinadas permissões. Analisar a telemetria relacionada é uma atividade somente de leitura e requer, no mínimo, acesso somente leitura ao CloudWatch.
As permissões necessárias para visualizar as associações entre telemetria e entidades são: `logs:ListLogGroupsForEntity`, `logs:ListEntitiesForLogGroup`, `cloudwatch:ListEntitiesForMetric` e `application-signals:ListObservedEntities`.
Cada uma das políticas gerenciadas pela AWS a seguir fornecerá as permissões do CloudWatch necessárias para acessar a telemetria relacionada no console do CloudWatch:
+ [CloudWatchFullAccessV2](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/CloudWatchFullAccessV2.html): concede acesso total ao CloudWatch.
+ [CloudWatchReadOnlyAccess](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/CloudWatchReadOnlyAccess.html): concede acesso somente leitura ao CloudWatch.
+ [ReadOnlyAccess](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/ReadOnlyAccess.html): concede acesso somente leitura aos serviços e recursos da AWS.
Além disso, você deve ter pelo menos o acesso somente de leitura (`Describe*` e`Get*`) a todos os recursos no mapa de topologia para que o CloudWatch descubra e exiba as relações.
Para obter mais detalhes sobre como usar políticas para controlar o acesso, consulte [Gerenciar o acesso usando políticas](auth-and-access-control-cw.md#security_iam_access-manage).
# Como o CloudWatch localiza a telemetria relacionada?
O painel **Analisar dados relacionados** do CloudWatch mostra métricas e logs relacionados entre si. Mas como isso funciona?
As métricas e os logs enviados ao CloudWatch podem incluir uma *entidade* opcional à qual estão relacionados. Normalmente, a entidade será uma representação sobre o que é a telemetria. Por exemplo, uma métrica sobre o uso da CPU é sobre uma instância do Amazon EC2 e usará essa instância como sua entidade. Quando você visualiza essa métrica no painel **Analisar dados relacionados**, ele mostra outra telemetria para a mesma instância.
O *mapa de topologia* (mapa) no painel **Analisar dados relacionados** exibe o recurso atualmente selecionado, junto com os *recursos relacionados*. Em recursos da AWS, o CloudWatch exibe automaticamente outros recursos que ele sabe que estão relacionados. Por exemplo, se você estiver visualizando uma instância do Amazon EC2, o mapa também exibirá todos os volumes do Amazon EBS que estão anexados à instância. A seleção de um volume mostra a telemetria do volume, e o mapa é atualizado para exibir recursos relacionados ao volume. Ele também exibe recursos que fazem parte do mesmo *serviço*.
As informações da entidade associadas à telemetria definem o recurso ao qual a telemetria está associada, como a instância do Amazon EC2. No entanto, também pode incluir dados contextuais sobre o recurso. Por exemplo, se você tiver uma aplicação de site que inclua recursos como um banco de dados e uma instância do Amazon EC2, as informações da entidade poderão incluir a aplicação do site como um serviço. Nesse caso, o mapa de topologia mostra o serviço como uma entidade relacionada, e, quando você o seleciona, ele exibe as instâncias e o banco de dados. Isso pode simplificar a localização de toda a telemetria de um serviço.
**nota**
O CloudWatch deve ter recebido telemetria com informações da entidade nas últimas três horas para poder localizar os recursos e a telemetria relacionados.
## Qual é a origem dos dados da entidade?
Há diferentes maneiras pelas quais o CloudWatch obtém entidades da telemetria:
+ A maior parte da telemetria enviada ao CloudWatch dos serviços da AWS está associada automaticamente aos recursos. Para obter uma lista completa de recursos compatíveis, consulte [Serviços da AWS compatíveis com a telemetria relacionada](services-with-related-telemetry.md).
+ O agente do CloudWatch adiciona automaticamente as informações da entidade à telemetria que ele envia para o CloudWatch.
**nota**
Pode ser necessário atualizar o agente do CloudWatch para a versão mais recente para incluir os dados da entidade. Para ter mais informações, consulte [Coleta de métricas, logs e rastreamentos usando o agente do CloudWatch](Install-CloudWatch-Agent.md) e [Configurar nomes de serviços e ambientes do agente do CloudWatch para entidades relacionadas](CloudWatch-Agent-configure-related-telemetry.md).
+ Ao enviar sua própria telemetria, você pode adicionar informações da entidade aos dados. Para obter mais informações, consulte [Como adicionar informações relacionadas à telemetria personalizada enviada ao CloudWatch](adding-your-own-related-telemetry.md).
+ O CloudWatch se esforça ao máximo para reconhecer as informações da entidade associadas a outra telemetria (por exemplo, telemetria personalizada que você envia para o CloudWatch sem nenhuma informação da entidade).
## Qual a origem dos dados do serviço?
Além de reconhecer as conexões naturais entre recursos, como um recurso de instância e um recurso de volume anexado, o CloudWatch também pode agrupar recursos por *serviço*. Por exemplo, um serviço pode ser uma aplicação de site. Uma instância do Amazon EC2 com um servidor Web e outra com um banco de dados podem fazer parte do mesmo serviço e estar conectadas no mapa de topologia com base nesse serviço.
Há diferentes maneiras pelas quais o CloudWatch obtém um nome de serviço de telemetria, incluindo:
+ Os sinais da aplicação ou a telemetria instrumentada pelo OTel usam a variável `OTEL_SERVICE_NAME` de ambiente usada pelas bibliotecas de instrumentação do OpenTelemetry compatíveis para definir o nome do serviço.
+ A configuração do agente do CloudWatch permite definir um nome de serviço. Para obter mais informações, consulte [Configurar nomes de serviços e ambientes do agente do CloudWatch para entidades relacionadas](CloudWatch-Agent-configure-related-telemetry.md).
+ As workloads do Kubernetes usam um nome correspondente do cluster, como Deployment, ReplicaSet, Pod ou Container, para o nome do serviço.
+ Para workloads do Amazon EC2, o serviço pode vir de tags (as tags `service`, `application` ou `app`).
**nota**
Para usar tags para gerar nomes de serviços, você deve primeiro [configurar os metadados da instância](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/work-with-tags-in-IMDS.html#allow-access-to-tags-in-IMDS) para a instância do Amazon EC2.
+ Ao enviar sua própria telemetria, você pode adicionar informações do serviço aos dados. Para obter mais informações, consulte [Como adicionar informações relacionadas à telemetria personalizada enviada ao CloudWatch](adding-your-own-related-telemetry.md).
+ Quando não puder usar o especificado acima, o CloudWatch usará o nome do perfil do IAM que envia as métricas como nome do serviço. Isso, por exemplo, pode fornecer um nome de serviço para a telemetria do Amazon ECS.
# Serviços da AWS compatíveis com a telemetria relacionada
A tabela a seguir lista os serviços da AWS que são compatíveis com as informações de entidades relacionadas na telemetria do CloudWatch. Serviços ou recursos que não estão listados na tabela não têm informações de entidades relacionadas expostas no CloudWatch.
**nota**
Para serviços que usam o [agente do CloudWatch](Install-CloudWatch-Agent.md), talvez seja necessário atualizar o agente para a versão mais recente para obter a telemetria relacionada. Para obter informações sobre o envio de informações de entidades relacionadas com suas próprias métricas personalizadas, consulte [Como adicionar informações relacionadas à telemetria personalizada enviada ao CloudWatch](adding-your-own-related-telemetry.md).
| Serviço da AWS | Recurso | Métricas | Logs |
| --- | --- | --- | --- |
| Amazon API Gateway | `AWS::ApiGateway::Method` | Sim | Não |
| Amazon API Gateway | `AWS::ApiGateway::Resource` | Sim | Não |
| Amazon API Gateway | `AWS::ApiGateway::RestApi` | Sim | Não |
| Amazon API Gateway | `AWS::ApiGateway::Stage` | Sim | Sim |
| Amazon API Gateway | `AWS::ApiGateway::VpcLink` | Sim | Não |
| Amazon API Gateway V2 | `AWS::ApiGatewayV2::Integration` | Sim | Não |
| Amazon API Gateway V2 | `AWS::ApiGatewayV2::Route` | Sim | Não |
| Amazon API Gateway V2 | `AWS::ApiGatewayV2::Stage` | Não | Sim |
| Amazon API Gateway V2 | `AWS::ApiGatewayV2::Api` | Sim | Não |
| AWS App Runner | `AWS::AppRunner::Service` | Não | Sim |
| AWS Application Migration Service | `AWS::MGN::SourceServer` | Sim | Não |
| Amazon WorkSpaces Applications | `AWS::AppStream::Fleet` | Sim | Sim |
| AWS AppSync | `AWS::AppSync::GraphQLApi` | Sim | Sim |
| AWS B2B Data Interchange | `AWS::B2BI::Transformer` | Não | Sim |
| AWS Backup gateway | `AWS::BackupGateway::Hypervisor` | Não | Sim |
| Amazon Bedrock | `AWS::Bedrock::KnowledgeBase` | Não | Sim |
| Amazon Bedrock | `AWS::Bedrock::ModelId` | Sim | Não |
| Amazon Chime | `AWS::Chime::SipMediaApplication` | Não | Sim |
| Amazon Chime | `AWS::Chime::VoiceConnector` | Não | Sim |
| AWS Clean Rooms | `AWS::CleanRooms::Membership` | Não | Sim |
| AWS CloudFormation | | Não | Sim |
| Hooks do AWS CloudFormation | | Não | Sim |
| Amazon CloudFront | `AWS::CloudFront::Distribution` | Sim | Sim |
| AWS CloudTrail | `AWS::CloudTrail::EventDataStore` | Não | Sim |
| AWS CloudTrail | `AWS::CloudTrail::Trail` | Não | Sim |
| Amazon CloudWatch | `AWS::CloudWatch::MetricStream` | Sim | Não |
| Amazon CloudWatch Logs | `AWS::Logs::LogGroup` | Sim | Não |
| Amazon CloudWatch RUM | `AWS::RUM::AppMonitor` | Não | Sim |
| Amazon CloudWatch Synthetics | `AWS::Synthetics::Canary` | Sim | Não |
| AWS CodeBuild | `AWS::CodeBuild::Project` | Sim | Não |
| Amazon CodeWhisperer | `AWS::CodeWhisperer::Customization` | Não | Sim |
| Grupos de usuários do Amazon Cognito | `AWS::Cognito::UserPool` | Sim | Sim |
| AWS Config | `AWS::Config::ConfigRule` | Não | Sim |
| Amazon Connect | `AWS::Connect::Instance` | Não | Sim |
| AWS Database Migration Service | `AWS::DMS::ReplicationInstance` | Sim | Não |
| AWS Database Migration Service | `AWS::DMS::ReplicationTask` | Sim | Não |
| AWS DataSync | `AWS::Datasync::Agent` | Sim | Não |
| AWS DataSync | `AWS::DataSync::Task` | Sim | Sim |
| AWS Directory Service | `AWS::DirectoryService::MicrosoftAD` | Não | Sim |
| Amazon DynamoDB | `AWS::DynamoDB::Table` | Sim | Não |
| DynamoDB Accelerator | `AWS::DAX::Cluster` | Sim | Não |
| Amazon EC2 | `AWS::EC2::CapacityReservation` | Sim | Não |
| Amazon EC2 | `AWS::EC2::Instance` | Sim | Não |
| Amazon EC2 | `AWS::EC2::FlowLog` | Sim | Não |
| Amazon EC2 | `AWS::EC2::NATGateway` | Sim | Não |
| Amazon EC2 | `AWS::EC2::NetworkInterface` | Sim | Sim |
| Amazon EC2 | `AWS::EC2::Subnet` | Sim | Sim |
| Amazon EC2 | `AWS::EC2::TransitGateway` | Sim | Não |
| Amazon EC2 | `AWS::EC2::TransitGatewayAttachment` | Sim | Sim |
| Amazon EC2 | `AWS::EC2::VerifiedAccessInstance` | Não | Sim |
| Amazon EC2 | `AWS::EC2::Volume` | Sim | Não |
| Amazon EC2 | `AWS::EC2::VPC` | Não | Sim |
| Amazon EC2 | `AWS::EC2::VPNConnection` | Sim | Sim |
| Amazon EC2 Auto Scaling | `AWS::AutoScaling::AutoScalingGroup` | Sim | Não |
| AWS Elastic Beanstalk | `AWS::ElasticBeanstalk::Environment` | Sim | Não |
| Amazon Elastic Container Service | `AWS::ECS::Cluster` | Sim | Sim |
| Amazon Elastic Container Service | `AWS::ECS::Service` | Sim | Sim |
| Amazon Elastic File System | `AWS::EFS::AccessPoint` | Sim | Não |
| Amazon Elastic File System | `AWS::EFS::FileSystem` | Sim | Não |
| Amazon Elastic File System | `AWS::EFS::MountTarget` | Sim | Não |
| Serviço Amazon Elastic Kubernetes | `AWS::EKS::Cluster` | Sim | Sim |
| Amazon Elastic Kubernetes Service no AWS Fargate | | Não | Sim |
| Elastic Load Balancing | `AWS::ElasticLoadBalancing::LoadBalancer` | Sim | Não |
| Elastic Load Balancing V2 | `AWS::ElasticLoadBalancingV2::LoadBalancer` | Sim | Não |
| Elastic Load Balancing V2 | `AWS::ElasticLoadBalancingV2::TargetGroup` | Sim | Não |
| Amazon ElastiCache | `AWS::ElastiCache::CacheCluster` | Sim | Sim |
| AWS Elemental MediaConvert | `AWS::MediaConvert::Queue` | Sim | Não |
| AWS Elemental MediaLive | | Não | Sim |
| AWS Elemental MediaLive | `AWS::MediaLive::Channel` | Sim | Não |
| AWS Elemental MediaPackage | `AWS::MediaPackage::Channel` | Sim | Não |
| AWS Elemental MediaStore | `AWS::MediaStore::Container` | Sim | Sim |
| AWS Elemental MediaTailor | | Não | Sim |
| Amazon EMR | `AWS::EMR::Cluster` | Sim | Sim |
| Amazon EventBridge | `AWS::Events::Rule` | Sim | Sim |
| Amazon EventBridge Pipes | `AWS::Pipes::Pipe` | Sim | Sim |
| AWS Fault Injection Service | `AWS::FIS::ExperimentTemplate` | Não | Sim |
| Amazon FinSpace | `AWS::FinSpace::Environment` | Não | Sim |
| Amazon FSx | `AWS::FSx::FileSystem` | Sim | Não |
| Amazon GameLift Servers | `AWS::GameLift::Fleet` | Sim | Não |
| AWS Glue | `AWS::Glue::Job` | Não | Sim |
| AWS Identity Sync | `AWS::IdentitySync::Profile` | Não | Sim |
| Amazon Interactive Video Service | `AWS::IVSChat::LoggingConfiguration` | Sim | Sim |
| AWS IoT | `AWS::IoT::TopicRule` | Sim | Sim |
| AWS IoT 1-Click | `AWS::IoT1Click::Device` | Sim | Não |
| AWS IoT Events | | Não | Sim |
| AWS IoT FleetWise | `AWS::IoTFleetWise::Vehicle` | Não | Sim |
| AWS IoT SiteWise | | Não | Sim |
| AWS Key Management Service | `AWS::KMS::Key` | Sim | Não |
| Amazon Managed Service for Apache Flink | `AWS::KinesisAnalytics::Application` | Sim | Sim |
| Amazon Data Firehose | `AWS::KinesisFirehose::DeliveryStream` | Sim | Sim |
| Amazon Kinesis Data Streams | `AWS::Kinesis::Stream` | Sim | Não |
| Amazon Kinesis Video Streams | `AWS::KinesisVideo::Stream` | Sim | Não |
| AWS Lambda | `AWS::Lambda::Function` | Sim | Não |
| Amazon Lex | | Não | Sim |
| AWS Mainframe Modernization | `AWS::M2::Application` | Não | Sim |
| Amazon Managed Streaming for Apache Kafka | `AWS::Kafka::Cluster` | Sim | Não |
| Amazon Managed Streaming for Apache Kafka | `AWS::KafkaConnect::Connector` | Não | Sim |
| Amazon Managed Streaming for Apache Kafka | `AWS::MSK::Cluster` | Sim | Sim |
| Amazon MemoryDB | `AWS::Mmemorydb::Cluster` | Sim | Não |
| Amazon MQ | `AWS::AmazonMQ::Broker` | Sim | Sim |
| AWS Network Firewall | `AWS::NetworkFirewall::Firewall` | Sim | Sim |
| Amazon OpenSearch Service | `AWS::OpenSearchService::Domain` | Sim | Não |
| Amazon OpenSearch Service | | Não | Sim |
| Ingestão do Amazon OpenSearch Service | `AWS::OSIS::Pipeline` | Não | Sim |
| AWS Organizations | `AWS::Organizations::Organization` | Não | Sim |
| AWS Outposts | `AWS::Outposts::Outpost` | Sim | Não |
| Amazon Managed Service for Prometheus | `AWS::Prometheus::Resource` | Sim | Não |
| Amazon Q Business | | Não | Sim |
| Amazon QLDB | `AWS::QLDB::Ledger` | Sim | Não |
| Amazon Quick | `AWS::Quicksight::Dashboard` | Sim | Não |
| Amazon Quick | `AWS::Quicksight::DataSet` | Sim | Não |
| Amazon Redshift | `AWS::Redshift::Cluster` | Sim | Sim |
| Amazon Redshift Sem Servidor | `AWS::RedshiftServerless::Workgroup` | Sim | Não |
| Amazon Relational Database Service | `AWS::RDS::DBCluster` | Sim | Sim |
| Amazon Relational Database Service | `AWS::RDS::DBInstance` | Sim | Sim |
| Amazon Route 53 | `AWS::Route53::HealthCheck` | Sim | Sim |
| Amazon Route 53 | `AWS::Route53::HostedZone` | Sim | Não |
| Amazon Route 53 Resolver | `AWS::Route53Resolver::ResolverEndpoint` | Sim | Não |
| Amazon S3 | `AWS::S3::Bucket` | Sim | Não |
| Amazon SageMaker AI | `AWS::SageMaker::Endpoint` | Sim | Não |
| Amazon SageMaker AI | `AWS::SageMaker::Workteam` | Não | Sim |
| AWS Service Catalog | `AWS::ServiceCatalog::CloudFormationProduct` | Sim | Não |
| Amazon Simple Email Service | `AWS::SES::ConfigurationSet` | Sim | Não |
| Amazon Simple Notification Service | `AWS::SNS::Topic` | Sim | Sim |
| Amazon Simple Notification Service | | Não | Sim |
| Amazon Simple Queue Service | `AWS::SQS::Queue` | Sim | Não |
| AWS Step Functions | `AWS::StepFunctions::Activity` | Sim | Não |
| AWS Step Functions | `AWS::StepFunctions::StateMachine` | Sim | Sim |
| AWS Storage Gateway | `AWS::StorageGateway::Gateway` | Sim | Não |
| AWS Storage Gateway | `AWS::StorageGateway::Share` | Não | Sim |
| AWS Transfer Family | `AWS::Transfer::Server` | Sim | Sim |
| Amazon VPC Lattice | `AWS::VpcLattice::Service` | Não | Sim |
| AWS WAFV2 | `AWS::WAFv2::WebAcl` | Não | Sim |
| Amazon WorkMail | `AWS::WorkMail::Organization` | Sim | Não |
| Amazon WorkSpaces | `AWS::WorkSpaces::Workspace` | Sim | Sim |
# Como adicionar informações relacionadas à telemetria personalizada enviada ao CloudWatch
Quando você publica suas próprias métricas e logs no CloudWatch, as informações da entidade necessárias para a telemetria relacionada não estão lá por padrão. Quando você envia métricas para o CloudWatch ou logs para o CloudWatch Logs (com as operações [PutMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html) ou [PutLogEvents](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutLogEvents.html)), você pode adicionar informações da entidade a esses logs ou métricas. As informações da entidade são associadas à telemetria e usadas no recurso **Analisar dados relacionados** para encontrar a telemetria relacionada associada à mesma entidade.
A entidade enviada com telemetria representa um recurso ou serviço ao qual a telemetria está associada. Por exemplo, uma métrica sobre um serviço ou que vem de um recurso da AWS. Para identificar a entidade associada no código, você cria um conjunto de `KeyAttributes` e `Attributes` opcionais da entidade.
**nota**
O CloudWatch só pode encontrar recursos relacionados de entidades que tiveram telemetria enviada nas últimas três horas. Se o recurso emitir apenas telemetria esparsa (menos de uma vez a cada três horas), é possível enviar telemetria de *pulsação* adicional para manter a entidade ativa no CloudWatch.
Para obter informações sobre como adicionar informações de entidade, consulte [Informações da entidade no formato EMF](CloudWatch_Embedded_Metric_Format_Specification.md#entity-information-emf-format).
As seções a seguir descrevem como criar `KeyAttributes` e `Attributes` para que o CloudWatch possa identificar os recursos e serviços associados à telemetria.
## Identificar a entidade com o objeto KeyAttributes
A propriedade `KeyAttributes` dos objetos da entidade ([no CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_Entity.html) ou nos [logs do CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_Entity.html)) identifica exclusivamente a entidade do CloudWatch. É uma lista de pares de chave/valor. Entidades com a mesma propriedade `KeyAttributes` são consideradas como sendo a mesma entidade. A telemetria associada à mesma entidade é considerada relacionada e pode ser facilmente encontrada no painel **Analisar dados relacionados**.
**nota**
Na API do CloudWatch, a propriedade é denominada `KeyAttributes`. Na API do CloudWatch Logs, a propriedade é denominada `keyAttributes`. Aqui elas são tratadas como a mesma propriedade.
Há cinco tipos possíveis de objetos que uma `Entity` pode representar.
+ **AWS::Resource**: a entidade representa um recurso da AWS, como uma tabela do DynamoDB ou uma instância do Amazon EC2.
+ **AWS::Service**: a entidade representa um serviço da AWS, como o Amazon S3. Isso pode ser usado, por exemplo, ao chamar a operação `ListBuckets`, que não está associada a um recurso específico do Amazon S3.
+ **Service**: a entidade representa uma workload em execução na conta. Por exemplo, uma aplicação ou serviço que você gerencia.
+ **Resource**: a entidade representa um recurso que não é gerenciado pela AWS, por exemplo, por recursos do sistema operacional, como processos ou volumes de arquivos.
+ **RemoteService**: a entidade representa um serviço externo em uma chamada remota. Por exemplo, uma chamada remota para um banco de dados, cache externo ou endpoint externo.
Dependendo de qual dos tipos acima você está tentando representar, é necessário fornecer os pares de chave/valor corretos para `KeyAttributes`. Os seguintes itens descrevem cada tipo.
------
#### [ AWS::Resource ]
Para especificar um recurso da AWS, você deve incluir os três pares de chave/valor abaixo:
+ `"Type": "AWS::Resource"`: este par de chave/valor identifica a entidade como um recurso da AWS.
+ `"ResourceType": ""`: o valor da string do `ResourceType` é a string do [tipo de recurso](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html) do CloudFormation. Por exemplo, `AWS::DynamoDB::Table`.
+ `"Identifier": ""`: o identificador primário do recurso. Para obter mais informações, consulte [primaryIdentifier](https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html#schema-properties-primaryidentifier) no *Guia do usuário de desenvolvimento de extensões do CloudFormation*.
------
#### [ AWS::Service ]
Para especificar um serviço da AWS, você deve incluir os três pares de chave/valor abaixo:
+ `"Type": "AWS::Service"`: este par de chave/valor identifica a entidade como um serviço da AWS.
+ `"Name": ""`: o valor do `Name` é a string do [nome do serviço](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html) do CloudFormation. Por exemplo, `AWS::DynamoDB`.
------
#### [ Service ]
Para especificar um serviço que não é operado pela AWS, você deve incluir os três pares de chave/valor abaixo:
+ `"Type": "Service"`: este par de chave/valor identifica a entidade como um serviço.
+ `"Name": ""`: representa o nome do serviço que está enviando as métricas. Por exemplo, o `my-service-frontend` ou o `api.myservice.com`.
+ `"Environment": ""`: este atributo especifica onde o serviço está hospedado ou o ambiente ao qual ele pertence. Por exemplo: `us-west-2` ou `myservice.production`.
------
#### [ Resource ]
Para especificar um recurso que não é fornecido pela AWS, você deve incluir os três pares de chave/valor abaixo:
+ `"Type": "Resource"`: este par de chave/valor identifica a entidade como um recurso.
+ `"ResourceType": ""`: uma string especificando o tipo de recurso. Por exemplo, `K8s::Pod` para um pod do Kubernetes.
+ `"Identifier": ""`: um identificador de string do recurso. Pode conter vários nomes, separados por barras verticais. Por exemplo, um pod do Kubernetes pode ser representado pelo nome do cluster, namespace e nome do pod, como `MyCluster|MyNamespace|MyPod`.
------
#### [ RemoteService ]
Para especificar um serviço remoto, você deve incluir os três pares de chave/valor abaixo:
+ `"Type": "RemoteService"`: este par de chave/valor identifica a entidade como um serviço remoto.
+ `"Name": ""`: especifica como a aplicação se refere ao serviço externo em uma chamada remota. Por exemplo, `api.test.myservice.com`.
------
## Fornecer detalhes adicionais sobre a entidade com o objeto Attributes
Você pode fornecer detalhes adicionais sobre a `Entity` que você fornece com sua telemetria. Isso pode incluir detalhes sobre a plataforma, o recurso, a aplicação ou o provedor de telemetria. As tabelas a seguir descrevem as palavras-chave que você pode usar para cada um desses tipos de dados.
**nota**
Na API do CloudWatch, a propriedade é denominada `Attributes`. Na API do CloudWatch Logs, a propriedade é denominada `attributes`. Aqui elas são tratadas como a mesma propriedade.
**Detalhes da plataforma**
| Palavra-chave | Usage | Domínio de valores | Exemplos |
| --- | --- | --- | --- |
| `PlatformType` | Define a plataforma hospedada. | AWS::EKS, AWS::ECS, AWS::EC2, AWS::Lambda, K8s, Generic | `AWS::EC2` |
| `EKS.Cluster` | O nome do cluster do Amazon EKS. | String alfanumérica com delimitadores básicos. | `FlyingSquad` |
| `K8s.Cluster` | Nome do cluster autohospedado do Kubernetes. | String alfanumérica com delimitadores básicos. | `minicube` |
| `K8s.Namespace` | Nome do namespace do Kubernetes nos clusters do Amazon EKS ou K8s. | String alfanumérica com delimitadores básicos. | `default`, `pet-clinic` |
| `K8s.Workload` | Nome da workload do Kubernetes nos clusters do Amazon EKS e K8s. | String alfanumérica com delimitadores básicos. | `frontend` |
| `K8s.Node` | Identidade do nó do Kubernetes nos clusters do Amazon EKS e K8s. | Nome do nó do K8s (por exemplo, nome DNS da instância do Amazon EC2). | `ip-11-22-33-44.ec2.internal` |
| `K8s.Pod` | Identidade do pod do Kubernetes nos clusters do Amazon EKS e K8s. | Identificador de pods do K8s. | `frontend-1234abcd56-ef7890` |
| `EC2.AutoScalingGroup` | Nome do grupo do AutoScaling do Amazon EC2. | String alfanumérica com delimitadores básicos. | `my-asg-name-1` |
| `EC2.InstanceId` | Identidade da instância do Amazon EC2. | Identificador de instância do Amazon EC2. | `i-1234abcd5678ef90` |
| `ECS.Cluster` | Identidade do cluster do Amazon ECS. | Nome do cluster do Amazon ECS. | `MyCluster` |
| `ECS.Service` | Identidade do serviço do Amazon ECS. | Nome do serviço do Amazon ECS. | `MyService` |
| `ECS.Task` | Identidade da tarefa do Amazon ECS. | ID da tarefa do Amazon ECS. | `task-123abc` |
| `Lambda.Function` | Identidade da função do Lambda. | Nome da função do Lambda. | `MyFunction` |
| `Host` | Nome do host de todos os tipos de plataforma. | Formato de subdomínio. | `ip-111-22-33-44.example.com` |
**Detalhes do recurso**
| Palavra-chave | Usage | Domínio de valores | Exemplos |
| --- | --- | --- | --- |
| `AWS.Resource.ARN` | ARN do recurso da AWS. | String alfanumérica com delimitadores básicos. | `arn:aws:dynamodb:us-east-1:123456789012:table/myDynamoDBTable` |
**Detalhes da aplicação**
| Palavra-chave | Usage | Domínio de valores | Exemplos |
| --- | --- | --- | --- |
| `AWS.Application` | Nome da aplicação no AppRegistry. | String alfanumérica com delimitadores básicos. | `PetClinicApp` |
| `AWS.Application.ARN` | ARN da aplicação no AppRegistry. | String alfanumérica com delimitadores básicos. | `arn:aws:servicecatalog:us-east-1:1234567890:/applications/...` |
**Detalhes do provedor de telemetria**
| Palavra-chave | Usage | Domínio de valores | Exemplos |
| --- | --- | --- | --- |
| `Telemetry.SDK` | A impressão digital da versão do SDK do OTel de serviços instrumentados. | String alfanumérica com delimitadores básicos. | `opentelemetry,1.32.0-aws-SNAPSHOT,java,Auto` |
| `Telemetry.Agent` | A impressão digital do agente usado para coletar e enviar dados de telemetria. | String alfanumérica com delimitadores básicos. | `CWAgent/1.300026.3, ADOTCollector/1.x` |
| `Telemetry.Source` | Especifica o ponto da aplicação em que a telemetria foi coletada ou o que foi usado como fonte de dados de telemetria. | ServerSpan, ClientSpan, ProducerSpan, ConsumerSpan, LocalRoot Span, JMX, OS. | `ClientSpan, JMX` |