Подключение ServiceNow к Соединителю управления ИТ-услугами

В этой статье показано, как настроить подключение между экземпляром ServiceNow и Соединителем управления ИТ-услугами (ITSM) в Log Analytics, чтобы можно было централизованно управлять рабочими элементами управления ИТ-услугами.

Примечание.

Начиная с сентября 2022 года мы начинаем 3-летний процесс отмены поддержки использования действий ITSM для отправки оповещений и событий в ServiceNow.

Необходимые компоненты

Необходимо выполнить следующие условия для подключения.

Установка соединителя ITSM

Сведения об установке соединителя ITSM см. в разделе Добавление решения Соединителя управления ИТ-услугами.

Примечание.

Соединитель ITSM поддерживает только официальное предложение SaaS (программное обеспечение как услуга) из ServiceNow. Закрытые развертывания ServiceNow не поддерживаются.

Настройка OAuth

Поддерживаемые версии ServiceNow включают Ванкувер, Юту, Токио, Сан-Диего, Рим, Квебек, Париж, Орландо, Нью-йорк, Мадрид, Лондон, Кингстон, Джакарта, Стамбул, Хельсинки и Женева.

Администраторы ServiceNow должны создать идентификатор клиента и секрет клиента для своего экземпляра ServiceNow. См. следующие сведения:

В рамках настройки OAuth выполните следующие действия:

  1. Создайте конечную точку для доступа клиентов к экземпляру.

  2. Обновите срок действия маркера обновления:

    1. В области ServiceNow найдите System OAuth и выберите Реестр приложений.
    2. Выберите имя определенного OAuth и измените Срок жизни маркера обновления на 7 776 000 с (90 дней).
    3. Выберите Обновить.
  3. Реализуйте внутреннюю процедуру, обеспечивающую постоянную активность подключения. За несколько дней до ожидаемого окончания срока действия маркера обновления выполните следующие операции:

    1. Завершите процесс синхронизации вручную для конфигурации соединителя ITSM.

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

      1. В области ServiceNow найдите System OAuth и выберите Управление маркерами.

      2. Выберите старый маркер в списке по имени OAuth и дате окончания срока действия.

        Screenshot that shows a list of tokens for OAuth.

      3. Выберите Отозвать доступ>Отозвать.

Установка пользовательского приложения и создание роли пользователя

Используйте следующую процедуру, чтобы установить пользовательское приложение ServiceNow и создать для него роль пользователя интеграции. Эти учетные данные потребуются для подключения к ServiceNow в Azure.

Примечание.

Соединитель ITSM поддерживает только официальное пользовательское приложение для интеграции с Microsoft Log Analytics, которое загружается из магазина ServiceNow. Соединитель ITSM не поддерживает прием кода на стороне ServiceNow или в любом приложении, которое не является частью официального решения ServiceNow.

  1. Посетите магазин ServiceNow и установите пользовательской приложение для интеграции Microsoft OMS и ServiceNow в экземпляр ServiceNow.

    Примечание.

    В рамках перехода с Microsoft Operations Management Suite (OMS) на Azure Monitor набор OMS теперь называется Log Analytics.

  2. После установки перейдите на левую панель навигации экземпляра ServiceNow, найдите и выберите интегратор Microsoft OMS.

  3. Щелкните Контрольный список установки.

    Если роль пользователя еще не создана, вы увидите состояние Не завершено.

  4. В текстовых полях рядом с разделом Создание пользователя для интеграции введите имя пользователя, который может подключиться к соединителю ITSM в Azure.

  5. Введите пароль для этого пользователя и нажмите кнопку ОК.

Отобразится созданный пользователь с назначенными по умолчанию ролями:

  • personalize_choices;
  • import_transformer;
  • x_mioms_microsoft.user;
  • itil
  • template_editor;
  • view_changer.

После успешного создания пользователя состояние контрольного списка проверки установки изменится на Завершено и будут выведены дополнительные сведения о созданной для приложения роли пользователя.

Примечание.

