Perguntas frequentes sobre o AWS X-Ray

Um rastreamento do X-Ray é um conjunto de pontos de dados que compartilham o mesmo ID de rastreamento. Por exemplo, quando um cliente faz uma solicitação para a sua aplicação, é atribuído a ele um ID exclusivo de rastreamento. Enquanto a solicitação percorre os serviços na sua aplicação, os serviços transmitem informações sobre a solicitação de volta para o X-Ray usando esse ID exclusivo de rastreamento. A informação transmitida por cada serviço na aplicação para o X-Ray é um segmento e um rastreamento é um conjunto de segmentos.

Um segmento do X-Ray engloba todos os pontos de dados de um único componente (por exemplo, um serviço de autorização) da aplicação distribuída. Os segmentos incluem dados definidos pelo sistema e pelo usuário na forma de anotações compostas de um ou mais subsegmentos que representam chamadas remotas feitas do serviço. Por exemplo, quando a aplicação cria uma chamada para um banco de dados em resposta a uma solicitação, ela cria um segmento para essa solicitação com um subsegmento que representa a chamada do banco de dados e o seu resultado. O subsegmento pode conter dados como a consulta, a tabela usada, o carimbo de data/hora e o status de erro.

Uma anotação do X-Ray são dados definidos pelo sistema ou pelo usuário associados a um segmento. Um segmento pode conter várias anotações. As anotações definidas pelo sistema incluem dados adicionados ao segmento pelos Serviços da AWS e as anotações definidas pelo usuário são metadados adicionados a um segmento por um desenvolvedor. Por exemplo, um segmento criado pela aplicação pode automaticamente ser injetado com dados regionais para chamadas de Serviço da AWS, por outro lado recomendamos que você mesmo adicione os dados da região para chamadas feitas para serviços que não são da AWS.

Os erros do X-Ray são anotações do sistema associadas a um segmento para uma chamada que resulta em uma resposta de erro. O erro inclui a mensagem de erro, o rastreamento da pilha e qualquer informação adicional (por exemplo, ID de versão ou confirmação) para associar o erro a um arquivo de origem.

Para disponibilizar uma experiência econômica e com bom desempenho, o X-Ray não coleta dados para toda solicitação enviada para uma aplicação. Em vez disso, ele coleta dados para um número estatisticamente significativo de solicitações. O X-Ray não deve ser usado como uma ferramenta de auditoria ou conformidade, pois ela não garante a integralidade dos dados.

O daemon do X-Ray coleta rastreamentos e os envia para o serviço do X-Ray para agregação, análise e armazenamento. O daemon facilita o envio de dados para o serviço do X-Ray, em vez de usar as APIs diretamente.

É possível começar a usar o X-Ray ao incluir o SDK de linguagem do X-Ray na aplicação e instalar o daemon do X-Ray. Para obter mais informações, consulte o guia do usuário do X-Ray.

O X-Ray pode ser usado com aplicações distribuídas de qualquer tamanho para rastrear e depurar solicitações síncronas e eventos assíncronos. Por exemplo, o X-Ray pode ser usado para rastrear solicitações web feitas para uma aplicação web ou eventos assíncronos que usam as filas do Amazon SQS.

É possível usar o X-Ray com aplicativos em execução no EC2, ECS, Lambda, Amazon SQS, Amazon SNS e Elastic Beanstalk. Além disso, o X-Ray SDK captura automaticamente os metadados das chamadas de API feitas para os serviços da AWS usando o AWS SDK. O X-Ray SDK também disponibiliza add-ons para drivers MySQL e PostgreSQL.

Se o Elastic Beanstalk estiver sendo usado, será necessário incluir as bibliotecas do X-Ray específicas da linguagem no código da aplicação. Para aplicações executadas em outros serviços da AWS, como o EC2 ou ECS, será necessário instalar o daemon do X-Ray e instrumentar o código da aplicação.

Sim. O X-Ray disponibiliza um conjunto de APIs para ingestão de dados de solicitação, consulta de rastreamentos e configuração de serviços. É possível usar a API do X-Ray para criar aplicações de análise e visualização além das que são disponibilizadas pelo X-Ray.

Sim. O X-Ray registra todas as chamadas de API como eventos de gerenciamento. Ele também registra chamadas em rastreamentos como eventos de dados, inclusive em PutTraceSegments e GetTimeSeriesServiceStatistics, entre outras APIs. Os eventos de dados não são registrados por padrão. Para registrar eventos de dados, você deve configurar sua trilha ou armazenamento de dados de eventos do CloudTrail para coletá-los.

Consulte Produtos e serviços regionais para obter detalhes.

Sim. É possível usar o X-Ray para rastrear solicitações percorrendo aplicações ou serviços entre várias regiões. Os dados do X-Ray são armazenados localmente na região processada mas com informações suficientes para permitir que aplicações cliente combinem os dados e disponibilizem uma visualização global dos rastreamentos. A anotação da região para os Serviços da AWS será adicionada automaticamente, no entanto, os clientes deverão instrumentar os serviços personalizados para adicionar a anotação regional para usar a compatibilidade entre regiões.

Geralmente, os dados de rastreamento enviados são disponibilizados para recuperação e filtragem dentro de 30 segundos após terem sido recebidos pelo serviço.

O X-Ray armazena dados de rastreamento dos últimos 30 dias. Isso permite consultar dados de rastreamento de até 30 dias atrás.

O X-Ray faz o possível para apresentar informações completas de rastreamento. No entanto, em algumas situações (como problemas de conectividade, atraso no recebimento de segmentos, etc.) é possível que informações de rastreamento disponibilizadas pelas APIs do X-Ray sejam parciais. Nessas situações, o X-Ray aponta os rastreamentos como incompletos ou parciais.

Sim. O daemon do X-Ray pode assumir um perfil para publicar dados em uma conta que não seja a conta em que ele está sendo executado. Isso permite publicar dados de vários componentes da aplicação em uma conta central.