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á.
Visualizar rastreamentos e detalhes do rastreamento
Use a página Traces no console X-Ray para encontrar traços porURL, código de resposta ou outros dados do resumo do rastreamento. Depois de selecionar um rastreamento na lista de rastreamento, a página de detalhes do rastreamento exibe um mapa dos nós de serviço associados ao rastreamento selecionado e uma linha do tempo dos segmentos de rastreamento.
Visualizar os rastreamentos
- CloudWatch console
-
Para visualizar traços no CloudWatch console
Faça login no AWS Management Console e abra o CloudWatch console em https://console.aws.amazon.com/cloudwatch/.
-
No painel de navegação esquerdo, escolha Traços de X-Ray e, em seguida, escolha Traços. Você pode filtrar por grupo ou inserir uma expressão de filtro. Isso filtra os traços que são exibidos na seção Traços na parte inferior da página.
Como alternativa, você pode usar o mapa de serviço para navegar até um nó de serviço específico e, em seguida, visualizar os rastreamentos. Isso abre a página Traços com uma consulta já aplicada.
-
Refine sua consulta na seção Refinadores de consulta. Para filtrar rastreamentos por um atributo comum, escolha uma opção na seta para baixo ao lado de Refinar consulta por. As opções incluem o seguinte:
-
Node — Filtre rastreamentos por nó de serviço.
-
Recurso ARN — Filtre rastreamentos por um recurso associado a um rastreamento. Exemplos desses recursos incluem uma instância do Amazon Elastic Compute Cloud (AmazonEC2), uma AWS Lambda
função ou uma Amazon DynamoDB tabela.
-
Usuário — Filtre rastreamentos com uma ID de usuário.
-
Mensagem de causa raiz do erro — Filtra os rastreamentos pela causa raiz do erro.
-
URL— Filtre os traços por um URL caminho usado pelo seu aplicativo.
-
HTTPcódigo de status — filtre os rastreamentos pelo código de HTTP status retornado pelo seu aplicativo. Você pode especificar um código de resposta personalizado ou selecionar uma das seguintes opções:
-
200— A solicitação foi bem-sucedida.
-
401— A solicitação não tinha credenciais de autenticação válidas.
-
403— A solicitação não tinha permissões válidas.
-
404— O servidor não conseguiu encontrar o recurso solicitado.
-
500— O servidor encontrou uma condição inesperada e gerou um erro interno.
Escolha uma ou mais entradas e, em seguida, escolha Adicionar à consulta para adicionar à expressão de filtro na parte superior da página.
-
Para encontrar um único rastreamento, insira um ID de rastreamento diretamente no campo de consulta. Você pode usar o formato X-Ray ou o formato World Wide Web Consortium (W3C). Por exemplo, um rastreamento criado usando o AWS Distro for OpenTelemetry está no formato W3C.
Quando você consulta rastreamentos criados com um ID de rastreamento no formato W3C, o console exibe o rastreamento correspondente no formato X-Ray. Por exemplo, se você consultar 4efaaf4d1e8720b39541901950019ee5 no formato W3C, o console exibirá o equivalente ao X-Ray:. 1-4efaaf4d-1e8720b39541901950019ee5
-
Escolha Executar consulta a qualquer momento para exibir uma lista de rastreamentos correspondentes na seção Rastreamentos na parte inferior da página.
-
Para exibir a página de detalhes do rastreamento de um único rastreamento, selecione um ID de rastreamento na lista.
A imagem a seguir mostra um mapa de rastreamento contendo nós de serviço associados ao rastreamento e bordas entre os nós representando o caminho percorrido pelos segmentos que compõem o rastreamento. Um resumo do Trace segue o Trace Map. O resumo contém informações sobre uma GET operação de amostra, seu código de resposta, a duração que o rastreamento levou para ser executado e a idade da solicitação. A linha do tempo dos segmentos segue o resumo do rastreamento, que mostra a duração dos segmentos e subsegmentos de rastreamento.
Se você tiver um aplicativo orientado a eventos que usa Amazon e SQS Lambda, você pode ver uma visualização conectada dos rastreamentos para cada solicitação no mapa Trace. No mapa, os traços dos produtores de mensagens são vinculados aos rastros dos AWS Lambda consumidores e são exibidos como uma borda tracejada. Para obter mais informações sobre aplicativos orientados a eventos, consulte. Rastrear aplicações orientadas a eventos
As páginas de detalhes do Traces and Trace também oferecem suporte ao rastreamento entre contas, que pode listar rastreamentos de várias contas na lista de rastreamento e dentro de um único mapa de rastreamento.
- X-Ray console
-
Como visualizar rastreamentos no console do X-Ray
-
Abra a página Rastreamentos no console do X-Ray. O painel de visão geral do Trace mostra uma lista de rastreamentos agrupados por recursos comuns, incluindo causas-raiz de errosARN, recursos e. InstanceId
-
Para selecionar um recurso comum para visualizar um conjunto agrupado de traços, expanda a seta para baixo ao lado de Agrupar por. A ilustração a seguir mostra uma visão geral dos traços agrupados URL porAWS X-Ray aplicação de amostra, e uma lista dos rastreamentos associados.
-
Escolha o ID de um rastreamento para visualizá-lo na lista de rastreamento. Você também pode escolher Mapa de serviços no painel de navegação para visualizar os rastreamentos de um nó de serviço específico. Em seguida, você pode visualizar os traços associados a esse nó.
A guia Cronograma mostra o fluxo de solicitações para o rastreamento e inclui o seguinte:
-
Um mapa do caminho para cada segmento no traçado.
-
Quanto tempo levou para o segmento alcançar um nó no mapa de rastreamento.
-
Quantas solicitações foram feitas ao nó no mapa de rastreamento.
A ilustração a seguir mostra um exemplo de Mapa de Rastreamento associado a uma GET solicitação feita a um aplicativo de amostra. As setas mostram o caminho que cada segmento percorreu para concluir a solicitação. Os nós de serviço mostram o número de solicitações feitas durante a GET solicitação.
Para obter mais informações sobre a guia Cronograma, consulte a seção Explorando o cronograma de rastreamento a seguir.
A guia Dados brutos mostra informações sobre o rastreamento e os segmentos e subsegmentos que compõem o rastreamento, em JSON formato. Essas informações podem incluir o seguinte:
-
Carimbos de data/hora
-
Único IDs
-
Recursos associados ao segmento ou subsegmento
-
A fonte ou origem do segmento ou subsegmento
-
Informações adicionais sobre a solicitação à sua inscrição, como a resposta de uma HTTP solicitação
Explorar a linha do tempo do rastreamento
A seção Cronograma mostra uma hierarquia de segmentos e subsegmentos ao lado de uma barra horizontal que corresponde ao tempo usado para concluir suas tarefas. A primeira entrada na lista é o segmento, que representa todos os dados registrados pelo serviço para uma única solicitação. Os subsegmentos são indentados e listados após o segmento. As colunas contêm informações sobre cada segmento.
- CloudWatch console
-
No CloudWatch console, a linha do tempo dos segmentos fornece as seguintes informações:
-
A primeira coluna: lista os segmentos e subsegmentos no traçado selecionado.
-
A coluna Status do segmento: lista o resultado do status de cada segmento e subsegmento.
-
A coluna Código de resposta: lista um código de status de HTTP resposta para uma solicitação do navegador feita pelo segmento ou subsegmento, quando disponível.
-
A coluna Duração: lista por quanto tempo o segmento ou subsegmento foi executado.
-
A coluna Hospedado em: lista o namespace ou o ambiente em que o segmento ou subsegmento é executado, se aplicável. Para obter mais informações, consulte Dimensões coletadas e combinações de dimensões.
-
A última coluna: exibe barras horizontais que correspondem à duração da execução do segmento ou subsegmento, em relação aos outros segmentos ou subsegmentos na linha do tempo.
Para agrupar a lista de segmentos e subsegmentos por nó de serviço, ative Agrupar por nós.
- X-Ray console
-
Na página de detalhes do rastreamento, escolha a guia Cronograma para ver o cronograma de cada segmento e subsegmento que compõe um traçado.
No console X-Ray, a Timeline fornece as seguintes informações:
-
A coluna Nome: lista os nomes dos segmentos e subsegmentos no rastreamento.
-
A coluna Res.: lista um código de status de HTTP resposta a uma solicitação do navegador feita pelo segmento ou subsegmento, quando disponível.
-
A coluna Duração: lista por quanto tempo o segmento ou subsegmento foi executado.
-
A coluna Status: lista o resultado do status do segmento ou subsegmento.
-
A última coluna: exibe barras horizontais que correspondem à duração da execução do segmento ou subsegmento, em relação aos outros segmentos ou subsegmentos na linha do tempo.
Para ver os dados de rastreamento brutos que o console usa para gerar a linha do tempo, escolha a guia Dados brutos. Os dados brutos mostram informações sobre o rastreamento e os segmentos e subsegmentos que compõem o rastreamento em JSON formato. Essas informações podem incluir o seguinte:
-
Carimbos de data/hora
-
Único IDs
-
Recursos associados ao segmento ou subsegmento
-
A fonte ou origem do segmento ou subsegmento
-
Informações adicionais sobre a solicitação de sua inscrição, como a resposta de uma HTTP solicitação.
Quando você usa um instrumentado AWS SDK ou SQL cliente para fazer chamadas para recursos externos, o X-Ray SDK grava subsegmentos automaticamente. HTTP Você também pode usar o X-Ray SDK para gravar subsegmentos personalizados para qualquer função ou bloco de código. Subsegmentos adicionais que são registrados enquanto um subsegmento personalizado está aberto se tornam filhos do subsegmento personalizado.
Visualizar os detalhes do segmento
Na linha do tempo de rastreamento, escolha o nome de um segmento para ver seus detalhes.
O painel de detalhes do segmento mostra a visão geral, os recursos, as anotações, os metadados, as exceções e as guias. SQL O seguinte se aplica:
-
A guia Overview (Visão geral) mostra informações sobre a solicitação e a resposta. As informações incluem o nome, a hora de início, a hora de término, a duração, a solicitaçãoURL, a operação da solicitação, o código de resposta da solicitação e quaisquer erros e falhas.
-
A guia Resources de um segmento mostra informações do X-Ray SDK e sobre os AWS recursos que executam seu aplicativo. Use os ECS plug-ins Amazon EC2 ou Amazon para o X-Ray SDK para registrar informações de recursos específicos do serviço. AWS Elastic Beanstalk Para obter mais informações sobre plug-ins, consulte a seção Plug-ins de serviço emConfigurando o X-Ray SDK para Java.
-
As guias restantes mostram Anotações, Metadados e Exceções que são registrados para o segmento. As exceções são capturadas automaticamente quando são geradas a partir de uma solicitação instrumentada. As anotações e os metadados contêm informações adicionais que você registra usando as operações fornecidas pelo X-Ray. SDK Para adicionar anotações ou metadados aos seus segmentos, use o X-Ray. SDK Para obter mais informações, consulte o link específico do idioma listado em Instrumentando seu aplicativo em. AWS X-Ray SDKs Instrumentando seu aplicativo para AWS X-Ray
Visualizar os detalhes do subsegmento
Na linha do tempo do rastreamento, escolha o nome de um subsegmento para visualizar os respectivos detalhes.
-
A guia Visão geral contém informações sobre a solicitação e a resposta. Isso inclui o nome, a hora de início, a hora de término, a duração, a solicitaçãoURL, a operação da solicitação, o código de resposta da solicitação e quaisquer erros e falhas. Para subsegmentos gerados com clientes instrumentados, a guia Overview (Visão geral) contém informações sobre a solicitação e a resposta do ponto de vista do seu aplicativo.
-
A guia Recursos de um subsegmento mostra detalhes sobre os AWS
recursos que foram usados para executar o subsegmento. Por exemplo, a guia de recursos pode incluir uma AWS Lambda funçãoARN, informações sobre uma tabela do DynamoDB, qualquer operação chamada e ID da solicitação.
-
As guias restantes mostram anotações, metadados e exceções registradas no subsegmento. As exceções são capturadas automaticamente quando são geradas a partir de uma solicitação instrumentada. As anotações e os metadados contêm informações adicionais que você registra usando as operações fornecidas pelo X-Ray. SDK Use o X-Ray SDK para adicionar anotações ou metadados aos seus segmentos. Para obter mais informações, consulte o link específico do idioma listado em Instrumentando seu aplicativo em. AWS X-Ray
SDKs Instrumentando seu aplicativo para AWS X-Ray
Para subsegmentos personalizados, a guia Overview (Visão geral) mostra o nome do subsegmento, que é possível definir para especificar a área do código ou a função que ele registra. Para obter mais informações, consulte o link específico do idioma listado em Instrumentando seu aplicativo em. AWS X-Ray SDKs Gerar subsegmentos personalizados com o X-Ray SDK para Java
A imagem a seguir mostra a guia Visão geral de um subsegmento personalizado. A visão geral contém o ID do subsegmento, o ID principal, o nome, os horários de início e término, a duração, o status e os erros ou falhas.
A guia Metadados de um subsegmento personalizado contém informações em JSON formato sobre os recursos usados por esse subsegmento.
