IBM Cloud Application Performance Management

Конфигурирование агента Python agent

Нужно сконфигурировать агент Monitoring Agent for Python, чтобы он мог собирать данные в отслеживаемых программах Python.

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

Перед конфигурированием агента убедитесь, что сервер Apache HTTPD запущен.

Откройте файл конфигурации httpd.conf сервера Apache HTTPD и убедитесь, что mod_status задано.

Убедитесь, что команда apachectl status работает на отслеживаемом сервере Apache без изменений кода в файле конфигурации httpd.conf. Если она не работает, то вы не сможете просматривать в сводных панелях некоторые показатели (например, Занятый обработчик запросов и Бездействующий обработчик запросов).

Прим.: Чтобы команда apachectl status работала правильно, нужно установить Lynx. Дополнительную информацию о том, как разрешить эту команду, смотрите на веб-странице apachectl - Интерфейс управления сервером HTTP Apache.

Если вы конфигурируете экземпляр агента не впервые, то сделайте следующее:

Остановите экземпляр агента.
Чтобы сконфигурировать экземпляр агента, выполните одно из следующих действий:
- Сконфигурируйте агент, изменив файл ответов без вывода сообщений.
- Сконфигурируйте агент, отвечая на запросы.
Убедитесь, что в папку параметров Django внедрено новое связующее программное обеспечение. Для этого убедитесь, что файл kpg_число.py в папке параметров Django обновлен.
Перезапустите сервер Apache.

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

Чтобы избежать проблем с разрешениями при конфигурировании агента, обязательно используйте тот же ID пользователя (root или не-root), который использовался для установки агента. Если вы установили свой агент как избранный пользователь, а сконфигурировать агент хотите как другой пользователь, то обратитесь к разделу Конфигурирование агентов от имени пользователя не-root. Если вы установили и сконфигурировали свой агент как избранный пользователь, а запустить агент хотите как другой пользователь, то обратитесь к разделу Запуск агентов от имени пользователя не-root.

Агент Python agent - это агент с несколькими экземплярами; нужно создать первый экземпляр и запустить агент вручную. В имя управляемой системы включается указанное имя экземпляра (например, имя_экземпляра:имя_хоста:код_продукта, где код_продукта - это двухсимвольный код продукта). Имя управляемой системы может содержать не более 32 символов. Максимальная длина имени экземпляра - 28 символов минус длина имени хоста. Например, если имя экземпляра - Python2, то именем управляемой системы будет Python2:имя_хоста:PG.

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

Процедура

Чтобы сконфигурировать агент посредством изменения файла ответов без вывода сообщений и выполнения сценария не в интерактивном режиме, сделайте следующее:
1. Откройте в текстовом редакторе файл каталог_установки /samples/python_silent_config.txt, где каталог_установки - это каталог установки Python agent. Каталог установки по умолчанию - /opt/ibm/apm/agent.
2. Порт ожидания HTTPD - задайте номер порта, чтобы отличить одну группу процессов HTTPD от остальных. Значение по умолчанию - 80.
  Прим.:
  - Если сервер Apache ожидает на нескольких портах, то для этого параметра можно задать любой из них.
  - Если на одном компьютере работает несколько серверов Apache, то нужно задать номер порта сервера, на котором работают программы Django.
  - Если вы хотите использовать несколько экземпляров агента для мониторинга экземпляров программы Python, которые используют разные порты на одном сервере Apache, то помимо указания портов нужно указать на следующем шаге разные точки входа WSGI Django. Если вы укажете только порты, то экземпляры агента будут отслеживать один и тот же сервер, и данные будут одинаковыми.
3. Если в поле Python 3 задано false, то среда Python рассматривается как Python версии 2.x. Если вы работаете в Python версии 3.x, то замените значение на true. Значение по умолчанию - false.
4. Точки входа WSGI Django - задайте точки входа WSGI Django. Точки входа разделяются двоеточием.
  Например, в файле конфигурации Apache может содержаться следующая строка:
  WSGIScriptAlias / /var/www/html/mysite/mysite/wsgi.py
  В этом примере /var/www/html/mysite/mysite/wsgi.py задано как точка входа.
  
  Чтобы включить все точки входа, обнаруженные в файлах конфигурации Apache, оставьте этот параметр пустым.
  Прим.: Не задавайте одну точку входа WSGI Django для разных экземпляров агента. Если вы используете для конфигурирования одного экземпляра агента для мониторинга сервера Apache опции по умолчанию, то не конфигурируйте другие экземпляры агента для мониторинга того же сервера.
