IKuznetsov в 15:31, 11 ноября 2025

2025-11-11T15:31:13Z

IKuznetsov: Новая страница: «Внедрение модуля кода Ключ-АСТРОМ в контейнер во время процесса его сборки. Этот метод и...»

2025-11-11T15:31:05Z

Новая страница: «Внедрение модуля кода Ключ-АСТРОМ в контейнер во время процесса его сборки. Этот метод и...»

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

Внедрение модуля кода Ключ-АСТРОМ в контейнер во время процесса его сборки.

Этот метод инструментирования приложений имеет ограничения при связывании рабочих нагрузок '''Kubernetes''' с отслеживаемыми контейнерами/процессами. Для достижения корректных взаимодействий и связывания рассмотрите возможность использования [[Начало работы с наблюдаемостью приложений|автоматического внедрения только на уровне приложения]].

== Предустановка ==

* Ознакомьтесь со списком поддерживаемых приложений и версий.
* Создайте токен доступа с областью действия <code>PaaS Integration - InstallerDownload</code>.
* Требования к хранению:
** ~325 МБ для '''glibc'''
** ~290 МБ для '''musl'''
** ~650 МБ для '''glibc''' и '''musl''' вместе взятых
* Для архитектуры '''ARM''' убедитесь, что установлены <code>wget</code> и <code>unzip</code>.

