mshegolev/jaeger-mcp

Сравнивает две трассы структурно — находит добавленные, удалённые и изменённые спаны. Получает обе трассы из Jaeger и выполняет структурное сравнение, сопоставляя спаны по (operationName, serviceName, parentOperation), а не по идентификаторам спанов, которые различаются в разных трассах. Сообщает разницу в длительности и различия в тегах для изменённых спанов. Примеры: - Используйте когда: «Что изменилось между быстрым и медленным запросом?» → передайте идентификаторы трасс обоих запросов; проверьте changed_spans на разницу в длительности. - Используйте когда: «Добавил ли деплой новые вызовы сервисов?» → сравните трассу до деплоя с трассой после деплоя; проверьте added_spans на наличие новых операций. - Используйте когда: «Эти две трассы структурно идентичны?» → если added_spans, removed_spans и changed_spans пусты, трассы имеют одинаковую структуру. - Не используйте когда: Вам нужны агрегированные статистики по множеству трасс (используйте jaeger_span_statistics, как только он станет доступен). - Не используйте когда: У вас только одна трасса — используйте jaeger_get_trace для просмотра одной трассы. Возвращает: словарь с trace_id_a / trace_id_b / added_spans / removed_spans / changed_spans (с разницей в длительности и тегах) / unchanged_count.

Сравнивает агрегированное поведение трасс между двумя временными периодами для сервиса. Выбирает трассы из обоих временных окон, агрегирует статистику спанов по операциям, затем сравнивает агрегированное поведение для обнаружения изменений производительности. Примеры: - Используйте когда: «Повлияло ли последнее развёртывание на производительность?» → сравните временные окна до и после развёртывания для сервиса. - Используйте когда: «Какие операции замедлились после обновления базы данных?» → проверьте столбцы comparison_p95_us и p95_delta_pct на увеличения. - Используйте когда: «Появляются ли новые шаблоны ошибок?» → ищите операции с увеличенным error_rate_delta. - Используйте когда: «Добавили или удалили ли мы какие-либо конечные точки API?» → проверьте added_count и removed_count в сводке. - Не используйте когда: нужно сравнить две конкретные трассы (вместо этого используйте jaeger_compare_traces). - Не используйте когда: нужна полная детализация спанов для одной трассы (вместо этого используйте jaeger_get_trace). Возвращает: WindowComparisonOutput с различиями по операциям и сводной статистикой.

Определяет критический путь и основные узкие места в трейсе. Находит самую длинную цепочку спанов (критический путь) от корня до листа и ранжирует спаны по собственному времени, чтобы выявить реальные узкие места производительности. Примеры: - Используйте, когда: «Почему этот трейс такой медленный?» → вызовите с ID медленного трейса; посмотрите на critical_path_duration_us и critical_path_percentage, чтобы узнать, сколько общего времени приходится на самый длинный путь. - Используйте, когда: «Какие операции потребляют больше всего CPU/собственного времени?» → проверьте список узких мест, отсортированный по self_time_us по убыванию. - Используйте, когда: Отладка регрессий производительности — сравнивайте доли критического пути до и после изменений. - Не используйте, когда: Нужна агрегированная статистика по множеству трейсов (для этого используйте jaeger_span_statistics). - Не используйте, когда: Нужно сравнить два трейса структурно (для этого используйте jaeger_compare_traces). Возвращает: словарь с метаданными трейса, спанами критического пути и рейтингом узких мест.

Обнаруживает аномалии задержек и частоты ошибок для сервиса, сравнивая недавнее поведение с историческим базовым уровнем. Извлекает трассы из исторического базового окна и недавнего окна наблюдения, вычисляет статистику по каждой операции для обоих окон, а затем выявляет статистически значимые отклонения, которые могут указывать на проблемы с производительностью или надёжностью. Примеры: - Используйте, когда: «Есть ли новые проблемы с производительностью в order-service?» → service='order-service' (использует базовый период по умолчанию 60 минут, текущий – 5 минут). - Используйте, когда: «Нужна большая чувствительность к незначительным изменениям» → установите sensitivity=1.5 (более низкий порог). - Используйте, когда: «Проверить проблемы за последние 24 часа относительно предыдущей недели» → baseline_duration_minutes=10080, current_duration_minutes=1440. - Не используйте, когда: нужно сравнить два конкретных временных периода (вместо этого используйте jaeger_compare_windows). - Не используйте, когда: нужны полные детали спана для одного трейса (вместо этого используйте jaeger_get_trace). Возвращает: AnomalyDetectionOutput с отмеченными операциями и оценками серьёзности.

