Вопросы и ответы по AWS X-Ray

Маршрут в X-Ray – это набор точек данных с общим ID маршрута. К примеру, когда клиент создает запрос к приложению, этому запросу назначается уникальный ID маршрута. Запрос начинает перемещаться между сервисами приложения, и сервисы передают информацию об этом запросе в X-Ray с помощью этого уникального ID маршрута. Каждый элемент данных, передаваемый сервисом приложения в X-Ray – это сегмент, а маршрут – это набор таких сегментов.

Сегмент X-Ray содержит все точки данных одного компонента распределенного приложения (например, сервиса авторизации). Сегменты включают в себя определенные системой и пользователем данные в виде аннотаций и состоят из одного или более подсегментов – удаленных вызовов, выполненных сервисом. Например, когда приложение в ответ на запрос выполняет вызов базы данных, для этого запроса создается сегмент, подсегменты которого описывают выполненный вызов базы данных и полученный ответ. Подсегмент может содержать такие данные, как запросы, использованные таблицы, отметки времени и статусы ошибок.

Аннотация в X-Ray – это определенные системой или пользователем данные, связанные с сегментом. Сегмент может содержать несколько аннотаций. Определенные системой аннотации включают данные, добавляемые в сегмент сервисами AWS, а определенные пользователем аннотации – это метаданные, добавляемые в сегмент разработчиком. Например, данные о регионе для вызовов сервисов AWS могут быть добавлены в созданный приложением сегмент автоматически, а данные о регионе для вызовов сервисов, не принадлежащих AWS, нужно добавлять самостоятельно.

Ошибки в X-Ray – это системные аннотации, привязанные к сегментам, в которых вызов вернул сообщение об ошибке. Ошибка включает в себя сообщение об ошибке, маршрут стека и любую дополнительную информацию (например, версию или ID подтверждения записи), которая поможет сопоставить ошибку с исходным файлом.

Для оптимизации производительности и стоимости сервис X-Ray не собирает данные по каждому запросу, отправленному в приложение. Вместо этого сервис собирает данные по статистически значимому количеству запросов. Сервис X-Ray не следует использовать как инструмент для аудита и проверки соответствия требованиям, так как он не гарантирует полноту данных.

Демон X-Ray собирает сведения о маршрутах и отправляет их в сервис X-Ray для последующего объединения, анализа и хранения. Демон позволяет упростить вашу работу: вы отправляете данные в сервис X-Ray вместо использования API напрямую.

Чтобы начать работу с X-Ray, подключите языковой пакет SDK X-Ray к приложению и установите демон X-Ray. Подробнее см. в Руководстве пользователя X-Ray.

X-Ray можно использовать для отслеживания и отладки синхронных запросов и асинхронных событий в распределенных приложениях любого размера. Например, с помощью X-Ray можно отслеживать сетевые запросы к интернет-приложению или асинхронные события, использующие очереди Amazon SQS.

X-Ray можно использовать с приложениями, работающими на EC2, ECS, в Lambda, Amazon SQS, Amazon SNS и Elastic Beanstalk. Кроме того, SDK X-Ray автоматически отслеживает метаданные API-запросов к сервисам AWS, выполненных с помощью SDK AWS. В SDK X-Ray входят дополнения для драйверов MySQL и PostgreSQL.

При использовании Elastic Beanstalk следует включить в код приложения соответствующие языковые библиотеки X-Ray. Для приложений, работающих в других сервисах AWS, таких как EC2 и ECS, необходимо установить демон X-Ray и обработать код приложения.

Да, у сервиса X-Ray есть набор API для обработки данных о запросах, сбора маршрутов и настройки сервиса. С помощью API X-Ray можно дополнительно разработать собственные приложения для анализа и визуализации.

Да. X-Ray регистрирует все вызовы API как события управления. Сервис также регистрирует вызовы трассировок как события данных, в том числе в PutTraceSegments и GetTimeSeriesServiceStatistics и других API. По умолчанию данные о событиях не регистрируются. Чтобы их зарегистрировать, необходимо настроить отслеживание событий CloudTrail или хранилище данных о событиях для их сбора.

Подробнее см. на странице «Продукты и сервисы по регионам».

Да, X-Ray позволяет следить за запросами в адрес приложений и сервисов, распределенных на несколько регионов. Данные X-Ray хранятся в регионах обработки, но при этом информации достаточно для того, чтобы объединить данные и сформировать общую карту маршрутов. Региональные аннотации для сервисов AWS создаются автоматически. При этом собственные сервисы клиента должны самостоятельно добавлять региональные аннотации для поддержания работы в нескольких регионах.

Данные о маршрутах, отправляемые X-Ray, обычно становятся доступны для загрузки и фильтрации в течение 30 секунд с момента их получения сервисом.

X-Ray хранит данные о маршрутах за последние 30 дней. Таким образом, данные отслеживаний доступны для загрузки в течение 30 дней.

X-Ray всегда старается предоставить полную информацию о маршрутах. При этом в некоторых ситуациях (ошибки соединения, задержки при получении сегментов и т. д.) данные, предоставляемые через API X-Ray, будут неполными. В таких случаях X-Ray отмечает маршруты как частичные или неполные.

Да. Демон X-Ray может взять на себя роль, разрешающую публикацию данных в аккаунте, отличном от того, в котором он запущен. Это позволяет публиковать данные с разных компонентов приложения на центральный аккаунт.