/docs/tags/amqp/Recent content in AMQP on Документация Proto Observability PlatformHugo -- gohugo.ioru/docs/guides/message_queues/Mon, 01 Jan 0001 00:00:00 +0000/docs/guides/message_queues/ <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="#%d1%87%d1%82%d0%be-%d1%82%d0%b0%d0%ba%d0%be%d0%b5-mq-%d1%81%d0%b5%d1%80%d0%b2%d0%b8%d1%81">Что такое MQ-сервис</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="#%d1%81%d0%bf%d0%b8%d1%81%d0%be%d0%ba-%d0%be%d1%87%d0%b5%d1%80%d0%b5%d0%b4%d0%b5%d0%b9-%d1%81%d0%be%d0%be%d0%b1%d1%89%d0%b5%d0%bd%d0%b8%d0%b9">Список очередей сообщений</a></li> <li><a href="#%d0%b4%d0%b5%d1%82%d0%b0%d0%bb%d1%8c%d0%bd%d1%8b%d0%b9-%d0%b4%d0%b0%d1%88%d0%b1%d0%be%d1%80%d0%b4-mq-%d1%81%d0%b5%d1%80%d0%b2%d0%b8%d1%81%d0%b0">Детальный дашборд MQ-сервиса</a></li> <li><a href="#%d0%b3%d1%80%d0%b0%d1%84-%d0%b7%d0%b0%d0%b2%d0%b8%d1%81%d0%b8%d0%bc%d0%be%d1%81%d1%82%d0%b5%d0%b9-%d0%b8-%d0%bf%d0%b5%d1%80%d0%b5%d1%85%d0%be%d0%b4%d1%8b-%d0%b8%d0%b7-%d1%81%d0%bf%d0%b0%d0%bd%d0%b0">Граф зависимостей и переходы из спана</a></li> <li><a href="#%d1%81%d0%be%d0%be%d1%82%d0%bd%d0%be%d1%88%d0%b5%d0%bd%d0%b8%d0%b5-%d1%81-%d0%b8%d0%bd%d1%84%d1%80%d0%b0%d1%81%d1%82%d1%80%d1%83%d0%ba%d1%82%d1%83%d1%80%d0%bd%d1%8b%d0%bc-%d0%bc%d0%be%d0%bd%d0%b8%d1%82%d0%be%d1%80%d0%b8%d0%bd%d0%b3%d0%be%d0%bc-mq">Соотношение с инфраструктурным мониторингом MQ</a></li> <li><a href="#%d0%be%d0%b3%d1%80%d0%b0%d0%bd%d0%b8%d1%87%d0%b5%d0%bd%d0%b8%d1%8f">Ограничения</a></li> </ul> <h2 id="введение">Введение</h2> <p><strong>Очереди сообщений</strong> — раздел модуля APM платформы Proto Observability, в котором очереди и топики систем обмена сообщениями (Kafka, JMS, AMQP, RabbitMQ и др.) представлены как самостоятельные сущности. Для каждой очереди доступен отдельный дашборд со статистикой операций, временем обработки, процентом ошибок и списком вызывающих и потребляющих сервисов.</p> <p>В отличие от инфраструктурного мониторинга брокера (см. <a href="../../instrumentation/infra/mq/">Мониторинг очередей сообщений в инфраструктуре</a>), этот раздел показывает очередь с точки зрения <strong>прикладной нагрузки</strong>: сколько и каких сообщений проходит через неё, как быстро они обрабатываются и какие сервисы являются продюсерами и консьюмерами.</p> <div class="alert alert-info" role="alert"> <h4 class="alert-heading">Версия</h4> Данный функционал доступен начиная с версии 200. </div> <hr> <h2 id="что-такое-mq-сервис">Что такое MQ-сервис</h2> <p>MQ-сервис — это уникальная очередь или топик, через который инструментированные сервисы платформы обмениваются сообщениями. Платформа автоматически обнаруживает MQ-сервисы по спанам с атрибутами <code>messaging.*</code>:</p> <ul> <li><code>messaging.system</code> — тип системы обмена сообщениями (<code>kafka</code>, <code>rabbitmq</code>, <code>jms</code>, <code>amqp</code> и т.п.);</li> <li><code>messaging.destination</code> / <code>messaging.destination.name</code> — имя очереди или топика;</li> <li><code>messaging.operation</code> — вид операции (<code>send</code>, <code>receive</code>, <code>process</code>);</li> <li><code>amqp.queue</code>, <code>amqp.routing_key</code>, <code>amqp.exchange</code> — атрибуты AMQP / RabbitMQ.</li> </ul> <p>Каждое уникальное место назначения становится отдельным MQ-сервисом. В графе зависимостей такие сервисы помечаются иконкой очереди. Полный список поддерживаемых атрибутов см. в <a href="../../instrumentation/tracing/tags_naming_convention/#%d1%81%d0%be%d0%be%d0%b1%d1%89%d0%b5%d0%bd%d0%b8%d1%8f">Соглашении об именовании тегов</a>.</p> <hr> <h2 id="как-открыть">Как открыть</h2> <p>Перейдите в раздел <strong>Приложения</strong> &gt; <strong>Очереди сообщений</strong> в основном меню навигации платформы.</p> <p>Также детальный дашборд MQ-сервиса можно открыть:</p> <ul> <li>из вкладки <strong>Связи</strong> любого инструментированного сервиса — кликнув на узел очереди в таблице или в графе;</li> <li>из контекстного меню узла очереди на графе сервисной топологии;</li> <li>из деталей спана — кликнув на значения <code>messaging.destination</code>, <code>messaging.destination.name</code> или <code>amqp.queue</code>.</li> </ul> <hr> <h2 id="список-очередей-сообщений">Список очередей сообщений</h2> <p>Страница списка показывает все обнаруженные в трейсах очереди и топики с агрегированными показателями.</p> <p><strong>Столбцы таблицы:</strong></p> <table> <thead> <tr> <th>Столбец</th> <th>Описание</th> </tr> </thead> <tbody> <tr> <td><strong>Имя очереди</strong> (<code>messaging.destination</code>)</td> <td>Имя очереди или топика</td> </tr> <tr> <td><strong>Система</strong> (<code>messaging.system</code>)</td> <td>Тип системы: Kafka, RabbitMQ, JMS, AMQP и т.п.</td> </tr> <tr> <td><strong>Вызовов в минуту</strong></td> <td>Среднее количество операций над очередью</td> </tr> <tr> <td><strong>Время обработки</strong></td> <td>Среднее время операции (<code>send</code> / <code>process</code>)</td> </tr> <tr> <td><strong>Процент ошибок</strong></td> <td>Доля операций, завершившихся ошибкой</td> </tr> <tr> <td><strong>Зависимых сервисов</strong></td> <td>Количество сервисов, работающих с этой очередью</td> </tr> </tbody> </table> <p><strong>Возможности:</strong></p> <ul> <li>Поиск по имени очереди;</li> <li>Фильтрация по типу системы (Kafka, RabbitMQ, JMS, AMQP);</li> <li>Сортировка по любому из столбцов;</li> <li>Настройка временного диапазона через стандартный таймпиккер платформы.</li> </ul> <p>Нажмите на строку, чтобы открыть детальный дашборд MQ-сервиса.</p> <hr> <h2 id="детальный-дашборд-mq-сервиса">Детальный дашборд MQ-сервиса</h2> <p>Детальный дашборд MQ-сервиса построен по общему шаблону дашбордов платформы и включает несколько секций. На вкладке <strong>Обзор</strong> доступны KPI и графики, на вкладке <strong>Связи</strong> — граф зависимостей, на вкладке <strong>Трейсы</strong> — Traces Explorer с предустановленным фильтром по очереди.</p> <p><img src="../../release-notes/images/200-queue-dashboard.png" alt="Дашборд очереди сообщений"></p> <p><strong>Заголовок (KPI)</strong></p> <p>В верхней части дашборда размещены ключевые показатели за выбранный период:</p> <ul> <li><strong>Вызовы</strong> — общее число операций над очередью;</li> <li><strong>95-й перцентиль</strong> времени обработки;</li> <li><strong>Процент ошибок</strong>.</li> </ul> <p>Под каждым показателем выводится сравнение с предыдущим аналогичным периодом.</p> <p><strong>Пропускная способность (Вызовы)</strong></p> <p>Линейный график количества операций во времени за выбранный диапазон. Позволяет выявить пики, провалы и аномальные всплески нагрузки.</p> <p><strong>Время исполнения (мс)</strong></p> <p>График времени операций с перцентилями <strong>P95</strong> и <strong>P99</strong>. Позволяет отличить общую деградацию от выбросов (long tail).</p> <p><strong>Ошибки (%)</strong></p> <p>График доли ошибочных операций во времени.</p> <p><strong>Длительность типов операций (мс)</strong></p> <p>Таблица с разбивкой по <code>messaging.operation</code> (<code>send</code>, <code>receive</code>, <code>process</code>) с количеством вызовов, средней длительностью и процентом ошибок для каждого типа. Помогает понять, на стороне продюсера или консьюмера возникает деградация.</p> <p><strong>Топ операций по ошибкам и кол-ву</strong></p> <p>Таблица операций (например, <code>kafka.consume</code>, <code>kafka.produce</code>, <code>amqp.publish</code>, <code>jms.send</code>), отсортированных по количеству вызовов и проценту ошибок. Для AMQP / RabbitMQ дополнительно отображается <code>routing_key</code>.</p> <p><strong>Вкладка «Трейсы»</strong></p> <p>Открывает Traces Explorer с предустановленным фильтром по выбранному MQ-сервису — для детального разбора отдельных сообщений и причин ошибок. В деталях спана в секции <strong>Очередь</strong> отображаются все <code>amqp.*</code> теги.</p> <hr> <h2 id="граф-зависимостей-и-переходы-из-спана">Граф зависимостей и переходы из спана</h2> <p>Очереди сообщений интегрированы с модулем анализа зависимостей платформы и <a href="../resource_service_model/">Ресурсно-сервисной моделью</a>:</p> <ol> <li>Откройте дашборд любого инструментированного сервиса, перейдите на вкладку <strong>Связи</strong> — очереди отображаются как отдельные узлы графа.</li> <li>На вкладке <strong>Обзор</strong> MQ-сервиса доступен <strong>граф направленных зависимостей</strong> между продюсерами, очередью и консьюмерами.</li> <li>В деталях любого спана с messaging-атрибутами клик на значениях <code>messaging.destination</code>, <code>messaging.destination.name</code> или <code>amqp.queue</code> открывает соответствующий дашборд MQ-сервиса.</li> <li>Аналогичный переход доступен из контекстного меню узла очереди на графе сервисной топологии.</li> </ol> <hr> <h2 id="соотношение-с-инфраструктурным-мониторингом-mq">Соотношение с инфраструктурным мониторингом MQ</h2> <p>Раздел <strong>Очереди сообщений</strong> APM и раздел <a href="../../instrumentation/infra/mq/">Мониторинг очередей сообщений в инфраструктуре</a> дополняют друг друга:</p> <table> <thead> <tr> <th>Аспект</th> <th>APM &gt; Очереди сообщений</th> <th>Мониторинг инфраструктуры MQ</th> </tr> </thead> <tbody> <tr> <td>Источник данных</td> <td>Трейсы инструментированных сервисов (<code>messaging.*</code>-спаны)</td> <td>JMX, Admin API, Prometheus-экспортеры брокера</td> </tr> <tr> <td>Что видно</td> <td>Сколько сообщений отправляют/обрабатывают сервисы, время обработки, процент ошибок, какие сервисы участвуют</td> <td>Метрики самого брокера: состояние нод, реплики, лаг консьюмер-групп, дисковое потребление</td> </tr> <tr> <td>Ключ агрегации</td> <td>Имя очереди / топика</td> <td>Хост брокера, топик, группа консьюмеров</td> </tr> <tr> <td>Когда использовать</td> <td>Разбор инцидентов в прикладной обработке сообщений</td> <td>Мониторинг здоровья брокера и кластера</td> </tr> </tbody> </table> <p>Для полной картины рекомендуется использовать оба раздела совместно.</p> <hr> <h2 id="ограничения">Ограничения</h2> <ul> <li>MQ-сервисы обнаруживаются только если инструментированные сервисы отправляют трейсы с messaging-спанами и проставленными атрибутами <code>messaging.system</code>, <code>messaging.destination</code> и <code>messaging.operation</code>.</li> <li>Внутренние метрики брокера (длина очереди, лаг, статистика реплик) в этом разделе недоступны — для них используйте <a href="../../instrumentation/infra/mq/">инфраструктурный мониторинг MQ</a>.</li> <li>JMS-спаны корректно определяют имя очереди начиная с версии 200 (атрибут <code>peer.hostname</code> устанавливается из имени очереди).</li> <li>Применяются права доступа RBAC: пользователь увидит только те очереди, которые задействованы в разрешённых ему сервисах.</li> </ul>