Находит трассы Jaeger, соответствующие указанному запросу по тегам. Принимает любую схему ключ-значение тегов (Allure, pytest, custom) без нормализации. Если служба не указана, выполняет поиск по всем известным службам одновременно (не более 20). Результаты сортируются от новых к старым.

Прогнозирует будущие требования к пропускной способности и ресурсам для сервиса. Предоставляет прогнозы на ближайшие 7-30 дней с доверительными интервалами для принятия решений по масштабированию инфраструктуры. Args: service: Название сервиса, для которого нужно спрогнозировать ёмкость days_ahead: Количество дней для прогноза (по умолчанию: 30 дней) Returns: ForecastResult с прогнозами пропускной способности и требованиями к ресурсам

Получает граф вызовов между сервисами из Jaeger. Оборачивает GET /api/dependencies. Возвращает направленные рёбра (родитель → потомок) с call_count — количество спанов, где родитель вызвал потомка за окно просмотра. Используйте это, чтобы понять топологию сервисов, найти сервисы с большим количеством исходящих вызовов (high fan-out) или проверить, что новый сервис подключён как ожидается. Примеры: - Используйте, когда: «Какие сервисы вызывает order-service?» → проверьте рёбра, где parent='order-service'. - Используйте, когда: «Построить полный граф зависимостей сервисов за последние 7 дней» → lookback_hours=168. - Используйте, когда: «Какие сервисы вызываются чаще всего?» → отсортируйте рёбра по call_count по убыванию. - Не используйте, когда: нужны детальные тайминги спанов (вместо этого используйте jaeger_search_traces + jaeger_get_trace). - Не используйте, когда: нужны данные в реальном времени — граф зависимостей Jaeger агрегирован и может отставать на несколько минут. Возвращает: dict с полями end_ts_us / lookback_hours / edge_count / edges (список {parent, child, call_count}).

Получает полную детализацию трассировки со всеми спанами, разбивкой по сервисам и деревом выполнения. Обёртка для GET /api/traces/{traceID}. Возвращает каждый спан в трассировке, статистику по каждому сервису и плоское дерево выполнения (каждый узел содержит идентификаторы дочерних спанов), которое обобщает иерархию вызовов. Спаны с ошибками определяются по tags["error"] = "true". Примеры: - Используй когда: «Почему трассировка abc123... тормозит — покажи разбивку по спанам» → trace_id='abc123...'; проверяй services на самый медленный сервис и execution_tree для иерархии вызовов. - Используй когда: «Какой сервис вызвал ошибку в трассировке xyz...?» → проверь spans, где is_error=true. - Используй когда: Вы нашли медленную или ошибочную трассировку в jaeger_search_traces и нужна полная детализация. - Не используй когда: У вас нет конкретного traceID — сначала примените jaeger_search_traces, чтобы его найти. - Не используй когда: Нужны только агрегированные данные по многим трассировкам (вместо этого используйте jaeger_search_traces с фильтрами). Возвращает: словарь с trace_id / span_count / service_count / root_operation / root_service / start_time_us / total_duration_us / errors_count / services (статистика по сервисам) / spans (все спаны) / execution_tree.

Выводит все имена операций, которые Jaeger видел для заданного сервиса. Оборачивает GET /api/services/{service}/operations. Полезен для поиска имён операций, которые нужно передавать в качестве фильтров в jaeger_search_traces. Вывод ограничен 500 операциями. Примеры: - Используйте, когда: «Какие HTTP-эндпоинты order-service отслеживает в трейсинге?» → service='order-service'. - Используйте, когда: нужно найти конкретную медленную операцию, но точное имя неизвестно — сначала выведите список операций, затем передайте его в jaeger_search_traces. - Используйте, когда: аудит того, какие gRPC-методы отслеживает сервис. - Не используйте, когда: нет конкретного сервиса — сначала вызовите jaeger_list_services. - Не используйте, когда: нужно сразу искать трейсы (пропустите этот шаг, если имя операции уже известно). Возвращает: dict с ключами service / operations_count / truncated / operations (отсортированы по алфавиту).