{| class="wikitable"
|Внедрение во время сборки контейнера и cgroup v2

Если используется внедрение сборки контейнера с [https://kubernetes.io/docs/concepts/architecture/cgroups/ cgroup v2], <code>builtin:containers.*</code> метрики передаются в Ключ-АСТРОМ только в том случае, если модуль запускает один контейнер.
|}

== Развертка ==
Чтобы интегрировать ЕдиныйАгент в образ приложения, выполните следующие действия.

=== Kubernetes/OpenShift v4.0 ===
1. Войдите в '''Docker''', используя идентификатор среды Ключ-АСТРОМ в качестве имени пользователя и токен доступа в качестве пароля.
{| class="wikitable"
|docker login -u <environmentID> -p <accessToken> <environmentURL>
|}
2. Добавьте следующие строки кода в образ приложения после последней команды <code>FROM</code>:
{| class="wikitable"
|COPY --from=<environment>/linux/oneagent-codemodules:<technology> / /

ENV LD_PRELOAD /opt/dynatrace/oneagent/agent/lib64/liboneagentproc.so
|}

* <code><technology></code>— Модуль кода ЕдиногоАгента, необходимый для вашего приложения. Доступные варианты: <code>all</code>, <code>java</code>, <code>apache</code>, <code>nginx</code>, <code>nodejs</code>, <code>dotnet</code>, <code>php</code>, <code>go</code> и <code>sdk</code>. Вы можете указать несколько модулей кода, разделив их дефисом (<code>-</code>), например <code>java-go</code>. Включение поддержки отдельных технологий вместо поддержки всех технологических опций приводит к уменьшению размера пакета ЕдиногоАгента.

{| class="wikitable"
|Ключ-АСТРОМ ЕдиныйАгент поддерживает среды на базе Alpine Linux.
{| class="wikitable"
|COPY --from=<ACTIVEGATE-ADDRESS>/linux/oneagent-codemodules-musl:<TECHNOLOGY> / /

ENV LD_PRELOAD /opt/dynatrace/oneagent/agent/lib64/liboneagentproc.so
|}
Допустимые варианты: <code>all</code>, <code>dotnet</code>, <code>php</code>, <code>java</code>, <code>apache</code>, <code>nginx</code>, <code>nodejs</code> и <code>go</code>.
|}
3. Создайте образ своего приложения.

Создайте образ '''Docker''' из '''Dockerfile''' для использования в среде '''Kubernetes'''.
{| class="wikitable"
|docker build -t yourapp .
|}
{| class="wikitable"
|Вы можете контролировать контейнеры своих приложений с помощью другой среды Ключ-АСТРОМ.

<code>Для ЕдиногоАгента версии 1.139+</code> Если у вас есть образ приложения, в который вы уже добавили модули кода ЕдиногоАгента для конкретной среды Ключ-АСТРОМ, вы можете настроить отправку ЕдиногоАгента в другую среду Ключ-АСТРОМ без пересборки образа приложения.

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

В ответ вы получаете '''JSON-объект''', содержащий необходимую информацию, которую необходимо передать в качестве переменной среды контейнеру приложения.

Убедитесь, что переменные среды контейнера приложения настроены так, как описано ниже:

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

Вы можете настроить сетевые зоны как переменную среды:

* <code>DT_NETWORK_ZONE</code>: равно <code>your.network.zone</code>

Более подробную информацию смотрите в разделе [[Сетевые зоны]].

5. <code>необязательно</code> Настройка прокси-адреса

Если вы запускаете среду с прокси-сервером, вам необходимо установить переменную среды <code>DT_PROXY</code> в контейнере приложения, чтобы передать учетные данные прокси-сервера в ЕдиномАгенте.

=== OpenShift v3.11 ===
1. Определите переменные с необязательными значениями по умолчанию, используя инструкции <code>ARG</code>, как показано ниже.
{| class="wikitable"
|ARG DT_API_URL="https://<environmentID>.live.dynatrace.com/api"

ARG DT_PAAS_TOKEN="<token>"

ARG DT_ONEAGENT_OPTIONS="flavor=default&include=<technology1>&include=<technology2>"

ENV DT_HOME="/opt/dynatrace/oneagent"
|}

* Вы можете переопределить значения по умолчанию в '''OpenShift''' <code>BuildConfig</code>. Замените <code><environmentID></code> на идентификатор вашей среды Ключ-АСТРОМ. Если вы используете Ключ-АСТРОМ Managed, необходимо указать URL-адрес вашего сервера Ключ-АСТРОМ (<code>https://<YourDynatraceServerURL>/e/<environmentID>/api</code>). Замените <code><token></code> на токен '''PaaS''', указанный выше.
* Поддержка технологий включается с помощью параметров <code>include</code>. Допустимые параметры <code>flavor=default</code>: <code>all</code>, <code>java</code>, <code>apache</code>, <code>nginx</code>, <code>nodejs</code>, <code>dotnet</code>, <code>php</code>, <code>go</code> и <code>sdk</code>. Включение отдельных вариантов поддержки технологий вместо поддержки всех технологических вариантов приводит к уменьшению размера пакета ЕдиногоАгента.

{| class="wikitable"
|Ключ-АСТРОМ ЕдиныйАгент поддерживает среды на базе Alpine Linux.
{| class="wikitable"
|COPY --from=<ACTIVEGATE-ADDRESS>/linux/oneagent-codemodules-musl:<TECHNOLOGY> / /

ENV LD_PRELOAD /opt/dynatrace/oneagent/agent/lib64/liboneagentproc.so
|}
Допустимые варианты: <code>all</code>, <code>dotnet</code>, <code>php</code>, <code>java</code>, <code>apache</code>, <code>nginx</code>, <code>nodejs</code> и <code>go</code>.
|}
2. Добавьте следующие команды в текущий '''Dockerfile''' для интеграции ЕдиногоАгента и активации инструментария вашего приложения.
{| class="wikitable"
|ARG DT_API_URL="https://<environmentID>.live.dynatrace.com/api"

ARG DT_API_TOKEN="<token>"

ARG DT_ONEAGENT_OPTIONS="flavor=default&include=<technology1>&include=<technology2>"

ENV DT_HOME="/opt/dynatrace/oneagent"

RUN mkdir -p "$DT_HOME" && \

wget -O "$DT_HOME/oneagent.zip" "$DT_API_URL/v1/deployment/installer/agent/unix/paas/latest?Api-Token=$DT_API_TOKEN&$DT_ONEAGENT_OPTIONS" && \

unzip -d "$DT_HOME" "$DT_HOME/oneagent.zip" && \

rm "$DT_HOME/oneagent.zip"

ENV LD_PRELOAD="/opt/dynatrace/oneagent/agent/lib64/liboneagentproc.so"

ARGT_ONEAGENT_OPTIONS="flavor=default&include=<technology1>&include=<technology2>"

ENV DT_HOME="/opt/dynatrace/oneagent"

RUN mkdir -p "$DT_HOME" && \

wget -O "$DT_HOME/oneagent.zip" "$DT_API_URL/v1/deployment/installer/agent/unix/paas/latest?Api-Token=$DT_API_TOKEN&$DT_ONEAGENT_OPTIONS" && \

unzip -d "$DT_HOME" "$DT_HOME/oneagent.zip" && \

rm "$DT_HOME/oneagenzip"

ENV LD_PRELOAD="/opt/dynatrace/oneagent/agent/lib64/liboneagentproc.so"
|}
Вышеприведенные команды, которые используют <code>wget</code> и <code>unzip</code> могут не работать, если они не предусмотрены базово.

3. Создайте образ своего приложения.

В контексте '''OpenShift''' указанный выше '''Dockerfile''' можно использовать для двоичных сборок следующим образом:
{| class="wikitable"
|oc new-build --binary --strategy=docker --allow-missing-images yourapp

oc patch bc/yourapp --type=json --patch='[{"op":"remove","path":"/spec/strategy/dockerStrategy/from"}]'

oc start-build yourapp --from-dir=. --follow
|}
{| class="wikitable"
|Вы можете контролировать контейнеры своих приложений с помощью другой среды Ключ-АСТРОМ.

<code>Для ЕдиногоАгента версии 1.139+</code> Если у вас есть образ приложения, в который вы уже добавили модули кода ЕдиногоАгента для конкретной среды Ключ-АСТРОМ, вы можете настроить отправку ЕдиногоАгента в другую среду Ключ-АСТРОМ без пересборки образа приложения.

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

В ответ вы получаете '''JSON-объект''', содержащий необходимую информацию, которую необходимо передать в качестве переменной среды контейнеру приложения.

Убедитесь, что переменные среды контейнера приложения настроены так, как описано ниже:

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

Вы можете настроить сетевые зоны как переменную среды:

* <code>DT_NETWORK_ZONE</code>: равно <code>your.network.zone</code>

Более подробную информацию смотрите в разделе [[Сетевые зоны]].

5. <code>необязательно</code> Настройка прокси-адреса

Если вы запускаете среду с прокси-сервером, вам необходимо установить переменную среды <code>DT_PROXY</code> в контейнере приложения, чтобы передать учетные данные прокси-сервера в ЕдиномАгенте.

=== ARM ===

# Установите следующие переменные времени сборки:
#* <code>$DT_API_URL</code> (URL-адрес API вашей среды Ключ-АСТРОМ)
#* <code>$DT_PAAS_TOKEN</code> (PaaS-токен для загрузки модулей кода)
#* <code>$DT_ONEAGENT_TECHNOLOGY</code> (Модуль, который загружается, например <code>php</code>)
# Добавьте следующие команды в '''Dockerfile''':

{| class="wikitable"
|RUN mkdir -p /opt/dynatrace/oneagent && ARCHIVE=$(mktemp) && wget -O $ARCHIVE "$DT_API_URL/v1/deployment/installer/agent/unix/paas/latest?Api-Token=$DT_PAAS_TOKEN&flavor=default&arch=arm&include=$DT_ONEAGENT_TECHNOLOGY" && unzip -o -d /opt/dynatrace/oneagent $ARCHIVE && rm -f $ARCHIVE

ENV LD_PRELOAD /opt/dynatrace/oneagent/agent/lib64/liboneagentproc.so
|}

== Обновление ==
Вам необходимо вручную обновлять ЕдиныйАгент, перестраивая образ контейнера каждый раз, когда требуется новая версия модуля кода.

== Удаление ==
Чтобы удалить ЕдиныйАгент из мониторинга приложений

=== Многоэтапные сборки образов Docker ===
1. Удалите две строки кода из образа приложения.
{| class="wikitable"
|COPY --from=<ACTIVEGATE-ADDRESS>/linux/oneagent-codemodules:<TECHNOLOGY> / /

ENV LD_PRELOAD /opt/dynatrace/oneagent/agent/lib64/liboneagentproc.so
|}
2. Перестройте образ приложения.
{| class="wikitable"
|docker build -t yourapp .
|}

=== Классическая интеграция ===
1. Удалите следующие команды из вашего Dockerfile.
{| class="wikitable"
|ARG DT_API_URL="https://<environmentID>.live.dynatrace.com/api"

ARG DT_API_TOKEN="<token>"

ARG DT_ONEAGENT_OPTIONS="flavor=default&include=<technology1>&include=<technology2>"

ENV DT_HOME="/opt/dynatrace/oneagent"

RUN mkdir -p "$DT_HOME" && \

wget -O "$DT_HOME/oneagent.zip" "$DT_API_URL/v1/deployment/installer/agent/unix/paas/latest?Api-Token=$DT_API_TOKEN&$DT_ONEAGENT_OPTIONS" && \

unzip -d "$DT_HOME" "$DT_HOME/oneagent.zip" && \

rm "$DT_HOME/oneagent.zip"

ENTRYPOINT [ "/opt/dynatrace/oneagent/dynatrace-agent64.sh" ]

CMD [ "executable", "param1", "param2" ] # the command of your application, for example, Java
|}
2. Перестройте образ приложения.
{| class="wikitable"
|docker build -t yourapp .
|}

Наблюдаемость приложения посредством внедрения во время сборки контейнера - История изменений

IKuznetsov в 15:31, 11 ноября 2025

IKuznetsov: Новая страница: «Внедрение модуля кода Ключ-АСТРОМ в контейнер во время процесса его сборки. Этот метод и...»