ЕдиныйАгент настройка параметров установки в Linux - История изменений

IKuznetsov в 08:47, 7 января 2025

2025-01-07T08:47:11Z

← Предыдущая версия		Версия от 08:47, 7 января 2025
Строка 1:		Строка 1:
			'''''[[Установка и настройка]] / [[Установка и настройка\|Основные элементы АппОптима]] / [[ЕдиныйАгент АппОптима]] / [[ЕдиныйАгент АппОптима\|Установка и эксплуатация]]/ [https://docs.expert-apm.ru/index.php/%D0%95%D0%B4%D0%B8%D0%BD%D1%8B%D0%B9%D0%90%D0%B3%D0%B5%D0%BD%D1%82_%D0%90%D0%BF%D0%BF%D0%9E%D0%BF%D1%82%D0%B8%D0%BC%D0%B0#:~:text=%D0%9E%D0%BF%D0%B5%D1%80%D0%B0%D1%86%D0%B8%D0%BE%D0%BD%D0%BD%D1%8B%D0%B5%20%D1%81%D0%B8%D1%81%D1%82%D0%B5%D0%BC%D1%8B Операционные системы]/ [[ЕдиныйАгент в Linux]] / [[ЕдиныйАгент в Linux\|Установка]] / ЕдиныйАгент настройка параметров установки в Linux'''''

	Установщик для дистрибутивов Linux можно использовать с параметрами командной строки, если вы не можете использовать параметры по умолчанию. Обратите внимание, что все параметры, перечисленные ниже, являются необязательными.		Установщик для дистрибутивов Linux можно использовать с параметрами командной строки, если вы не можете использовать параметры по умолчанию. Обратите внимание, что все параметры, перечисленные ниже, являются необязательными.

Строка 69:		Строка 71:
	'''Значение по умолчанию:''' <code>зависит от среды</code>		'''Значение по умолчанию:''' <code>зависит от среды</code>

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

	Чтобы установить токен, передайте его как значение параметра:		Чтобы установить токен, передайте его как значение параметра:

IKuznetsov в 10:38, 11 ноября 2024

2024-11-11T10:38:01Z

ENetrebin в 15:30, 21 сентября 2023

2023-09-21T15:30:37Z

Lobanov: /* Непривилегированный режим */

2022-03-15T17:17:16Z

Непривилегированный режим

Lobanov: /* Изменение непривилегированного пользователя и группы */

2022-03-15T15:59:49Z

Изменение непривилегированного пользователя и группы

← Предыдущая версия		Версия от 15:59, 15 марта 2022
Строка 99:		Строка 99:
	<code>--set-proxy=172.1.1.128:8080</code>		<code>--set-proxy=172.1.1.128:8080</code>

	~~Dynatrace~~ также поддерживает адреса IPv6.		Ключ-Астром также поддерживает адреса IPv6.

	Если вам нужно изменить адрес прокси-сервера после установки, используйте --set-proxy в интерфейсе командной строки ЕдиногоАгента.		Если вам нужно изменить адрес прокси-сервера после установки, используйте --set-proxy в интерфейсе командной строки ЕдиногоАгента.
Строка 364:		Строка 364:
	* Если указан параметр <code>USER=<username></code>, программа установки использует <code><username></code> в качестве имени непривилегированного пользователя.		* Если указан параметр <code>USER=<username></code>, программа установки использует <code><username></code> в качестве имени непривилегированного пользователя.

	В любом случае программа установки ~~Dynatrace~~ проверяет, существует ли уже в системе требуемый пользователь (<code>dtuser</code> или пользователь, указанный в параметре USER).		В любом случае программа установки Ключ-Астром проверяет, существует ли уже в системе требуемый пользователь (<code>dtuser</code> или пользователь, указанный в параметре USER).

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

Lobanov: добавил ссылку

2022-02-13T05:48:18Z

добавил ссылку

