Use um AWS Management Console

Use um AWS Management Console se quiser uma interface gráfica de usuário (GUI) que exija o mínimo de codificação. Usuários iniciantes no X-Ray podem começar rapidamente usando visualizações pré-criadas e executando tarefas básicas. Você pode fazer o seguinte diretamente do console:

• Habilite o X-Ray.

• Veja resumos de alto nível do desempenho do seu aplicativo.

• Verifique o status de saúde de seus aplicativos.

• Identifique erros de alto nível.

• Veja resumos básicos de rastreamento.

Você pode usar o console da Amazon em https://console.aws.amazon.com/cloudwatch/ ou o CloudWatch console do X-Ray em https://console.aws.amazon.com/xray/home para interagir com o X-Ray.

Use o CloudWatch console da Amazon

O CloudWatch console inclui a nova funcionalidade X-Ray que foi redesenhada a partir do console X-Ray para facilitar o uso. Se você usar o CloudWatch console, poderá visualizar CloudWatch registros e métricas junto com os dados de rastreamento do X-Ray. Use o CloudWatch console para visualizar e analisar dados, incluindo os seguintes:

• Rastreamentos X-Ray — Visualize, analise e filtre os rastreamentos associados ao seu aplicativo à medida que ele atende a uma solicitação. Use esses rastreamentos para encontrar altas latências, depurar erros e otimizar o fluxo de trabalho do seu aplicativo. Visualize um mapa de rastreamento e um mapa de serviços para ver representações visuais do fluxo de trabalho do seu aplicativo.

• Registros — Visualize, analise e filtre os registros que seu aplicativo produz. Use registros para solucionar erros e configurar o monitoramento com base em valores de registro específicos.

• Métricas — Meça e monitore o desempenho do seu aplicativo usando métricas que seus recursos emitem ou crie suas próprias métricas. Veja essas métricas em gráficos e tabelas.

• Monitoramento de redes e infraestrutura — monitore as principais redes em busca de interrupções e a integridade e o desempenho de sua infraestrutura, incluindo aplicativos em contêineres, outros AWS serviços e clientes.

• Todas as funcionalidades do console X-Ray listadas na seção Use o console X-Ray a seguir.

Para obter mais informações sobre o CloudWatch console, consulte Introdução à Amazon CloudWatch.

Faça login no CloudWatch console da Amazon em https://console.aws.amazon.com/cloudwatch/.

Usar o console do X-Ray

O console X-Ray oferece rastreamento distribuído para solicitações de aplicativos. Use o console X-Ray se quiser uma experiência de console mais simples ou não quiser atualizar o código do aplicativo. AWS não está mais desenvolvendo o console X-Ray. O console X-Ray contém os seguintes recursos para aplicações instrumentadas:

• Insights — Detecte automaticamente anomalias no desempenho do seu aplicativo e encontre as causas subjacentes. Os Insights estão incluídos no CloudWatch console em Insights. Para obter mais informações, consulte o Use X-Ray Insights emExplore o console X-Ray.

• Mapa de serviços — Visualize uma estrutura gráfica do seu aplicativo e suas conexões com clientes, recursos, serviços e dependências.

• Traços — Veja uma visão geral dos rastreamentos que são gerados pelo seu aplicativo quando ele atende a uma solicitação. Use dados de rastreamento para entender o desempenho do seu aplicativo em relação às métricas básicas, incluindo HTTP resposta e tempo de resposta.

• Análise — Interprete, explore e analise dados de rastreamento usando gráficos para distribuição do tempo de resposta.

• Configuração — Crie rastreamentos personalizados para alterar as configurações padrão para o seguinte:

  • Amostragem — Crie uma regra que defina com que frequência a amostra do seu aplicativo para obter informações de rastreamento. Para obter mais informações, consulte Configurar regras de amostragem emExplore o console X-Ray.

  • Criptografia — Criptografe dados em repouso usando uma chave que você pode auditar ou desativar usando AWS Key Management Service.

  • Grupos — Use uma expressão de filtro para definir um grupo de rastreamentos com um recurso comum, como o nome de um URL ou um tempo de resposta. Para obter mais informações, consulte Configurar grupos.

Faça login no console X-Ray em https://console.aws.amazon.com/xray/home.

Explore o console X-Ray

Use o console X-Ray para visualizar um mapa dos serviços e rastreamentos associados às solicitações que seus aplicativos atendem e para configurar grupos e regras de amostragem que afetam a forma como os rastreamentos são enviados ao X-Ray.

nota

O mapa e CloudWatch ServiceLens o mapa do X-Ray Service foram combinados no mapa de rastreamento do X-Ray no CloudWatch console da Amazon. Abra o CloudWatchconsole e escolha Trace Map em Traços de X-Ray no painel de navegação esquerdo.

CloudWatch agora inclui o Application Signals, que pode descobrir e monitorar seus serviços de aplicativos, clientes, canários da Synthetics e dependências de serviços. Use o Application Signals para ver uma lista ou um mapa visual dos seus serviços, visualizar métricas de integridade com base nos seus objetivos de nível de serviço (SLOs) e fazer uma busca profunda para ver rastreamentos do X-Ray correlacionados para uma solução de problemas mais detalhada.

A página principal do console do X-Ray é o mapa de rastreamento, que é uma representação visual do gráfico do serviço JSON que o X-Ray gera a partir dos dados de rastreamento gerados por seus aplicativos. O mapa consiste em nós de serviço para cada aplicativo na sua conta que atende solicitações, nós de cliente upstream que representam as origens das solicitações e nós de serviço downstream que representam serviços da Web e recursos usados por um aplicativo ao processar uma solicitação. Há páginas adicionais para visualizar rastreamentos e detalhes de rastreamento e configurar grupos e regras de amostragem.

Veja a experiência do console com o X-Ray e compare com a do CloudWatch console nas seções a seguir.

Use o mapa de rastreamento X-Ray

Visualize o mapa de rastreamento do X-Ray para identificar serviços em que erros estão ocorrendo, conexões com alta latência ou rastreamentos de solicitações que não tiveram êxito.

nota

CloudWatch agora inclui o Application Signals, que pode descobrir e monitorar seus serviços de aplicativos, clientes, canários sintéticos e dependências de serviços. Use o Application Signals para ver uma lista ou um mapa visual dos seus serviços, visualizar métricas de integridade com base nos seus objetivos de nível de serviço (SLOs) e fazer uma busca profunda para ver rastreamentos do X-Ray correlacionados para uma solução de problemas mais detalhada.

O mapa e CloudWatch ServiceLens o mapa do serviço X-Ray são combinados no mapa de rastreamento do X-Ray no CloudWatch console da Amazon. Abra o CloudWatchconsole e escolha Trace Map em Traços de X-Ray no painel de navegação esquerdo.

Exibir o mapa de rastreamento

O mapa de rastreamento é uma representação visual dos dados de rastreamento gerados por seus aplicativos. Ele mostra nós de serviço que atendem a solicitações, nós de cliente precedentes que representam as origens das solicitações e nós de serviço subsequentes que representam serviços da web e recursos usados por uma aplicação ao processar uma solicitação.

O mapa de rastreamento exibe uma visão conectada dos rastreamentos em aplicativos orientados a eventos que usam o Amazon SQS e o Lambda. Para obter mais informações, consulte a seção a seguir sobre aplicativos orientados por eventos do Trace. O mapa de rastreamento também oferece suporte ao rastreamento entre contas, exibindo nós de várias contas em um único mapa.

CloudWatch console

Para visualizar o mapa de rastreamento no CloudWatch console

1. Abra o console de CloudWatch . Escolha Trace Map na seção X-Ray Traces no painel de navegação esquerdo.

   

2. Escolha um nó de serviço para visualizar solicitações desse nó ou uma borda entre dois nós para visualizar solicitações que percorreram essa conexão.

3. Informações adicionais são exibidas abaixo do mapa de rastreamento, incluindo guias para métricas, alertas e distribuição do tempo de resposta. Na guia Métricas, selecione um intervalo em cada gráfico para detalhar e ver mais detalhes ou escolha as opções Falhas ou Erros para filtrar os rastreamentos. Na guia Distribuição do tempo de resposta, selecione um intervalo no gráfico para filtrar os rastreamentos por tempo de resposta.

   

4. Para visualize os rastreamentos, escolha Visualizar rastreamentos ou, se tiver sido aplicado um filtro, selecione Exibir rastreamentos filtrados.

5. Escolha Exibir registros para ver CloudWatch os registros associados ao nó selecionado. Nem todos os nós do mapa de rastreamento oferecem suporte à visualização de registros. Consulte os CloudWatch registros de solução de problemas para obter mais informações.

O mapa de rastreamento indica problemas em cada nó, descrevendo-o com cores:

• Vermelho para falhas do servidor (erros da série 500)

• Amarelo para erros de clientes (erros da série 400)

• Roxo para erros de controle de utilização (429, muitas solicitações)

Se o seu mapa de rastreamento for grande, use os controles na tela ou o mouse para ampliar e diminuir o zoom e mover o mapa.

X-Ray console

Para ver o mapa de serviços

1. Abra o console do X-Ray. O mapa de serviço é exibido por padrão. Você também pode escolher Mapa de serviços no painel de navegação esquerdo.

   

2. Escolha um nó de serviço para visualizar solicitações desse nó ou uma borda entre dois nós para visualizar solicitações que percorreram essa conexão.

3. Use um histograma de distribuição de resposta para filtrar os traços por duração e selecione os códigos de status para os quais você deseja visualizar os traços. Em seguida, escolha Visualizar rastreamentos para abrir a lista de rastreamentos com a expressão de filtro aplicada. Para obter mais informações sobre histogramas de distribuição, consulte. Use histogramas de latência

   

O mapa de serviço indica a integridade de cada nó atribuindo cores a ele com base no índice de chamadas bem-sucedidas em relação a erros e falhas:

• Verde para chamadas bem-sucedidas

• Vermelho para falhas do servidor (erros da série 500)

• Amarelo para erros de clientes (erros da série 400)

• Roxo para erros de controle de utilização (429, muitas solicitações)

Se o mapa de serviço for grande, use os controles na tela ou o mouse para ampliar e reduzir e mover o mapa.

nota

O mapa de rastreamento X-Ray pode exibir até 10.000 nós. Em cenários raros em que o número total de nós de serviço excede esse limite, você pode receber um erro e não conseguir exibir um mapa de rastreamento completo no console.

Filtrando o mapa de rastreamento por grupo

Ao usar uma expressão de filtro, é possível definir critérios para incluir rastreamentos em um grupo. Para obter mais informações sobre expressões de filtro, consulte Usar expressões de filtro. Em seguida, use as etapas a seguir para exibir esse grupo específico no mapa de rastreamento.

CloudWatch console

Escolha um nome de grupo no filtro de grupo no canto superior esquerdo do mapa de rastreamento.

X-Ray console

Escolha um nome de grupo no menu suspenso à esquerda da barra de pesquisa.

O mapa de serviço agora será filtrado para exibir rastreamentos que correspondam à expressão de filtro do grupo selecionado.

Legenda e opções do mapa de rastreamento

O mapa de rastreamento inclui uma legenda e várias opções para personalizar a exibição do mapa.

CloudWatch console

Escolha o menu suspenso Legenda e opções no canto superior direito do mapa. Escolha o que é exibido nos nós, como:

• Métricas: exibem o tempo médio de resposta e o número de rastreamentos enviados por minuto durante o intervalo de tempo escolhido.