5. Параметры Django для отслеживаемой программы - задайте параметры Django для отслеживаемой программы (например, my_project.settings). Если вы используете значения по умолчанию, то оставьте это поле пустым.
6. Минимальное записываемое время ответа - задайте среднее время ответа в миллисекундах. Требования, выполняемые в течение этого времени или быстрее, не записываются. Значение по умолчанию - 300.
7. Порог медленных требований - задайте порог медленных требований в миллисекундах. Значение по умолчанию - 500.
8. Порог очень медленных требований - задайте порог очень медленных требований в миллисекундах. Значение по умолчанию - 7000.
9. Интервал отчетов профилировщика - задайте интервал (в минутах), с которым агент генерирует отчеты профилировщика для медленных требований. Минимальное значение этого параметра - 10; это гарантирует, что работа программ не замедляется из-за избыточного профилирования. Обычно пользователи задают значение больше 10. Значение по умолчанию - 10.
  Этот параметр также сообщает сценарию агента, как нужно агрегировать данные мониторинга. В начале каждой минуты связующее программное обеспечение сбрасывает данные, собранные на предыдущую минуту, и начинает записывать новый файл необработанных данных. Сценарий агента суммирует необработанные данные на основе этого параметр и возвращает результат. Например, если задано 10 минут, то сценарий агента агрегирует все необработанные данные за предыдущие 10 минут и возвращает результаты. Окончательный результат может быть усредненным значением (например, время ответа для конкретного URL) или суммой (например, общее число требований или число байт трафика).
10. Сохраните и закройте файл python_silent_config.txt, а затем введите
  каталог_установки /bin/python-agent.sh config имя_экземпляра каталог_установки /samples/python_silent_config.txt
  где имя_экземпляра - это имя экземпляра, а каталог_установки - это каталог установки Python agent. Каталог установки по умолчанию - /opt/ibm/apm/agent.
11. Чтобы запустить агент, введите
  каталог_установки /bin/python-agent.sh start имя_экземпляра
Чтобы сконфигурировать агент посредством выполнения сценария и ответов на запросы, сделайте следующее:
1. Введите
  каталог_установки /bin/python-agent.sh config имя_экземпляра
  где имя_экземпляра - это имя экземпляра, а каталог_установки - это каталог установки Python agent. Каталог установки по умолчанию - /opt/ibm/apm/agent.
2. Изменить параметры агента Monitoring Agent for Python - введите 1, чтобы продолжить.
3. Порт ожидания HTTP - нажмите Enter, чтобы принять значение по умолчанию, или задайте номер порта.
  Прим.:
  - Если сервер Apache ожидает на нескольких портах, то для этого параметра можно задать любой из них.
  - Если на одном компьютере работает несколько серверов Apache, то нужно задать номер порта сервера, на котором работают программы Django.
  - Если вы хотите использовать несколько экземпляров агента для мониторинга экземпляров программы Python, которые используют разные порты на одном сервере Apache, то помимо указания портов нужно указать на следующем шаге разные точки входа WSGI Django. Если вы укажете только порты, то экземпляры агента будут отслеживать один и тот же сервер, и данные будут одинаковыми.
4. В поле Python 3 укажите false, если версия Python не 3. Если вы работаете в Python версии 3.x, то задайте значение true. Значение по умолчанию - false.
5. Точки входа WSGI Django - оставьте этот параметр пустым или задайте точки входа.
  Прим.: Не задавайте одну точку входа WSGI Django для разных экземпляров агента. Если вы используете для конфигурирования одного экземпляра агента для мониторинга сервера Apache опции по умолчанию, то не конфигурируйте другие экземпляры агента для мониторинга того же сервера.
6. Параметры Django для отслеживаемой программы - задайте параметры Django для отслеживаемой программы (например, my_project.settings). Если вы используете значения по умолчанию, то оставьте это поле пустым и нажмите Enter.
7. Минимальное записываемое время ответа - нажмите Enter, чтобы принять значение по умолчанию, или задайте время.
8. Порог медленных требований - нажмите Enter, чтобы принять значение по умолчанию, или задайте порог.
9. Порог очень медленных требований - нажмите Enter, чтобы принять значение по умолчанию, или задайте порог.
10. Интервал отчетов профилировщика - нажмите Enter, чтобы принять значение по умолчанию, или задайте интервал.
11. Чтобы запустить агент, введите
  каталог_установки /bin/python-agent.sh start имя_экземпляра

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

После запуска экземпляра агента генерируется сценарий вставки для настройки связующего программного обеспечения мониторинга, который сохраняется во временном каталоге.

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

каталог_установки /tmp/kpg/inject_числоg.sh
папка_параметров_Django/kpg_число.py

Важное замечание: Числовой суффикс указывает программу Django. Если в этой временной папке сгенерировано несколько сценариев вставки, то вы увидите такое же число файлов kpg_числовая строка.py.

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

Копирует первоначальный файл параметров WSGI для каждой программы Django.
Копирует пользовательский файл параметров WSGI, чтобы переопределить первоначальный файл.
Перемещает пользовательское связующее программное обеспечение в папку программ Django.
Разрешает состояние модуля для сервера Apache.

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

Прим.: Разблокирование модуля состояние Apache может входить в несколько сценариев вставки, но при выполнении сценариев модуль добавляется только один раз.

Для сервера Apache можно использовать следующие команды остановки и перезапуска:

Остановка: каталог_apache_bin/httpd -k graceful-stop
Перезапуск: каталог_apache_bin/httpd -k graceful