← Предыдущая версия		Версия от 05:48, 13 февраля 2022
Строка 347:		Строка 347:
	Чтобы переключить установщик обратно на использование уровня разрешений суперпользователя для последующих обновлений, запустите его с параметром <code>DISABLE_ROOT_FALLBACK=0</code>.		Чтобы переключить установщик обратно на использование уровня разрешений суперпользователя для последующих обновлений, запустите его с параметром <code>DISABLE_ROOT_FALLBACK=0</code>.

	Дополнительные сведения см. в требованиях к разрешениям для установки и работы ЕдиногоАгента в Linux.		Дополнительные сведения см. в [[Непривилегированный режим работы ЕдиногоАгента в Linux\|требованиях к разрешениям для установки и работы ЕдиногоАгента в Linux]].

	'''Примечания:'''		'''Примечания:'''

Lobanov: /* Группа хостов */

2022-02-13T05:47:08Z

Группа хостов

Внесённые изменения

Lobanov: Новая страница: «Установщик для дистрибутивов Linux можно использовать с параметрами командной строки, есл...»

2022-02-07T15:23:28Z

Новая страница: «Установщик для дистрибутивов Linux можно использовать с параметрами командной строки, есл...»

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

Установщик для дистрибутивов Linux можно использовать с параметрами командной строки, если вы не можете использовать параметры по умолчанию. Обратите внимание, что все параметры, перечисленные ниже, являются необязательными.

==== '''Передача параметров установки''' ====
Чтобы передать параметры, добавьте их к команде установщика и разделите пробелами.

Например:

<code>Dynatrace-OneAgent-Linux.sh --set-host-group=my_host_group --set-infra-only=true</code>

==== '''Удаленные параметры установки''' ====
Преобразуйте в более новые параметры <code>--set-param=<value></code>. Эквивалентные параметры <code>PARAM=<value></code> не поддерживаются программой установки ЕдиногоАгента, начиная с версии 1.213.

Удален параметр PARAM=<value> Новый параметр --set-param=<value>
{| class="wikitable"
!Удаленные <code>PARAM=<value></code> параметры
!Новые <code>--set-param=<value></code> параметры
|-
|<code>SERVER</code>
|<code>--set-server</code>
|-
|<code>TENANT</code>
|<code>--set-tenant</code>
|-
|<code>TENANT_TOKEN</code>
|<code>--set-tenant-token</code>
|-
|<code>PROXY</code>
|<code>--set-proxy</code>
|-
|<code>HOST_GROUP</code>
|<code>--set-host-group</code>
|-
|<code>APP_LOG_CONTENT_ACCESS</code>
|<code>--set-app-log-content-access</code>
|-
|<code>DISABLE_SYSTEM_LOGS_ACCESS</code>
|<code>--set-system-logs-access-enabled</code>
|-
|<code>INFRA_ONLY</code>
|<code>--set-infra-only</code>
|}
Если вы смешиваете эквивалентные параметры <code>PARAM=<value></code> и <code>--set-param=<value></code>, параметр <code>--set-param=<value></code> переопределяет параметр <code>PARAM=<value></code>.

==== '''Конечная точка связи''' ====
Значение по умолчанию: <code>зависит от среды</code>

Адрес конечной точки связи ЕдиногоАгента, которая является компонентом Ключ-Астром, на который ЕдиныйАгент отправляет данные. В зависимости от вашего развертывания это может быть кластер Ключ-Астром или АктивныйШлюз. Если вы устанавливаете ЕдиныйАгент с помощью страницы развертывания Ключ-Астром, для него уже установлено правильное значение. Чтобы изменить его, используйте IP-адрес или имя. Добавьте номер порта после двоеточия.

Чтобы установить конечную точку связи, передайте ее как значение параметра:

<code>--set-server=<nowiki>https://100.20.10.1:443</nowiki></code>

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

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

==== '''Идентификатор среды''' ====
Значение по умолчанию: <code>зависит от среды</code>

Идентификатор среды Ключ-Астром, который вы получили по электронной почте с активацией. Если вы устанавливаете ЕдиныйАгент с помощью страницы развертывания Ключ-астром, для него уже установлено правильное значение. Если вы продаете услуги на основе Ключ-Астром, используйте этот параметр, чтобы установить идентификаторы ваших клиентов из пула идентификаторов, приобретенных вами у Ключ-Астром.

Чтобы установить идентификатор среды, передайте его в качестве значения параметра:

<code>--set-tenant=mySampleEnv</code>

Если вам нужно изменить арендатора после установки, используйте <code>--set-tenant</code> в интерфейсе командной строки ЕдиногоАгента.

