Просмотр кода страницы Настройка установки OneAgent в Windows


Установщик OneAgent для Windows предоставляется и используется в виде самораспаковывающегося EXE-файла. Установщик также можно извлечь и использовать напрямую — в виде пакета MSI. Этот более поздний подход в основном используется при развертывании групповой политики.

Вы можете настроить установку, указав параметры командной строки для выбранных параметров, или вы можете полагаться на параметры по умолчанию. Однако обратите внимание, что параметры, отмеченные ниже как <code>зависящие от среды</code>, то есть параметры, которые устанавливают конечную точку связи, идентификатор среды и токен, — это:

* обязательный
* предварительно настроен только для EXE-версии установщика. Поэтому при использовании установщика в качестве MSI-пакета необходимо указывать эти параметры явно.

== Передача параметров установки ==

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

Например, для EXE-версии установщика:
 <code>.\OneAgent-Windows.exe --set-host-group=my_host_group --set-infra-only=true INSTALL_PATH="C:\installdir"</code>
При использовании установщика в качестве пакета MSI вы можете напрямую добавлять только параметры <code>INSTALL_PATH</code>, <code>LOG_PATH</code>, <code>DATA_STORAGE</code>, <code>PCAP_DRIVER</code> и <code>USER</code>. Этот тип установки обычно выполняется в автоматическом режиме как часть развертывания групповой политики. <code>--set-param=<value></code> должен быть помещен внутри <code>ADDITIONAL_CONFIGURATION</code> (<code>ADDITIONAL_CONFIGURATION="--set-param=<value>"</code>).

Дополнительные сведения о синтаксисе командной строки см. в разделе Silent installation.

=== Пользовательский интерфейс установщика ===
Вы также можете добавить параметры <code>--set-param=<value></code> на экране установки настроек конфигурации OneAgent.

Параметры, поддерживаемые пользовательским интерфейсом установщика

Пользовательский интерфейс установщика OneAgent для Windows поддерживает только параметры <code>--set-param=<value></code>.

Следующие параметры НЕ поддерживаются пользовательским интерфейсом установщика: <code>USER</code>, <code>INSTALL_PATH</code>, <code>LOG_PATH</code>, <code>PCAP_DRIVER</code> и <code>DATA_STORAGE</code>.

== Удаленные параметры установки ==
Начиная с версии 1.213, следующие параметры принимаются только в том случае, если они заданы с использованием синтаксиса <code>--set-param=<value></code>. Для этих конкретных параметров эквивалентный синтаксис <code>PARAM=<value></code> больше не поддерживается:
{| 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>INFRA_ONLY</code>
|<code>--set-infra-only</code>
|}

== Параметры установки MSI ==
<code>INSTALL_PATH</code>, <code>LOG_PATH</code>, <code>DATA_STORAGE</code>, <code>PCAP_DRIVER</code> и <code>USER</code> это особый тип параметров, соответствующих синтаксису общедоступных свойств MSI. Они не будут заменены эквивалентными параметрами <code>--set-param=<value></code>. Вы можете использовать их только в командной строке установщика, а не в пользовательском интерфейсе установщика.

== Путь установки ==
Значение по умолчанию: <code>%PROGRAMFILES%\Dynatrace\oneagent</code>

Параметр <code>INSTALL_PATH</code> позволяет установить OneAgent в каталог по вашему выбору.

Например:

<code>.\Dynatrace-OneAgent-Windows.exe INSTALL_PATH="C:\test dir"</code>.

Примечание: Этот параметр не поддерживается пользовательским интерфейсом установщика.

Примечание: Параметр <code>INSTALL_PATH</code> не управляет каталогами журнала и файлов конфигурации OneAgent. Чтобы настроить путь к журналу, используйте параметр <code>LOG_PATH</code>.

=== Требования к пользовательскому каталогу ===
Ваш пользовательский каталог установки должен соответствовать следующим требованиям:

* Каталог должен быть выделен только для целей OneAgent. Никакое другое программное обеспечение не может иметь к нему доступа. Одной из причин является безопасность, а другой - автоматическая очистка, периодически выполняемая OneAgent, которая может удалять файлы, созданные другими приложениями.
* Вы не должны совместно использовать или вкладывать друг в друга каталоги установки, хранения и журнала.
* Значение должно быть абсолютным путем и не должно указывать на каталог корневого тома.
* Значение не должно быть дочерним каталогом %PROGRAMDATA%\Dynatrace.

== Путь к журналу ==
Значение по умолчанию: <code>%PROGRAMDATA%\Dynatrace\oneagent\log</code>

