Конфигурирование IBM Integration Bus для включения данных

Чтобы в компоненте консоль Cloud APM были доступны какие-либо данные, надо сконфигурировать IBM® Integration Bus для включения сбора нужных данных.

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

Убедитесь, что IBM Integration Bus сконфигурирован.

Напоминание: Чтобы включить отслеживание транзакции, нужно перезапустить узел интеграции (посредник).

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

Компонент IBM Integration Bus может отслеживать статистику архивов и статистику ресурсов только после включения сбора данных для узла интеграции (посредника). Точно так же, если вы хотите увидеть отслеживание транзакций в сводных панелях промежуточного программного обеспечения и топологии, вы должны включить отслеживание транзакций на узле интеграции (посреднике), прежде чем включать отслеживание транзакций для компонента IBM Integration Bus.

Решите, какой тип данных вы хотите отслеживать с помощью компонента IBM Integration Bus, и выполните следующие шаги в соответствии с вашими требованиями.

У серверов интеграции, которые принадлежат узлу интеграции, есть по умолчанию файл конфигурации server.conf.yaml для каждого сервера интеграции, который хранится в подкаталоге каталога узла интеграции. Все свойства, которые вы задаете для узла интеграции в файле node.conf.yaml, наследуются серверами интеграции, которыми он владеет. Тем не менее, можно изменить свойства сервера интеграции, модифицировав их в файле server.conf.yaml. (Дополнительную информацию смотрите в разделе Конфигурирование узла интеграции путем изменения файла node.conf.yaml в документации IBM App Connect Enterprise.)

Процедура

Чтобы узнать, как включить сбор статистических данных архивов для узла интеграции (посредника), смотрите раздел Как включить учет архивов и сбор статистических данных.
Чтобы узнать, как включить статистические данные ресурсов для узла интеграции (посредника), смотрите раздел Включение статистики ресурса JVM.
Чтобы узнать, как включить отслеживание транзакций для потоков сообщений на узле интеграции (посреднике), смотрите раздел Разрешение отслеживания транзакций.
Если вам больше не нужны данные отслеживания транзакций, не забудьте выключить отслеживание транзакций для узла интеграции (посредника), на котором оно включено. Смотрите раздел Запрещение трассировки транзакций.

Как включить учет архивов и сбор статистических данных

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

Чтобы включить учета архивов и сбор статистики для потоков сообщений, принадлежащих узлу интеграции (посреднику), введите команду mqsichangeflowstats из каталога bin, находящегося в каталоге установки узла интеграции (посредника).

Напоминание: Введите команду mqsichangeflowstats на узле интеграции (посреднике) в соответствии с вашими требованиями к мониторингу данных. Рекомендуется включать только ту статистику, которая вам нужна, так как если у вас много потоков сообщений, объем данных и обработки может быть большим. Более подробную информацию о команде mqsichangeflowstats смотрите в документации по IBM Integration Bus.

Важное замечание: IBM Cloud Application Performance Management не поддерживает данные учета и статистики снимков из-за большого объема данных и обработки, требуемых для заданного 20-секундного интервала снимков. Данные архивов предоставляют точно те же атрибуты, что и данные снимков, и лучше подходят для регулярного мониторинга в производственном режиме, обеспечиваемого IBM Cloud Application Performance Management. Если вы разрешили сбор данных снимков для узла интеграции (посредника), не забудьте указать в конфигурации IBM Integration Bus, что не надо не хранить никакие данные снимков. Инструкции смотрите в разделе Запрещение сбора данных снимков для агента.

Процедура

Чтобы получить большинство данных для потоков сообщений, введите указанную ниже команду. Эта команда рекомендуется, поскольку она не включает наиболее детализированную статистику терминала, которая позволяет получать число вызовов на терминал и на узел. Уровень терминала использует большой объем хранилища.
```
mqsichangeflowstats имя_посредника -a -g -j -c active -t none -n basic -o xml
```

В ACE версии 11 для получения большинства данных для потоков сообщений измените файл node.conf.yaml или server.conf.yaml следующим образом. Эти свойства рекомендуются, поскольку они не включают наиболее детализированную статистику терминала, которая позволяет получать число вызовов на терминал и на узел. Уровень терминала расходует большой объем хранения.

