Настройте ЕдиныйАгент в контейнерах для мониторинга только приложений - История изменений

IKuznetsov в 09:05, 8 января 2025

2025-01-08T09:05:49Z

← Предыдущая версия		Версия от 09:05, 8 января 2025
Строка 1:		Строка 1:
			'''''[[Установка и настройка]] / [[Установка и настройка\|АппОптима разворачивается на]] / [https://docs.expert-apm.ru/index.php/%D0%A3%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0_%D0%B8_%D0%BD%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0#:~:text=%D0%9A%D0%BE%D0%BD%D1%82%D0%B5%D0%B9%D0%BD%D0%B5%D1%80%D0%BD%D1%8B%D1%85%20%D0%BF%D0%BB%D0%B0%D1%82%D1%84%D0%BE%D1%80%D0%BC%D0%B0%D1%85 Контейнерных платформах] / [[Настройте АппОптима на Docker\|Docker]] / Настройте ЕдиныйАгент в контейнерах для мониторинга только приложений'''''

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

IKuznetsov в 18:10, 2 января 2025

2025-01-02T18:10:24Z

← Предыдущая версия		Версия от 18:10, 2 января 2025
Строка 12:		Строка 12:
	3. Добавьте следующие строки кода в образ приложения после последней команды <code>FROM</code>:		3. Добавьте следующие строки кода в образ приложения после последней команды <code>FROM</code>:
	COPY --from=<ADDRESS>/linux/oneagent-codemodules:<TECHNOLOGY> / /		COPY --from=<ADDRESS>/linux/oneagent-codemodules:<TECHNOLOGY> / /
	ENV LD_PRELOAD /opt/~~astromkey~~/oneagent/agent/lib64/liboneagentproc.so		ENV LD_PRELOAD /opt/AppOptima/oneagent/agent/lib64/liboneagentproc.so
	где:		где:

Строка 28:		Строка 28:
	Используйте этот синтаксис:		Используйте этот синтаксис:
	COPY --from=<ACTIVEGATE-ADDRESS>/linux/oneagent-codemodules-musl:<TECHNOLOGY> / /		COPY --from=<ACTIVEGATE-ADDRESS>/linux/oneagent-codemodules-musl:<TECHNOLOGY> / /
	ENV LD_PRELOAD /opt/~~astromkey~~/oneagent/agent/lib64/liboneagentproc.so		ENV LD_PRELOAD /opt/AppOptima/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>.		Допустимые варианты: <code>all</code>, <code>dotnet</code>, <code>php</code>, <code>java</code>, <code>apache</code>, <code>nginx</code>, <code>nodejs</code> и <code>go</code>.

Строка 76:		Строка 76:
	1. Удалите две строки кода из образа приложения.		1. Удалите две строки кода из образа приложения.
	COPY --from=<ACTIVEGATE-ADDRESS>/linux/oneagent-codemodules:<TECHNOLOGY> / /		COPY --from=<ACTIVEGATE-ADDRESS>/linux/oneagent-codemodules:<TECHNOLOGY> / /
	ENV LD_PRELOAD /opt/~~astromkey~~/oneagent/agent/lib64/liboneagentproc.so		ENV LD_PRELOAD /opt/AppOptima/oneagent/agent/lib64/liboneagentproc.so
	2. Восстановите образ приложения.		2. Восстановите образ приложения.
	docker build -t yourapp .		docker build -t yourapp .
Строка 85:		Строка 85:
	ARG DT_API_TOKEN="<token>"		ARG DT_API_TOKEN="<token>"
	ARG DT_ONEAGENT_OPTIONS="flavor=default&include=<technology1>&include=<technology2>"		ARG DT_ONEAGENT_OPTIONS="flavor=default&include=<technology1>&include=<technology2>"
	ENV DT_HOME="/opt/~~astromkey~~/oneagent"		ENV DT_HOME="/opt/AppOptima/oneagent"
	RUN mkdir -p "$DT_HOME" && \		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" && \		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" && \		unzip -d "$DT_HOME" "$DT_HOME/oneagent.zip" && \
	rm "$DT_HOME/oneagent.zip"		rm "$DT_HOME/oneagent.zip"
	ENTRYPOINT [ "/opt/~~astromkey~~/oneagent/~~astromkey~~-agent64.sh" ]		ENTRYPOINT [ "/opt/AppOptima/oneagent/AppOptima-agent64.sh" ]
	CMD [ "executable", "param1", "param2" ] # the command of your application, for example, Java		CMD [ "executable", "param1", "param2" ] # the command of your application, for example, Java

