

# Rastrear solicitações de usuário para APIs REST usando o X-Ray no API Gateway
<a name="apigateway-xray"></a>

Você pode usar o [AWS X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/xray-services-apigateway.html) para rastrear e analisar solicitações de usuário à medida que passam pelas APIs REST do Amazon API Gateway a caminho dos serviços subjacentes. O API Gateway oferece suporte ao rastreamento de do X-Ray para todos os tipos de endpoint de API REST do API Gateway: regional, otimizado para bordas e privado. Você pode usar o X-Ray com o Amazon API Gateway em todas as regiões da AWS em que o X-Ray está disponível.

Como o X-Ray fornece uma visão completa de uma solicitação inteira, você pode analisar latências em suas APIs e serviços de backend. Use um mapa de serviço do X-Ray para visualizar a latência de uma solicitação inteira e dos serviços downstream integrados ao X-Ray. Também é possível configurar regras de amostragem para informar ao X-Ray quais solicitações registrar e com quais taxas de amostragem, de acordo com os critérios especificados. 

Se você chamar uma API do API Gateway de um serviço que já está sendo rastreado, o API Gateway propagará o rastreamento, mesmo que o rastreamento do X-Ray não esteja habilitado na API.

Você pode habilitar o X-Ray para um estágio da API usando o console do API Gateway ou usando a CLI ou a API do API Gateway.

**Topics**
+ [Configurar o AWS X-Ray com APIs REST do API Gateway](apigateway-enabling-xray.md)
+ [Usar mapas de serviço e visualizações de rastreamento do AWS X-Ray com o API Gateway](apigateway-using-xray-maps.md)
+ [Configurar regras de amostragem do AWS X-Ray para APIs do API Gateway](apigateway-configuring-xray-sampling-rules.md)
+ [Rastreamentos do AWS X-Ray para APIs do Amazon API Gateway](apigateway-understanding-xray-traces.md)