# Usar mapas de serviço e visualizações de rastreamento do AWS X-Ray com o API Gateway
<a name="apigateway-using-xray-maps"></a>

Nesta seção, encontre informações detalhadas sobre como usar mapas de serviço e exibições de rastreamento do [AWS X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/xray-services-apigateway.html) com o API Gateway.

**Topics**
+ [Exemplo de mapa de serviço do X-Ray](#apigateway-using-xray-maps-active)
+ [Exemplo de exibição de rastreamento do X-Ray](#apigateway-using-xray-trace-view-active)

## Exemplo de mapa de serviço do X-Ray
<a name="apigateway-using-xray-maps-active"></a>

AWS X-RayOs mapas de serviço do mostram informações sobre a API e todos seus serviços downstream. Quando o X-Ray estiver habilitado para um estágio da API no API Gateway, você verá um nó no mapa de serviço contendo informações sobre o tempo total gasto no serviço API Gateway. Obtenha informações detalhadas sobre o status de resposta e um histograma do tempo de resposta da API para o período selecionado. Para APIs que integram-se a serviços da AWS, como o AWS Lambda e o Amazon DynamoDB, você verá mais nós que fornecem métricas de performance relacionadas a esses serviços. Haverá um mapa de serviço para cada estágio da API.

O exemplo a seguir mostra um mapa de serviço para o estágio `test` de uma API chamada `xray`. Essa API tem duas integrações do Lambda. Os nós representam o serviço do API Gateway e as duas funções do Lambda.

Consulte uma explicação detalhada sobre a estrutura do mapa de serviço em [Use the X-Ray trace map](https://docs.aws.amazon.com/xray/latest/devguide/aws-xray-interface-console.html#xray-console-servicemap).

![\[Exemplo de mapa de serviço de um estágio de API do API Gateway\]](http://docs.aws.amazon.com/pt_br/apigateway/latest/developerguide/images/apigateway-xray-servicemap-2.png)


No mapa de serviço, você pode ampliar para ver uma exibição de rastreamento do estágio da API. O rastreamento exibirá informações mais detalhadas sobre a API, representadas como segmentos e subsegmentos. Por exemplo, o rastreamento para o mapa de serviço mostrado acima incluiria segmentos para o serviço Lambda e a função do Lambda. Para obter mais informações, consulte [AWS Lambda e AWS X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/xray-services-lambda.html).

Se você escolher um nó ou uma borda em um mapa de serviço do X-Ray, o console do X-Ray mostrará um histograma de distribuição da latência. Você pode usar um histograma de latência para ver o tempo necessário para que um serviço conclua suas solicitações. Veja a seguir um histograma do estágio do API Gateway chamado `xray/test` no mapa de serviço anterior. Consulte uma explicação detalhada sobre os histogramas de distribuição de latência em [Use Latency Histograms](https://docs.aws.amazon.com/xray/latest/devguide/aws-xray-interface-console.html#xray-console-histograms).

![\[Histograma do X-Ray de um estágio de API do API Gateway\]](http://docs.aws.amazon.com/pt_br/apigateway/latest/developerguide/images/apigateway-xray-histogram-1.png)


## Exemplo de exibição de rastreamento do X-Ray
<a name="apigateway-using-xray-trace-view-active"></a>

O diagrama a seguir mostra uma visualização de rastreamento gerada para a API de exemplo descrita acima, com uma função de backend do Lambda. Uma solicitação de método da API bem-sucedida é mostrada com um código de resposta de 200.

Consulte uma explicação detalhada sobre visualizações de rastreamento em [View traces and trace details](https://docs.aws.amazon.com/xray/latest/devguide/aws-xray-interface-console.html#xray-console-traces).

![\[API Gateway com rastreamento ativo habilitado\]](http://docs.aws.amazon.com/pt_br/apigateway/latest/developerguide/images/apigateway-xray-traceview-1.png)