Статистика:
  # Потоки Сообщения приложения по умолчанию наследуют значения снимка и архива
  # задано здесь
  Снимок:
    #publicationOn: 'inactive' # выбрать 1 из : active|inactive, по умолчанию inactive
                               # Обеспечить Events.OperationalEvents.MQ|MQTT 
                               # настроено для outputFormat json,xml
    #accountingOrigin: 'none'  # выбрать 1 из : none|basic
    #nodeDataLevel: 'none'     # выбрать 1 из : none|basic|advanced
    #outputFormat: 'usertrace' # список разделенных запятой значений: 
                               #csv,bluemix,json,xml,usertrace
    #threadDataLevel: 'none'   # выбрать 1 из : none|basic
  Архив:
    archivalOn: 'active'    # выбрать 1 из : active|inactive,
                             # по умолчанию inactive
                               # Обеспечить Events.OperationalEvents.MQ|MQTT
                               # настроено для outputFormat xml
    #accountingOrigin: 'none'  # выбрать 1 из : none|basic
    #majorInterval: 60       # Задает интервал в минутах, в который 
                              # публикуется статистика архива
    nodeDataLevel: 'basic'     # выбрать 1 из : none|basic|advanced
    outputFormat: 'xml' # список разделенных запятой значений: csv,xml,usertrace
    #threadDataLevel: 'none'   # выбрать 1 из : none|basic

Прим.: Если вы хотите отключить этот параметр, закомментируйте строки archivalOn: 'active', nodeDataLevel: 'basic' и outputFormat: 'xml'.

Чтобы получить все данные, поддерживаемые компонентом IBM Integration Bus, введите следующую команду:
```
mqsichangeflowstats имя_посредника -a -g -j -c active -t none -n advanced -o xml
```

В ACE версии 11, для получения всех данных, поддерживаемых IBM Integration Bus, измените файл node.conf.yaml или server.conf.yaml следующим образом:

Статистика:
  # Потоки Сообщения приложения по умолчанию наследуют значения снимка и архива
  # задано здесь
  Снимок:
    #publicationOn: 'inactive' # выбрать 1 из : active|inactive, по умолчанию inactive
                               # Обеспечить Events.OperationalEvents.MQ|MQTT
                               # настроено для outputFormat json,xml
    #accountingOrigin: 'none'  # выбрать 1 из : none|basic
    #nodeDataLevel: 'none'     # выбрать 1 из : none|basic|advanced
    #outputFormat: 'usertrace' # список разделенных запятой значений:
                               # csv,bluemix,json,xml,usertrace
    #threadDataLevel: 'none'   # выбрать 1 из : none|basic
  Архив:
    archivalOn: 'active'    # выбрать 1 из : active|inactive, по умолчанию inactive
                               # Обеспечить Events.OperationalEvents.MQ|MQTT
                               # настроено для outputFormat xml
    #accountingOrigin: 'none'  # выбрать 1 из : none|basic
    #majorInterval: 60       # Задает интервал в минутах, в который
                             # публикуется статистика архива
    nodeDataLevel: 'advanced'     # выбрать 1 из : none|basic|advanced
    outputFormat: 'xml' # список разделенных запятой значений: csv,xml,usertrace
    #threadDataLevel: 'none'   # выбрать 1 из : none|basic

Прим.: Если вы хотите отключить этот параметр, закомментируйте строки archivalOn: 'active', nodeDataLevel: 'advanced' и outputFormat: 'xml'.

Чтобы сократить объем данных, но все же отслеживать на разумном уровне потоки сообщений без дополнительных подробностей, введите следующую команду:
```
mqsichangeflowstats имя_посредника -a -g -j -c active -t none -n none -o xml
```

В ACE версии 11, чтобы сократить объем данных, но все же обеспечить разумный мониторинг всех потоков сообщений без дальнейших подробностей, измените файл node.conf.yaml или server.conf.yaml следующим образом:

Статистика:
  # Потоки Сообщения приложения по умолчанию наследуют значения снимка и архива
  #задано здесь
  Снимок:
    #publicationOn: 'inactive' # выбрать 1 из : active|inactive, по умолчанию inactive
                               # Обеспечить Events.OperationalEvents.MQ|MQTT
                               # настроено для outputFormat json,xml
    #accountingOrigin: 'none'  # выбрать 1 из : none|basic
    #nodeDataLevel: 'none'     # выбрать 1 из : none|basic|advanced
    #outputFormat: 'usertrace' # список разделенных запятой значений:
                               # csv,bluemix,json,xml,usertrace
    #threadDataLevel: 'none'   # выбрать 1 из : none|basic
  Архив:
    archivalOn: 'active'    # выбрать 1 из : active|inactive, по умолчанию inactive
                               # Обеспечить Events.OperationalEvents.MQ|MQTT
                               # настроено для outputFormat xml
    #accountingOrigin: 'none'  # выбрать 1 из : none|basic  
    #majorInterval: 60       # Задает интервал в минутах, в который
                             # публикуется статистика архива
    nodeDataLevel: 'none'     # выбрать 1 из : none|basic|advanced
    outputFormat: 'xml' # список разделенных запятой значений: csv,xml,usertrace
    #threadDataLevel: 'none'   # выбрать 1 из : none|basic