==== '''Токен''' ====
Значение по умолчанию: <code>зависит от среды</code>

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

Чтобы установить токен, передайте его как значение параметра:

<code>--set-tenant-token=abcdefghij123456</code>

См. Токены доступа, чтобы узнать, как получить токен.

Если вам нужно изменить токен клиента после установки, используйте <code>--set-tenant-token</code> в интерфейсе командной строки ЕдиногоАгента.

==== '''Сетевые зоны''' ====
Значение по умолчанию: <code>не установлено</code>

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

Используйте параметр --set-network-zone, чтобы указать ЕдиномуАгенту обмениваться данными через указанную сетевую зону:

<code>--set-network-zone=ваша.сетевая.зона</code>

Если вам нужно изменить назначение сетевой зоны после установки, используйте --set-network-zone в интерфейсе командной строки ЕдиногоАгента.

==== '''Прокси''' ====
Значение по умолчанию: <code>не установлено</code>

Адрес прокси-сервера. Используйте IP-адрес или имя и добавьте номер порта после двоеточия. Для прокси-сервера с проверкой подлинности вы можете указать имя пользователя и пароль, например имя пользователя: пароль@172.1.1.128:8080, где имя пользователя и пароль должны быть указаны в URL-адресе.

Чтобы установить прокси, передайте его как значение параметра:

<code>--set-proxy=172.1.1.128:8080</code>

Dynatrace также поддерживает адреса IPv6.

Если вам нужно изменить адрес прокси-сервера после установки, используйте --set-proxy в интерфейсе командной строки ЕдиногоАгента.

==== '''Диапазон портов''' ====
Значение по умолчанию: <code>50000:50100</code>

Используйте параметр <code>--set-watchdog-portrange=<arg></code>, чтобы изменить диапазон портов прослушивания на <code><arg></code>. <code><arg></code> должен содержать два номера порта, разделенных двоеточием (:). Например <code>50000:50100</code>. Максимальный поддерживаемый диапазон портов — от 1024 до 65535. Диапазон портов должен охватывать не менее 4 портов. Номер порта, начиная с диапазона, должен быть меньше. Например:

<code>--set-watchdog-portrange=50000:50100</code>

Если вам нужно изменить диапазон портов после установки, используйте --set-watchdog-portrange в интерфейсе командной строки ЕдиногоАгента.

==== '''Группа хостов''' ====
Значение по умолчанию: <code>не установлено</code>

Имя группы, к которой вы хотите привязать хост. Дополнительные сведения см. в разделе Организация среды с помощью групп хостов. Требования к строке группы хостов:

* Может содержать только буквенно-цифровые символы, дефисы, символы подчеркивания и точки.
* Не должен начинаться с <code>dt</code>.
* Максимальная длина – 100 символов.

Чтобы назначить хост группе хостов, передайте имя группы хостов в качестве значения параметра:

<code>--set-host-group=My.HostGroup_123-456</code>

Чтобы удалить узел из группы, необходимо удалить ЕдиныйАгент или передать пустое значение <code>--set-host-group=""</code> при запуске обновления ЕдиногоАгента. Вы не можете удалить хост из группы с помощью параметра <code>HOST_GROUP</code> при обновлении ЕдиногоАгента. Дополнительные сведения см. в разделе Настройка ЕдиногоАгента через интерфейс командной строки.

← Предыдущая версия		Версия от 10:38, 11 ноября 2024
Строка 45:		Строка 45:
	'''Значение по умолчанию:''' <code>зависит от среды</code>		'''Значение по умолчанию:''' <code>зависит от среды</code>

	Адрес конечной точки связи ЕдиногоАгента, которая является компонентом ~~Ключ-Астром~~, на который ЕдиныйАгент отправляет данные. В зависимости от вашего развертывания это может быть кластер ~~Ключ-Астром~~ или АктивныйШлюз. Если вы устанавливаете ЕдиныйАгент с помощью страницы развертывания ~~Ключ-Астром~~, для него уже установлено правильное значение. Чтобы изменить его, используйте IP-адрес или имя. Добавьте номер порта после двоеточия.		Адрес конечной точки связи ЕдиногоАгента, которая является компонентом АппОптима, на который ЕдиныйАгент отправляет данные. В зависимости от вашего развертывания это может быть кластер АппОптима или АктивныйШлюз. Если вы устанавливаете ЕдиныйАгент с помощью страницы развертывания АппОптима, для него уже установлено правильное значение. Чтобы изменить его, используйте IP-адрес или имя. Добавьте номер порта после двоеточия.

	Чтобы установить конечную точку связи, передайте ее как значение параметра:		Чтобы установить конечную точку связи, передайте ее как значение параметра:
