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

# Conceitos básicos do X-Ray
<a name="xray-gettingstarted"></a>

**nota**  
Aviso de SDK/Daemon manutenção do X-Ray — Em 25 de fevereiro de 2026, o AWS X-Ray SDKs/Daemon entrará no modo de manutenção, onde AWS limitará as versões do X-Ray SDK e do Daemon para tratar apenas de problemas de segurança. Para obter mais informações sobre a linha do tempo do suporte, consulte [Cronograma de suporte do X-Ray SDK e do Daemon Support](xray-sdk-daemon-timeline.md). Recomendamos migrar para o. OpenTelemetry Para obter mais informações sobre a migração para OpenTelemetry, consulte [Migrando da instrumentação X-Ray para a instrumentação](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-migration.html). OpenTelemetry 

Para usar o X-Ray, siga estas etapas:

1. Instrumente seu aplicativo, o que permite que o X-Ray rastreie como ela processa uma solicitação.
   + Use o X-Ray SDKs, o X-Ray APIs ADOT ou o CloudWatch Application Signals para enviar dados de rastreamento para o X-Ray. Para obter mais informações sobre a interface a ser usada, consulte [Escolher uma interface](aws-xray-interface.md).

    Para obter mais informações sobre a instrumentação, consulte [Instrumentando seu aplicativo para AWS X-Ray](xray-instrumenting-your-app.md).

1. (Opcional) Configure o X-Ray para funcionar com outros Serviços da AWS que se integram ao X-Ray. Você pode fazer amostras de rastreamentos e adicionar cabeçalhos a solicitações de entrada, executar um agente ou coletor e enviar dados de rastreamento automaticamente ao X-Ray. Para obter mais informações, consulte [Integrando AWS X-Ray com outros Serviços da AWS](xray-services.md).

1. Implantar o aplicativo instrumentado. Conforme seu aplicativo recebe solicitações, o X-Ray SDK registra dados de rastreamento, segmento e subsegmento. Nesta etapa, talvez você também precise configurar uma política do IAM e implantar um agente ou coletor.
   +  Por exemplo, scripts para implantar um aplicativo usando o SDK AWS Distro for OpenTelemetry (ADOT) e o CloudWatch agente em diferentes plataformas, consulte [Application Signals](https://github.com/aws-observability/application-signals-demo/tree/main/scripts) Demo Scripts.
   + Para obter um script de exemplo para implantar o aplicativo usando o SDK e o daemon do X-Ray, consulte [AWS X-Ray aplicação de amostra](xray-scorekeep.md).

1. (Opcional) Abra um console para visualizar e analisar os dados. Você pode ver uma representação gráfica de um mapa de rastreamento, mapa de serviço e muito mais para inspecionar o funcionamento do aplicativo. Use as informações gráficas no console para otimizar, depurar e entender seu aplicativo. Para obter informações sobre como escolher um console, consulte [Usar um console](aws-xray-interface-console.md).

O diagrama a seguir mostra como começar a usar o X-Ray:

![\[O X-Ray exibe informações detalhadas sobre as solicitações do aplicativo, incluindo status, duração e código de resposta HTTP.\]](http://docs.aws.amazon.com/pt_br/xray/latest/devguide/images/xray-get-started.png)


Para obter um exemplo dos dados e mapas disponíveis no console, inicie um aplicativo[ de amostra](xray-scorekeep.md) que já esteja instrumentada para gerar dados de rastreamento. Em poucos minutos, você pode gerar tráfego, enviar segmentos para o X-Ray e visualizar um mapa de rastreamento e serviço.