Прим.: Если вы хотите отключить этот параметр, закомментируйте строки archivalOn: 'active', nodeDataLevel: 'none' и outputFormat: 'xml'.

Если у вас большое число потоков сообщений и вы хотите сократить объем данных, вы можете указать, какие потоки сообщений нужно отслеживать, заменив опцию -g или -j в ранее упомянутых командах.
- Чтобы указать конкретный сервер интеграции (группу выполнения) для включения, замените -g на -e имя_сервера_интеграции.
- Чтобы указать конкретный поток сообщений для включения, замените -j на -f имя_потока_сообщений.
- Если вы сгруппировали потоки сообщений по программам, для задания включения определенной программы добавьте к опции -j параметр -k имя_программы.
Компонент IBM Integration Bus собирает данные учета архивов и статистики с интервалом в 5 минут. Чтобы задать равные интервалы, с которыми узел интеграции (посредник) будет генерировать данные учета архивов и статистики, введите следующую команду при остановленном узле интеграции (посреднике), а затем перезапустите узел интеграции (посредник):
```
mqsichangebroker имя_посредника -v 5
```

В ACE версии 11 IBM Integration Bus собирает данные учета архивов и статистики с интервалом в 5 минут. Чтобы задать интервал, с которым узел интеграции (посредник) будет генерировать данные учета архивов и статистики, измените файл node.conf.yaml или server.conf.yaml следующим образом:

Статистика:
  # Потоки Сообщения приложения по умолчанию наследуют значения снимка и архива
  # задано здесь
  Снимок:
    #publicationOn: 'inactive' # выбрать 1 из : active|inactive, по умолчанию inactive
                               # Обеспечить Events.OperationalEvents.MQ|MQTT
                               # настроено для outputFormat json,xml
    #accountingOrigin: 'none'  # выбрать 1 из : none|basic
    #nodeDataLevel: 'none'     # выбрать 1 из : none|basic|advanced
    #outputFormat: 'usertrace' # список разделенных запятой значений:
                               # csv,bluemix,json,xml,usertrace
    #threadDataLevel: 'none'   # выбрать 1 из : none|basic
  Архив:
    #publicationOn: 'active' # выбрать 1 из : active|inactive, по умолчанию inactive
                               # Обеспечить Events.OperationalEvents.MQ|MQTT
                               # настроено для outputFormat xml
    #accountingOrigin: 'none'  # выбрать 1 из : none|basic   
    majorInterval: 5         # Задает интервал в минутах, в который
                             # публикуется статистика архива
    nodeDataLevel: 'none'         # выбрать 1 из : none|basic|advanced
    outputFormat: 'xml' # список разделенных запятой значений: csv,xml,usertrace  
    #threadDataLevel: 'none'   # выбрать 1 из : none|basic

Результаты

После того как компонент IBM Integration Bus будет сконфигурирован и запущен, данные учета потоков сообщений и статистики будут показаны в следующих виджетах группы:

Сводная панель Поток сообщений
- Принятия и отклонения
- Микросекунды процессора
- Затраченное время (микросекунды)
- Скорость входящих байт
- Скорость входящих сообщений
- Размер входящих сообщений
- Срок ожидания процессора для входящих сообщений в микросекундах
- Затраченное время ожидания входящих сообщений в микросекундах
- Ошибки потока сообщений
- Статистика узла обработки сообщений
Сводная панель Узел обработки
- Микросекунды процессора
- Затраченное время (микросекунды)
- Вызовы
- Состояние узла обработки
- Статистика терминала

Включение статистики ресурса JVM

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

Чтобы включить статистику ресурсов JVM для серверов интеграции, которые принадлежат к узлу интеграции (посреднику), введите команду mqsichangeresourcestats из каталога bin в каталоге установки узла интеграции (посредника).

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

