Перейти к основному содержимому

Перенаправление событий в веб-службу REST

Lenovo XClarity Orchestrator можно настроить для перенаправления определенных событий в веб-службу REST.

Перед началом работы

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

Об этой задаче

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

Общие фильтры перенаправления данных используются для определения области событий, которые требуется перенаправить, на основании кодов событий, классов событий, уровней серьезности событий, типов служб и ресурса, в котором было создано событие. Убедитесь, что фильтры событий и ресурсов, которые требуется использовать для этого средства перенаправления, уже созданы (см. раздел Создание фильтров перенаправления данных).

Приведенный ниже пример — это формат по умолчанию для данных, перенаправляемых в веб-службу REST. Слова между двойными квадратными скобками — это атрибуты, которые при перенаправлении данных заменяются фактическими значениями.
{\"msg\":\"[[EventMessage]]\",\"eventID\":\"[[EventID]]\",\"serialnum\":
\"[[EventSerialNumber]]\",\"senderUUID\":\"[[EventSenderUUID]]\",\"flags\":
\"[[EventFlags]]\",\"userid\":\"[[EventUserName]]\",\"localLogID\":
\"[[EventLocalLogID]]\",\"systemName\":\"[[DeviceFullPathName]]\",\"action\":
[[EventActionNumber]],\"failFRUNumbers\":\"[[EventFailFRUs]]\",\"severity\":
[[EventSeverityNumber]],\"sourceID\":\"[[EventSourceUUID]]\",
\"sourceLogSequence\":[[EventSourceLogSequenceNumber]],\"failFRUSNs\":
\"[[EventFailSerialNumbers]]\",\"failFRUUUIDs\":\"[[EventFailFRUUUIDs]]\",
\"eventClass\":[[EventClassNumber]],\"componentID\":\"[[EventComponentUUID]]\",
\"mtm\":\"[[EventMachineTypeModel]]\",\"msgID\":\"[[EventMessageID]]\",
"sequenceNumber\":\"[[EventSequenceID]]\",\"timeStamp\":\"[[EventTimeStamp]]\",
\"args\":[[EventMessageArguments]],\"service\":[[EventServiceNumber]],
\"commonEventID\":\"[[CommonEventID]]\",\"eventDate\":\"[[EventDate]]\"}"

Процедура

Чтобы перенаправить данные в веб-службу REST, выполните следующие действия.

  1. В строке меню XClarity Orchestrator нажмите Мониторинг (Значок «Мониторинг») > Перенаправление, а затем выберите Средства перенаправления данных на левой панели навигации, чтобы открыть карту Средства перенаправления данных.
  2. Нажмите значок Создать (Значок «Добавить»), чтобы открыть диалоговое окно Создать средство перенаправления данных.
  3. Укажите имя и описание (необязательно) средства перенаправления событий.
  4. Включите или отключите средство перенаправления с помощью переключателя Состояние.
  5. Выберите REST как тип средства перенаправления.
  6. Нажмите Конфигурация и укажите сведения, относящиеся к протоколу.
    • Введите имя хоста или IP-адрес сервера REST.
    • Введите порт, используемый для перенаправления событий. Значение по умолчанию — 80.
    • Введите путь к ресурсу, по которому средство перенаправления должно отправлять события (например, /rest/test).
    • Выберите метод REST. Может иметь одно из следующих значений.
      • PUT
      • POST
    • Выберите протокол, используемый для перенаправления событий. Может иметь одно из следующих значений.
      • HTTP
      • HTTPS
    • Введите тайм-аут запроса (в секундах). Значение по умолчанию — 30 секунд.
    • Если требуется аутентификация, выберите один из следующих типов аутентификации.
      • Базовая. Аутентификация на указанном сервере с использованием заданного идентификатора пользователя и пароля.
      • Маркер. Аутентификация на указанном сервере с использованием заданного имени заголовка и значения маркера.
  7. Нажмите Фильтры и при необходимости выберите фильтры, которые требуется использовать для этого средства перенаправления.

    Можно выбрать не более одного фильтра событий и одного фильтра ресурсов.

    Если фильтр не выбран, данные перенаправляются для всех событий, создаваемых всеми ресурсами (устройствами, диспетчерами ресурсов и XClarity Orchestrator).

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

  8. Нажмите Списки управления доступом и выберите один или несколько списков управления доступом, которые требуется связать с этим средством перенаправления.

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

    Совет
    Пользователи, входящие в группу, которой назначена предопределенная роль Супервизор, при необходимости могут выбрать Сопоставить все вместо выбора списков управления доступом, чтобы перенаправляемые данные не ограничивались.
  9. Нажмите кнопку Создать, чтобы создать средство перенаправления.

После завершения

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

  • Включить или отключить выбранное средство перенаправления, установив переключатель в соответствующее положение в столбце Состояние.
  • Изменить выбранное средство перенаправления, щелкнув значок Изменить (Значок «Изменить»).
  • Удалить выбранное средство перенаправления, щелкнув значок Удалить (Значок «Удалить»).