Перечисляет все сервисы, для которых Jaeger наблюдал трассы. Обёртка над GET /api/services. Jaeger возвращает все сервисы сразу, без пагинации. Результат ограничен 500 сервисами с подсказкой об усечении. Сначала используйте его для обнаружения существующих имён сервисов перед вызовом jaeger_list_operations или jaeger_search_traces. Примеры: - Используйте, когда: "Какие сервисы знает Jaeger?" → вызовите без параметров; прочитайте список services. - Используйте, когда: "Инструментирован ли payment-service?" → проверьте, появляется ли payment-service в списке сервисов. - Используйте, когда: начинаете сессию отладки, сначала перечислите сервисы, затем выберите один для jaeger_list_operations или jaeger_search_traces. - Не используйте, когда: вы уже знаете имя сервиса и хотите найти его трассы (вызовите jaeger_search_traces напрямую). - Не используйте, когда: вам нужен граф зависимостей между сервисами (вызовите jaeger_get_dependencies). Возвращает: dict с ключами services_count / truncated / services.

Прогнозирует потенциальные события ухудшения производительности для сервиса. Анализирует исторические паттерны данных трассировки, тенденции критических путей и результаты обнаружения аномалий, чтобы прогнозировать вероятные проблемы с производительностью за 2-24 часа вперед. Аргументы: service: Имя сервиса для анализа на предмет возможного ухудшения производительности hours_back: Количество часов исторических данных для анализа (по умолчанию: 168 часов/1 неделя) Возвращает: PredictionResult с прогнозом ухудшения, уровнем уверенности и рекомендациями

Сравнивает два временных окна Jaeger и классифицирует пооперационные регрессии.Извлекает трассы из базового и сравнительного окон, затем относит каждую операцию к категории регрессировавшей, восстановившейся, появившейся или удалённой. Результаты сортируются по оценке серьёзности (0–100) по убыванию для удобной приоритезации.

Ищет трейсы Jaeger с богатыми фильтрами. Обёртка над GET /api/traces. Возвращает список сводок по трейсам — используй jaeger_get_trace, чтобы углубиться в конкретный трейс и получить детали спанов. Параметр tags принимает JSON-строку, чтобы LLM могла строить произвольные фильтры по тегам. Длительности (min_duration/max_duration) передаются в Jaeger как есть (например '100ms', '1.5s'). Примеры: - Используй когда: «Покажи последние 500 ошибок в order-service» → service='order-service', tags='{"http.status_code":"500"}'. - Используй когда: «Найди медленные трейсы (>1с) для эндпоинта checkout» → service='checkout', operation='POST /checkout', min_duration='1s'. - Используй когда: «Выдай последние 5 трейсов за последний час» → limit=5, установи start = (сейчас - 3600с) в микросекундах. - Не используй когда: у тебя уже есть traceID и нужны полные детали (вызови jaeger_get_trace напрямую — одним круговым запросом меньше). - Не используй когда: нужна топология зависимостей сервисов (вызови jaeger_get_dependencies). Возвращает: dict с service / operation / returned / truncated / traces (список :class:TraceSummary).

Вычисляет процентили задержки и частоту ошибок для каждой операции по последним трейсам. Получает до limit трейсов для указанного сервиса (опционально отфильтрованных по операции), затем агрегирует все спаны по имени операции. Для каждой операции сообщает: количество спанов, p50/p95/p99 длительность в микросекундах, количество ошибок и частоту ошибок. Длительность указывается в микросекундах (целое число). Частота ошибок — error_count / span_count (число с плавающей точкой, 0.0–1.0). Примеры: - Используйте когда: «Какие p95 задержки для каждой конечной точки в order-service?» → service='order-service'; проверьте p95_duration_us для каждой операции. - Используйте когда: «Как часто ошибается конечная точка POST /checkout?» → service='checkout-svc', operation='POST /checkout'; посмотрите error_rate в статистике. - Используйте когда: «Сравнить распределение задержек между операциями» → посмотрите разброс p50 и p99, чтобы найти операции с высокой вариативностью. - Используйте когда: «Получить большую выборку для более точной статистики» → limit=100 для более достоверных процентилей. - Не используйте когда: нужно сравнить два конкретных трейса (вместо этого используйте jaeger_compare_traces). - Не используйте когда: нужны полные детали спанов для одного трейса (вместо этого используйте jaeger_get_trace). Возвращает: словарь с полями service / operation / trace_count / stats (список статистики по каждой операции: count, p50/p95/p99 duration_us, error_count, error_rate).

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