Процедура

Чтобы включить статистику для всех серверов интеграции в узле интеграции (посреднике), введите следующую команду:
```
mqsichangeresourcestats имя_посредника -c active
```

В ACE версии 11, чтобы включить статистику для всех серверов интеграции в узле интеграции (посреднике), измените файл node.conf.yaml следующим образом:

Статистика:
  # Потоки Сообщения приложения по умолчанию наследуют значения снимка и архива
  # задано здесь
  Снимок:
    #publicationOn: 'inactive' # выбрать 1 из : active|inactive, по умолчанию inactive
                               # Обеспечить Events.OperationalEvents.MQ|MQTT
                               # настроено для outputFormat json,xml
    #accountingOrigin: 'none'  # выбрать 1 из : none|basic
    #nodeDataLevel: 'none'     # выбрать 1 из : none|basic|advanced
    #outputFormat: 'usertrace' # список разделенных запятой значений:
                               # csv,bluemix,json,xml,usertrace
    #threadDataLevel: 'none'   # выбрать 1 из : none|basic
  Архив:
    #publicationOn: 'active' # выбрать 1 из : active|inactive, по умолчанию inactive
                               # Обеспечить Events.OperationalEvents.MQ|MQTT
                               # настроено для outputFormat xml
    #accountingOrigin: 'none'  # выбрать 1 из : none|basic
    majorInterval: 5         # Задает интервал в минутах, в который
                             # публикуется статистика архива
    nodeDataLevel: 'advanced'     # выбрать 1 из : none|basic|advanced
    outputFormat: 'xml' # список разделенных запятой значений: csv,xml,usertrace
    threadDataLevel: 'basic'   # выбрать 1 из : none|basic
   Ресурс:
     reportingOn: true        # выбрать 1 из : true|false, по умолчанию false
......

Прим.: Если вы хотите отключить этот параметр, закомментируйте reportingOn:true.

Чтобы включить статистику для данного сервера интеграции в узле интеграции (посреднике), введите следующую команду:
```
mqsichangeresourcestats имя_посредника -e имя_сервера_интеграции -c active
```

В ACE версии 11, чтобы включить статистику для одного конкретного сервера интеграции в узле интеграции (посреднике), измените файл server.conf.yaml следующим образом:

Статистика:
  # Потоки Сообщения приложения по умолчанию наследуют значения снимка и архива
  # задано здесь
  Снимок:
    #publicationOn: 'inactive' # выбрать 1 из : active|inactive, по умолчанию inactive
                               # Обеспечить Events.OperationalEvents.MQ|MQTT
                               # настроено для outputFormat json,xml
    #accountingOrigin: 'none'  # выбрать 1 из : none|basic
    #nodeDataLevel: 'none'     # выбрать 1 из : none|basic|advanced
    #outputFormat: 'usertrace' # список разделенных запятой значений: 
                               # csv,bluemix,json,xml,usertrace
    #threadDataLevel: 'none'   # выбрать 1 из : none|basic
  Архив:
    #publicationOn: 'active' # выбрать 1 из : active|inactive, по умолчанию inactive
                               # Обеспечить Events.OperationalEvents.MQ|MQTT
                               # настроено для outputFormat xml
    #accountingOrigin: 'none'  # выбрать 1 из : none|basic
    majorInterval: 5         # Задает интервал в минутах, в который
                             # публикуется статистика архива
    nodeDataLevel: 'advanced'     # выбрать 1 из : none|basic|advanced
    outputFormat: 'xml' # список разделенных запятой значений: csv,xml,usertrace
    threadDataLevel: 'basic'   # выбрать 1 из : none|basic
  Ресурс:
    reportingOn: true        # выбрать 1 из : true|false, по умолчанию false

Прим.: Если вы хотите отключить этот параметр, закомментируйте reportingOn:true.

Результаты

Данные статистики ресурсов JVM появятся в следующих виджетах группы:

Число операций сбора мусора
Продолжительность сбора мусора
Память не кучи JVM
Память кучи JVM

Разрешение отслеживания транзакций

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

Убедитесь, что IBM Integration Bus установлен. Поставляется обработчик пользователя KQIUserExit, позволяющий включить IBM Integration Bus для отслеживания транзакций.
Убедитесь, что у пользователя, который запускает узел интеграции (посредник), есть доступ к каталогу модуля обработчика пользователя KQI. Это означает, что вы должны добавить ID пользователя, который использовался для запуска узла интеграции (посредника), в группу, от имени которой устанавливался компонент IBM Integration Bus.

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

