Конфигурирование агента агент Node.js

Чтобы агент смог начать мониторинг приложения, нужно добавить сборщика данных агента в приложение Node.js и перезапустить приложение.

1. Убедитесь, что у идентификатора пользователя, использующегося для выполнения сервера приложений, есть полные полномочия в каталоге каталог_установки агента.
2. Перейдите в каталог каталог_установки /bin и введите следующую команду:

   ./nodejs-agent.sh config

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

   KNJ_NODEJS_RUNTIME_BIN_LOCATION

   Каталог для папки bin среды выполнения Node.js. Каталог по умолчанию - /usr/local/bin.

   KNJ_NPM_RUNTIME_BIN_LOCATION

   Каталог для папки bin команды npm. Каталог по умолчанию - /usr/local/bin.

   KNJ_NPM_LIB_LOCATION

   Каталог для папки lib глобального каталога установки пакета npm. Каталог по умолчанию - /usr/local/lib. Например, если пакет npm устанавливается командой npm install -g, он будет установлен в каталоге /домашний_каталог_nodejs/lib/node_modules, а каталогом KNJ_NPM_LIB_LOCATION будет /домашний_каталог_nodejs/lib.

   CP_PORT

   Порт приема агента для данных от клиентов гнезда. Значение 0 указывает, что будет использоваться эфемерный порт. Значение по умолчанию - 63336.

   Прим.: Не используйте номер порта, уже использующийся в вашей системе. Чтобы проверить, не используется ли уже порт, введите команду netstat -apn | grep номер_порта.

4. Запустите агент, выполнив следующую команду:

   ./nodejs-agent.sh start

5. Проверьте успешность запуска агент Node.js. Если агент успешно запущен, будет создана папка KNJ_NPM_LIB_LOCATION/node_modules/ibmapm.
6. В зависимости от имеющегося у вас предложения и ваших требований, вставьте одну из следующих записей в .js файл вашего приложения Node.js, чтобы сконфигурировать сборщики данных агента:
   Прим.: В приложение Node.js можно добавить только одну запись, чтобы включить возможности сбора данных агента. Также, если вы включите возможности, которых нет в предложении, может возникать ненужная служебная нагрузка, которая снизит эффективность выполнения приложения.
   • Если у вас есть только возможности мониторинга ресурсов, вы можете добавить сборщик данных о ресурсах. Чтобы его добавить, вставьте в начало файла приложения Node.js следующую строку:

     require('KNJ_NPM_LIB_LOCATION/node_modules/ibmapm');

     Если значением KNJ_NPM_LIB_LOCATION в вашей среде является /usr/local/lib, строка примет вид:

     require('/usr/local/lib/node_modules/ibmapm');

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

       require('KNJ_NPM_LIB_LOCATION/node_modules/ibmapm/methodtrace.js');

     • Чтобы добавить сборщик диагностических данных, вставьте в начало файла приложения Node.js следующую строку:

       require('KNJ_NPM_LIB_LOCATION/node_modules/ibmapm/deepdive.js');

     • Чтобы добавить сборщик данных мониторинга ресурсов, вставьте в начало файла приложения Node.js следующую строку:

       require('KNJ_NPM_LIB_LOCATION/node_modules/ibmapm');

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

   Прим.: Код изменений подключаемых модулей, начиная с Cloud APM март 2017. Если вы обновили агент более ранних версий, вы должны обновить код существующих сборщиков данных в приложениях, чтобы возможность мониторинга функционировала правильно.
7. Перезапустите программу Node.js, чтобы включить сборщик данных агента.