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á.
Se o X-Ray SDK não for compatível com sua linguagem de programação, você poderá usar o X-Ray APIs diretamente ou o AWS Command Line Interface (AWS CLI) para chamar os comandos da API X-Ray. Use as orientações a seguir para escolher como interagir com a API:
-
Use a sintaxe AWS CLI para simplificar usando comandos pré-formatados ou com opções dentro de sua solicitação.
-
Use a API do X-Ray diretamente para obter o máximo de flexibilidade e personalização das solicitações que você fizer ao X-Ray.
Se você usar a X-Ray API diretamente em vez da AWS CLI, deverá parametrizar sua solicitação no formato de dados correto e talvez também precise configurar a autenticação e o tratamento de erros.
O diagrama a seguir mostra orientações para escolher como interagir com a API do X-Ray:
Use a API do X-Ray para enviar dados de rastreamento diretamente para o X-Ray. A API do X-Ray é compatível com todas as funções disponíveis no SDK do X-Ray, incluindo as seguintes ações comuns:
-
PutTraceSegments— Carrega documentos do segmento para o X-Ray.
-
BatchGetTraces— Recupera uma lista de traços em uma lista de rastreamento IDs. Cada rastreamento recuperado é uma coleção de documentos de segmento de uma única solicitação.
-
GetTraceSummaries— Recuperações IDs e anotações para rastreamentos. Você pode especificar uma
FilterExpressionpara recuperar um subconjunto de resumos de rastreamento. -
GetTraceGraph— Recupera um gráfico de serviço para um ID de rastreamento específico.
-
GetServiceGraph— Recupera um JSON documento formatado que descreve serviços que processam solicitações recebidas e chamam solicitações downstream.
Você também pode usar o AWS Command Line Interface (AWS CLI) dentro do código do aplicativo para interagir programaticamente com o X-Ray. O AWS CLI suporta todas as funções disponíveis no X-Ray SDK, incluindo aquelas para outras Serviços da AWS. As funções a seguir são versões das operações de API listadas anteriormente com um formato mais simples:
-
put-trace-segments
— Carrega documentos do segmento para o X-Ray. -
batch-get-traces
— Recupera uma lista de traços em uma lista de rastreamento IDs. Cada rastreamento recuperado é uma coleção de documentos de segmento de uma única solicitação. -
get-trace-summaries
— Recuperações IDs e anotações para rastreamentos. Você pode especificar uma FilterExpressionpara recuperar um subconjunto de resumos de rastreamento. -
get-trace-graph
— Recupera um gráfico de serviço para um ID de rastreamento específico. -
get-service-graph
— recupera um documento JSONformatado que descreve serviços que processam solicitações recebidas e ligam para solicitações posteriores.
Para começar, você deve instalar o AWS CLIpara o seu sistema operacional. AWS apoios Linux, macOS and Windows sistemas operacionais. Para obter mais informações sobre a lista de comandos do X-Ray, consulte o Guia de referência de comandos de AWS CLI para o X-Ray
Tópicos
