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á.
Começando com X-Ray
nota
X-Ray SDK/Daemon Aviso de manutenção — Em 25 de fevereiro de 2026, eles AWS X-Ray SDKs/Daemon entrarão no modo de manutenção, onde AWS limitarão as versões do X-Ray SDK e do Daemon para resolver apenas 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 Migração da X-Ray instrumentação para a instrumentação. OpenTelemetry
Para usar X-Ray, siga as seguintes etapas:
-
Instrumente seu aplicativo, o que X-Ray permite rastrear como seu aplicativo processa uma solicitação.
-
Use os X-Ray SDKs, X-Ray APIs ADOT ou sinais de CloudWatch aplicativos 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 X-Ray para trabalhar com outros Serviços da AWS que se integram com X-Ray o. Você pode testar rastreamentos e adicionar cabeçalhos às solicitações recebidas, executar um agente ou coletor e enviar automaticamente dados de rastreamento para o. X-Ray Para obter mais informações, consulte Integrando AWS X-Ray com outros Serviços da AWS.
-
Implantar o aplicativo instrumentado. À medida que 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 ver um exemplo de script para implantar um aplicativo usando o X-Ray SDK e o X-Ray daemon, consulte. AWS X-Ray exemplo de aplicação
-
-
(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 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 alguns minutos, você pode gerar tráfego X-Ray, enviar segmentos e visualizar um mapa de rastreamento e serviço.