Строка 51:		Строка 51:
	<code>--set-server=<nowiki>https://100.20.10.1:443</nowiki></code>		<code>--set-server=<nowiki>https://100.20.10.1:443</nowiki></code>

	ЕдиныйАгент и ~~Ключ-Астром~~ Cluster автоматически поддерживают рабочее соединение. Если детали конечной точки изменяются, кластер уведомляет ЕдиныйАгент об изменении, и ЕдиныйАгент автоматически обновляет конечную точку, которую вы установили с помощью --set-server, до нового рабочего значения.		ЕдиныйАгент и АппОптима Cluster автоматически поддерживают рабочее соединение. Если детали конечной точки изменяются, кластер уведомляет ЕдиныйАгент об изменении, и ЕдиныйАгент автоматически обновляет конечную точку, которую вы установили с помощью --set-server, до нового рабочего значения.

	Если вам нужно изменить конечную точку после установки, используйте --set-server в интерфейсе командной строки ЕдиныйАгент.		Если вам нужно изменить конечную точку после установки, используйте --set-server в интерфейсе командной строки ЕдиныйАгент.
Строка 58:		Строка 58:
	'''Значение по умолчанию:''' <code>зависит от среды</code>		'''Значение по умолчанию:''' <code>зависит от среды</code>

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

	Чтобы установить идентификатор среды, передайте его в качестве значения параметра:		Чтобы установить идентификатор среды, передайте его в качестве значения параметра:
Строка 69:		Строка 69:
	'''Значение по умолчанию:''' <code>зависит от среды</code>		'''Значение по умолчанию:''' <code>зависит от среды</code>

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

	Чтобы установить токен, передайте его как значение параметра:		Чтобы установить токен, передайте его как значение параметра:
Строка 99:		Строка 99:
	<code>--set-proxy=172.1.1.128:8080</code>		<code>--set-proxy=172.1.1.128:8080</code>

	~~Ключ-Астром~~ также поддерживает адреса IPv6.		АппОптима также поддерживает адреса IPv6.

	Если вам нужно изменить адрес прокси-сервера после установки, используйте --set-proxy в интерфейсе командной строки ЕдиногоАгента.		Если вам нужно изменить адрес прокси-сервера после установки, используйте --set-proxy в интерфейсе командной строки ЕдиногоАгента.
Строка 190:		Строка 190:
	Чтобы '''определить источник для генерации идентификатора хоста''', используйте <code>--set-host-id-source</code> и установите для него одно из предопределенных значений:		Чтобы '''определить источник для генерации идентификатора хоста''', используйте <code>--set-host-id-source</code> и установите для него одно из предопределенных значений:

	* <code>auto</code> — разрешить ~~Ключ-Астром~~ автоматически генерировать идентификатор хоста.		* <code>auto</code> — разрешить АппОптима автоматически генерировать идентификатор хоста.
	* <code>ip-addresses</code> — Генерировать идентификатор хоста на основе IP-адреса хоста		* <code>ip-addresses</code> — Генерировать идентификатор хоста на основе IP-адреса хоста
	* <code>mac-address</code> — Генерировать идентификатор хоста на основе MAC-адреса сетевой карты хоста.		* <code>mac-address</code> — Генерировать идентификатор хоста на основе MAC-адреса сетевой карты хоста.
Строка 226:		Строка 226:
	'''Значение по умолчанию:''' <code>18125</code>		'''Значение по умолчанию:''' <code>18125</code>

	Вы можете использовать параметр <code>--set-extensions-statsd-port=<arg></code>, чтобы изменить порт прослушивания UDP ~~Ключ-АстромStatsD~~ по умолчанию.		Вы можете использовать параметр <code>--set-extensions-statsd-port=<arg></code>, чтобы изменить порт прослушивания UDP АппОптимаStatsD по умолчанию.

	Дополнительные сведения см. в разделе Прием метрик.		Дополнительные сведения см. в разделе Прием метрик.