Соединитель ITSM может отправлять инциденты ServiceNow. Для этого на экземпляре ServiceNow не нужно устанавливать модули. Если в экземпляре ServiceNow используется модуль EventManagement и вы хотите создать события или предупреждения в ServiceNow с помощью соединителя, добавьте следующие роли для пользователя интеграции:

  • evt_mgmt_integration;
  • evt_mgmt_operator.

Создать подключение

Используйте следующую процедуру, чтобы создать подключение ServiceNow.

Примечание.

Оповещения, отправляемые из Azure Monitor, могут создавать один из следующих элементов в ServiceNow: события, инциденты или оповещения.

  1. На портале Azure перейдите к разделу Все ресурсы и найдите элемент ServiceDesk(имя_вашей_рабочей_области).

  2. В области Источники данных рабочей области щелкните Подключения ITSM.

    Screenshot that shows selection of a data source.

  3. Вверху справа щелкните Добавить.

  4. Введите необходимые сведения, как описано в следующей таблице, а затем нажмите кнопку ОК.

    Поле Description
    Имя подключения Введите имя экземпляра ServiceNow, который вы хотите подключить к соединителю ITSM. В Log Analytics это имя вам потребуется позже при настройке рабочих элементов в ITSM или подробном анализе журналов.
    Тип партнера Выберите ServiceNow.
    URL-адрес сервера Введите URL-адрес экземпляра ServiceNow, который вы хотите подключить к соединителю ITSM. URL-адрес должен указывать на поддерживаемую версию SaaS с суффиксом .servicenow.com (например, https://XXXXX.service-now.com/).
    Username Введите имя пользователя для интеграции, которое вы создали в приложении ServiceNow для подключения к соединителю ITSM.
    Пароль Введите пароль, связанный с именем пользователя. Примечание. Имя пользователя и пароль используются только для создания маркеров проверки подлинности. Они не хранятся в службе соединителя ITSM.
    Идентификатор клиента Введите созданный ранее идентификатор клиента, который вы хотите использовать для проверки подлинности OAuth2. Дополнительные сведения о создании идентификатора клиента и секрета см. в разделе Настройка OAuth.
    Секрет клиента Введите секрет клиента, созданный для этого идентификатора.
    Область синхронизации данных (в днях) Введите число прошедших дней, которые будут учитываться при синхронизации. Ограничение — 120 дней.
    Рабочие элементы для синхронизации Выберите рабочие элементы ServiceNow, которые вы хотите синхронизировать с Azure Log Analytics через соединитель ITSM. Выбранные значения импортируются в службу Log Analytics. Варианты — инциденты и запросы на изменения.
    Создать элемент конфигурации в продукте ITSM Выберите этот параметр, если вы хотите создать элементы конфигурации в продукте ITSM. Если этот параметр выбран, соединитель ITSM создает элементы конфигурации (если они отсутствуют) в поддерживаемой системе ITSM. По умолчанию он отключен.

Screenshot of boxes and options for adding a ServiceNow connection.

После успешного подключения и синхронизации:

  • Выбранные рабочие элементы из экземпляра ServiceNow будут импортированы в службу Log Analytics. Вы можете просмотреть сводку по этим рабочим элементам с помощью плитки Соединитель управления ИТ-услугами.

  • Вы можете создавать инциденты из оповещений поиска по журналам или записей журналов или из оповещений Azure в этом экземпляре ServiceNow.

Примечание.

Для ServiceNow предусмотрено ограничение скорости запросов в час. Чтобы настроить ограничение, определите ограничение скорости для REST API входящего трафика в экземпляре ServiceNow.

Структура полезных данных

Полезные данные, отправляемые в ServiceNow, имеют общую структуру. Структура содержит раздел, содержащий все данные оповещений <Description> .

Структура полезных данных для всех типов оповещений, кроме оповещений поиска по журналам версии 1, является общей схемой.

Для оповещений поиска по журналам (только версия 1) структура:

  • Оповещение (имя правила генерации оповещений) : <значение>
  • Поисковый запрос: <значение>
  • Время начала поиска (UTC) : <значение>
  • Время окончания поиска (UTC) : <значение>
  • AffectedConfigurationItems : [<список затронутых элементов> конфигурации]

Следующие шаги