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
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. 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. OpenTelemetry
Para usar o X-Ray, siga estas etapas:
-
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.
Para obter mais informações sobre a instrumentação, consulte Instrumentando seu aplicativo para AWS X-Ray.
-
-
(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.
-
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
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.
-
-
(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.
O diagrama a seguir mostra como começar a usar o X-Ray:
Para obter um exemplo dos dados e mapas disponíveis no console, inicie um aplicativo de amostra 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.