Строка 361:		Строка 361:
	Данный параметр определяет имя непривилегированного пользователя, которое используется непривилегированными процессами ЕдиногоАгента. Непривилегированные процессы — это процессы, которым не нужны привилегии root. Эти процессы в Linux называются Network ЕдиныйАгент и Plugin ЕдиныйАгент.		Данный параметр определяет имя непривилегированного пользователя, которое используется непривилегированными процессами ЕдиногоАгента. Непривилегированные процессы — это процессы, которым не нужны привилегии root. Эти процессы в Linux называются Network ЕдиныйАгент и Plugin ЕдиныйАгент.

	* По умолчанию программа установки ~~Ключ-Астром~~ использует <code>dtuser</code> в качестве имени непривилегированного пользователя.		* По умолчанию программа установки АппОптима использует <code>dtuser</code> в качестве имени непривилегированного пользователя.
	* Если указан параметр <code>USER=<username></code>, программа установки использует <code><username></code> в качестве имени непривилегированного пользователя.		* Если указан параметр <code>USER=<username></code>, программа установки использует <code><username></code> в качестве имени непривилегированного пользователя.

	В любом случае программа установки ~~Ключ-Астром~~ проверяет, существует ли уже в системе требуемый пользователь (<code>dtuser</code> или пользователь, указанный в параметре USER).		В любом случае программа установки АппОптима проверяет, существует ли уже в системе требуемый пользователь (<code>dtuser</code> или пользователь, указанный в параметре USER).

	* Если пользователь и группа с одинаковым именем существуют, и эта группа установлена для этого пользователя в качестве основной, пользователь используется для запуска сетевых и подключаемых модулей ЕдиногоАгента.		* Если пользователь и группа с одинаковым именем существуют, и эта группа установлена для этого пользователя в качестве основной, пользователь используется для запуска сетевых и подключаемых модулей ЕдиногоАгента.
	* Если пользователь не существует, программа установки ~~Ключ-Астром~~ создает этого пользователя и группу, а затем запускает непривилегированные процессы с этим новым пользователем.		* Если пользователь не существует, программа установки АппОптима создает этого пользователя и группу, а затем запускает непривилегированные процессы с этим новым пользователем.
	* Если пользователь существует в системе, но не имеет группы с тем же именем, что и основная, установка прерывается — чтобы использовать группу с другим именем, необходимо использовать параметр <code>GROUP</code>.		* Если пользователь существует в системе, но не имеет группы с тем же именем, что и основная, установка прерывается — чтобы использовать группу с другим именем, необходимо использовать параметр <code>GROUP</code>.

← Предыдущая версия		Версия от 15:30, 21 сентября 2023
Строка 153:		Строка 153:
	<code>--set-host-name=myhostname</code>		<code>--set-host-name=myhostname</code>

	Если вам нужно изменить имя хоста после установки, используйте <code>--set-host-name</code> в интерфейсе командной строки ~~OneAgent~~.		Если вам нужно изменить имя хоста после установки, используйте <code>--set-host-name</code> в интерфейсе командной строки ЕдиногоАгента.

	==== '''Пользовательские метаданные хоста''' ====		==== '''Пользовательские метаданные хоста''' ====
Строка 222:		Строка 222:

	==== '''Загрузка показателей StatsD''' ====		==== '''Загрузка показателей StatsD''' ====
	<code>~~OneAgent~~ версии 1.201</code>		<code>ЕдиныйАгент версии 1.201</code>

	'''Значение по умолчанию:''' <code>18125</code>		'''Значение по умолчанию:''' <code>18125</code>