Параметр <code>LOG_PATH</code> позволяет настроить каталог журналов OneAgent.

Например:

<code>.\Dynatrace-OneAgent-Windows.exe LOG_PATH=C:\Dynatrace\logs</code>

Примечание: Этот параметр не поддерживается пользовательским интерфейсом установщика.

=== Требования к пользовательскому каталогу ===
Ваш пользовательский каталог установки должен соответствовать следующим требованиям:

* Каталог должен быть выделен только для целей OneAgent. Никакое другое программное обеспечение не может иметь к нему доступа. Одной из причин является безопасность, а другой - автоматическая очистка, периодически выполняемая OneAgent, которая может удалять файлы, созданные другими приложениями.
* Вы не должны совместно использовать или вкладывать друг в друга каталоги установки, хранения и журнала.
* Значение должно быть абсолютным путем и не должно указывать на каталог корневого тома.
* Значение не должно быть дочерним каталогом %PROGRAMDATA%\Dynatrace.

=== Изменение расположения ===
Если вы используете этот параметр для изменения местоположения для уже установленного OneAgent:

* Существующие файлы не переносятся в новое расположение
* После установки или изменения параметра <code>LOG_PATH</code> необходимо перезапустить процессы с глубоким мониторингом, чтобы один из агентов, отслеживающих их, мог выбрать новый путь для хранения журналов. Вы получите уведомление о необходимости перезапуска соответствующего процесса на странице Обзора процесса.

== Хранение данных ==
OneAgent версии 1.199

Значение по умолчанию: <code>%PROGRAMDATA%\Dynatrace\oneagent\datastorage</code>

Параметр <code>DATA_STORAGE</code> позволяет определить каталог, предназначенный для хранения больших данных во время выполнения, создаваемых OneAgent в режиме мониторинга полного стека, таких как отчеты о сбоях или дампы памяти.

Для примера:

<code>.\Dynatrace-OneAgent-Windows.exe DATA_STORAGE=D:\data\key-astom\runtime</code>

Примечание: Этот параметр не поддерживается пользовательским интерфейсом установщика.

=== Требования к пользовательскому каталогу ===

* Каталог должен быть выделен только для целей OneAgent. Никакое другое программное обеспечение не может иметь к нему доступа. Одной из причин является безопасность, а другой - автоматическая очистка, периодически выполняемая OneAgent, которая может удалять файлы, созданные другими приложениями.
* Вы не должны совместно использовать или вкладывать друг в друга каталоги установки, хранения и журнала.
* Значение должно быть абсолютным путем и не должно указывать на каталог корневого тома.
* Значение не должно быть дочерним каталогом %PROGRAMDATA%\Dynatrace.

=== Изменение расположения ===
Если вы используете этот параметр для изменения местоположения для уже установленного OneAgent:

* Существующие файлы не переносятся в новое расположение
* После установки или изменения параметра <code>DATA_STORAGE</code> необходимо перезапустить процессы с глубоким мониторингом, чтобы один из агентов, отслеживающих их, мог выбрать новый путь для хранения данных во время выполнения. В противном случае дампы памяти и другие данные во время выполнения не будут сохранены. Вы получите уведомление о необходимости перезапуска соответствующего процесса на странице Обзора процесса.

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

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

Чтобы задать конечную точку связи, передайте ее в качестве значения параметра:
 <code>--set-server=<nowiki>https://100.20.10.1:443</nowiki></code>
OneAgent и кластер Dynatrace автоматически поддерживают рабочее соединение. Если сведения о конечной точке изменяются, кластер уведомляет OneAgent об изменении, и OneAgent автоматически обновляет конечную точку, заданную с помощью --set-server, до нового рабочего значения.

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

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

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

Чтобы задать идентификатор среды, передайте его в качестве значения параметра:
 <code>--set-tenant=mySampleEnv</code>
Если вам нужно изменить клиента после установки, используйте <code>--set-tenant</code> в интерфейсе командной строки OneAgent.

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

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

Чтобы установить токен, передайте его в качестве значения параметра:
 <code>--set-tenant-token=abcdefghij123456</code>
См. раздел Токены доступа, чтобы узнать, как получить токен.

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

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

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

Используйте параметр <code>--set-network-zone</code>, чтобы указать OneAgent осуществлять связь через указанную сетевую зону:
 <code>--set-network-zone=your.network.zone</code>
Если вам нужно изменить назначение сетевой зоны после установки, используйте <code>--set-network-zone</code> в интерфейсе командной строки OneAgent.

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