IKuznetsov в 09:18, 26 декабря 2024

2024-12-26T09:18:56Z

← Предыдущая версия		Версия от 09:18, 26 декабря 2024
Строка 19:		Строка 19:
	* Среда АктивногоШлюза: <<code>ActiveGateaddress:9999</code>>		* Среда АктивногоШлюза: <<code>ActiveGateaddress:9999</code>>
	* SaaS: <code>saas.ruscomtech.ru</code>		* SaaS: <code>saas.ruscomtech.ru</code>
	* ~~Managed~~: {<code>~~ManagedAddress~~</code>}		* АппОптима: {<code>АппОптимаAddress</code>}

	<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>java-go</code>, чтобы указать <code>java</code> и <code>go</code>). Включение определенных вариантов технической поддержки вместо поддержки всех технологических параметров приводит к меньшему размеру пакета ЕдиногоАгента.		<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>java-go</code>, чтобы указать <code>java</code> и <code>go</code>). Включение определенных вариантов технической поддержки вместо поддержки всех технологических параметров приводит к меньшему размеру пакета ЕдиногоАгента.

IKuznetsov в 11:48, 11 ноября 2024

2024-11-11T11:48:13Z

Lobanov: Новая страница: «Если у вас нет доступа к базовым хостам, вы можете развернуть ЕдиныйАгент в контейнерах...»

2023-04-23T06:44:59Z

Новая страница: «Если у вас нет доступа к базовым хостам, вы можете развернуть ЕдиныйАгент в контейнерах...»

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

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

== Развернуть ЕдиныйАгент ==
Требуемые версии

<code>Docker версии 17.05+</code>

1. Войдите в Docker, используя свой идентификатор среды Ключ-АСТРОМ в качестве имени пользователя.
docker login <ADDRESS> -u <environmentID>
2. Введите свой <PAAS_TOKEN> при появлении запроса.

3. Добавьте следующие строки кода в образ приложения после последней команды <code>FROM</code>:
COPY --from=<ADDRESS>/linux/oneagent-codemodules:<TECHNOLOGY> / /
ENV LD_PRELOAD /opt/astromkey/oneagent/agent/lib64/liboneagentproc.so
где:

<code><ADDRESS>:</code>

* Среда АктивногоШлюза: <<code>ActiveGateaddress:9999</code>>
* SaaS: <code>saas.ruscomtech.ru</code>
* Managed: {<code>ManagedAddress</code>}

<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>java-go</code>, чтобы указать <code>java</code> и <code>go</code>). Включение определенных вариантов технической поддержки вместо поддержки всех технологических параметров приводит к меньшему размеру пакета ЕдиногоАгента.

=== Что, если мой образ Docker основан на Alpine Linux? ===
Ключ-АСТРОМ ЕдиныйАгент поддерживает среды на базе Alpine Linux.

Используйте этот синтаксис:
COPY --from=<ACTIVEGATE-ADDRESS>/linux/oneagent-codemodules-musl:<TECHNOLOGY> / /
ENV LD_PRELOAD /opt/astromkey/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. Сделайте build образа вашего приложения.

Создайте образ Docker из своего Dockerfile, чтобы использовать его в своей среде Kubernetes.
docker build -t yourapp .
Вы можете контролировать свои контейнеры приложений с помощью другой среды Ключ-АСТРОМ.

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

Для этого вам нужно позвонить в конечную точку REST вашей второй среды Ключ-АСТРОМ. Не забудьте адаптировать соответствующие заполнители <code><environmentID></code> и <code><token></code>.
curl "<nowiki>https://saas.ruscomtech.ru/api/v1/deployment/installer/agent/connectioninfo?Api-Token=</nowiki><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>.network.zone</code>

