Настройка межсредового отслеживания

Настройка межсредового отслеживания

В сценариях с несколькими средами пулы данных разделены. Если запрос затрагивает сервисы, отслеживаемые в разных средах Ключ-АСТРОМ, его распределенные трассировки не сопоставляются автоматически.

Для сопоставления и отслеживания таких распределенных трассировок можно настроить соединение между средами Ключ-АСТРОМ и включить заголовок ответа и переключатели скоординированной выборки. В этом случае поток обслуживания представляет собой соединение между подключенными средами, распределенные трассировки связываются с подключенной удаленной средой, и вы можете получить доступ к возможностям анализа ИИ.

Конфигурация

Прежде чем начать

Ограничения

Межсредовое отслеживание ограничивается распределенными трассировками запросов, которые могут передавать информацию о заголовках ответа и контекст трассировки из принимающей среды, например, HTTP-запросов или синхронных запросов.

IBM z/OS (CICS, IMS и Java) и AWS Lambda не поддерживают распределенные трассировки между средами.

Предварительные требования

Убедитесь, что между кластерами можно установить прямое сетевое соединение по протоколу HTTP.

Эквиваленты API

Описанные ниже процедуры выполняются с использованием веб-интерфейса Ключ-АСТРОМ. Для выполнения аналогичных задач через API см.:

• API токенов — для создания токена в удаленной среде.
• API для удаленных сред — для создания ссылки на удаленную среду из локальной среды.

Шаги

1. Создайте токен доступа

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

Для создания токена доступа в удалённой среде Ключ-АСТРОМ:

1. Войдите в удаленную среду.
   • Это среда, из которой вы извлекаете данные.
   • Если у вас не получается войти в удаленную среду, эту процедуру может выполнить за вас кто-то, имеющий к ней доступ.
2. Перейдите в раздел Токены доступа.
3. Выберите Сгенерировать новый токен.
4. Введите имя токена.
5. Найдите и выберите следующие области видимости:
   • Найдите отдельную распределенную трассировку (traces.lookup)
   • Получение данных из удаленной среды (RestRequestForwarding)
6. Выберите Сгенерировать токен.
   • Это сгенерирует токен, который предоставит вашей локальной среде разрешение проверять наличие распределенной трассировки в удаленной среде и получать данные из удаленной среды.
7. Выберите Копировать, а затем вставьте токен в безопасное место.
   • Это длинная строка, которую вам нужно будет скопировать и вставить обратно в Ключ-АСТРОМ позже.

2. Добавьте удаленную среду

Чтобы добавить удаленную среду Ключ-АСТРОМ в список доступных удаленных сред:

1. Войдите в свою локальную среду Ключ-АСТРОМ.
2. Перейдите в Настройки.
3. Выберите Интеграция > Удаленные среды.
4. Выберите Среда подключения.
5. Укажите удалённую среду, из которой ваша локальная среда будет получать данные, а затем выберите Сохранить изменения.
   • Имя — это имя, под которым удалённая среда будет отображаться в вашей текущей среде Ключ-АСТРОМ. Это произвольный текст. Он не влияет на удалённую среду.
   • Удалённая среда URI
     • Для SaaS-решения формат должен быть следующим: https://<ENVIRONMENTID>.live.astromkey.com/
     • Замените <ENVIRONMENTID> на фактический идентификатор вашей среды.
     • Для управляемых сред допускается использование любого URI.
     • Для подключения среды Ключ-АСТРОМ (развертывание SaaS) к управляемому развертыванию Ключ-АСТРОМ через URI, находящийся за пределами домена astromkey-managed.com, свяжитесь со специалистом по продуктам Ключ-АСТРОМ через онлайн-чат в вашей среде Ключ-АСТРОМ.
   • Область действия сети
     • External — Удалённая среда находится в другой сети. При наличии используются глобально настроенные параметры прокси-сервера. Это область действия по умолчанию.
     • Internal — Удалённая среда находится в той же сети. Глобально настроенные параметры прокси-сервера не используются.
     • Cluster — Удалённая среда находится в том же кластере. Запрос отправлен на localhost.
     • Ключ-АСТРОМ SaaS может использовать только External сетевую область действия.
   • Токен — это токен, сгенерированный вами в предыдущей процедуре. Он должен включать в себя параметр Найти одну область распределенной трассировки (traces.lookup).
   • Проверка соединения проверяет связь между вашей текущей средой и удаленной средой. Перед продолжением обязательно получите сообщение connection successfully established.

3. Включите эти функции

Включите следующие функции в каждой среде группы, которую вы хотите подключить:

Скоординированная выборка Вы можете повысить согласованность распределенных трассировок в разных средах с помощью скоординированной выборки. При включении этого параметра выборка координируется в разных средах с помощью идентификатора трассировки W3C.

1. Перейдите в Настройки > Предпочтения > Функции OneAgent.
2. Настройте распространение контекста трассировки W3C в соответствии со своими предпочтениями. Вы можете отправлять HTTP-заголовки контекста трассировки W3C или заголовки gRPC.
3. Найдите и включите функцию Отслеживание перемещений между различными средами — скоординированный отбор проб.

Заголовки ответа Вы можете включить идентификацию и отслеживание вызовов между средами, включая идентификатор среды и идентификатор трассировки в заголовках HTTP-ответа. Если среда, принимающая ответ, настроена как доверенная удаленная среда, то устанавливается связь с местом назначения вызова.

1. Перейдите в Настройки и выберите Предпочтения > Функции OneAgent.
2. Найдите и включите Трассировку между средами — идентификаторы среды и транзакций в заголовках HTTP-ответа.

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

Поиск неисправностей

Сообщение Verification failed, please check your settings: Constraints violated. отображается при добавлении удаленной среды.

Анализ взаимосвязанных удаленных сред

После настройки связи между средами становятся доступны следующие параметры анализа.

Обзор услуг

Ключ-АСТРОМ обнаруживает запросы к подключенным средам Ключ-АСТРОМ и использует доступную информацию для создания соответствующего веб-сервиса удаленной среды или веб-сервиса запросов.

Исходящие вызовы в подключенные среды отображаются в Smartscape и Service flow.

Все службы, отслеживаемые удаленной средой и участвующие в обработке запроса, перечислены на странице Удаленные среды. Чтобы открыть ее, выберите Открыть среду на странице службы удаленной среды.

Поток обслуживания

Service Flow распознает вызовы из удаленных сред. Поскольку запросы отслеживаются другой средой Ключ-АСТРОМ, при выборе вызова из удаленной среды доступна специальная опция детализации. В боковой панели выберите Открыть среду, чтобы перейти на страницу Удаленные среды.

Распределенные трассировки

Когда запрос поступает в подключенную удаленную среду, Ключ-АСТРОМ отображает имя удаленной среды в дереве вызовов.

Чтобы отследить распределенную трассировку в удаленной среде:

1. Выберите запрос на удаленную среду.
2. На вкладке Сводка выберите Открыть среду.

Если соединение между средами настроено правильно, Ключ-АСТРОМ автоматически отображает вызов «Агрегированные запросы». Он агрегирует все данные обнаруженных запросов в каждой соответствующей подключенной удаленной среде.

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

ИИ

После того как Ключ-АСТРОМ создаст службу удаленной среды, проблемы и события будут соотнесены с соответствующей службой удаленной среды.

Возможности ИИ позволяют понять, какие запросы завершаются с ошибкой, и выявить первопричину проблем в удаленной среде.