• Nós: exibem o ícone do serviço em cada nó.

Escolha configurações adicionais do mapa no painel Preferências, que pode ser acessado por meio do ícone de engrenagem no canto superior direito do mapa. Essas configurações exigem a seleção da métrica a ser usada para determinar o tamanho de cada nó e dos canários que devem ser exibidos no mapa.

X-Ray console

Exiba a legenda do mapa de serviço escolhendo o link Legenda do mapa no canto superior direito do mapa. As opções do mapa de serviço podem ser escolhidas na parte inferior direita do mapa de rastreamento, incluindo:

• Ícones de serviço: alternam o que é exibido em cada nó, exibindo o ícone do serviço ou o tempo médio de resposta e o número de rastreamentos enviados por minuto durante o intervalo de tempo escolhido.

• Dimensionamento de nó: Nenhum define todos os nós com o mesmo tamanho.

• Dimensionamento de nó: Integridade dimensiona os nós pelo número de solicitações afetadas, incluindo erros, falhas ou solicitações com controle de utilização.

• Dimensionamento de nó: Tráfego dimensiona os nós pelo número total de solicitações.

Visualize traços e detalhes de rastreamento

Use a lista Rastreamentos no console do X-Ray para encontrar rastreamentos por URL, código de resposta ou outros dados do resumo de rastreamentos. 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

1. Faça login no AWS Management Console e abra o CloudWatch console em https://console.aws.amazon.com/cloudwatch/.

2. 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, que filtra os traços exibidos na seção Traços na parte inferior da página. Para obter mais informações, consulte Usar expressões de filtro.

   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.

3. 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.

   • ARN do recurso — filtra os rastreamentos por um recurso associado a um rastreamento. Exemplos desses recursos incluem uma instância, uma função ou uma tabela do Amazon Elastic Compute Cloud (Amazon EC2). AWS Lambda Amazon DynamoDB

   • 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 rastreamentos por um caminho de URL usado pelo seu aplicativo.

   • Código de status HTTP — filtre os rastreamentos pelo código de status HTTP 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.

4. 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.

   nota

   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

5. Escolha Executar consulta a qualquer momento para exibir uma lista de rastreamentos correspondentes na seção Rastreamentos na parte inferior da página.

6. 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 SQS e Lambda, você pode ver uma visualização conectada dos rastreamentos de cada solicitação no mapa de rastreamento. 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. Rastreie aplicativos orientados por 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. Para ter mais informações, consulte Rastreamento entre contas.

X-Ray console

Como visualizar rastreamentos no console do X-Ray

1. 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 erro, resourceArn e. InstanceId

2. 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 rastreamentos agrupados por URL para o AWS X-Ray aplicação de amostra e uma lista dos rastreamentos associados.

   

3. 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

   • IDs exclusivos

   • Recursos associados ao segmento ou subsegmento

   • A fonte ou origem do segmento ou subsegmento

   • Informações adicionais sobre a solicitação para seu aplicativo, como a resposta de uma solicitação HTTP

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 resposta HTTP 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 ter mais informações, consulte https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AppSignals-StandardMetrics.html#AppSignals-StandardMetrics-Dimensions.

• 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 resposta HTTP 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 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

• IDs exclusivos

• Recursos associados ao segmento ou subsegmento

• A fonte ou origem do segmento ou subsegmento

• Informações adicionais sobre a solicitação para seu aplicativo, como a resposta de uma solicitação HTTP.

Quando você usa um AWS SDK instrumentado ou SQL cliente para fazer chamadas para recursos externosHTTP, o X-Ray SDK registra subsegmentos automaticamente. 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 as guias Visão geral, Recursos, Anotações, Metadados, Exceções e 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, o URL da solicitação, 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 plug-ins Amazon EC2 ou Amazon ECS 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 emConfigurar 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 com AWS X-Ray SDKs em. Instrumente 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 um ARN de AWS Lambda função, 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 com AWS X-Ray SDKs em. Instrumente 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 com AWS X-Ray SDKs em. 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.

Use expressões de filtro

Use expressões de filtro para visualizar um mapa de rastreamento ou rastreamentos para uma solicitação específica, serviço, conexão entre dois serviços (uma borda) ou solicitações que satisfaçam uma condição. O X-Ray fornece uma linguagem de expressão de filtro para filtrar solicitações, serviços e bordas com base em dados em cabeçalhos de solicitação, status de resposta e campos indexados nos segmentos originais.

Ao escolher um período de rastreamento para visualizar no console do X-Ray, você pode obter mais resultados do que o console é capaz de exibir. No canto superior direito, o console mostra o número de rastreamentos que verificou e se há mais rastreamentos disponíveis. É possível usar uma expressão de filtro para estreitar os resultados a apenas rastreamentos que você deseja localizar.

Detalhes de expressão de filtro

Quando você escolhe um nó no mapa de rastreamento, o console constrói uma expressão de filtro com base no nome do serviço do nó e nos tipos de erro presentes com base na sua seleção. Para encontrar rastreamentos que mostram problemas de desempenho ou relacionados a solicitações específicas, é possível ajustar a expressão fornecida pelo console ou criar a sua própria. Se você adicionar anotações com o X-Ray SDK, poderá também filtrar com base na presença de uma chave de anotação ou no valor de uma chave.

nota

Se você escolher um intervalo de tempo relativo no mapa de rastreamento e escolher um nó, o console converterá o intervalo de tempo em um horário absoluto de início e término. Para garantir que os rastreamentos do nó apareçam nos resultados da pesquisa e evitar tempos de verificação quando o nó não estava ativo, o intervalo de tempo inclui apenas as horas em que o nó enviou rastreamentos. Para pesquisar com relação à hora atual, é possível voltar a um intervalo de tempo relativo na página de rastreamentos e verificar novamente.

Se ainda houver mais resultados disponíveis além do que o console pode mostrar, o console mostrará o número de rastreamentos correspondidos e o número de rastreamentos verificados. A porcentagem mostrada é a porcentagem do intervalo de tempo selecionado que foi verificado. Para garantir que você veja todos os rastreamentos correspondentes representados nos resultados, restrinja mais sua expressão de filtro ou escolha um limite de tempo mais curto.

Para obter os resultados mais recentes primeiro, o console inicia a verificação no final do intervalo de tempo e trabalha retroativamente. Se houver um grande número de rastreamentos, mas poucos resultados, o console dividirá o intervalo de tempo em partes e os verificará em paralelo. A barra de progresso mostra as partes do intervalo de tempo que foram verificadas.

Use expressões de filtro com grupos

Os grupos são uma coleção de rastreamentos definidos por uma expressão de filtro. Você pode usar grupos para gerar gráficos de serviços adicionais e fornecer CloudWatch métricas da Amazon.

Os grupos são identificados pelo nome ou pelo nome do recurso da Amazon (ARN) e contêm uma expressão de filtro. O serviço compara os rastreamentos de entrada com a expressão e os armazena adequadamente.

É possível criar e modificar grupos usando o menu suspenso à esquerda da barra de pesquisa da expressão de filtro.

nota

Se o serviço encontrar um erro na qualificação de um grupo, esse grupo não estará mais incluído no processamento de rastreamentos de entrada e uma métrica de erro será registrada.

Para obter mais informações sobre grupos, consulte Configurar grupos.

Sintaxe de expressão de filtro

As expressões de filtro podem conter uma palavra-chave, um operador unário ou binário e um valor para comparação.

keyword operator value

Operadores diferentes estão disponíveis para tipos diferentes de palavras-chave. Por exemplo, responsetime é uma palavra-chave de número e pode ser comparada com os operadores relacionados a números.

exemplo Exemplo: solicitações em que o tempo de resposta foi superior a 5 segundos

responsetime > 5

É possível combinar várias expressões em uma expressão composta usando os operadores AND ou OR.

exemplo Exemplo: solicitações em que a duração total foi de 5 a 8 segundos

duration >= 5 AND duration <= 8

Palavras-chave e operadores simples encontram problemas apenas no nível de rastreamento. Se ocorrer um erro de downstream, mas é controlado pelo seu aplicativo e não retornado ao usuário, uma pesquisa por error não o encontrará.

Para encontrar rastros com problemas posteriores, você pode usar as palavras-chave complexas service() e. edge() Essas palavras-chave permitem que você aplique uma expressão de filtro a todos os nós de downstream, um único nó de downstream ou uma borda entre dois nós. Para obter mais informações sobre essas palavras-chave, consulte a seção Palavras-chave complexas a seguir. Para obter mais granularidade, filtre os serviços e bordas por tipo com a função id(). Para obter mais informações, consulte a seção da função id a seguir.

Palavras-chave boolianas

Os valores de palavras-chave boolianas são verdadeiros ou falsos. Use essas palavras-chave para encontrar rastreamentos que resultaram em erros.

Palavras-chave boolianas

• ok: o código de status da resposta foi 2XX Êxito.

• error: o código de status da resposta foi 4XX Erro do cliente.

• throttle: o código de status da resposta foi 429 Solicitações em excesso.

• fault: o código de status da resposta foi 5XX Erro do servidor.

• partial: a solicitação tem segmentos incompletos.

• inferred: a solicitação inferiu segmentos.

• first: o elemento é o primeiro de uma lista enumerada.

• last: o elemento é o último de uma lista enumerada.

• remote: a entidade de causa raiz é remota.

• root: o serviço é o ponto de entrada ou o segmento raiz de um rastreamento.

Os operadores boolianos encontram segmentos onde a chave especificada é true ou false.

Operadores booleanos

• none: a expressão é verdadeira se a palavra-chave for verdadeira.

• !: a expressão é verdadeira se a palavra-chave for falsa.

• =,!=: compara o valor da palavra-chave com a string true ou false. Estes operadores agem da mesma forma que os outros operadores, mas são mais explícitos.

exemplo Exemplo: o status de resposta é 2XX OK

ok

exemplo Exemplo: o status de resposta não é 2XX OK

!ok

exemplo Exemplo: o status de resposta não é 2XX OK

ok = false

exemplo Exemplo: o último rastreamento de falha enumerado tem o nome de erro "deserialize"

rootcause.fault.entity { last and name = "deserialize" }

exemplo Exemplo: solicitações com segmentos remotos em que a cobertura é maior que 0,7 e o nome do serviço é "traces"

rootcause.responsetime.entity { remote and coverage > 0.7 and name = "traces" }

exemplo Exemplo: solicitações com segmentos inferidos em que o tipo de serviço é "AWS:DynamoDB"

rootcause.fault.service { inferred and name = traces and type = "AWS::DynamoDB" }

exemplo Exemplo: solicitações que têm um segmento com o nome "data-plane" como raiz

service("data-plane") {root = true and fault = true}

Palavras-chave de número

Use palavras-chave de número para pesquisar solicitações com um tempo de resposta, duração ou status de resposta específico.

Palavras-chave de número

• responsetime: o tempo que o servidor levou para enviar uma resposta.

• duration: duração total da solicitação, incluindo todas as chamadas subsequentes.

• http.status: código de status da resposta.

• index: posição de um elemento em uma lista enumerada.

• coverage: porcentagem decimal do tempo de resposta da entidade sobre o tempo de resposta do segmento raiz. Aplicável apenas para entidades de causa raiz de tempo de resposta.

Operadores de número

Palavras-chave de número usam operadores padrão de igualdade e comparação.

• =,!=: a palavra-chave é igual ou não a um valor numérico.

