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

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

Процедура

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

1. В строке меню XClarity Administrator нажмите Мониторинг > Перенаправление событий. Откроется страница Перенаправление событий.
2. Перейдите на вкладку Средство перенаправления событий.
3. Нажмите значок Создать (). Откроется вкладка Общие диалогового окна Создание средства перенаправления событий.
4. Выберите в качестве типа средства перенаправления событий вариант REST и укажите сведения, относящиеся к протоколу:

   • Введите путь к ресурсу, по которому средство перенаправления должно отправлять события (например, /rest/test).

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

     • HTTP

     • HTTPS

   • Выберите метод REST. Может иметь одно из следующих значений.

     • PUT

     • POST

   • Введите тайм-аут запроса (в секундах). Значение по умолчанию — 30 секунд.

   • Необязательно. Если требуется аутентификация, выберите один из следующих типов аутентификации.

     • Базовая. Аутентификация на указанном сервере с использованием заданного идентификатора пользователя и пароля.

     • Нет. Аутентификация не используется.

5. Нажмите Формат вывода, чтобы выбрать формат вывода отправляемых данных о событиях. Для каждого типа средства перенаправления событий информация различается.

   Приведенный ниже пример формата вывода — это формат по умолчанию для получателей веб-службы 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]]\"}"
   
   

   Можно нажать кнопку Восстановить значения по умолчанию, чтобы вернуться к полям по умолчанию для формата вывода.
6. Установите флажок Разрешить исключенные события, чтобы не пересылать исключенные события, или снимите флажок Разрешить исключенные события, чтобы пересылать исключенные события. Дополнительные сведения см. в разделе Исключение событий.
7. Выберите Включить это средство перенаправления, чтобы активировать перенаправление событий для данного средства перенаправления событий.
8. Нажмите Далее, чтобы перейти на вкладку Устройства.
9. Выберите устройства и группы, которые требуется отслеживать для данного средства перенаправления событий.
   Совет

   Для перенаправления событий для всех управляемых устройств (сейчас и в будущем) установите флажок Сопоставить все системы.

   Если флажок Сопоставить все системы не установлен, убедитесь, что у выбранных устройств нет DUMMY-UUID в столбце «UUID». DUMMY-UUID назначается для устройств, которые еще не восстановились после перезагрузки или полностью не обнаруживаются сервером управления. Если выбрано устройство с DUMMY-UUID, перенаправление событий для этого устройства осуществляется до момента полного обнаружения или восстановления, после чего DUMMY-UUID заменяется на фактический UUID.

10. Нажмите Далее, чтобы перейти на вкладку События.
11. Выберите фильтры, которые требуется использовать для данного средства перенаправления событий.
    • Сопоставить по категории событий
      1. Для перенаправления всех событий аудита независимо от уровня состояния выберите Включить все события аудита.
      2. Для перенаправления всех событий, связанных с гарантией, выберите Включить события, связанные с гарантией.
      3. Чтобы перенаправить все события изменения состояния работоспособности, выберите Включить события изменения состояния.
      4. Чтобы перенаправить все события обновления состояния работоспособности, выберите Включить события обновления состояния.
      5. Выберите классы и уровень ремонтопригодности для событий, которые требуется перенаправлять.
      6. Введите идентификаторы одного или нескольких событий, перенаправление которых требуется запретить. Идентификаторы разделяются запятой (например, FQXHMEM0214I,FQXHMEM0214I).
    • Сопоставлять по кодам событий. Введите идентификаторы одного или нескольких событий, которые требуется перенаправлять. В качестве разделителя для нескольких идентификаторов используется запятая.
    • Исключать по категориям событий.
      1. Чтобы исключить все события аудита независимо от уровня состояния, выберите Исключить все события аудита.
      2. Чтобы исключить все события, связанные с гарантией, выберите Исключить события, связанные с гарантией.
      3. Чтобы исключить все события изменения состояния работоспособности, выберите Исключить события изменения состояния.
      4. Чтобы исключить все события обновления состояния работоспособности, выберите Исключить события обновления состояния.
      5. Выберите классы и уровень ремонтопригодности для событий, которые требуется исключить.
      6. Введите идентификаторы одного или нескольких событий, которые требуется перенаправлять. Идентификаторы разделяются запятой.
    • Исключать по кодам событий. Введите идентификаторы одного или нескольких событий, которые требуется исключить. В качестве разделителя для нескольких идентификаторов используется запятая.
12. Выберите, нужно ли включать те или иные типы событий.
    • Включить все события аудита. Отправляет уведомления о событиях аудита по выбранным классам событий и их серьезности.
    • Включить события предупреждения. Отправляет уведомления о предупреждениях.
    • Включить события изменения состояния. Отправляет уведомления об изменениях в состоянии.
    • Включить события обновления состояния. Отправленные уведомления о новых оповещениях
    • Включить события бюллетеня. Отправляет уведомления о новых бюллетенях.
13. Выберите типы событий и уровни серьезности, о которых вас нужно уведомлять.
14. Выберите, следует ли фильтровать события по ремонтопригодности.
15. Нажмите Далее, чтобы перейти на вкладку Планировщик.
16. Необязательно: Укажите время и дни, когда требуется перенаправлять указанные события в данное средство перенаправления событий. Будут перенаправлены только события, соответствующие заданному периоду времени.

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

    1. Укажите день и время начала работы расписания с помощью значков Прокрутка влево () и Прокрутка вправо () и кнопок День, Неделя и Месяц.
    2. Дважды нажмите период времени, чтобы открыть диалоговое окно «Создать период времени».
    3. Укажите требуемую информацию, включая дату, время начала и окончания, необходимость в повторении расписания.
    4. Нажмите Создать, чтобы сохранить расписание и закрыть диалоговое окно. Новое расписание будет добавлено в календарь.

    Рекомендации.

    • Период времени можно изменить, перетащив запись расписания в другой период времени в календаре.
    • Продолжительность можно изменить, перетащив верхнюю или нижнюю границу записи расписания на новое время в календаре.
    • Время окончания можно изменить, перетащив нижнюю границу записи расписания в новое время в календаре.
    • Расписание можно изменить, дважды щелкнув запись расписания в календаре и нажав Изменить запись.
    • Сводные данные по всем записям расписания можно просмотреть, выбрав Показать сводку планировщика. В сводных данных указаны период времени для каждой записи и повторяемые записи.
    • Запись расписания можно удалить из календаря или сводки планировщика, выбрав запись и нажав Удалить запись.
17. Нажмите Создать.

    Средство перенаправления событий указывается в таблице «Перенаправление событий».

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