IKuznetsov: Новая страница: «'''Heroku''' — это облачная платформа как услуга ('''PaaS'''), позволяющая создавать и запускать пр...»

2025-12-10T23:28:29Z

Новая страница: «'''Heroku''' — это облачная платформа как услуга ('''PaaS'''), позволяющая создавать и запускать пр...»

Новая страница

'''Heroku''' — это облачная платформа как услуга ('''PaaS'''), позволяющая создавать и запускать приложения в облаке. Приложения, развернутые на '''Heroku''', обычно запускаются с помощью одного или нескольких сборочных пакетов, которые обеспечивают поддержку фреймворков и среды выполнения.

== Возможности ==
Сборщик '''Heroku''' для Ключ-АСТРОМ ЕдиныйАгент не зависит от языка программирования и может использоваться с любым языком, [[Поддержка технологий|поддерживаемым Ключ-АСТРОМ]], включая приложения на основе Node.js. Если вы использовали [https://www.npmjs.com/package/@dynatrace/oneagent модуль Ключ-АСТРОМ NPM для PaaS], вы можете удалить его из зависимостей, поскольку сборщик автоматически обнаружит и внедрит ваши приложения '''Node.js'''.

Вам больше не нужно полагаться на релизы зависимостей Ключ-АСТРОМ ЕдиныйАгент для '''NPM'''. Сборщик '''Heroku''' для Ключ-АСТРОМ ЕдиныйАгент автоматически загружает последнюю версию Ключ-АСТРОМ ЕдиныйАгент, чтобы вы могли получать потенциальные исправления как можно быстрее и проще. Если вы указали версию установки ЕдиногоАгента по умолчанию для новых хостов и приложений в [[Установка ЕдиногоАгента в Linux|настройках обновления ЕдиногоАгента]], сборщик '''Heroku''' для Ключ-АСТРОМ ЕдиныйАгент загрузит определенную версию по умолчанию.

В следующих инструкциях объясняется, как включить мониторинг Ключ-АСТРОМ для ваших приложений '''Heroku''', добавив [https://github.com/Dynatrace/heroku-buildpack-dynatrace сборочный пакет Ключ-АСТРОМ Heroku] в конфигурацию '''Heroku''' вашего приложения.

== Требования ==

* [[Токены доступа|Создайте токен PaaS]].
* Ознакомьтесь со списком [[Поддержка технологий|поддерживаемых приложений и версий]] .
* [[ЕдиныйАгент требования к памяти|Для модуля кода ЕдиногоАгента требуется 200 МБ]] памяти от размера вашего [https://devcenter.heroku.com/articles/slug-compiler#slug-size slug].

== Установка ==
В этих инструкциях объясняется, как интегрировать Ключ-АСТРОМ ЕдиныйАгент в ваши машины '''Heroku''' и начать мониторинг ваших приложений '''Heroku'''.

=== Получение интерфейса командной строки Heroku ===
Для настройки приложений '''Heroku''' на использование Ключ-АСТРОМ '''Heroku buildpack''' можно использовать либо [https://devcenter.heroku.com/articles/heroku-cli интерфейс командной строки Heroku], либо настроить приложения с помощью [https://dashboard.heroku.com/ дашборда Heroku].

=== Добавление Ключ-АСТРОМ Heroku buildpack ===
Для интеграции Ключ-АСТРОМ ЕдиныйАгент в существующее приложение необходимо добавить Ключ-АСТРОМ '''Heroku buildpack''' в список сборочных пакетов вашего приложения и установить идентификатор среды Ключ-АСТРОМ и токен '''PaaS''', используя приведенные ниже команды.
{| class="wikitable"
|# Add the astromkey buildpack

heroku buildpacks:add <nowiki>https://github.com/astromkey/heroku-buildpack-astromkey.git#</nowiki><version>

<nowiki>#</nowiki> Set required credentials to your astromkey environment

heroku config:set DT_TENANT=<environmentID>

heroku config:set DT_API_TOKEN=<token>

<nowiki>#</nowiki> Deploy to Heroku

git push heroku master
|}
После внесения этих изменений '''buildpack''' установит Ключ-АСТРОМ ЕдиныйАгент для автоматического мониторинга вашего приложения.

=== Дополнительная конфигурация ===
Ключ-АСТРОМ '''Heroku buildpack''' поддерживает следующие конфигурации:
{| class="wikitable"
!Переменная окружения
!Описание
|-
|DT_TENANT
|Примечание: Подробную информацию о том, как определить идентификатор среды, см. в разделе Идентификатор среды.
|-
|DT_API_TOKEN
|PaaS-токен для интеграции вашей среды Ключ-АСТРОМ с Heroku.
|-
|DT_API_URL
| - Для Ключ-АСТРОМ SaaS, где ЕдиныйАгент может подключаться к интернету: <code>https://<your-environment-ID>.live.astromkey.com/api</code>
- Для Ключ-АСТРОМ Managed: <code>https://<your-managed-cluster-domain>/e/<your-environment-ID>/api</code>
- Для АктивногоШлюза среды (SaaS или Managed) используйте следующие команды для загрузки ЕдиногоАгента, а также для передачи трафика ЕдиногоАгента через АктивныйШлюз: <code>https://<your-ActiveGate-IP-or-FQDN>:9999/e/<your-environment-ID>/api</code>
Примечание: Подробную информацию о том, как определить идентификатор вашей среды, см. в разделе Идентификатор среды.
|-
|DT_DOWNLOAD_URL
|<code>Необязательно</code> Прямая ссылка для загрузки Ключ-АСТРОМ ЕдиныйАгент. Если эта переменная среды установлена, buildpack загрузит ЕдиныйАгент из этого места.
|-
|SSL_MODE
|<code>Необязательно</code> Установите этот параметр на <code>all</code>, если хотите принимать все самоподписанные SSL-сертификаты.
|-
|DT_TAGS
|<code>Не рекомендуется</code> Теги, которые вы хотите добавить к отслеживаемым приложениям.
|-
|DT_CUSTOM_PROP
|<code>Не рекомендуется</code> Примените это правило, если хотите разделить данные по компонентам и/или средам.
|-
|SKIP_ERRORS
|<code>Необязательно</code> Если установить это значение на <code>1</code>, развертывание приложения не будет завершаться с ошибкой при загрузке установщика ЕдиногоАгента.
|}
Мы рекомендуем создавать переменные среды, специфичные для обнаружения процессов. Переменные среды, используемые в других областях видимости, например <code>DT_TAGS</code>, или <code>DT_CUSTOM_PROP</code>, могут привести к некорректному или непреднамеренному разделению, поскольку все значения переменных среды оцениваются для обнаружения групп процессов.
{| class="wikitable"
!Как использовать Heroku buildpack для Ключ-АСТРОМ ЕдиныйАгент вместо модуля Ключ-АСТРОМ NPM для PaaS
|-
|Для использования '''Heroku buildpack''' для Ключ-АСТРОМ ЕдиныйАгент не требуется вносить изменения в исходный код вашего приложения:

Вам больше не нужно устанавливать зависимость <code>@astromkey/oneagent</code> в директорию проекта вашего '''Node.js'''-приложения. Кроме того, вам больше не требуется добавлять следующее выражение в качестве первого оператора вашего '''Node.js'''-приложения:
{| class="wikitable"
|try {

require('@astromkey/oneagent')();

} catch(err) {

console.log(err.toString());

}
|}
Благодаря этим преимуществам, '''Heroku buildpack''' для Ключ-АСТРОМ ЕдиныйАгент заменяет модуль Ключ-АСТРОМ '''NPM''' для '''PaaS''' и требует <code>Версию ЕдиногоАгента 1.141+.</code>

Если вы хотите начать использовать '''Heroku buildpack''' для Ключ-АСТРОМ ЕдиныйАгент вместо модуля Ключ-АСТРОМ '''NPM''' для '''PaaS''', мы вам поможем. Все, что вам нужно сделать, это удалить зависимость <code>@astromkey/oneagent</code> в вашем файле <code>package.json</code>:
{| class="wikitable"
|$ npm uninstall --save @astromkey/oneagent
|}
Кроме того, вы можете удалить <code>require</code> указанное выше утверждение из своего приложения '''Heroku'''.
|}
{| class="wikitable"
!Как использовать другую среду Ключ-АСТРОМ для приложений Heroku, дополненных ЕдинымАгентом
|-
|<code>Для Версии ЕдиногоАгента 1.139+</code> Если у вас уже есть приложение '''Heroku''', в которое вы добавили модули кода ЕдиногоАгента для конкретной среды Ключ-АСТРОМ, вы можете настроить ЕдиныйАгент на отправку отчетов в другую среду Ключ-АСТРОМ.

Для этого вам необходимо обратиться к REST-эндпоинту вашей второй среды Ключ-АСТРОМ. Не забудьте адаптировать соответствующие значения <code><environmentID></code> и <code><token></code>.
{| class="wikitable"
|curl "https://<environmentID>.live.astromkey.com/api/v1/deployment/installer/agent/connectioninfo?Api-Token=<token>"
|}
В ответ вы получите JSON-объект, содержащий необходимую информацию, которую нужно передать в контейнер приложения в качестве переменной окружения. Убедитесь, что вы настроили переменные окружения вашего приложения '''Heroku''', как описано ниже:

* <code>DT_TENANT</code>: равно <code>tenantUUID</code>
* <code>DT_TENANTTOKEN</code>: равно <code>tenantToken</code>
* <code>DT_CONNECTION_POINT</code>: список <code>communicationEndpoints</code>, разделённый точкой с запятой
|}

=== Настройка сетевых зон <code>Необязательно</code> ===
Сетевые зоны можно настроить с помощью переменной среды:
{| class="wikitable"
|heroku config:set DT_NETWORK_ZONE=<your.network.zone>
|}
Дополнительную информацию см. в разделе [[Сетевые зоны]].

== Обновление ЕдиногоАгента ==
Когда становится доступна новая версия ЕдиногоАгента, необходимо запустить повторный запуск сборки в '''Heroku'''. Сборка Ключ-АСТРОМ автоматически загрузит последнюю версию ЕдиногоАгента.

Если в [[Установка ЕдиногоАгента в Linux|настройках обновлений ЕдиногоАгента]] вы указали версию ЕдиногоАгента по умолчанию для новых хостов и приложений, '''Heroku buildpack''' автоматически загрузит определенную версию ЕдиногоАгента по умолчанию.

Настройка Ключ-АСТРОМ на Heroku - История изменений

IKuznetsov: Новая страница: «'''Heroku''' — это облачная платформа как услуга ('''PaaS'''), позволяющая создавать и запускать пр...»