Дополнительные сведения см. в разделе «Сетевые зоны».

4. <code>опционально</code> Настроить прокси-адрес

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

Примечание. Для контейнеров на основе Alpine Linux может потребоваться обновить wget, поставляемый с образом Alpine, чтобы разрешить аутентификацию прокси-сервера для загрузки ЕдиногоАгента.

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

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

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

=== Внедрение во время сборки контейнера ===

==== Многоэтапные сборки образов Docker ====
1. Удалите две строки кода из образа приложения.
COPY --from=<ACTIVEGATE-ADDRESS>/linux/oneagent-codemodules:<TECHNOLOGY> / /
ENV LD_PRELOAD /opt/astromkey/oneagent/agent/lib64/liboneagentproc.so
2. Восстановите образ приложения.
docker build -t yourapp .

==== Классическая интеграция ====
1. Удалите следующие строки кода из вашего Dockerfile.
ARG DT_API_URL="<nowiki>https://saas.ruscomtech.ru/api</nowiki>"
ARG DT_API_TOKEN="<token>"
ARG DT_ONEAGENT_OPTIONS="flavor=default&include=<technology1>&include=<technology2>"
ENV DT_HOME="/opt/astromkey/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/astromkey/oneagent/astromkey-agent64.sh" ]
CMD [ "executable", "param1", "param2" ] # the command of your application, for example, Java

← Предыдущая версия		Версия от 11:48, 11 ноября 2024
Строка 6:		Строка 6:
	<code>Docker версии 17.05+</code>		<code>Docker версии 17.05+</code>

	1. Войдите в Docker, используя свой идентификатор среды ~~Ключ-АСТРОМ~~ в качестве имени пользователя.		1. Войдите в Docker, используя свой идентификатор среды АппОптима в качестве имени пользователя.
	docker login <ADDRESS> -u <environmentID>		docker login <ADDRESS> -u <environmentID>
	2. Введите свой <PAAS_TOKEN> при появлении запроса.		2. Введите свой <PAAS_TOKEN> при появлении запроса.
Строка 24:		Строка 24:

	=== Что, если мой образ Docker основан на Alpine Linux? ===		=== Что, если мой образ Docker основан на Alpine Linux? ===
	~~Ключ-АСТРОМ~~ ЕдиныйАгент поддерживает среды на базе Alpine Linux.		АппОптима ЕдиныйАгент поддерживает среды на базе Alpine Linux.

	Используйте этот синтаксис:		Используйте этот синтаксис:
Строка 35:		Строка 35:
	Создайте образ Docker из своего Dockerfile, чтобы использовать его в своей среде Kubernetes.		Создайте образ Docker из своего Dockerfile, чтобы использовать его в своей среде Kubernetes.
	docker build -t yourapp .		docker build -t yourapp .
	Вы можете контролировать свои контейнеры приложений с помощью другой среды ~~Ключ-АСТРОМ~~.		Вы можете контролировать свои контейнеры приложений с помощью другой среды АппОптима.

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

	Для этого вам нужно позвонить в конечную точку REST вашей второй среды ~~Ключ-АСТРОМ~~. Не забудьте адаптировать соответствующие заполнители <code><environmentID></code> и <code><token></code>.		Для этого вам нужно позвонить в конечную точку REST вашей второй среды АппОптима. Не забудьте адаптировать соответствующие заполнители <code><environmentID></code> и <code><token></code>.
	curl "<nowiki>https://saas.ruscomtech.ru/api/v1/deployment/installer/agent/connectioninfo?Api-Token=</nowiki><token>"		curl "<nowiki>https://saas.ruscomtech.ru/api/v1/deployment/installer/agent/connectioninfo?Api-Token=</nowiki><token>"
	В ответ вы получаете объект JSON, содержащий необходимую информацию, которую необходимо передать в виде переменной среды в контейнер приложения.		В ответ вы получаете объект JSON, содержащий необходимую информацию, которую необходимо передать в виде переменной среды в контейнер приложения.
Строка 64:		Строка 64:

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

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

	== Удалить ЕдиныйАгент ==		== Удалить ЕдиныйАгент ==