• <,<=, >,>=: a palavra-chave é menor ou maior do que um valor numérico.

exemplo Exemplo: o status de resposta não é 200 OK

http.status != 200

exemplo Exemplo: solicitação em que a duração total foi de 5 a 8 segundos

duration >= 5 AND duration <= 8

exemplo Exemplo: solicitações que foram concluídas com êxito em menos de 3 segundos, incluindo todas as chamadas subsequentes

ok !partial duration <3

exemplo Exemplo: entidade de lista enumerada que tem um índice maior que 5

rootcause.fault.service { index > 5 }

exemplo Exemplo: solicitações em que a última entidade tem cobertura superior a 0,8

rootcause.responsetime.entity { last and coverage > 0.8 }

Palavras-chave de string

Use palavras-chave de string para encontrar rastreamentos com texto específico em cabeçalhos de solicitação ou IDs de usuário específicos.

Palavras-chave de string

• http.url: URL da solicitação.

• http.method: método da solicitação.

• http.useragent: string do agente de usuário da solicitação.

• http.clientip: endereço IP do solicitante.

• user: valor do campo de usuário em qualquer segmento no rastreamento.

• name: o nome de um serviço ou exceção.

• type: tipo de serviço.

• message: mensagem de exceção.

• availabilityzone: valor do campo da zona de disponibilidade em qualquer segmento no rastreamento.

• instance.id: valor do campo de ID da instância em qualquer segmento no rastreamento.

• resource.arn: valor do campo de ARN do recurso em qualquer segmento no rastreamento.

Os operadores de string encontram valores que são iguais a ou contêm um texto específico. Os valores devem sempre ser especificados entre aspas.

Operadores de string

• =,!=: a palavra-chave é igual ou não a um valor numérico.

• CONTAINS: a palavra-chave contém uma string específica.

• BEGINSWITH,ENDSWITH: a palavra-chave começa ou termina com uma string específica.

exemplo Exemplo: filtro http.url

http.url CONTAINS "/api/game/"

Para testar se um campo existe em um rastreamento, independentemente do seu valor, verifique se ele contém a string vazia.

exemplo Exemplo: filtro do usuário

Encontre todos os rastreamentos com IDs de usuário.

user CONTAINS ""

exemplo Exemplo: selecionar rastreamentos com uma causa raiz de falha que inclua um serviço chamado "Auth"

rootcause.fault.service { name = "Auth" }

exemplo Exemplo: selecionar rastreamentos com uma causa raiz de tempo de resposta cujo último serviço tenha um tipo do DynamoDB

rootcause.responsetime.service { last and type = "AWS::DynamoDB" }

exemplo Exemplo: selecionar rastreamentos com uma causa raiz de falha cuja última exceção tenha a mensagem "Access Denied for account_id: 1234567890"

