/docs/tags/traces-explorer/ Recent content in traces explorer on Документация Proto Observability Platform Hugo -- gohugo.io ru /docs/guides/traces_explorer/ Mon, 01 Jan 0001 00:00:00 +0000 /docs/guides/traces_explorer/ <p>На этой странице:</p> <ul> <li><a href="#%D0%B2%D0%B2%D0%B5%D0%B4%D0%B5%D0%BD%D0%B8%D0%B5">Введение</a></li> <li><a href="#%D0%BA%D0%B0%D0%BA-%D0%BE%D1%82%D0%BA%D1%80%D1%8B%D1%82%D1%8C">Как открыть</a></li> <li><a href="#%D0%BF%D0%BE%D0%B8%D1%81%D0%BA-%D0%B8-%D1%84%D0%B8%D0%BB%D1%8C%D1%82%D1%80%D0%B0%D1%86%D0%B8%D1%8F-%D1%82%D1%80%D0%B5%D0%B9%D1%81%D0%BE%D0%B2">Поиск и фильтрация трейсов</a></li> <li><a href="#%D0%B0%D0%BD%D0%B0%D0%BB%D0%B8%D0%B7-%D1%82%D1%80%D0%B5%D0%B9%D1%81%D0%B0">Анализ трейса</a></li> <li><a href="#%D1%82%D0%B8%D0%BF%D0%B8%D1%87%D0%BD%D1%8B%D0%B5-%D1%81%D1%86%D0%B5%D0%BD%D0%B0%D1%80%D0%B8%D0%B8-%D0%B8%D1%81%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D1%8F">Типичные сценарии использования</a></li> <li><a href="#%D1%81%D0%B2%D1%8F%D0%B7%D1%8C-%D1%81-%D0%B8%D0%BD%D1%81%D1%82%D1%80%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5%D0%BC">Связь с инструментированием</a></li> </ul> <h2 id="введение">Введение</h2> <p><strong>Traces Explorer</strong> — раздел платформы Proto Observability, предоставляющий интерфейс для поиска и анализа распределенных трейсов (traces). Traces Explorer реализован как преднастроенный дашборд (слой GENERAL, дашборд «Traces-Explorer»), который включает виджеты для поиска, фильтрации и визуализации трейсов.</p> <p>Распределенный трейс (trace) — это запись прохождения запроса через цепочку сервисов и компонентов. Каждый трейс состоит из набора спанов (spans), представляющих отдельные операции в рамках транзакции.</p> <div class="alert alert-info" role="alert"> <h4 class="alert-heading">Версия</h4> Данный функционал доступен начиная с версии 200. </div> <hr> <h2 id="как-открыть">Как открыть</h2> <p>Перейдите в раздел <strong>Трейсы</strong> в основном меню навигации платформы. Откроется страница Traces Explorer с преднастроенными виджетами для поиска и анализа трейсов.</p> <hr> <h2 id="поиск-и-фильтрация-трейсов">Поиск и фильтрация трейсов</h2> <p>Traces Explorer предоставляет возможности для поиска трейсов по различным критериям:</p> <ul> <li><strong>По сервису</strong> — выберите один или несколько сервисов для отображения их трейсов</li> <li><strong>По операции</strong> — фильтрация по имени операции (endpoint, метод)</li> <li><strong>По длительности</strong> — поиск трейсов, превышающих заданное время выполнения</li> <li><strong>По статусу</strong> — фильтрация по статусу выполнения (успешные, с ошибками)</li> <li><strong>По временному диапазону</strong> — выбор периода для анализа</li> </ul> <!-- TODO: screenshot --> <p>Результаты поиска отображаются в табличном виде с основными характеристиками каждого трейса: идентификатор, сервис, операция, длительность, статус, время начала.</p> <hr> <h2 id="анализ-трейса">Анализ трейса</h2> <p>При выборе конкретного трейса из результатов поиска открывается детальное представление, включающее:</p> <p><strong>Временная шкала (Timeline / Waterfall)</strong></p> <p>Диаграмма водопада отображает все спаны трейса на временной шкале. Каждый спан представлен горизонтальной полосой, длина которой пропорциональна его продолжительности. Вложенные спаны отображаются с отступом, показывая иерархию вызовов.</p> <!-- TODO: screenshot --> <p><strong>Детали спана</strong></p> <p>При выборе спана на временной шкале отображаются его детали:</p> <ul> <li><strong>Имя операции</strong> — название операции, которую выполняет спан</li> <li><strong>Сервис</strong> — сервис, в котором выполнялась операция</li> <li><strong>Длительность</strong> — время выполнения операции</li> <li><strong>Теги</strong> — атрибуты спана (HTTP метод, URL, статус код и другие)</li> <li><strong>Логи / События</strong> — записи событий, привязанные к спану</li> </ul> <hr> <h2 id="типичные-сценарии-использования">Типичные сценарии использования</h2> <p><strong>Анализ медленных запросов</strong></p> <ol> <li>Откройте Traces Explorer</li> <li>Установите фильтр по длительности, превышающей ожидаемое время</li> <li>Выберите трейс из результатов</li> <li>На временной шкале определите, какой спан (сервис/операция) занимает наибольшее время</li> </ol> <p><strong>Поиск ошибок в цепочке вызовов</strong></p> <ol> <li>Установите фильтр по статусу «ошибка»</li> <li>Откройте трейс с ошибкой</li> <li>На диаграмме водопада найдите спан с ошибкой (обычно выделен цветом)</li> <li>Просмотрите теги и логи спана для определения причины</li> </ol> <p><strong>Анализ зависимостей сервисов</strong></p> <ol> <li>Выберите интересующий сервис</li> <li>Просмотрите трейсы, проходящие через этот сервис</li> <li>На временной шкале определите, какие сервисы вызываются и в каком порядке</li> </ol> <hr> <h2 id="связь-с-инструментированием">Связь с инструментированием</h2> <p>Данные трейсов поступают в платформу из инструментированных приложений через агент платформы. Для того чтобы трейсы были доступны в Traces Explorer, приложения должны быть настроены на отправку данных распределенного трейсинга.</p> <p>Подробнее о настройке инструментирования приложений см. разделы:</p> <ul> <li><a href="../../instrumentation/java/">Инструментирование Java-приложений</a></li> <li><a href="../../instrumentation/dotnet/">Инструментирование .NET-приложений</a></li> <li><a href="../../instrumentation/nodejs/">Инструментирование Node.js-приложений</a></li> <li><a href="../../instrumentation/python/">Инструментирование Python-приложений</a></li> <li><a href="../../instrumentation/go/">Инструментирование Go-приложений</a></li> </ul>