Настройка трассировок

Приём трейсов из сторонних источников

По умолчанию агент Астра Мониторинг выполняет роль конечной точки для приёма трейсов от различных источников. Это позволяет централизованно собирать данные трассировок и автоматически направлять их в backend системы для дальнейшей обработки и анализа.

Вы можете использовать сторонние экспортеры или SDK-инструментализацию, направляя их данные напрямую в агент. Это позволяет гибко организовать сбор трейсов из различных сервисов и приложений.

Агент поддерживает приём данных по протоколу HTTP, используя для этого следующий порт:

  • 9702 — приём трассировок по HTTP;

Таким образом, при настройке источника данных необходимо указывать конечную точку агента в зависимости от используемого протокола:

  • для HTTP: 127.0.0.1:9702; В отдельных случая требуется указания протокола и(или) полного пути. Например:

  • «http://127.0.0.1:9702/api/v1/write/traces»

По завершению конфигурации верефецируйте полученые корректный сбор трасиоровк в пользовательском интерфейсе системы.

Автоматический сбор трейсов

Агент АМ имеет собственный экспортер трейсов, который поддерживает автоматический сбор трейсов, что позволяет получать трассировки приложений без необходимости внесения изменений в исходный код.

Экспортер АМ работает на основе технологии eBPF. Данный экспортер отслеживает системные вызовы и события в ядре операционной системы, собирая данные о выполнении приложений в реальном времени. Использование eBPF-экспортера позволяет:

  • Собирать трейсы без ручной инструментализации кода;

  • Отслеживать активные процессы без их перезапуска;

  • Получать полную информацию о взаимодействиях между сервисами и задержках в вызовах;

  • Минимизировать влияние на производительность приложений, так как сбор данных происходит на уровне ядра.

Таким образом, автоматический сбор трейсов через eBPF обеспечивает простую и эффективную интеграцию мониторинга в существующую инфраструктуру, позволяя получать детальные данные о работе приложений сразу после установки агента.

Активация работы встроенного eBPF-экспортера осуществляется через файл конфигурации config.yaml Активация экспортера осуществляетcя путём добавления параметров, указанных ниже:

trace:
  enabled: true

После чего необходимо пeрезапустить агент.

По завершению конфигурации верефецируйте полученые корректный сбор трасиоровк в пользовательском интерфейсе системы.

Визуализация трассировок в пользовательском интрфейсе.

Чтобы просмотреть трассировки:

  1. Перейдите в раздел «Трассировки».

  2. При необходимости задайте параметры фильтров для уточнения выборки трейсов (например, сервис, хост, пользовательский тег).

  3. Укажите временной диапазон, используя таймпикер.

  4. При необходимости укажите частоту обновления (доступно частота обноления от 5 секунд)

После выполнения этих действий ниже отобразится список трейсов, доступных для просмотра и анализа. Вы сможете:

  • Разворачивать спаны внутри трейсов;

  • Сравнивать длительность операций;

  • Отслеживать цепочки вызовов между сервисами.

Описание параметров конфигурации агента

  1. Запуск eBPF экспортера трейсов. Запускается при выборе значения true.  При установке параметра false агент сохраняет функцию приёма трассировок otlp. Данный параметр отвечает только за запуск встроенного экспортера трейсво

trace:  
  enabled: true

  1. Интервал обновления информации об экспортере eBPF. Минимальное значение параметра 100ms По умолчанию установлен параметр на 20000ms

trace:  
  update_info_interval: "100ms"

  1. Настройка кастомного пути для конфигурационного файла экспортера.

trace:  
  save_config_path: ""