Вы должны внедрить обработчик пользователя KQIUserExit на узел интеграции (посредник). В противном случае в промежуточном программном обеспечении (ПО) и сводных панелях топологии не будет никаких данных, даже после включения IBM Integration Bus для отслеживания транзакций.

Совет: Перечисленные ниже узлы IBM Integration Bus включены в сводные панели промежуточного ПО и топологии обработчиком пользователя KQIUserExit как службы без инструментария:

База данных и вычислительные узлы, где задан источник данных ODBC
Узлы TCP/IP
Узлы файлов для удаленных серверов FTP или FTPS
Узлы MQ, если в них еще нет инструментов

Процедура

Чтобы включить отслеживание транзакций для IBM Integration Bus, выполните следующие шаги:

Закройте все оболочки посредников, которые загрузили среду MQSI.
Откройте консоль команд IBM Integration Bus одним из следующих методов. Если у вас установлено несколько версий (посредников), убедитесь, что вы запустили консоль команд для правильной версии.
- Выберите Запустить > IBM Integration Bus > IBM Integration Console
- В подкаталоге bin каталога установки узла интеграции (посредника) введите команду mqsiprofile.
Остановите узел интеграции (посредник), который вы хотите сконфигурировать, с помощью команды mqsistop.
Включите отслеживание транзакций для потока сообщений в пределах узла интеграции (посредника), добавив обработчик пользователя KQIUserExit с помощью команды mqsichangebroker.
- Чтобы включить отслеживание транзакции для всех потоков сообщений в пределах узла интеграции (посредника), введите следующую команду:
```
mqsichangebroker
имя_посредника -e "KQIUserExit"
```
- Чтобы включить отслеживание транзакции для отдельного потока сообщений в пределах узла интеграции (посредника), введите следующую команду:
```
mqsichangeflowuserexits имя_посредника -e имя_группы_выполнения -k имя_программы -f 
имя_потока_сообщений -a "KQIUserExit"
```
Другой вариант в Ace версии 11 - включить отслеживание транзакций для потока сообщений на узле интеграции (посреднике), добавив KQIUserExit к файлу node.conf.yaml или server.conf.yaml.
```
UserExits:
activeUserExitList: 'KQIUserExit' # Задаем имя 
#установленного обработчика пользователя для активации.
```
Прим.: Если вы хотите отключить отслеживание транзакций, закомментируйте activeUserExitList: 'KQIUserExit'.
Перезапустите узел интеграции (посредник) при помощи команды mqsistart.

Запрещение трассировки транзакций

Процедура

Чтобы отключить отслеживание транзакций для IBM Integration Bus, выполните следующие шаги:

Откройте консоль команд IBM Integration Bus одним из следующих методов. Если у вас установлено несколько версий (посредников), убедитесь, что вы запустили консоль команд для правильной версии.
- Выберите Запустить > IBM Integration Bus > IBM Integration Console
- В подкаталоге bin каталога установки узла интеграции (посредника) введите команду mqsiprofile.
Отключите отслеживание транзакций для потока сообщений в пределах узла интеграции (посредника) одним из следующих методов:
- Чтобы отключить отслеживание транзакции для отдельного потока сообщений, используйте команду mqsichangeflowuserexits:
```
mqsichangeflowuserexits имя_посредника -e
имя_группы_выполнения -f имя_потока_сообщений -a ""
```
- Чтобы отключить отслеживание транзакции для всех потоков сообщений в пределах узла интеграции (посредника), сначала остановите узел интеграции (посредник) с помощью команды mqsistop, а затем введите команду mqsichangebroker:
```
mqsichangebroker имя_посредника -e ""
```

Дальнейшие действия

Чтобы производить отслеживание транзакций после включения отслеживания транзакций для IBM Integration Bus, нужно также включить отслеживание транзакций для агента. Инструкции смотрите в разделе Конфигурирование отслеживания транзакций для IBM Integration Bus.
Если вы разрешили сбор данных снимков для узла интеграции (посредника), сконфигурируйте IBM Integration Bus так, чтобы не хранились данные снимков. Cloud APM не поддерживает данные учета и статистики снимков из-за большого объема данных и обработки, требуемых для заданного 20-секундного интервала снимков. Инструкции смотрите в разделе Запрещение сбора данных снимков для агента.