

# Identifique oportunidades de otimização do Amazon ECS usando dados de rastreamento de aplicações
<a name="trace-data"></a>

O Amazon ECS integra-se com a distribuição da AWS do OpenTelemetry para coletar dados de rastreamento da sua aplicação. O Amazon ECS usa um contêiner de arquivo associado da distribuição da AWS do OpenTelemetry para coletar e encaminhar dados de rastreamento para AWS X-Ray. Para obter mais informações, consulte [Configuração da distribuição da AWS do OpenTelemetry Collector no Amazon ECS](https://aws-otel.github.io/docs/setup/ecs). Em seguida, você pode usar AWS X-Ray para identificar erros e exceções, analisar gargalos de desempenho e tempos de resposta.

Para que a distribuição da AWS do OpenTelemetry Collectorenvie dados de rastreamento para AWS X-Ray, sua aplicação deve ser configurada para criar os dados de rastreamento. Para obter mais informações, consulte [Instrumentando sua aplicação para AWS X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/xray-instrumenting-your-app.html) no *Guia do desenvolvedor do AWS X-Ray*.

## Permissões obrigatórias do IAM para integração da distribuição da AWS do OpenTelemetry com o AWS X-Ray
<a name="trace-data-iam"></a>

A integração do Amazon ECS com o AWS Distro para OpenTelemetry requer que você crie um perfil de tarefa e especifique o perfil em sua definição de tarefa. Recomendamos configurar o arquivo associado do AWS Distro para OpenTelemetry com a finalidade de encaminhar logs de contêiner para o CloudWatch Logs.

**Importante**  
Se você também coletar métricas de aplicações usando a integração do AWS Distro para OpenTelemetry, certifique-se de que o perfil do IAM da tarefa também contenha as permissões necessárias para essa integração. Para obter mais informações, consulte [Correlação do desempenho da aplicação do Amazon ECS usando métricas de aplicações](metrics-data.md).

Depois de criar o perfil, crie uma política com as seguintes permissões e, em seguida, anexe-a ao perfil.
+ `logs:PutLogEvents`
+ `logs:CreateLogGroup`
+ `logs:CreateLogStream`
+ `logs:DescribeLogStreams`
+ `logs:DescribeLogGroups`
+ `logs:PutRetentionPolicy`
+ `xray:PutTraceSegments`
+ `xray:PutTelemetryRecords`
+ `xray:GetSamplingRules`
+ `xray:GetSamplingTargets`
+ `xray:GetSamplingStatisticSummaries`
+ `ssm:GetParameters`