Python(Django, FastAPI)
Для установки и настройки Python-агента New Relic в Django выполните следующие шаги:
1. Установка пакета New Relic
Заголовок раздела «1. Установка пакета New Relic»Установите агент из PyPi, выполнив следующую команду:
pip install newrelic2. Настройка агента
Заголовок раздела «2. Настройка агента»Для начала работы агенту Python необходимы базовые настройки. Их можно задать двумя способами: через конфигурационный файл или переменные окружения.
Способ 1: Использование конфигурационного файла
Заголовок раздела «Способ 1: Использование конфигурационного файла»- Перейдите в рабочий каталог, в котором вы можете сохранить файл, и выполните команду:newrelic-admin generate-config 0123456789-123456789-123456789-123456789 newrelic.ini
- Откройте файл
newrelic.iniи внесите изменения в следующие параметры:license_key = 0123456789-123456789-123456789-123456789 # Ключ (заглушка, не меняем) host = gmonit-collector.<>.ru # Домен коллектора app_name = “MY_AWESOME_APP” # Название приложения
Способ 2: Использование переменных окружения
Заголовок раздела «Способ 2: Использование переменных окружения»Для настройки без конфигурационного файла можно задать переменные окружения. Выполните следующие команды:
NEW_RELIC_LICENSE_KEY=0123456789-123456789-123456789-123456789NEW_RELIC_HOST=gmonit-collector.<DOMAIN>.ru # Домен коллектораNEW_RELIC_APP_NAME="MY_AWESOME_APP" # Название приложенияПодробнее
Заголовок раздела «Подробнее»Для более детальной информации о конфигурации агента обратитесь к официальной документации New Relic.
FastAPI
Заголовок раздела «FastAPI»Для установки и настройки Python-агента New Relic в FastAPI выполните следующие шаги:
1. Установка пакета New Relic
Заголовок раздела «1. Установка пакета New Relic»Установите агент из PyPi, выполнив следующую команду:
pip install newrelic2. Настройка агента
Заголовок раздела «2. Настройка агента»Агенту Python необходимы базовые настройки. Их можно задать через конфигурационный файл или переменные окружения.
Способ 1: Использование конфигурационного файла
Заголовок раздела «Способ 1: Использование конфигурационного файла»- Перейдите в рабочий каталог, в котором вы можете сохранить файл, и выполните команду:newrelic-admin generate-config 0123456789-123456789-123456789-123456789 newrelic.ini
- Откройте файл
newrelic.iniи внесите изменения в следующие параметры:license_key = 0123456789-123456789-123456789-123456789 # Ключ (заглушка, не меняем) host = gmonit-collector.<>.ru # Домен коллектора app_name = “MY_FAST_API_APP” # Название приложения
Способ 2: Использование переменных окружения
Заголовок раздела «Способ 2: Использование переменных окружения»Для настройки без конфигурационного файла можно задать переменные окружения. Выполните следующие команды:
NEW_RELIC_LICENSE_KEY=0123456789-123456789-123456789-123456789NEW_RELIC_HOST=gmonit-collector.<DOMAIN>.ru # Домен коллектораNEW_RELIC_APP_NAME= "MY_FAST_API_APP" # Название приложения3. Интеграция агента с FastAPI
Заголовок раздела «3. Интеграция агента с FastAPI»Для запуска вашего приложения FastAPI с агентом New Relic необходимо использовать команду newrelic-admin run-program перед командой запуска вашего приложения.
Пример запуска приложения с Uvicorn:
Заголовок раздела «Пример запуска приложения с Uvicorn:»newrelic-admin run-program uvicorn main:app --host 0.0.0.0 --port 8000main:app— путь к вашему приложению FastAPI. Если ваш файл называетсяmain.pyи содержит объект приложенияapp, то этот синтаксис корректен.--host 0.0.0.0— слушать на всех интерфейсах.--port 8000— порт, на котором будет доступно ваше приложение.
Пример запуска приложения с Gunicorn:
Заголовок раздела «Пример запуска приложения с Gunicorn:»newrelic-admin run-program gunicorn main:app -w 4 -k uvicorn.workers.UvicornWorker --bind 0.0.0.0:8000-w 4— количество рабочих процессов.-k uvicorn.workers.UvicornWorker— использованиеUvicornWorkerдля асинхронной обработки.
Подробнее
Заголовок раздела «Подробнее»Для более детальной информации о конфигурации агента обратитесь к официальной документации New Relic.