Адрес прокси-сервера. Используйте IP-адрес или имя и добавьте номер порта после двоеточия. Для аутентифицирующего прокси-сервера вы можете указать имя пользователя и пароль следующим образом <code>username:password@172.1.1.128:8080</code> где и имя пользователя, и пароль должны быть закодированы по URL-адресу.

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

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

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

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

== Автоматическое обновление ==
Используйте <code>--set-auto-update-enabled=<arg></code>, чтобы включить или отключить автоматическое обновление OneAgent. Например:
 <code>--set-auto-update-enabled=true</code>
После того, как вы используете эту команду для отключения автоматического обновления, вы не сможете управлять автоматическими обновлениями OneAgent с помощью веб-интерфейса Dynatrace в разделе Настройки > Настройки > Обновления OneAgent.

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

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

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

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

== Режим мониторинга инфраструктуры ==
Значение по умолчанию: <code>false</code>

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

Чтобы включить режим мониторинга инфраструктуры, установите для параметра значение:
 <code>--set-infra-only=true</code>
Чтобы отключить режим мониторинга инфраструктуры, установите для параметра значение:
 <code>--set-infra-only=false</code>
Если вам нужно изменить, включить или отключить режим мониторинга инфраструктуры после установки, используйте  <code>--set-infra-only</code> в интерфейсе командной строки OneAgent или установите его на странице настроек хоста.

== Пользовательское имя хоста ==
Значение по умолчанию: <code>не задано</code>

Используйте параметр <code>--set-hostname</code>, чтобы переопределить автоматически определяемое имя хоста. Значение имени хоста не должно содержать символов <code><</code>, <code>></code>, <code>&</code>, <code>CR</code> (возврат каретки) и <code>LF</code> (перевод строки), а максимальная длина - 256 символов.

Важно: Эта команда добавляет пользовательское имя хоста для отображения в пользовательском интерфейсе, но обнаруженное имя хоста не изменяется. Дополнительные сведения см. в разделе Настройка пользовательских имен узлов.

Чтобы задать имя хоста:
 <code>--set-host-name=myhostname</code>
Если вам нужно изменить имя хоста после установки, используйте <code>--set-host-name</code> в интерфейсе командной строки OneAgent.

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

После настройки пользовательские метаданные отображаются в виде набора свойств в нижней части раздела Свойств и тегов страницы обзора хоста. Значения свойств не должны содержать символов <code>=</code> (кроме разделителя ключ-значение) и пробелов. Максимальная длина - 256 символов, включая разделитель ключ-значение.

Чтобы добавить или изменить свойства хоста:
 <code>--set-host-property=AppName --set-host-property=Environment=Dev</code>
Вы можете добавить или изменить несколько свойств в одной и той же команде.

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

== Пользовательские теги хоста ==
Значение по умолчанию: <code>не задано</code>

После настройки теги отображаются в верхней части раздела Свойств и тегов страницы обзора хоста. Значения свойств не должны содержать символов <code>=</code> (кроме разделителя ключ-значение) и пробелов. Максимальная длина - 256 символов, включая разделитель ключ-значение.

Чтобы добавить или изменить теги хоста:
 <code>--set-host-tag=TestHost --set-host-tag=role=fallback --set-host-tag=Gdansk</code>
Вы можете добавить или изменить несколько тегов в одной и той же команде. Допускается определять теги с одним и тем же ключом, но разными значениями.

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

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

Доступно на всех поддерживаемых платформах для OneAgent версии 1.223+. Для OneAgent версии 1.221 и более ранних версий эта функция поддерживается только для Citrix Virtual Apps and Desktops.

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

Чтобы '''определить источник для генерации идентификатора хоста''', выберите user <code>--set-host-id-source</code> и установите для него одно из предопределенных значений:
* <code>auto</code> — Пусть Dynatrace автоматически сгенерирует идентификатор хоста
* <code>ip-addresses</code> — Генерировать идентификатор хоста на основе IP-адреса хоста
* <code>mac-address</code> — Сгенерируйте идентификатор хоста на основе MAC адреса сетевой карты хоста
* <code>fqdn</code> — Создайте идентификатор хоста на основе полного доменного имени хоста (FQDN) в формате <code>host.domain</code>. Если полное доменное имя не содержит символа точки, вместо него используется MAC-адрес сетевой карты.
* Если вы отслеживаете несколько сред, вы можете разделить хосты с одинаковыми IP-адресами, MAC-адресами или полными доменными именами, используя разные пространства имен для каждой среды. Пространство имен может содержать только буквенно-цифровые символы, дефисы, подчеркивания и точки; максимальная длина - 256 символов:

* <code>ip-addresses;namespace=<namespace></code>
* <code>mac-addresses;namespace=<namespace></code>
* <code>fqdn;namespace=<namespace></code>

Например, чтобы установить для источника hostID <code>ip-адреса</code> и назначить его пространству имен с именем <code>test</code>, запустите программу установки OneAgent со следующим параметром:
 <code>--set-host-id-source="ip-addresses;namespace=test"</code>

== Доступ к системным журналам ==
OneAgent может загружать системные журналы с целью диагностики проблем, которые могут быть вызваны условиями в вашей среде. OneAgent в настоящее время не загружает никаких системных журналов Windows, но это может измениться в будущих версиях.

<code>--set-system-logs-access-enabled=false</code> отключает доступ к журналам

<code>--set-system-logs-access-enabled=true</code> включает доступ к журналам

Если вам нужно изменить этот доступ после установки, используйте интерфейс командной строки OneAgent:

Обратите внимание, что это параметр самодиагностики, который не связан с мониторингом журнала.

== Мониторинг лога ==
Значение по умолчанию: <code>true</code>

Если установлено значение <code>true</code>, позволяет OneAgent получать доступ к файлам журнала с целью мониторинга лога. Допустимыми значениями являются (<code>true</code>, <code>false</code>) или (<code>1</code>, <code>0</code>). В качестве альтернативы эту опцию можно включить/отключить через веб-интерфейс.

Например: <code>--set-app-log-content-access=true</code>

Если вам нужно включить или отключить мониторинг журналов после установки, используйте <code>-set-app-log-content-access</code> в интерфейсе командной строки OneAgent.

== Автоматическая инъекция ==
OneAgent версия 1.213

Значение по умолчанию: <code>true</code>

Вы можете установить для параметра <code>--set-auto-injection-enabled=<arg></code> значение <code>true</code> или <code>false</code>, чтобы отключить или включить автоматическую инъекцию OneAgent.

Дополнительные сведения см. в разделе Автоматическая инъекция.

== Прием локальных метрик ==
OneAgent версия 1.201

Значение по умолчанию: <code>14449</code>

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

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

== Получение метрик StatsD ==
OneAgent версия 1.201

Значение по умолчанию: <code>18125</code>

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

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

== Пользователь расширения OneAgent ==
Значение по умолчанию: <code>LocalSystem</code> (OneAgent версия 1.195+. Для более ранних версий - <code>dtuser</code>)

Используйте параметр <code>USER</code>, чтобы указать пользователя, запускающего процесс, отвечающий за функциональность расширений Dynatrace OneAgent. Например:

<code>.\Dynatrace-OneAgent-Windows.exe USER=LocalService</code>

Примечание. Этот параметр не поддерживается пользовательским интерфейсом установщика.

Если вы не добавите параметр <code>USER</code>:

* Для новых установок OneAgent 1.195+ учетная запись <code>LocalSystem</code> по умолчанию будет использоваться для запуска расширений OneAgent.
* Для новых развертываний OneAgent до версии 1.195 OneAgent будет использовать учетную запись <code>dtuser</code>.
* Обновление OneAgent сохраняет ранее настроенную учетную запись пользователя. Чтобы изменить его, необходимо переустановить OneAgent, задав для параметра <code>USER</code> новое значение.


Параметр <code>USER</code> может иметь одно из следующих значений:

* <code>Рекомендуемое</code> <code>LocalSystem</code> — это учетная запись пользователя по умолчанию, используемая для запуска расширений OneAgent, начиная с версии 1.195. Применяется автоматически, если параметр <code>USER</code> не используется. Это значение параметра заставляет OneAgent использовать привилегированную системную учетную запись <code>NT AUTHORITY\SYSTEM</code> для запуска расширений OneAgent. По сути, локальная учетная запись пользователя не создается. В результате все модули OneAgent, включая все расширения, полностью функциональны. Это рекомендуемый параметр для всех установок OneAgent Windows, начиная с версии 1.191.
* <code>LocalService</code>: этот параметр заставляет OneAgent использовать системную учетную запись <code>NT AUTHORITY\LOCAL SERVICE</code> для запуска расширений OneAgent. Хотя этого ограниченного набора привилегий достаточно для работы большинства расширений, есть некоторые, которые не смогут эффективно создавать данные (а именно, расширения, которые собирают счетчики системного монитора, такие как расширения MS SQL или .NET). Если вы не уверены, какие расширения вы можете использовать, лучше вместо этого использовать значение параметра <code>LocalSystem</code>.
* '''<code>Устарело</code>''' <code>no_create</code> отключал создание пользователей при установке OneAgent до версии 1.209. Начиная с версии 1.209, при использовании параметра <code>no_create</code> программа установки OneAgent применяет параметр <code>LocalSystem</code> без предупреждения. Параметр <code>no_create</code> не преобразуется в <code>LocalSystem</code> для существующих установок при запуске обновления. Для преобразования необходимо переустановить OneAgent, задав для параметра <code>USER</code> новое значение.
* '''<code>Устарело</code>''' <code>dtuser</code> был учетной записью пользователя по умолчанию, которая использовалась для запуска расширений OneAgent до версии 1.195. Это заставляло установщика создавать локальную учетную запись пользователя с таким же именем в системе. Начиная с версии 1.209, при использовании параметра <code>dtuser</code> программа установки OneAgent применяет параметр <code>LocalSystem</code> без предупреждения. Начиная с версии 1.239, параметр <code>dtuser</code> преобразуется в <code>LocalSystem</code> для существующих установок при запуске обновления.

При развертывании Dynatrace на контроллере домена Windows Server убедитесь, что для параметра <code>USER</code> установлено значение <code>LocalSystem</code> или, в качестве альтернативы, <code>LocalService</code>, чтобы избежать распространения <code>dtuser</code> по всему домену, что может вызвать помехи для существующих учетных записей <code>dtuser</code> на хостах, на которых установлен Dynatrace.

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

'''Примечание''': Параметры среды предварительно настроены только для EXE-версии программы установки. При использовании установщика в виде MSI-пакета все эти параметры необходимо указать самостоятельно.

=== Пакет MSI — тихая установка ===
Чтобы настроить тихую установку из командной строки при использовании пакета MSI, добавьте /quiet /qn, как в следующих примерах:

==== Command shell ====
 <code>msiexec /i C:\some\path\Dynatrace-OneAgent-Windows.msi ADDITIONAL_CONFIGURATION="--set-server=<nowiki>https://someserver.com</nowiki> --set-tenant=xxx --set-tenant-token=xxx --set-host-group=myGroup" /quiet /qn</code>

==== PowerShell 3.0+ ====
 <code>msiexec /i C:\some\path\Dynatrace-OneAgent-Windows.msi --% ADDITIONAL_CONFIGURATION="--set-server=<nowiki>https://someserver.com</nowiki> --set-tenant=xxx --set-tenant-token=xxx --set-host-group=myGroup" /quiet /qn</code>
Обратите внимание на символ <code>--%</code> stop-parsing, используемый в команде PowerShell.

=== EXE-установщик — тихая установка ===
Чтобы настроить тихую установку из командной строки для EXE-версии установщика, добавьте <code>--quiet</code>, как в этом примере:
 <code>.\Dynatrace-OneAgent-Windows.exe --set-host-group="myGroup" --quiet</code>

== Драйвер захвата пакетов (pcap) ==
OneAgent версия 1.229+

Параметр <code>PCAP_DRIVER</code> позволяет указать, какой драйвер перехвата пакетов будет установлен и использован для сбора сетевых показателей.

Возможные значения:

<code>npcap</code> — установить драйвер <code>Npcap</code>. Эта опция удалит любую существующую установку <code>Npcap</code> или <code>WinPcap</code>.

<code>winpcap</code> — установить драйвер <code>WinPcap</code>. Эта опция '''НЕ''' удалит и не перекроет любую существующую установку <code>Npcap</code> или <code>WinPcap</code>.

<code>auto</code> — автоматически определяет, какой драйвер установить. Эта опция '''НЕ''' удалит и не перекроет любую существующую установку <code>Npcap</code> или <code>WinPcap</code>. По умолчанию установлен <code>Npcap</code>, за исключением <code>Windows Server 2019 build 1809 без исправления KB4571748</code>, где из соображений совместимости установлен <code>WinPcap</code>.

Значение по умолчанию: <code>auto</code>

Например:
 <code>.\Dynatrace-OneAgent-Windows.exe PCAP_DRIVER=npcap</code>
Примечание:

* Этот параметр не поддерживается пользовательским интерфейсом установщика.
* Значение этого параметра сохраняется при обновлениях.

Для получения дополнительной информации см.

* [[OneAgent Безопасность в Windows]]
* [[Установка OneAgent в Windows]]