Строка 241:		Строка 241:
	Программа установки создает символическую ссылку <code>/opt/<namespace>/oneagent</code> > <code>/data/<namespace>/agent</code>, и файлы установки ЕдиногоАгента будут помещены в указанный каталог (в данном примере <code>/data/<namespace>/agent</code>). Обратите внимание, что эту символическую ссылку необходимо удалить вручную после удаления ЕдиногоАгента.		Программа установки создает символическую ссылку <code>/opt/<namespace>/oneagent</code> > <code>/data/<namespace>/agent</code>, и файлы установки ЕдиногоАгента будут помещены в указанный каталог (в данном примере <code>/data/<namespace>/agent</code>). Обратите внимание, что эту символическую ссылку необходимо удалить вручную после удаления ЕдиногоАгента.

	'''Примечание'''. Параметр INSTALL_PATH не управляет каталогами журналов и файлов конфигурации ~~OneAgent~~. Чтобы настроить путь журнала, используйте параметр LOG_PATH.		'''Примечание'''. Параметр INSTALL_PATH не управляет каталогами журналов и файлов конфигурации ЕдиногоАгента. Чтобы настроить путь журнала, используйте параметр LOG_PATH.

	===== '''Требования к пользовательскому каталогу''' =====		===== '''Требования к пользовательскому каталогу''' =====
Строка 257:		Строка 257:
	'''Необходимое условие:''' использование этого параметра при включенном SELinux требует, чтобы в вашей системе была доступна утилита semanage.		'''Необходимое условие:''' использование этого параметра при включенном SELinux требует, чтобы в вашей системе была доступна утилита semanage.

	Параметр LOG_PATH позволяет настроить каталог журналов ~~OneAgent~~. Например:		Параметр LOG_PATH позволяет настроить каталог журналов ЕдиногоАгента. Например:

	<code>/bin/sh OneAgent-Linux-1.0.0.sh LOG_PATH=/data/<namespace>/logs</code>		<code>/bin/sh OneAgent-Linux-1.0.0.sh LOG_PATH=/data/<namespace>/logs</code>

← Предыдущая версия		Версия от 17:17, 15 марта 2022
Строка 6:		Строка 6:
	Например:		Например:

	<code>~~Dynatrace-~~OneAgent-Linux.sh --set-host-group=my_host_group --set-infra-only=true</code>		<code>OneAgent-Linux.sh --set-host-group=my_host_group --set-infra-only=true</code>

	==== '''Удаленные параметры установки''' ====		==== '''Удаленные параметры установки''' ====
Строка 217:		Строка 217:
	'''Значение по умолчанию:''' <code>14449</code>		'''Значение по умолчанию:''' <code>14449</code>

	Вы можете использовать параметр <code>--set-extensions-ingest-port=<arg></code>, чтобы изменить порт связи по умолчанию, используемый для локального приема метрик. Порт используется следующими модулями: ЕдиныйАгент REST API, интеграции сценариев ~~(<code>dynatrace_ingest</code>)~~ и Telegraf.		Вы можете использовать параметр <code>--set-extensions-ingest-port=<arg></code>, чтобы изменить порт связи по умолчанию, используемый для локального приема метрик. Порт используется следующими модулями: ЕдиныйАгент REST API, интеграции сценариев и Telegraf.

	Дополнительные сведения см. в разделе Прием метрик.		Дополнительные сведения см. в разделе Прием метрик.
Строка 231:		Строка 231:

	==== '''Путь установки''' ====		==== '''Путь установки''' ====
	'''Значение по умолчанию:''' <code>/opt/~~dynatrace~~/oneagent</code>		'''Значение по умолчанию:''' <code>/opt/<namespace>/oneagent</code>

	'''Необходимое условие:''' использование этого параметра при включенном SELinux требует, чтобы в вашей системе была доступна утилита semanage.		'''Необходимое условие:''' использование этого параметра при включенном SELinux требует, чтобы в вашей системе была доступна утилита semanage.
