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

2026-07-24T01:16:41Z

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

Новая страница

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

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

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

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

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

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

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

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

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

=== Шаги ===

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

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

# Войдите в удаленную среду.
#* Это среда, из которой вы извлекаете данные.
#* Если у вас не получается войти в удаленную среду, эту процедуру может выполнить за вас кто-то, имеющий к ней доступ.
# Перейдите в раздел '''Токены доступа'''.
# Выберите '''Сгенерировать новый токен'''.
# Введите имя токена.
# Найдите и выберите следующие области видимости:
#* '''Найдите отдельную распределенную трассировку''' (<code>traces.lookup</code>)
#* '''Получение данных из удаленной среды''' (<code>RestRequestForwarding</code>)
# Выберите '''Сгенерировать токен'''.
#* Это сгенерирует токен, который предоставит вашей локальной среде разрешение проверять наличие распределенной трассировки в удаленной среде и получать данные из удаленной среды.
# Выберите '''Копировать''', а затем вставьте токен в безопасное место.
#* Это длинная строка, которую вам нужно будет скопировать и вставить обратно в Ключ-АСТРОМ позже.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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