rootcause.fault.exception { last and message = "Access Denied for account_id: 1234567890" 

Palavras-chave complexas

Use palavras-chave complexas para encontrar solicitações com base no nome do serviço, no nome de borda ou no valor de anotação. Para serviços e bordas, você pode especificar uma expressão de filtro adicional que se aplica ao serviço ou borda. Para anotações, é possível filtrar pelo valor de uma anotação com uma chave específica usando operadores boolianos, de número ou de string.

Palavras-chave complexas

• annotation.key: valor de uma anotação com o campo key. O valor de uma anotação pode ser um booliano, um número ou uma string; portanto, é possível usar qualquer um desses tipos de operador de comparação. É possível usar essa palavra-chave em combinação com as palavras-chave service ou edge.

• edge(source, destination) {filter}: conexão entre serviços source e destination. As chaves opcionais podem conter uma expressão de filtro que se aplica a segmentos nessa conexão.

• group.name / group.arn: o valor da expressão de filtro de um grupo, referido pelo nome do grupo ou ARN do grupo.

• json: objeto de causa raiz do JSON. Consulte Obter dados do AWS X-Ray para ver as etapas para criar entidades JSON programaticamente.

• service(name) {filter}: serviço com name. Chaves opcionais podem conter uma expressão de filtro que se aplica a segmentos criados pelo serviço.

Use a palavra-chave service para encontrar rastreamentos para solicitações que atingiram um determinado nó em seu mapa de rastreamento.

Os operadores complexos de palavras-chave encontram segmentos nos quais a chave especificada foi definida ou não.

Operadores de palavras-chave complexos

• none: a expressão é verdadeira se a palavra-chave for definida. Se a palavra-chave for do tipo booliano, ela será avaliada como o valor booliano.

• !: a expressão é verdadeira se a palavra-chave não for definida. Se a palavra-chave for do tipo booliano, ela será avaliada como o valor booliano.

• =,!=: compara o valor da palavra-chave.

• edge(source, destination) {filter}: conexão entre serviços source e destination. As chaves opcionais podem conter uma expressão de filtro que se aplica a segmentos nessa conexão.

• annotation.key: valor de uma anotação com o campo key. O valor de uma anotação pode ser um booliano, um número ou uma string; portanto, é possível usar qualquer um desses tipos de operador de comparação. É possível usar essa palavra-chave em combinação com as palavras-chave service ou edge.

• json: objeto de causa raiz do JSON. Consulte Obter dados do AWS X-Ray para ver as etapas para criar entidades JSON programaticamente.

Use a palavra-chave service para encontrar rastreamentos para solicitações que atingiram um determinado nó em seu mapa de rastreamento.

exemplo Exemplo: filtro de serviço

Solicitações que incluem uma chamada para api.example.com com uma falha (erro da série 500).

service("api.example.com") { fault }

É possível excluir o nome do serviço para aplicar uma expressão de filtro para todos os nós no seu mapeamento de serviço.

exemplo Exemplo: filtro de serviço

Solicitações que causaram uma falha em qualquer lugar do seu mapa de rastreamento.

service() { fault }

A palavra-chave de borda aplica uma expressão de filtro a uma conexão entre dois nós.

exemplo Exemplo: filtro de borda

Solicitação em que o serviço api.example.com fez uma chamada para o backend.example.com que gerou um erro.

edge("api.example.com", "backend.example.com") { error }

Use também o operador ! com palavras-chave de serviço e borda para excluir um serviço ou borda dos resultados de outra expressão de filtro.

exemplo Exemplo: filtro de serviço e solicitação

Solicitação em que o URL começa com http://api.example.com/ e contém /v2/, mas não abrange um serviço chamado api.example.com.

http.url BEGINSWITH "http://api.example.com/" AND http.url CONTAINS "/v2/" AND !service("api.example.com")

exemplo Exemplo: filtro de serviço e tempo de resposta

Encontre rastreamento em que http url está definido e o tempo de resposta é maior que 2 segundos.

http.url AND responseTime > 2

Para anotações, você pode chamar todos os rastreamentos em que annotation.key está definido ou usar os operadores de comparação que correspondem ao tipo de valor.

exemplo Exemplo: anotação com valor de string

Solicitações com uma anotação chamada gameid com o valor de string "817DL6VO".

annotation.gameid = "817DL6VO"

exemplo Exemplo: a anotação está definida

Solicitações com uma anotação definida como age.

annotation.age

exemplo Exemplo: a anotação não está definida

Solicitações sem uma anotação definida como age.

!annotation.age

exemplo Exemplo: anotação com valor numérico

Solicitações cuja idade de anotação tem um valor numérico maior do que 29.

annotation.age > 29

exemplo Exemplo: anotação em combinação com serviço ou borda

service { annotation.request_id = "917DL6VO" }

edge { source.annotation.request_id = "916DL6VO" }

edge { destination.annotation.request_id = "918DL6VO" }

exemplo Exemplo: grupo com usuário

Solicitações em que os rastreamentos atendem ao filtro de grupo high_response_time (por exemplo, responseTime > 3) e o usuário se chama Alice.

group.name = "high_response_time" AND user = "alice"

exemplo Exemplo: JSON com entidade de causa raiz

Solicitações com entidades de causa raiz correspondentes.

rootcause.json = #[{ "Services": [ { "Name": "GetWeatherData", "EntityPath": [{ "Name": "GetWeatherData" }, { "Name": "get_temperature" } ] }, { "Name": "GetTemperature", "EntityPath": [ { "Name": "GetTemperature" } ] } ] }]

Função id

Ao fornecer um nome de serviço para as palavras-chave service ou edge, você obtém resultados para todos os nós que têm esse nome. Para filtragem mais precisa, use a função id para especificar um tipo de serviço, além de um nome para distinguir os nós com o mesmo nome.

Use a função account.id para especificar uma conta específica para o serviço ao visualizar rastreamentos de várias contas em uma conta de monitoramento.

id(name: "service-name", type:"service::type", account.id:"account-ID")

Use a função id no lugar de um nome de serviço nos filtros de serviço e de borda.

service(id(name: "service-name", type:"service::type")) { filter }

edge(id(name: "service-one", type:"service::type"), id(name: "service-two", type:"service::type")) { filter }

Por exemplo, AWS Lambda as funções resultam em dois nós no mapa de rastreamento; um para a invocação da função e outro para o serviço Lambda. Os dois nós têm o mesmo nome, mas tipos diferentes. Um filtro de serviço padrão encontrará rastreamentos para ambos.

exemplo Exemplo: filtro de serviço

As solicitações que incluem um erro em qualquer serviço chamado random-name.

service("function-name") { error }

Use a função id para restringir a pesquisa para erros na função em si, excluindo os erros do serviço.

exemplo Exemplo: filtro de serviço com a função id

Solicitações que incluem um erro em um serviço chamado random-name com tipo AWS::Lambda::Function.

service(id(name: "random-name", type: "AWS::Lambda::Function")) { error }

Para procurar nós por tipo, também é possível excluir o nome inteiramente.

exemplo Exemplo: filtro de serviço com função id e tipo de serviço

Solicitações que incluem um erro em um serviço com o tipo AWS::Lambda::Function.

service(id(type: "AWS::Lambda::Function")) { error }

Para pesquisar nós para um determinado Conta da AWS, especifique um ID de conta.

exemplo Exemplo: filtro de serviço com a função id e o ID da conta

Solicitações que incluem um serviço dentro de um ID de conta AWS::Lambda::Function específico.

service(id(account.id: "account-id"))

Rastreamento entre contas

AWS X-Ray oferece suporte à observabilidade entre contas, permitindo monitorar e solucionar problemas de aplicativos que abrangem várias contas em um. Região da AWS Você pode pesquisar, visualizar e analisar facilmente métricas, logs e rastreamentos em qualquer conta vinculada, como se estivesse operando em uma única conta. Isso fornece uma visão completa das solicitações que se estendem por várias contas. Você pode visualizar rastreamentos entre contas no mapa de rastreamento do X-Ray e nas páginas de rastreamentos no CloudWatchconsole.

Os dados de observabilidade compartilhados podem incluir qualquer um dos seguintes tipos de telemetria:

• Métricas na Amazon CloudWatch

• Grupos de registros no Amazon CloudWatch Logs

• Traços em AWS X-Ray

• Aplicativos no Amazon CloudWatch Application Insights

Configurar a observabilidade entre contas

Para ativar a observabilidade entre contas, configure uma ou mais contas de monitoramento da AWS e vincule-as a diversas contas de origem. Uma conta de monitoramento é uma central Conta da AWS que pode visualizar e interagir com dados de observabilidade gerados pelas contas de origem. Uma conta de origem é um indivíduo Conta da AWS que gera dados de observabilidade para os recursos que ela contém.

As contas de origem compartilham os dados de observabilidade com as contas de monitoramento. Os rastreamentos são copiados de cada conta de origem para até cinco contas de monitoramento. As cópias dos rastreamentos das contas de origem para a primeira conta de monitoramento são gratuitas. As cópias dos rastreamentos enviados a contas de monitoramento adicionais são cobradas em cada conta de origem, com base no preço padrão. Para obter mais informações, consulte AWS X-Ray preços e CloudWatch preços da Amazon.

Para criar links entre contas de monitoramento e contas de origem, use o CloudWatch console ou os novos comandos do Observability Access Manager na API AWS CLI e. Para obter mais informações, consulte CloudWatch observabilidade entre contas.

nota

Os traços de raio-X são cobrados no Conta da AWS local onde são recebidos. Se uma solicitação de amostra abranger serviços em mais de um Conta da AWS, cada conta registra um rastreamento separado e todos os rastreamentos compartilham o mesmo ID de rastreamento. Para saber mais sobre preços de observabilidade entre contas, consulte preços e AWS X-Ray preços da Amazon CloudWatch .

Visualizar rastreamentos entre contas

Os rastreamentos entre contas são exibidos na conta de monitoramento. Cada conta de origem exibe somente rastreamentos locais para essa conta específica. As seções a seguir pressupõem que você esteja conectado à conta de monitoramento e tenha aberto o CloudWatch console da Amazon. Tanto no mapa de rastreamento quanto nas páginas de rastreamentos, um selo da conta de monitoramento é exibido no canto superior direito.

Mapa de rastreamento

No CloudWatch console, escolha Trace Map em Traços de X-Ray no painel de navegação esquerdo. Por padrão, o mapa de rastreamento exibe nós para todas as contas de origem que enviam rastreamentos para a conta de monitoramento e nós para a própria conta de monitoramento. No mapa de rastreamento, escolha Filtros no canto superior esquerdo para filtrar o mapa de rastreamento usando o menu suspenso Contas. Depois que um filtro de conta é aplicado, os nós de serviço de contas que não correspondem ao filtro atual ficam desabilitados.

Quando você escolhe um nó de serviço, o painel de detalhes do nó inclui o ID da conta e o rótulo do serviço.

No canto superior direito do mapa de rastreamento, escolha Visualização em lista para ver uma lista de nós de serviço. A lista de nós de serviço inclui serviços da conta de monitoramento e de todas as contas de origem configuradas. Filtre a lista de nós por Rótulo da conta ou ID da conta escolhendo-os no filtro Nós.

Rastreamentos

Veja os detalhes de rastreamento de rastreamentos que abrangem várias contas abrindo o CloudWatch console a partir da conta de monitoramento e escolhendo Traces em Traços de X-Ray no painel de navegação esquerdo. Você também pode abrir essa página escolhendo um nó no X-Ray Trace Map e, em seguida, escolhendo Exibir traços no painel de detalhes do nó.

A página Rastreamentos permite consultas por ID de conta. Para começar, insira uma consulta que inclua um ou mais IDs de conta. Para obter mais informações sobre consultas, consulteUse expressões de filtro. O exemplo a seguir consulta rastreamentos que passaram pelo ID da conta X ou Y:

service(id(account.id:"X")) OR service(id(account.id:"Y"))

Refine sua consulta por Conta. Selecione uma ou mais contas na lista e escolha Adicionar à consulta.

Detalhes de rastreamento

Veja os detalhes de um rastreamento escolhendo-o na lista Rastreamentos na parte inferior da página Rastreamentos. Os detalhes do rastreamento são exibidos, incluindo um mapa de detalhes do rastreamento com nós de serviço de todas as contas pelas quais o rastreamento passou. Escolha um nó de serviço específico para ver a conta correspondente.

A seção Linha do tempo dos segmentos exibe os detalhes da conta para cada segmento na linha do tempo.

Rastreie aplicativos orientados por eventos

AWS X-Ray suporta o rastreamento de aplicativos orientados por eventos usando o Amazon SQS e. AWS Lambda Use o CloudWatch console para ver uma visão conectada de cada solicitação conforme ela é enfileirada com o Amazon SQS e processada por uma ou mais funções Lambda. Os rastreamentos dos produtores de mensagens upstream são automaticamente vinculados aos rastreamentos dos nós consumidores do Lambda downstream, criando uma end-to-end visão do aplicativo.

nota

Cada segmento de rastreamento pode ser vinculado a até vinte traços, enquanto um rastreamento pode incluir no máximo cem links. Em determinadas situações, ao vincular rastreamentos adicionais, o tamanho máximo do documento de rastreamentos pode ser excedido e resultar em um rastreamento possivelmente incompleto. Isso pode acontecer, por exemplo, quando uma função do Lambda com rastreamento habilitado envia muitas mensagens SQS para uma fila em uma única invocação. Se você se deparar com esse problema, há um método de mitigação que usa os X-Ray SDKs. Consulte o X-Ray SDK para Java, Node.js, Python, Go ou .NET para obter mais informações.

Exibir traços vinculados no mapa de rastreamento

Use a página Trace Map no CloudWatchconsole para visualizar um mapa de rastreamento com traços de produtores de mensagens vinculados a traços de consumidores do Lambda. Esses links são exibidos com uma borda tracejada que conecta o nó do Amazon SQS e os nós consumidores subsequentes do Lambda.

Selecione uma borda tracejada para exibir um histograma da idade do evento recebido, que mapeia a distribuição da idade do evento quando ele é recebido pelos consumidores. A idade é calculada sempre que um evento é recebido.

Visualizar detalhes de rastreamentos vinculados

Veja os detalhes dos rastreamento enviados por um produtor de mensagens, uma fila do Amazon SQS ou um consumidor do Lambda:

1. Use o Trace Map para selecionar um produtor de mensagens, Amazon SQS ou nó consumidor Lambda.

2. Escolha Visualizar rastreamentos no painel de detalhes do nó para exibir uma lista de rastreamentos. Você também pode navegar diretamente até a página Traces no CloudWatch console.

3. Escolha um rastreamento específico na lista para abrir a página de detalhes do rastreamento. A página de detalhes do rastreamento exibe uma mensagem quando o rastreamento selecionado faz parte de um conjunto vinculado de rastreamentos.

   

O mapa de detalhes do rastreamento exibe o rastreamento atual, junto com os traços vinculados a montante e a jusante, cada um deles contido em uma caixa que indica os limites de cada rastreamento. Se o rastreamento selecionado no momento estiver vinculado a vários rastreamentos precedentes e subsequentes, os nós dentro dos rastreamentos vinculados precedentes e subsequentes serão empilhados e um botão Selecionar rastreamento será exibido.

Abaixo do mapa de detalhes do traçado, é exibida uma linha do tempo dos segmentos de rastreamento, incluindo traços vinculados a montante e a jusante. Se houver vários rastreamentos vinculados precedentes e subsequentes, os detalhes do segmento não poderão ser exibidos. Para visualizar os detalhes do segmento de um único rastreamento em um conjunto de traços vinculados, selecione um único rastreamento conforme descrito na seção a seguir.

Selecionar um único rastreamento dentro de um conjunto de rastreamentos vinculados

Filtre um conjunto vinculado de rastreamentos em um único rastreamento para ver os detalhes do segmento na linha do tempo.

1. Escolha Selecionar traçado abaixo dos traços vinculados no mapa de detalhes do traçado. Uma lista de rastreamentos é exibida.

   

2. Selecione o botão de rádio ao lado de um traçado para visualizá-lo no mapa de detalhes do traçado.

3. Escolha Cancelar seleção de rastreamentos para visualizar todo o conjunto de rastreamentos vinculados.

   

Use histogramas de latência

Quando você seleciona um nó ou borda em um mapa de rastreamento, o console X-Ray mostra um histograma de distribuição de latência.

Latência

A latência é o tempo entre o início de uma solicitação e sua conclusão. Um histograma mostra uma distribuição de latências. Ela mostra a duração no eixo x e a porcentagem de solicitações correspondentes a cada período no eixo y.

Este histograma mostra um serviço que conclui a maioria das solicitações em menos de 300 ms. Uma pequena porcentagem de solicitações demora até 2 segundos, e algumas exceções levam mais tempo.

Interpretar detalhes do serviço

Os histogramas de serviço e margem apresentam uma representação visual da latência a partir do ponto de vista de um serviço ou solicitante.

• Clique no círculo para escolher um nó de serviço. O X-Ray mostra um histograma de solicitações atendidas pelo serviço. As latências são as registradas pelo serviço e não incluem nenhuma latência de rede entre o serviço e o solicitante.

• Escolha uma borda clicando na linha ou na ponta da seta da borda entre dois serviços. O X-Ray mostra um histograma para pedidos do solicitante que foram atendidos pelo serviço subsequente. As latências são as registradas pelo solicitante e incluem a latência na conexão de rede entre os dois serviços.

Para interpretar o histograma de painel Service details, é possível examinar os valores que mais diferem da maioria dos valores no histograma. Essas exceções podem ser vistas como picos ou picos no histograma, e é possível visualizar os rastreamentos de uma área específica para investigar o que está acontecendo.

Para visualizar rastreamentos filtrados por latência, selecione um intervalo no histograma. Clique onde você deseja iniciar a seleção e arraste da esquerda para a direita a fim de destacar um intervalo de latências a serem incluídas no filtro de rastreamento.

Depois de selecionar um intervalo, você poderá escolher Zoom para visualizar apenas essa parte do histograma e refinar a seleção.

Assim que você tiver o foco definido na área pela qual tem interesse, escolha View traces.

Use X-Ray Insights

AWS X-Ray analisa continuamente os dados de rastreamento em sua conta para identificar problemas emergentes em seus aplicativos. Quando as taxas de falha excedem o intervalo esperado, ele cria um insight que registra o problema e rastreia o respectivo impacto até que ele seja resolvido. Com o Insights, você pode:

• Identificar onde os problemas estão ocorrendo na aplicação, a causa raiz do problema e o impacto correspondente. A análise de impacto fornecida pelo Insights permite que você determine a gravidade e a prioridade de um problema.

• Receber notificações à medida que o problema muda ao longo do tempo. As notificações do Insights podem ser integradas à sua solução de monitoramento e alerta usando a Amazon EventBridge. Essa integração permite que você envie e-mails ou alertas automatizados com base na gravidade do problema.

O console X-Ray identifica nós com incidentes em andamento no mapa de rastreamento. Para ver um resumo de insights, escolha o nó afetado. Você também pode visualizar e filtrar Insights escolhendo Insights no painel de navegação à esquerda.

O X-Ray cria um insight quando detecta uma anomalia em um ou mais nós do mapa de serviço. O serviço usa modelagem estatística para prever as taxas de falha esperadas dos serviços na aplicação. No exemplo anterior, a anomalia é um aumento nas falhas de. AWS Elastic Beanstalk O servidor do Elastic Beanstalk teve vários tempos limite de chamadas de API, causando uma anomalia nos nós subsequentes.

Ative o Insights no console X-Ray

É necessário habilitar os insights para cada grupo com o qual você deseja usar os recursos de insight. Você pode habilitá-los na página Grupos.

1. Abra o console do X-Ray.

2. Selecione um grupo ou crie um escolhendo Criar grupo e escolha Habilitar Insights. Para obter mais informações sobre como configurar grupos no console do X-Ray, consulte Configurar grupos.

3. No painel de navegação à esquerda, escolha Insights e selecione um insight para visualizar.

   

nota

O X-Ray usa GetInsightSummaries GetInsight GetInsightEvents,,, e operações de GetInsightImpactGraph API para recuperar dados de insights. Para ver os insights, use a política gerenciada AWSXrayReadOnlyAccess do IAM ou adicione a seguinte política personalizada à sua função do IAM:

          {
             "Version": "2012-10-17",
             "Statement": [
                 {
                     "Effect": "Allow",
                     "Action": [
                         "xray:GetInsightSummaries",
                         "xray:GetInsight",
                         "xray:GetInsightEvents",
                         "xray:GetInsightImpactGraph"
                     ],
                     "Resource": [
                         "*"
                     ]
                 }
             ]
         }
      

Para ter mais informações, consulte Como AWS X-Ray funciona com o IAM.

Habilitar notificações de insights

Com as notificações de insights, uma notificação é criada para cada evento de insight, como quando um insight é criado, muda significativamente ou é fechado. Os clientes podem receber essas notificações por meio de EventBridge eventos da Amazon e usar regras condicionais para realizar ações como notificação do SNS, invocação do Lambda, publicação de mensagens em uma fila do SQS ou qualquer suporte de destino. EventBridge As notificações de insight são emitidas com base no melhor esforço, mas não são garantidas. Para obter mais informações sobre metas, consulte Amazon EventBridge Targets.

Você pode habilitar as notificações de insight para qualquer grupo habilitado para insights na página Grupos.

Como habilitar notificações para um grupo do X-Ray

1. Abra o console do X-Ray.

2. Selecione um grupo ou crie um escolhendo Criar grupo. Certifique-se de que Habilitar Insights esteja selecionado e escolha Habilitar notificações. Para obter mais informações sobre como configurar grupos no console do X-Ray, consulte Configurar grupos.

Para configurar as regras EventBridge condicionais da Amazon

1. Abra o EventBridge console da Amazon.

2. Navegue até Regras na barra de navegação esquerda e escolha Criar regra.

3. Forneça um nome e uma descrição para a regra.

4. Escolha Padrão de evento e selecione Padrão personalizado. Forneça um padrão contendo "source": [ "aws.xray" ] e "detail-type": [ "AWS X-Ray Insight Update" ]. Veja a seguir alguns exemplos de padrões possíveis.

   • Padrão de evento para corresponder a todos os eventos de entrada de insights do X-Ray:

     {
     "source": [ "aws.xray" ],
     "detail-type": [ "AWS X-Ray Insight Update" ]
     }

   • Padrão de evento para corresponder a um state e category específicos:

              
     {
     "source": [ "aws.xray" ],
     "detail-type": [ "AWS X-Ray Insight Update" ],
     "detail": {
             "State": [ "ACTIVE" ],
             "Category": [ "FAULT" ]
       }
     }
                 

5. Selecione e configure os destinos que você gostaria de invocar quando um evento corresponder a essa regra.

6. (Opcional) Forneça tags para identificar e selecionar essa regra com maior facilidade.

7. Escolha Criar.

nota

As notificações do X-Ray Insights enviam eventos para a Amazon EventBridge, que atualmente não oferece suporte a chaves gerenciadas pelo cliente. Para ter mais informações, consulte Proteção de dados no AWS X-Ray.

Visão geral do insight

A página de visão geral de um insight tenta responder a três perguntas principais:

• Qual é o problema subjacente?

• Qual é a causa raiz?

• Qual é o impacto?

A seção Serviços anômalos mostra um cronograma para cada serviço que ilustra a mudança nas taxas de falha durante o incidente. A linha do tempo mostra o número de rastreamentos com falhas sobrepostas em uma faixa sólida que indica o número esperado de falhas com base na quantidade de tráfego registrada. A duração do insight é visualizada por meio da Janela de incidentes. A janela de incidentes começa quando o X-Ray observa a métrica se tornando anômala e persiste enquanto o insight está ativo.

O exemplo a seguir mostra um aumento nas falhas que causaram um incidente:

A seção Causa raiz mostra um mapa de rastreamento focado no serviço da causa raiz e no caminho afetado. É possível ocultar os nós não afetados selecionando o ícone de olho na parte superior direita do mapa da causa raiz. O serviço de causa raiz é o nó posterior mais distante em que o X-Ray identificou uma anomalia. Ele pode representar um serviço que você instrumentou ou um serviço externo que seu serviço chamou com um cliente instrumentado. Por exemplo, se você chamar o Amazon DynamoDB com um cliente SDK AWS instrumentado, um aumento nas falhas do DynamoDB resultará em uma visão com o DynamoDB como causa raiz.

Para investigar melhor a causa raiz, selecione Visualizar detalhes da causa raiz no gráfico da causa raiz. Você pode usar a página Análises para investigar a causa raiz e as mensagens relacionadas. Para ter mais informações, consulte Interaja com o console do Analytics.

As falhas que continuam na parte precedente no mapa podem afetar vários nós e causar várias anomalias. Se uma falha for passada de volta para o usuário que fez a solicitação, o resultado será uma falha do cliente. Isso é uma falha no nó raiz do mapa de rastreamento. O gráfico Impacto fornece uma linha do tempo da experiência do cliente para todo o grupo. Essa experiência é calculada com base em porcentagens dos seguintes estados: Falha, Erro, Controle e OK.

Este exemplo mostra um aumento nos rastreamentos com uma falha no nó raiz durante o período de um incidente. Incidentes em serviços subsequentes nem sempre correspondem a um aumento nos erros de cliente.

Escolher Analisar insight abre o console do X-Ray Analytics em uma janela na qual você pode se aprofundar no conjunto de rastreamentos que causam o insight. Para ter mais informações, consulte Interaja com o console do Analytics.

Noções básicas sobre impacto

AWS X-Ray mede o impacto causado por um problema contínuo como parte da geração de insights e notificações. O impacto é medido de duas maneiras:

• Impacto no grupo X-Ray. Para obter mais informações, consulte Configurar grupos

• Impacto no serviço de causa raiz

Esse impacto é determinado pela porcentagem de solicitações que estão falhando ou causando um erro em um determinado intervalo de tempo. Essa análise de impacto permite que você determine a gravidade e a prioridade do problema com base em seu cenário específico. Esse impacto está disponível como parte da experiência do console, além das notificações de insight.

Desduplicação

AWS X-Ray o Insights elimina a duplicação de problemas em vários microsserviços. O serviço usa a detecção de anomalias para determinar o serviço que é a causa raiz de um problema, determina se outros serviços relacionados estão exibindo um comportamento anômalo devido à mesma causa raiz e registra o resultado como um único insight.

Analisar o andamento de um insight

O X-Ray reavalia os insights periodicamente até que sejam resolvidos e registra cada alteração intermediária notável como uma notificação, que pode ser enviada como um evento da Amazon EventBridge . Isso permite que você crie processos e fluxos de trabalho para determinar como o problema mudou ao longo do tempo e tome as medidas apropriadas, como enviar um e-mail ou integrar-se a um sistema de alerta usando. EventBridge

Você pode analisar os eventos do incidente no Cronograma de impacto na página Inspecionar. Por padrão, o cronograma exibe o serviço mais afetado até que você escolha um serviço diferente.

Para ver um mapa de rastreamento e gráficos de um evento, escolha-o na linha do tempo de impacto. O mapa de rastreamento mostra os serviços em seu aplicativo que são afetados pelo incidente. Em Análise de impacto, os gráficos mostram cronogramas de falhas para o nó selecionado e os clientes do grupo.

Para analisar mais detalhadamente os rastreamentos envolvidos em um incidente, escolha Analisar evento na página Inspecionar. Você pode usar a página Análises para refinar a lista de rastreamentos e identificar os usuários afetados. Para ter mais informações, consulte Interaja com o console do Analytics.

Interaja com o console do Analytics

O console do AWS X-Ray Analytics é uma ferramenta interativa para interpretar dados de rastreamento para entender rapidamente o desempenho do aplicativo e dos serviços subjacentes. O console permite explorar, analisar e visualizar rastreamentos por meio de gráficos interativos de tempo de resposta e de séries temporais.

Ao fazer seleções no console do Analytics, o console cria filtros para refletir o subconjunto selecionado de todos os rastreamentos. É possível refinar o conjunto de dados ativo com filtros cada vez mais granulares clicando nos gráficos e nos painéis de métricas e campos que estão associados ao conjunto de rastreamentos atual.

Recursos do console

O console do X-Ray Analytics usa os principais recursos a seguir para agrupamento, filtragem, comparação e quantificação de dados de rastreamento.

Atributos

Atributo	Descrição
Groups (Grupos)	O grupo selecionado inicial é Default. Para alterar o grupo recuperado, selecione um grupo diferente no menu à direita da barra de pesquisa da expressão de filtro principal. Para saber mais sobre grupos, consulte Configurar grupos.
Rastreamentos recuperados	Por padrão, o console do Analytics gera gráficos com base em todos os rastreamentos no grupo selecionado. Rastreamentos recuperados representam todos os rastreamentos em seu conjunto de trabalho. Você pode encontrar a contagem de rastreamentos neste bloco. As expressões de filtro aplicadas à barra de pesquisa principal refinam e atualizam os rastreamentos recuperados.
Show in charts/Hide from charts (Mostrar nos gráficos/Ocultar dos gráficos)	Um botão para comparar o grupo ativo com os rastreamentos recuperados. Para comparar os dados relacionados ao grupo com qualquer filtro ativo, escolha Show in charts (Mostrar nos gráficos). Para remover essa visão dos gráficos, escolha Hide from charts (Ocultar dos gráficos).
Conjunto de rastreamentos filtrados A	Por meio de interações com os gráficos e tabelas, aplique filtros para criar os critérios para o conjunto de rastreamentos filtrados A. À medida que os filtros são aplicados, o número de rastreamentos aplicáveis e a porcentagem de rastreamentos do total que são recuperados são calculados neste bloco. Os filtros são preenchidos como tags no bloco Filtered trace set A (Conjunto de rastreamentos filtrados A) e também podem ser removidos do bloco.
Refinar	Esta função atualiza o conjunto de rastreamentos recuperados com base nos filtros aplicados ao conjunto de rastreamentos A. O refinamento do conjunto de rastreamentos recuperados atualiza o conjunto de trabalho de todos os rastreamentos recuperados com base nos filtros para o conjunto de rastreamentos A. O conjunto de trabalho de rastreamentos recuperados é um subconjunto de amostragem de todos os rastreamentos no grupo.
Conjunto de rastreamentos filtrados B	Quando criado, o conjunto de rastreamentos filtrados B é uma cópia do conjunto de rastreamentos filtrados A. Para comparar os dois conjuntos de rastreamentos, faça novas seleções de filtro que serão aplicadas ao conjunto de rastreamentos B, enquanto o conjunto de rastreamentos A permanece fixo. À medida que os filtros são aplicados, o número de rastreamentos aplicáveis e a porcentagem de rastreamentos do total recuperado são calculados dentro desse bloco. Os filtros são preenchidos como tags no bloco Filtered trace set B (Conjunto de rastreamentos filtrados B) e também podem ser removidos do bloco.
Response time root cause entity paths (Caminhos da entidade de causa raiz do tempo de resposta)	Uma tabela de caminhos de entidades registrados. O X-Ray determina qual caminho no rastreamento é a causa mais provável do tempo de resposta. O formato indica uma hierarquia de entidades encontradas, terminando em uma causa raiz do tempo de resposta. Use essas linhas para filtrar falhas de tempo de resposta recorrentes. Para obter mais informações sobre como personalizar um filtro de causa raiz e obter dados por meio da API, consulte a seção Recuperação e refinamento da análise de causa raiz em. Obtendo dados do X-Ray
Delta (�)	Uma coluna que é incluída nas tabelas de métricas quando ambos os conjuntos de rastreamentos A e B estão ativos. A coluna Delta calcula a diferença na porcentagem de rastreamentos entre o conjunto de rastreamentos A e o conjunto de rastreamentos B.

Distribuição do tempo de resposta

O console do X-Ray Analytics gera dois gráficos primários para ajudar você a visualizar rastreamentos: Distribuição do tempo de resposta e Atividade de séries temporais. Esta seção e a seguinte fornecem exemplos de cada uma delas e explicam os conceitos básicos de como ler os gráficos.

Veja a seguir as cores associadas ao gráfico de linha de tempo de resposta (o gráfico de série temporal usa o mesmo esquema de cores):

• Todos os rastreamentos no grupo: cinza

• Rastreamentos recuperados: laranja

• Conjunto de rastreamentos filtrados A: verde

• Conjunto de rastreamentos filtrados B: azul

exemplo Exemplo: distribuição do tempo de resposta

A distribuição do tempo de resposta é um gráfico que mostra o número de rastreamentos com um determinado tempo de resposta. Clique e arraste para fazer seleções dentro da distribuição do tempo de resposta. Isso seleciona e cria um filtro no conjunto de rastreamentos de trabalho nomeado responseTime para todos os rastreamentos dentro de um tempo de resposta específico.

Atividade de séries temporais

O gráfico de atividade da séries temporais mostra o número de rastreamentos em um determinado período. Os indicadores de cor refletem as cores do gráfico de linhas da distribuição do tempo de resposta. Quanto mais escuro e mais cheio for o bloco de cores dentro da série de atividades, mais traços serão representados no momento determinado.

exemplo Exemplo: atividade de séries temporais

Clique e arraste para fazer seleções no gráfico de atividades da séries temporais. Isso seleciona e cria um filtro chamado timerange no conjunto de rastreamentos de trabalho para todos os rastreamentos dentro de um intervalo de tempo específico.

Exemplos de fluxo de trabalho

Os exemplos a seguir mostram casos de uso comuns do console do X-Ray Analytics. Cada exemplo demonstra uma função-chave da experiência do console. Como um grupo, os exemplos seguem um fluxo de trabalho básico de solução de problemas. As etapas explicam como identificar primeiro os nós não íntegros e, depois, como interagir com o console do Analytics para gerar automaticamente consultas comparativas. Depois de restringir o escopo por meio de consultas, você finalmente analisará os detalhes dos traços de interesse para determinar o que está prejudicando a integridade do seu serviço.

Observar as falhas no gráfico de serviço

O mapa de rastreamento indica a integridade de cada nó colorindo-o com base na proporção de chamadas bem-sucedidas em relação a erros e falhas. Quando você vê uma porcentagem de vermelho no seu nó, ele sinaliza uma falha. Use o console do X-Ray Analytics para investigar.

Para obter mais informações sobre como ler o mapa de rastreamento, consulte Usar o mapa de rastreamento X-Ray.

Identificar picos de tempo de resposta

Usando a distribuição do tempo de resposta, você pode observar picos no tempo de resposta. Ao selecionar o pico no tempo de resposta, as tabelas abaixo dos gráficos serão atualizadas para expor todas as métricas associadas, como códigos de status.

Quando você clica e arrasta, o X-Ray selecione e cria um filtro. Ele será exibido em uma sombra cinza na parte superior das linhas em gráficos. Agora você pode arrastar esse destaque para a esquerda e para a direita ao longo da distribuição para atualizar sua seleção.

Visualizar todos os rastreamentos marcados com um código de status

Você pode analisar rastreamentos no pico selecionado usando as métricas tabelas abaixo dos gráficos. Clicando em uma linha na tabela HTTP STATUS CODE (CÓDIGO DE STATUS HTTP), você cria automaticamente um filtro no conjunto de dados de trabalho. Por exemplo, você pode ver todos os rastreamentos do código de status 500. Isso cria uma tag de filtro no bloco do conjunto de rastreamentos chamado http.status.

Visualizar todos os itens de um subgrupo de rastreamentos associados a um usuário

Analise o conjunto de erros com base no usuário, URL, causa raiz do tempo de resposta ou outros atributos predefinidos. Por exemplo, para filtrar o conjunto de rastreamentos adicionalmente com um código de status 500, selecione uma linha na tabela USERS (USUÁRIOS). Isso resulta em duas tags de filtro no bloco do conjunto de rastreamentos: http.status, conforme designado anteriormente, e user.

Compare dois conjuntos de rastreamentos com critérios diferentes

Compare vários usuários e suas solicitações POST para encontrar outras discrepâncias e correlações. Aplique o primeiro conjunto de filtros. Eles são definidos por uma linha azul na distribuição do tempo de resposta. Depois selecione Compare (Comparar). Inicialmente, isso cria uma cópia dos filtros no conjunto de rastreamentos A.

Para continuar, defina um novo conjunto de filtros para aplicar ao conjunto de rastreamentos B. Esse segundo conjunto é representado por uma linha verde. O exemplo a seguir mostra diferentes linhas de acordo com o esquema de cor verde e azul.

Identificar um rastreamento de interesse e visualizar os detalhes

À medida que você restringe seu escopo usando os filtros de console, a lista de rastreamentos abaixo das tabelas de métricas se torna mais significativa. A tabela da lista de rastreamentos combina informações sobre URL, USER (USUÁRIO) e STATUS CODE (CÓDIGO DE STATUS) em uma exibição. Para obter mais informações, selecione uma linha na tabela para abrir a página de detalhes de rastreamento e visualizar a linha do tempo e dados brutos.

Configurar grupos

Os grupos são uma coleção de rastreamentos definidos por uma expressão de filtro. Você pode usar grupos para gerar gráficos de serviços adicionais e fornecer CloudWatch métricas da Amazon. Você pode usar o console do AWS X-Ray ou a API do X-Ray para criar e gerenciar grupos para seus serviços. Este tópico descreve como criar e gerenciar grupos usando o console do X-Ray. Para obter informações sobre como gerenciar grupos usando a API do X-Ray, consulte Definindo configurações de amostragem, grupos e criptografia com a API X-Ray.

Você pode criar grupos de rastreamentos para mapas de rastreamento, rastreamentos ou análises. Quando você cria um grupo, o grupo fica disponível como um filtro no menu suspenso do grupo em todas as três páginas: Trace Map, Traces e Analytics.

Os grupos são identificados pelo nome ou pelo nome do recurso da Amazon (ARN) e contêm uma expressão de filtro. O serviço compara os rastreamentos de entrada com a expressão e os armazena adequadamente. Para obter mais informações sobre como criar uma expressão de filtro, consulte Use expressões de filtro.

Atualizar a expressão de filtro de um grupo não altera os dados que já estão registrados. A atualização se aplica somente aos rastreamentos subsequentes. Isso pode resultar em um gráfico mesclado das expressões novas e antigas. Para evitar isso, exclua o grupo atual e crie outro.

nota

Os grupos são faturados pelo número de rastreamentos recuperados que correspondem à expressão de filtro. Para obter mais informações, consulte Preços do AWS X-Ray.

Criar um grupo

nota

Agora você pode configurar grupos de X-Ray a partir do CloudWatch console da Amazon. Você também pode continuar usando o console do X-Ray.

CloudWatch console

1. Faça login no AWS Management Console e abra o CloudWatch console em https://console.aws.amazon.com/cloudwatch/.

2. Escolha Configurações no painel de navegação à esquerda.

3. Escolha Visualizar configurações em Grupos na seção Rastreamentos do X-Ray.

4. Escolha Criar grupo acima da lista de grupos.

5. Na página Criar grupo, digite um nome para o grupo. O nome de grupo pode ter no máximo 32 caracteres, mas somente caracteres alfanuméricos e hifens. Os nomes de grupo diferenciam letras maiúsculas de minúsculas.

6. Insira uma expressão de filtro. Para obter mais informações sobre como criar uma expressão de filtro, consulte Use expressões de filtro. No exemplo a seguir, o grupo filtra os rastreamentos de falhas do serviço api.example.com e as solicitações ao serviço em que o tempo de resposta foi maior ou igual a cinco segundos.

   fault = true AND http.url CONTAINS "example/game" AND responsetime >= 5

7. Em Insights, habilite ou desabilite o acesso a insights para o grupo. Para obter mais informações sobre insights, consulte Use X-Ray Insights.

   

8. Em Tags, escolha Adicionar nova tag para inserir uma chave de tag e, opcionalmente, um valor de tag. Continue adicionando outras tags conforme desejado. As chaves de tag devem ser exclusivas. Para excluir uma tag, escolha Remover abaixo de cada tag. Para obter mais informações sobre tags, consulte Marcar grupos e regras de amostragem do X-Ray.

   

9. Escolha Criar grupo.

X-Ray console

1. Faça login AWS Management Console e abra o console X-Ray em https://console.aws.amazon.com/xray/home.

2. Abra a página Criar grupo na página Grupos no painel de navegação esquerdo ou no menu do grupo em uma das seguintes páginas: Trace Map, Traces e Analytics.

3. Na página Criar grupo, digite um nome para o grupo. O nome de grupo pode ter no máximo 32 caracteres, mas somente caracteres alfanuméricos e hifens. Os nomes de grupo diferenciam letras maiúsculas de minúsculas.

4. Insira uma expressão de filtro. Para obter mais informações sobre como criar uma expressão de filtro, consulte Use expressões de filtro. No exemplo a seguir, o grupo filtra os rastreamentos de falhas do serviço api.example.com e as solicitações ao serviço em que o tempo de resposta foi maior ou igual a cinco segundos.

   fault = true AND http.url CONTAINS "example/game" AND responsetime >= 5

5. Em Insights, habilite ou desabilite o acesso a insights para o grupo. Para obter mais informações sobre insights, consulte Use X-Ray Insights.

   

6. Em Tags, insira uma chave de tag e, opcionalmente, um valor de tag. Ao adicionar uma tag, uma nova linha aparece para você adicionar outra tag. As chaves de tag devem ser exclusivas. Para excluir uma tag, escolha X no final da linha da tag. Para obter mais informações sobre tags, consulte Marcar grupos e regras de amostragem do X-Ray.

   

7. Escolha Criar grupo.

Aplicar um grupo

CloudWatch console

1. Faça login no AWS Management Console e abra o CloudWatch console em https://console.aws.amazon.com/cloudwatch/.

2. Abra uma das páginas a seguir no painel de navegação em Rastreamentos do X-Ray:

   • Mapa de rastreamento

   • Rastreamentos

3. Insira um nome de grupo no filtro Filtrar por grupo do X-Ray. Os dados mostrados na página são alterados para corresponder à expressão de filtro definida no grupo.

X-Ray console

1. Faça login AWS Management Console e abra o console X-Ray em https://console.aws.amazon.com/xray/home.

2. Abra uma das seguintes páginas no painel de navegação:

   • Mapa de rastreamento

   • Rastreamentos

   • Análise

3. No menu de grupos, escolha o grupo em que você criou em Criar um grupo. Os dados mostrados na página são alterados para corresponder à expressão de filtro definida no grupo.

Editar um grupo

CloudWatch console

1. Faça login no AWS Management Console e abra o CloudWatch console em https://console.aws.amazon.com/cloudwatch/.

2. Escolha Configurações no painel de navegação à esquerda.

3. Escolha Visualizar configurações em Grupos na seção Rastreamentos do X-Ray.

4. Escolha um grupo na seção Grupos e selecione Editar.

5. Embora não seja possível renomear um grupo, você pode atualizar a expressão de filtro. Para obter mais informações sobre como criar uma expressão de filtro, consulte Use expressões de filtro. No exemplo a seguir, o grupo filtra rastreamentos de falha do serviço api.example.com em que o endereço do URL da solicitação contém example/game e o tempo de resposta para solicitações foi maior ou igual a cinco segundos.

   fault = true AND http.url CONTAINS "example/game" AND responsetime >= 5

6. Em Insights, habilite ou desabilite o acesso a insights para o grupo. Para obter mais informações sobre insights, consulte Use X-Ray Insights.

   

7. Em Tags, escolha Adicionar nova tag para inserir uma chave de tag e, opcionalmente, um valor de tag. Continue adicionando outras tags conforme desejado. As chaves de tag devem ser exclusivas. Para excluir uma tag, escolha Remover abaixo de cada tag. Para obter mais informações sobre tags, consulte Marcar grupos e regras de amostragem do X-Ray.

   

8. Quando terminar de atualizar o grupo, escolha Atualizar grupo.

X-Ray console

1. Faça login AWS Management Console e abra o console X-Ray em https://console.aws.amazon.com/xray/home.

2. Realize uma das seguintes ações para abrir a página Editar grupo:

   1. Na página Grupos, escolha o nome de um grupo para editá-lo.

   2. No menu de grupos em uma das páginas a seguir, aponte para um grupo e escolha Editar.

      • Mapa de rastreamento

      • Rastreamentos

      • Análise

3. Embora não seja possível renomear um grupo, você pode atualizar a expressão de filtro. Para obter mais informações sobre como criar uma expressão de filtro, consulte Use expressões de filtro. No exemplo a seguir, o grupo filtra rastreamentos de falha do serviço api.example.com em que o endereço do URL da solicitação contém example/game e o tempo de resposta para solicitações foi maior ou igual a cinco segundos.

   fault = true AND http.url CONTAINS "example/game" AND responsetime >= 5

4. Em Insights, habilite ou desabilite os insights e as notificações de insights para o grupo. Para obter mais informações sobre insights, consulte Use X-Ray Insights.

   

5. Em Tags, edite chaves e valores da tag. As chaves de tag devem ser exclusivas. Os valores das tags são opcionais; você pode excluir valores se quiser. Para excluir uma tag, escolha X no final da linha da tag. Para obter mais informações sobre tags, consulte Marcar grupos e regras de amostragem do X-Ray.

   

6. Quando terminar de atualizar o grupo, escolha Atualizar grupo.

Clonar um grupo

A clonagem de um grupo cria um grupo com a expressão de filtro e as tags de um grupo existente. Quando você clona um grupo, o novo tem o mesmo nome do grupo do qual ele foi clonado, com -clone anexado ao nome.

CloudWatch console

1. Faça login no AWS Management Console e abra o CloudWatch console em https://console.aws.amazon.com/cloudwatch/.

2. Escolha Configurações no painel de navegação à esquerda.

3. Escolha Visualizar configurações em Grupos na seção Rastreamentos do X-Ray.

4. Escolha um grupo na seção Grupos e selecione Clonar.

5. Na página Criar grupo, o nome do grupo é group-name-clone. Opcionalmente, insira um novo nome para o grupo. O nome de grupo pode ter no máximo 32 caracteres, mas somente caracteres alfanuméricos e hifens. Os nomes de grupo diferenciam letras maiúsculas de minúsculas.

6. Você pode manter a expressão de filtro do grupo ou, opcionalmente, inserir uma nova expressão de filtro. Para obter mais informações sobre como criar uma expressão de filtro, consulte Use expressões de filtro. No exemplo a seguir, o grupo filtra os rastreamentos de falhas do serviço api.example.com e as solicitações ao serviço em que o tempo de resposta foi maior ou igual a cinco segundos.

   service("api.example.com") { fault = true OR responsetime >= 5 }

7. Em Tags, edite chaves e valores da tag, se necessário. As chaves de tag devem ser exclusivas. Os valores das tags são opcionais; você pode excluir valores se quiser. Para excluir uma tag, escolha X no final da linha da tag. Para obter mais informações sobre tags, consulte Marcar grupos e regras de amostragem do X-Ray.

8. Escolha Criar grupo.

X-Ray console

1. Faça login AWS Management Console e abra o console X-Ray em https://console.aws.amazon.com/xray/home.

2. Abra a página Grupos no painel de navegação esquerdo e escolha o nome de um grupo que você deseja clonar.

3. No menu Ações, escolha Clonar grupo.

4. Na página Criar grupo, o nome do grupo é group-name-clone. Opcionalmente, insira um novo nome para o grupo. O nome de grupo pode ter no máximo 32 caracteres, mas somente caracteres alfanuméricos e hifens. Os nomes de grupo diferenciam letras maiúsculas de minúsculas.

5. Você pode manter a expressão de filtro do grupo ou, opcionalmente, inserir uma nova expressão de filtro. Para obter mais informações sobre como criar uma expressão de filtro, consulte Use expressões de filtro. No exemplo a seguir, o grupo filtra os rastreamentos de falhas do serviço api.example.com e as solicitações ao serviço em que o tempo de resposta foi maior ou igual a cinco segundos.

   service("api.example.com") { fault = true OR responsetime >= 5 }

6. Em Tags, edite chaves e valores da tag, se necessário. As chaves de tag devem ser exclusivas. Os valores das tags são opcionais; você pode excluir valores se quiser. Para excluir uma tag, escolha X no final da linha da tag. Para obter mais informações sobre tags, consulte Marcar grupos e regras de amostragem do X-Ray.

7. Escolha Criar grupo.

Excluir um grupo

Siga as etapas nesta seção para excluir um grupo. Não é possível excluir o grupo padrão.

CloudWatch console

1. Faça login no AWS Management Console e abra o CloudWatch console em https://console.aws.amazon.com/cloudwatch/.

2. Escolha Configurações no painel de navegação à esquerda.

3. Escolha Visualizar configurações em Grupos na seção Rastreamentos do X-Ray.

4. Escolha um grupo na seção Grupos e selecione Excluir.

5. Quando for solicitada sua confirmação, escolha Excluir.

X-Ray console

1. Faça login AWS Management Console e abra o console X-Ray em https://console.aws.amazon.com/xray/home.

2. Abra a página Grupos no painel de navegação esquerdo e escolha o nome de um grupo que você deseja excluir.

3. No menu Ações, escolha Excluir grupo.

4. Quando for solicitada sua confirmação, escolha Excluir.

Veja as métricas do grupo na Amazon CloudWatch

Assim que um grupo é criado, os rastreamentos de entrada são verificados em relação à expressão de filtro do grupo, pois são armazenados no serviço X-Ray. As métricas do número de rastreamentos que correspondem a cada critério são publicadas na Amazon a CloudWatch cada minuto. Escolher Exibir métrica na página Editar grupo abre o CloudWatch console para a página Métrica. Para obter mais informações sobre como usar CloudWatch métricas, consulte Usando CloudWatch métricas da Amazon no Guia do CloudWatch usuário da Amazon.

CloudWatch console

1. Faça login no AWS Management Console e abra o CloudWatch console em https://console.aws.amazon.com/cloudwatch/.

2. Escolha Configurações no painel de navegação à esquerda.

3. Escolha Visualizar configurações em Grupos na seção Rastreamentos do X-Ray.

4. Escolha um grupo na seção Grupos e selecione Editar.

5. Na página Editar grupo escolha Exibir métrica.

   A página Métricas do CloudWatch console é aberta em uma nova guia.

X-Ray console

1. Faça login AWS Management Console e abra o console X-Ray em https://console.aws.amazon.com/xray/home.

2. Abra a página Grupos no painel de navegação esquerdo e escolha o nome de um grupo do qual você deseja visualizar as métricas.

3. Na página Editar grupo escolha Exibir métrica.

   A página Métricas do CloudWatch console é aberta em uma nova guia.

Configurar regras de amostragem

Você pode usar o AWS X-Ray console para configurar regras de amostragem para seus serviços. O X-Ray SDK e aqueles Serviços da AWS que oferecem suporte ao rastreamento ativo com configuração de amostragem usam regras de amostragem para determinar quais solicitações devem ser registradas.

Configurar regras de amostragem

Você pode configurar a amostragem para os seguintes casos de uso:

• Ponto de entrada do API Gateway: o API Gateway é compatível com amostragem e rastreamento ativo. Para habilitar o rastreamento ativo em um estágio de API, consulte Suporte de rastreamento ativo do Amazon API Gateway para AWS X-Ray.

• AWS AppSync— AWS AppSync suporta amostragem e rastreamento ativo. Para ativar o rastreamento ativo nas AWS AppSync solicitações, consulte Rastreamento com X-Ray AWS.

• Instrument X-Ray SDK em plataformas computacionais — Ao usar plataformas computacionais como Amazon EC2, Amazon ECS ou AWS Elastic Beanstalk, a amostragem é suportada quando o aplicativo é instrumentado com o SDK X-Ray mais recente.

Personalizar regras de amostragem

Ao personalizar regras de amostragem, você pode controlar a quantidade de dados registrados. Você também pode modificar o comportamento da amostragem sem modificar ou reimplantar seu código. As regras de amostragem informam ao X-Ray SDK o número de solicitações a serem registradas de acordo com um conjunto de critérios. Por padrão, o X-Ray SDK registra a primeira solicitação recebida no início de cada segundo e cinco por cento de todas as solicitações adicionais. Uma solicitação por segundo é o reservatório. Isso garante que pelo menos um rastreamento seja registrado a cada segundo à medida que o serviço atende às solicitações. Cinco por cento é a taxa segundo a qual as solicitações adicionais, além do tamanho de reservatório, são amostradas.

Você pode configurar o X-Ray SDK para ler as regras de amostragem de um documento JSON incluído com seu código. No entanto, ao executar várias instâncias do seu serviço, cada instância realiza a amostragem de forma independente. Isso faz com que a porcentagem total de solicitações amostradas aumente, pois os reservatórios de todas as instâncias são efetivamente somados. Além disso, para atualizar as regras de amostragem locais, você deve reimplantar seu código.

Ao definir regras de amostragem no console do X-Ray e configurar o SDK para ler as regras do serviço do X-Ray, você pode evitar esses problemas. O serviço gerencia o reservatório para cada regra e atribui cotas para cada instância de seu serviço a fim de distribuir o reservatório uniformemente com base no número de instâncias que estão em execução. O limite do reservatório é calculado de acordo com as regras definidas. Como as regras são configuradas no serviço, você pode gerenciá-las sem fazer implantações adicionais. Para obter mais informações sobre o AWS SDK, consulte Usar um SDK.

nota

Como o X-Ray usa a abordagem de melhor esforço na aplicação de regras de amostragem, em alguns casos a taxa de amostragem efetiva pode não corresponder exatamente às regras de amostragem configuradas. No entanto, com o tempo, o número de solicitações amostradas deve estar próximo à porcentagem configurada.

Agora você pode configurar as regras de amostragem do X-Ray no CloudWatch console da Amazon. Você também pode continuar usando o console do X-Ray.

CloudWatch console

Para configurar as regras de amostragem no console CloudWatch

1. Faça login no AWS Management Console e abra o CloudWatch console em https://console.aws.amazon.com/cloudwatch/.

2. Escolha Configurações no painel de navegação à esquerda.

3. Escolha Ver configurações em Regras de amostragem na seção Rastreamento do X-Ray.

4. Para criar uma regra, escolha Criar regra de amostragem.

   Para editar uma regra, escolha uma regra e selecione Editar para editá-la.

   Para excluir uma regra, escolha uma regra e selecione Excluir, para excluí-la.

X-Ray console

Como configurar as regras de amostragem no console do X-Ray

1. Abra o console do X-Ray.

2. No painel de navegação à esquerda, escolha Amostragem.

3. Para criar uma regra, escolha Criar regra de amostragem.

   Para editar uma regra, escolha o nome de uma regra.

   Para excluir uma regra, escolha uma regra e use o menu Actions (Ações) para excluí-la.

Opções de regras de amostragem

As opções a seguir estão disponíveis para cada regra. Valores de string podem usar curingas para corresponder a um caractere único (?) ou zero ou mais caracteres (*).

Opções de regras de amostragem

• Nome da regra (string): um nome exclusivo para a regra.

• Prioridade (inteiro entre 1 e 9.999): a prioridade da regra de amostragem. Os serviços avaliam as regras em ordem decrescente de prioridade e tomam uma decisão de amostragem com a primeira regra correspondente.

• Reservatório (inteiro não negativo): um número fixo de solicitações correspondentes para instrumentar por segundo, antes de aplicar a taxa fixa. O reservatório não é usado diretamente pelos serviços, mas se aplica a todos os serviços usando a regra coletivamente.

• Taxa (número inteiro entre 0 e 100): a porcentagem de solicitações correspondentes para instrumentar, depois que o reservatório está esgotado. Ao configurar uma regra de amostragem no console, escolha uma porcentagem entre 0 e 100. Ao configurar uma regra de amostragem em um SDK de cliente usando um documento JSON, forneça um valor percentual entre 0 e 1.

• Nome do serviço (string) — O nome do serviço instrumentado, conforme aparece no mapa de rastreamento.

  • X-Ray SDK: o nome do serviço que você configura no gravador.

  • Amazon API Gateway: api-name/stage.

• Tipo de serviço (string) — O tipo de serviço, conforme aparece no mapa de rastreamento. Para o X-Ray SDK, defina o tipo de serviço aplicando o plug-in apropriado:

  • AWS::ElasticBeanstalk::Environment— Um AWS Elastic Beanstalk ambiente (plugin).

  • AWS::EC2::Instance: um instância do Amazon EC2 (plug-in).

  • AWS::ECS::Container: um contêiner do Amazon ECS (plug-in).

  • AWS::APIGateway::Stage: um estágio do Amazon API Gateway.

  • AWS::AppSync::GraphQLAPI — Uma solicitação de AWS AppSync API.

• Host (string): o nome de host do cabeçalho de host HTTP.

• Método HTTP (string): o método da solicitação HTTP.

• Caminho do URL (string): o caminho URL da solicitação.

  • X-Ray SDK: a porção do caminho URL da solicitação HTTP.

• ARN do recurso (string) — O ARN do AWS recurso que está executando o serviço.

  • X-Ray SDK: sem suporte. O SDK só pode usar regras com o Resource ARN (ARN do recurso) definido como *.

  • Amazon API Gateway: o ARN do estágio.

• (Opcional) Atributos (chave e valor): atributos de segmento que são conhecidos quando a decisão de amostragem é feita.

  • X-Ray SDK: sem suporte. O SDK ignora as regras que especificam atributos.

  • Amazon API Gateway: cabeçalhos da solicitação HTTP original.

Exemplos de regras de amostragem

exemplo Exemplo: regra padrão sem reservatório e com taxa baixa

Você pode modificar o reservatório e a taxa da regra padrão. A regra padrão se aplica às solicitações que não correspondem a nenhuma outra regra.

• Reservatório: 0

• Taxa: 5 (0.05 se configurada usando um documento JSON)

exemplo Exemplo: regra de depuração para rastrear todas as solicitações para uma rota problemática

Uma regra de alta prioridade aplicada temporariamente para depuração.

• Nome da regra: DEBUG – history updates

• Prioridade: 1

• Reservatório: 1

• Taxa: 100 (1 se configurada usando um documento JSON)

• Nome de serviço: Scorekeep

• Tipo de serviço: *

• Host: *

• Método HTTP: PUT

• Caminho URL: /history/*

• ARN do recurso: *

exemplo Exemplo: taxa mínima maior para POSTs

• Nome da regra: POST minimum

• Prioridade: 100

• Reservatório: 10

• Taxa: 10 (.1 se configurada usando um documento JSON)

• Nome de serviço: *

• Tipo de serviço: *

• Host: *

• Método HTTP: POST

• Caminho URL: *

• ARN do recurso: *

Configure seu serviço para usar regras de amostragem

O X-Ray SDK requer configuração adicional para usar as regras de amostragem que você configura no console. Consulte o tópico de configuração referente à sua linguagem para obter detalhes sobre como configurar uma estratégia de amostragem:

• Java: Regras de amostragem

• Go: Regras de amostragem

• Node.js: Regras de amostragem

• Python: Regras de amostragem

• Ruby: Regras de amostragem

• .NET: Regras de amostragem

Para API Gateway, consulte Suporte de rastreamento ativo do Amazon API Gateway para AWS X-Ray.

Visualização dos resultados de amostragem

A página Amostragem do console do X-Ray mostra informações detalhadas sobre como seus serviços usam cada regra de amostragem.

A coluna Trend (Tendência) mostra como a regra foi usada nos últimos minutos. Cada coluna mostra estatísticas para uma janela de 10 segundos.

Estatísticas da amostragem

• Total de regras correspondidas: o número de solicitações que correspondem a essa regra. Esse número não inclui solicitações que poderiam ter correspondido essa regra, mas que primeiro encontraram uma regra correspondente de prioridade mais alta.

• Total de amostra o número de solicitações registradas.

• Amostradas com taxa fixa: o número de solicitações amostradas aplicando a taxa fixa da regra.

• Amostra com reservatório limite: o número de solicitações amostradas usando uma cota atribuída pelo X-Ray.

• Emprestado do reservatório: o número de solicitações amostradas por empréstimo do reservatório. Na primeira vez em que um serviço corresponde a uma solicitação de uma regra, ele não recebe uma cota do X-Ray. No entanto, se o reservatório for pelo menos 1, o serviço tomará emprestado um rastreamento por segundo até que o X-Ray atribua uma cota.

Para obter mais informações sobre as estatísticas de amostragem e como usar os serviços de regras de amostragem, consulte Usar regras de amostragem com a API do X-Ray.

Próximas etapas

Você pode usar a API do X-Ray para gerenciar as regras de amostragem. Com a API, você pode criar e atualizar regras de forma programática, em uma programação ou em resposta a alarmes ou notificações. Consulte Definindo configurações de amostragem, grupos e criptografia com a API X-Ray para obter instruções e ver mais exemplos de regras.

O X-Ray SDK Serviços da AWS também usa a X-Ray API para ler regras de amostragem, relatar resultados de amostragem e obter alvos de amostragem. Os serviços devem controlar a frequência com que eles aplicam cada regra, avaliam as regras com base na prioridade e tomam emprestado do reservatório quando uma solicitação corresponde a uma regra para a qual o X-Ray ainda não tiver atribuído uma cota de serviço. Para obter mais detalhes sobre como um serviço usa a API para amostragem, consulteUsar regras de amostragem com a API do X-Ray.

Quando o X-Ray SDK chama as APIs de amostragem, ele usa o daemon do X-Ray como um proxy. Se você já usa a porta TCP 2000, pode configurar o daemon para executar o proxy em uma porta diferente. Para mais detalhes, consulte Configurando o daemon AWS X-Ray.

Vinculação direta do console

Você pode usar rotas e consultas para criar links diretos para traços específicos ou visualizações filtradas dos traços e do mapa de rastreamento.

Páginas do console

• Página de boas-vindas: xray/home#/welcome

• Conceitos básicos: xray/home#/getting-started

• Mapa de rastreamento — xray/home#/service-map

• Rastreamentos: xray/home#/traces

Rastreamentos

Você pode gerar links para as visualizações de cronograma, bruta e de mapa de rastreamentos individuais.

Linha do tempo do rastreamento: xray/home#/traces/trace-id

Dados de rastreamento brutos: xray/home#/traces/trace-id/raw

exemplo Exemplo: dados de rastreamento brutos

https://console.aws.amazon.com/xray/home#/traces/1-57f5498f-d91047849216d0f2ea3b6442/raw

Expressões de filtro

Link para uma lista filtrada de rastreamentos.

Visualização de rastreamentos filtrados: xray/home#/traces?filter=filter-expression

exemplo Exemplo: expressão de filtro

https://console.aws.amazon.com/xray/home#/traces?filter=service("api.amazon.com") { fault = true OR responsetime > 2.5 } AND annotation.foo = "bar"

exemplo Exemplo: expressão de filtro (URL codificado)

https://console.aws.amazon.com/xray/home#/traces?filter=service(%22api.amazon.com%22)%20%7B%20fault%20%3D%20true%20OR%20responsetime%20%3E%202.5%20%7D%20AND%20annotation.foo%20%3D%20%22bar%22

Para obter mais informações sobre expressões de filtro, consulte Use expressões de filtro.

Intervalo de tempo

Especifique um período ou hora inicial e final no formato ISO8601. Os intervalos de tempo estão em UTC e podem ser de até seis horas.

Duração: xray/home#/page?timeRange=range-in-minutes

exemplo — mapa de rastreamento da última hora

https://console.aws.amazon.com/xray/home#/service-map?timeRange=PT1H

Horas de início e término: xray/home#/page?timeRange=start~end

exemplo Exemplo: intervalo de tempo preciso em segundos

https://console.aws.amazon.com/xray/home#/traces?timeRange=2023-7-01T16:00:00~2023-7-01T22:00:00

exemplo Exemplo: intervalo de tempo preciso em minutos

https://console.aws.amazon.com/xray/home#/traces?timeRange=2023-7-01T16:00~2023-7-01T22:00

Região

Especifique um link Região da AWS para páginas nessa região. Caso não especifique uma região, o console redirecionará você para a região visitada mais recentemente.

Região: xray/home?region=region#/page

exemplo — mapa de rastreamento no Oeste dos EUA (Oregon) (us-west-2)

https://console.aws.amazon.com/xray/home?region=us-west-2#/service-map

Quando você inclui uma região com outros parâmetros de consulta, a consulta da região fica antes do hash e as consultas específicas do X-Ray ficam depois do nome da página.

exemplo — mapa de rastreamento da última hora no Oeste dos EUA (Oregon) (us-west-2)

https://console.aws.amazon.com/xray/home?region=us-west-2#/service-map?timeRange=PT1H

Combinado

exemplo Exemplo: rastreamentos recentes com um filtro de duração

https://console.aws.amazon.com/xray/home#/traces?timeRange=PT15M&filter=duration%20%3E%3D%205%20AND%20duration%20%3C%3D%208

Saída

• Página: Rastreamentos

• Período: últimos 15 minutos

• Filtro: duração >= 5 E duração <= 8