Строка 237:		Строка 237:
	Параметр <code>INSTALL_PATH</code> разрешает установку в другой каталог. Например:		Параметр <code>INSTALL_PATH</code> разрешает установку в другой каталог. Например:

	<code>/bin/sh ~~Dynatrace-~~OneAgent-AIX-1.0.0.sh INSTALL_PATH=/data/~~dynatrace~~/agent</code>		<code>/bin/sh OneAgent-AIX-1.0.0.sh INSTALL_PATH=/data/<namespace>/agent</code>

	Программа установки создает символическую ссылку <code>/opt/~~dynatrace~~/oneagent</code> > <code>/data/~~dynatrace~~/agent</code>, и файлы установки ЕдиногоАгента будут помещены в указанный каталог (в данном примере <code>/data/~~dynatrace~~/agent</code>). Обратите внимание, что эту символическую ссылку необходимо удалить вручную после удаления ЕдиногоАгента.		Программа установки создает символическую ссылку <code>/opt/<namespace>/oneagent</code> > <code>/data/<namespace>/agent</code>, и файлы установки ЕдиногоАгента будут помещены в указанный каталог (в данном примере <code>/data/<namespace>/agent</code>). Обратите внимание, что эту символическую ссылку необходимо удалить вручную после удаления ЕдиногоАгента.

	'''Примечание'''. Параметр INSTALL_PATH не управляет каталогами журналов и файлов конфигурации OneAgent. Чтобы настроить путь журнала, используйте параметр LOG_PATH.		'''Примечание'''. Параметр INSTALL_PATH не управляет каталогами журналов и файлов конфигурации OneAgent. Чтобы настроить путь журнала, используйте параметр LOG_PATH.
Строка 250:		Строка 250:
	* Значение должно быть абсолютным путем и не должно указывать на корневой каталог тома.		* Значение должно быть абсолютным путем и не должно указывать на корневой каталог тома.
	* Значение не должно быть уже существующей символической ссылкой.		* Значение не должно быть уже существующей символической ссылкой.
	* Значение не должно быть дочерним каталогом <code>/var/lib/~~dynatrace~~</code>.		* Значение не должно быть дочерним каталогом <code>/var/lib/<namespace></code>.

	==== '''Путь журнала''' ====		==== '''Путь журнала''' ====
	'''Значение по умолчанию:''' <code>/var/log/~~dynatrace~~/oneagent</code>		'''Значение по умолчанию:''' <code>/var/log/<namespace>/oneagent</code>

	'''Необходимое условие:''' использование этого параметра при включенном SELinux требует, чтобы в вашей системе была доступна утилита semanage.		'''Необходимое условие:''' использование этого параметра при включенном SELinux требует, чтобы в вашей системе была доступна утилита semanage.
Строка 259:		Строка 259:
	Параметр LOG_PATH позволяет настроить каталог журналов OneAgent. Например:		Параметр LOG_PATH позволяет настроить каталог журналов OneAgent. Например:

	<code>/bin/sh ~~Dynatrace-~~OneAgent-Linux-1.0.0.sh LOG_PATH=/data/~~dynatrace~~/logs</code>		<code>/bin/sh OneAgent-Linux-1.0.0.sh LOG_PATH=/data/<namespace>/logs</code>

	===== '''Требования к пользовательскому каталогу''' =====		===== '''Требования к пользовательскому каталогу''' =====
Строка 268:		Строка 268:
	* Значение должно быть абсолютным путем и не должно указывать на корневой каталог тома.		* Значение должно быть абсолютным путем и не должно указывать на корневой каталог тома.
	* Значение не должно быть уже существующей символической ссылкой.		* Значение не должно быть уже существующей символической ссылкой.
	* Значение не должно быть дочерним каталогом <code>/var/lib/~~dynatrace~~</code>.		* Значение не должно быть дочерним каталогом <code>/var/lib/<namespace></code>.
	* Значение не должно указывать на <code>/opt/~~dynatrace~~/oneagent/log</code>, который является расположением журнала по умолчанию для версий ЕдиногоАгента до 1.203.		* Значение не должно указывать на <code>/opt/<namespace>/oneagent/log</code>, который является расположением журнала по умолчанию для версий ЕдиногоАгента до 1.203.

	===== '''Изменение местоположения''' =====		===== '''Изменение местоположения''' =====
Строка 280:		Строка 280:
	<code>ЕдиныйАгент версии 1.199</code>		<code>ЕдиныйАгент версии 1.199</code>

	'''Значение по умолчанию:''' <code>/var/lib/~~dynatrace~~/oneagent/datastorage</code>		'''Значение по умолчанию:''' <code>/var/lib/<namespace>/oneagent/datastorage</code>

	'''Необходимое условие:''' использование этого параметра при включенном SELinux требует, чтобы в вашей системе была доступна утилита semanage.		'''Необходимое условие:''' использование этого параметра при включенном SELinux требует, чтобы в вашей системе была доступна утилита semanage.
Строка 286:		Строка 286:
	Параметр <code>DATA_STORAGE</code> позволяет определить каталог, предназначенный для хранения больших данных во время выполнения, созданных ЕдинымАгентом в режиме мониторинга полного стека, таких как отчеты о сбоях или дампы памяти. Например:		Параметр <code>DATA_STORAGE</code> позволяет определить каталог, предназначенный для хранения больших данных во время выполнения, созданных ЕдинымАгентом в режиме мониторинга полного стека, таких как отчеты о сбоях или дампы памяти. Например:

	<code>/bin/sh ~~Dynatrace-~~OneAgent-Linux.sh DATA_STORAGE=/data/~~dynatrace~~/runtime</code>		<code>/bin/sh OneAgent-Linux.sh DATA_STORAGE=/data/<namespace>/runtime</code>

	===== '''Требования к пользовательскому каталогу''' =====		===== '''Требования к пользовательскому каталогу''' =====
Строка 295:		Строка 295:
	* Значение должно быть абсолютным путем и не должно указывать на корневой каталог тома.		* Значение должно быть абсолютным путем и не должно указывать на корневой каталог тома.
	* Значение не должно быть уже существующей символической ссылкой.		* Значение не должно быть уже существующей символической ссылкой.
	* Значение не должно быть дочерним каталогом <code>/var/lib/~~dynatrace~~</code>.		* Значение не должно быть дочерним каталогом <code>/var/lib/<namespace></code>.

	===== '''Изменение местоположения''' =====		===== '''Изменение местоположения''' =====
Строка 329:		Строка 329:
	Начиная с версии 1.193, ЕдиныйАгент по умолчанию устанавливается в непривилегированном режиме. Существующие установки не переключаются в непривилегированный режим.		Начиная с версии 1.193, ЕдиныйАгент по умолчанию устанавливается в непривилегированном режиме. Существующие установки не переключаются в непривилегированный режим.

	Чтобы переключить установленный ЕдиныйАгент в непривилегированный режим, вам необходимо вручную добавить параметр <code>NON_ROOT_MODE=1</code> к команде установки. Пример: <code>sudo /bin/sh ~~Dynatrace-~~Agent-Linux-1.0.0.sh NON_ROOT_MODE=1</code>		Чтобы переключить установленный ЕдиныйАгент в непривилегированный режим, вам необходимо вручную добавить параметр <code>NON_ROOT_MODE=1</code> к команде установки. Пример: <code>sudo /bin/sh Agent-Linux-1.0.0.sh NON_ROOT_MODE=1</code>

	Чтобы переключить установщик обратно в режим по умолчанию для последовательных обновлений, запустите его с <code>NON_ROOT_MODE=0</code>.		Чтобы переключить установщик обратно в режим по умолчанию для последовательных обновлений, запустите его с <code>NON_ROOT_MODE=0</code>.
Строка 343:		Строка 343:
	Используется вместе с параметром <code>NON_ROOT_MODE</code> для блокировки уровня разрешений суперпользователя для запуска ЕдиногоАгента в непривилегированном режиме. Привилегии суперпользователя требуются для автоматических обновлений и отдельных операций с версиями ядра между 2.6.26 и 4.3, то есть версиями без поддержки Linux ambient capabilities.		Используется вместе с параметром <code>NON_ROOT_MODE</code> для блокировки уровня разрешений суперпользователя для запуска ЕдиногоАгента в непривилегированном режиме. Привилегии суперпользователя требуются для автоматических обновлений и отдельных операций с версиями ядра между 2.6.26 и 4.3, то есть версиями без поддержки Linux ambient capabilities.

	<code>sudo /bin/sh ~~Dynatrace-~~OneAgent-Linux-1.0.0.sh NON_ROOT_MODE=1 DISABLE_ROOT_FALLBACK=1</code>		<code>sudo /bin/sh OneAgent-Linux-1.0.0.sh NON_ROOT_MODE=1 DISABLE_ROOT_FALLBACK=1</code>

	Чтобы переключить установщик обратно на использование уровня разрешений суперпользователя для последующих обновлений, запустите его с параметром <code>DISABLE_ROOT_FALLBACK=0</code>.		Чтобы переключить установщик обратно на использование уровня разрешений суперпользователя для последующих обновлений, запустите его с параметром <code>DISABLE_ROOT_FALLBACK=0</code>.