Настройка установки OneAgent в Windows: различия между версиями

Материал из Dynatrace
(Новая страница: « Установщик ЕдиногоАгента для Windows предоставляется и используется в виде самораспаковы...»)
 
Строка 171: Строка 171:
Если вам нужно изменить назначение сетевой зоны после установки, используйте <code>--set-network-zone</code> в интерфейсе командной строки ЕдиногоАгента.
Если вам нужно изменить назначение сетевой зоны после установки, используйте <code>--set-network-zone</code> в интерфейсе командной строки ЕдиногоАгента.


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


The address of the proxy server. Use the IP address or a name, and add the port number following a colon. For an authenticating proxy you can specify a username and password like this <code>username:password@172.1.1.128:8080</code> where both username and password need to be URL encoded.
Адрес прокси-сервера. Используйте IP-адрес или имя и добавьте номер порта после двоеточия. Для аутентифицирующего прокси-сервера вы можете указать имя пользователя и пароль следующим образом <code>username:password@172.1.1.128:8080</code> где и имя пользователя, и пароль должны быть закодированы по URL-адресу.


To set a proxy, pass it as a parameter value:
Чтобы установить прокси, передайте его в качестве значения параметра:
  <code>--set-proxy=172.1.1.128:8080</code>
  <code>--set-proxy=172.1.1.128:8080</code>
Dynatrace also supports IPv6 addresses.
Ключ-Астром также поддерживает IPv6-адреса.


If you need to change the proxy address after installation, use <code>--set-proxy</code> in the OneAgent command-line interface.
Если вам нужно изменить адрес прокси-сервера после установки, используйте <code>--set-proxy</code> в интерфейсе командной строки ЕдиногоАгента.


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


Use the <code>--set-watchdog-portrange=<arg></code> parameter to change the watchdog listening port range to <code><arg></code>. The <code><arg></code> must contain two port numbers separated by a colon (<code>:</code>). For example <code>50000:50100</code>. The maximum supported port range is from 1024 to 65535. The port range must cover at least 4 ports. The port number starting the range must be lower. For example:
Используйте параметр <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=50000:50100</code>
If you need to change port range after installation, use <code>--set-watchdog-portrange</code> in OneAgent command-line interface.
Если вам нужно изменить диапазон портов после установки, используйте <code>--set-watchdog-portrange</code> в интерфейсе командной строки ЕдиногоАгента.


== Auto-update ==
== Автоматическое обновление ==
Use the <code>--set-auto-update-enabled=<arg></code> to enable or disable OneAgent auto-update. For example:
Используйте <code>--set-auto-update-enabled=<arg></code>, чтобы включить или отключить автоматическое обновление ЕдиногоАгента. Например:
  <code>--set-auto-update-enabled=true</code>
  <code>--set-auto-update-enabled=true</code>
After you use this command to disable auto-updates, you won't be able to control OneAgent automatic updates using the Dynatrace web UI at Settings > Preferences > OneAgent updates.
После того, как вы используете эту команду для отключения автоматического обновления, вы не сможете управлять автоматическими обновлениями ЕдиногоАгента с помощью веб-интерфейса Ключ-Астром в разделе Настройки > Настройки > Обновления ЕдиногоАгента.


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


The name of a group you want to assign the host to. For details, see Organize your environment using host groups. Host group string requirements:
Имя группы, которой вы хотите назначить хост. Дополнительные сведения см. в разделе Организация среды с помощью групп хостов. Требования к строкам группы хостов:


* Can contain only alphanumeric characters, hyphens, underscores, and periods
* Может содержать только буквенно-цифровые символы, дефисы, подчеркивания и точки
* Must not start with <code>dt.</code>
* Не должно начинаться с dt.
* Maximum length is 100 characters
* Максимальная длина - 100 символов


To assign a host to the host group, pass the host group name as a parameter value:
Чтобы назначить узел группе узлов, передайте имя группы узлов в качестве значения параметра:
  <code>--set-host-group=My.HostGroup_123-456</code>
  <code>--set-host-group=My.HostGroup_123-456</code>
To remove the host from a group, you must uninstall OneAgent or pass an empty value <code>--set-host-group=""</code> when running a OneAgent update. You can't remove the host from a group using the <code>HOST_GROUP</code> parameter when updating OneAgent. For more information, see OneAgent configuration via command-line interface.
Чтобы удалить хост из группы, необходимо удалить ЕдиныйАгент или передать пустое значение <code>--set-host-group=""</code> при запуске обновления для ЕдиногоАгента. Вы не можете удалить хост из группы, используя параметр <code>HOST_GROUP</code> при обновлении ЕдиногоАгента. Дополнительные сведения см. в разделе Настройка ЕдиногоАгента через интерфейс командной строки.


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


Activates Infrastructure monitoring mode, in place of full-stack monitoring mode. With this approach, you receive infrastructure-only health data, with no application or user performance data.
Активирует режим мониторинга инфраструктуры вместо режима мониторинга полного стека. При таком подходе вы получаете данные о работоспособности только инфраструктуры, без каких-либо данных о производительности приложений или пользователей.


To enable Infrastructure monitoring mode, set the parameter to:
Чтобы включить режим мониторинга инфраструктуры, установите для параметра значение:
  <code>--set-infra-only=true</code>
  <code>--set-infra-only=true</code>
To disable Infrastructure monitoring mode, set the parameter to:
Чтобы отключить режим мониторинга инфраструктуры, установите для параметра значение:
  <code>--set-infra-only=false</code>
  <code>--set-infra-only=false</code>
If you need to change, enable, or disable Infrastructure monitoring mode after installation, use <code>--set-infra-only</code> in OneAgent command-line interface or set it using the Host settings page.
Если вам нужно изменить, включить или отключить режим мониторинга инфраструктуры после установки, используйте  <code>--set-infra-only</code> в интерфейсе командной строки ЕдиногоАгента или установите его на странице настроек хоста.


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


Use the <code>--set-host-name</code> to override an automatically detected host name. The host name value must not contain the <code><</code>, <code>></code>, <code>&</code>, <code>CR</code> (carriage return), and <code>LF</code> (line feed) characters and the maximum length is 256 characters.
Используйте параметр <code>--set-hostname</code>, чтобы переопределить автоматически определяемое имя хоста. Значение имени хоста не должно содержать символов <code><</code>, <code>></code>, <code>&</code>, <code>CR</code> (возврат каретки) и <code>LF</code> (перевод строки), а максимальная длина - 256 символов.


Important: This command adds a custom host name to display in the UI, but the detected host name is not changed. For details, see Set custom host names.
Важно: Эта команда добавляет пользовательское имя хоста для отображения в пользовательском интерфейсе, но обнаруженное имя хоста не изменяется. Дополнительные сведения см. в разделе Настройка пользовательских имен узлов.


To set the host name:
Чтобы задать имя хоста:
  <code>--set-host-name=myhostname</code>
  <code>--set-host-name=myhostname</code>
If you need to change the host name after installation, use <code>--set-host-name</code> in OneAgent command-line interface.
Если вам нужно изменить имя хоста после установки, используйте <code>--set-host-name</code> в интерфейсе командной строки ЕдиногоАгента.


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


Once configured, custom metadata is displayed as a set of properties at the bottom of the Properties and tags section of the host overview page. The property values must not contain the <code>=</code> (except key-value delimiter) and whitespace characters. The maximum length is 256 characters including the key-value delimiter.
После настройки пользовательские метаданные отображаются в виде набора свойств в нижней части раздела Свойств и тегов страницы обзора хоста. Значения свойств не должны содержать символов <code>=</code> (кроме разделителя ключ-значение) и пробелов. Максимальная длина - 256 символов, включая разделитель ключ-значение.


To add or change host properties:
Чтобы добавить или изменить свойства хоста:
  <code>--set-host-property=AppName --set-host-property=Environment=Dev</code>
  <code>--set-host-property=AppName --set-host-property=Environment=Dev</code>
You can add or change more than one property in the same command.
Вы можете добавить или изменить несколько свойств в одной и той же команде.


If you need to change the host metadata after installation, use <code>--set-host-property</code> OneAgent command-line interface.
Если вам нужно изменить метаданные хоста после установки, используйте <code>--set-host-property</code> в интерфейсе командной строки ЕдиногоАгента.


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


Once configured, the tags are displayed at the top of the Properties and tags section of the host overview page. The property values must not contain the <code>=</code> (except key-value delimiter) and whitespace characters. The maximum length is 256 characters including the key-value delimiter.
После настройки теги отображаются в верхней части раздела Свойств и тегов страницы обзора хоста. Значения свойств не должны содержать символов <code>=</code> (кроме разделителя ключ-значение) и пробелов. Максимальная длина - 256 символов, включая разделитель ключ-значение.


To add or change host tags:
Чтобы добавить или изменить теги хоста:
  <code>--set-host-tag=TestHost --set-host-tag=role=fallback --set-host-tag=Gdansk</code>
  <code>--set-host-tag=TestHost --set-host-tag=role=fallback --set-host-tag=Gdansk</code>
You can add or change more than one tag in the same command. It is allowed to define tags with the same key but different values.
Вы можете добавить или изменить несколько тегов в одной и той же команде. Допускается определять теги с одним и тем же ключом, но разными значениями.


If you need to change the host tags after installation, use <code>--set-host-tag</code> in OneAgent command-line interface.
Если вам нужно изменить теги хоста после установки, используйте <code>--set-host-tag</code> в интерфейсе командной строки ЕдиногоАгента.


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


Available on all supported platforms for OneAgent version 1.223+. For OneAgent version 1.221 and earlier, this feature is supported only for Citrix Virtual Apps and Desktops.
Доступно на всех поддерживаемых платформах для одного агента версии 1.223+. Для ЕдиногоАгента версии 1.221 и более ранних версий эта функция поддерживается только для Citrix Virtual Apps and Desktops.


It's particularly important to keep you host ID static in dynamic virtual environments where hosts are recreated on a daily basis.
Особенно важно сохранять статический идентификатор хоста в динамических виртуальных средах, где хосты воссоздаются ежедневно.


To define the source for host ID generation, use <code>--set-host-id-source</code> and set it to one of the predefined values:
Чтобы '''определить источник для генерации идентификатора хоста''', выберите user <code>--set-host-id-source</code> и установите для него одно из предопределенных значений:
 
* <code>auto</code> — Пусть Ключ-Астром автоматически сгенерирует идентификатор хоста
* <code>auto</code> — Let Dynatrace generate the host ID automatically
* <code>ip-addresses</code> — Генерировать идентификатор хоста на основе IP-адреса хоста
* <code>ip-addresses</code> — Generate host ID based on the host IP address
* <code>mac-address</code> — Сгенерируйте идентификатор хоста на основе MAC адреса сетевой карты хоста
* <code>mac-address</code> — Generate host ID based on the host's NIC MAC address
* <code>fqdn</code> — Создайте идентификатор хоста на основе полного доменного имени хоста (FQDN) в формате <code>host.domain</code>. Если полное доменное имя не содержит символа точки, вместо него используется MAC-адрес сетевой карты.
* <code>fqdn</code> — Generate host ID based on the host fully qualified domain name (FQDN) in the <code>host.domain</code> format. If the FQDN doesn't contain a dot character, the NIC MAC address is used instead.
* Если вы отслеживаете несколько сред, вы можете разделить хосты с одинаковыми IP-адресами, MAC-адресами или полными доменными именами, используя разные пространства имен для каждой среды. Пространство имен может содержать только буквенно-цифровые символы, дефисы, подчеркивания и точки; максимальная длина - 256 символов:
* If you monitor multiple environments, you can split the hosts with identical IPs, MAC addresses, or FQDNs using a different namespace for each environment. The namespace can contain only alphanumeric characters, hyphens, underscores, and periods; the maximum length is 256 characters:


* <code>ip-addresses;namespace=<namespace></code>
* <code>ip-addresses;namespace=<namespace></code>
Строка 270: Строка 269:
* <code>fqdn;namespace=<namespace></code>
* <code>fqdn;namespace=<namespace></code>


For example, to set the host ID source to <code>ip-addresses</code> and assign it to a namespace called <code>test</code>, run the OneAgent installer with the following parameter:
Например, чтобы установить для источника hostID <code>ip-адреса</code> и назначить его пространству имен с именем <code>test</code>, запустите программу установки ЕдиногоАгента со следующим параметром:
  <code>--set-host-id-source="ip-addresses;namespace=test"</code>
  <code>--set-host-id-source="ip-addresses;namespace=test"</code>


== Access to system logs ==
== Доступ к системным журналам ==
OneAgent can download system logs for the purpose of diagnosing issues that may be caused by conditions in your environment. OneAgent doesn't currently download any Windows system logs, but this can change in future releases.
ЕдиныйАгент может загружать системные журналы с целью диагностики проблем, которые могут быть вызваны условиями в вашей среде. ЕдиныйАгент в настоящее время не загружает никаких системных журналов Windows, но это может измениться в будущих версиях.
 
<code>--set-system-logs-access-enabled=false</code> отключает доступ к журналам
 
<code>--set-system-logs-access-enabled=true</code> включает доступ к журналам


<code>--set-system-logs-access-enabled=false</code> disables access to logs
Если вам нужно изменить этот доступ после установки, используйте интерфейс командной строки ЕдиногоАгента:


<code>--set-system-logs-access-enabled=true</code> enables access to logs
Обратите внимание, что это параметр самодиагностики, который не связан с мониторингом журнала.


If you need to change this access after installation, use the OneAgent command-line interface:
== Мониторинг лога ==
Значение по умолчанию: <code>true</code>


Note that this is a self-diagnostics setting that is not related to Log Monitoring.
Если установлено значение <code>true</code>, позволяет одному агенту получать доступ к файлам журнала с целью мониторинга лога. Допустимыми значениями являются (<code>true</code>, <code>false</code>) или (<code>1</code>, <code>0</code>). В качестве альтернативы эту опцию можно включить/отключить через веб-интерфейс.


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


When set to <code>true</code>, allows OneAgent to access log files for the purpose of Log Monitoring. Accepted values are (<code>true</code>, <code>false</code>) or (<code>1</code>, <code>0</code>). This option can alternatively be enabled/disabled through the Web UI.
Если вам нужно включить или отключить мониторинг журналов после установки, используйте <code>-set-app-log-content-access</code> в интерфейсе командной строки ЕдиногоАгента.


For example: <code>--set-app-log-content-access=true</code>
== Автоматическая инъекция ==
ЕдиныйАгент версия 1.213


If you need to enable or disable Log Monitoring after installation, use <code>-set-app-log-content-access</code> in OneAgent command-line interface.
Значение по умолчанию: <code>true</code>


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


Default value: <code>true</code>
Дополнительные сведения см. в разделе Автоматическая инъекция.


You can set the <code>--set-auto-injection-enabled=<arg></code> parameter to <code>true</code> or <code>false</code> to disable or enable OneAgent auto-injection.
== Прием локальных метрик ==
ЕдиныйАгент версия 1.201


For more information, see Automatic injection.
Значение по умолчанию: <code>14449</code>


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


Default value: <code>14449</code>
Дополнительные сведения см. в разделе Прием метрик.


You can use the <code>--set-extensions-ingest-port=<arg></code> parameter to change the default communication port used for local metric ingestion. The port is used by OneAgent REST API, Scripting integration (<code>dynatrace_ingest</code>), and Telegraf.
== Получение метрик StatsD ==
ЕдиныйАгент версия 1.201


For more information, see Metric ingestion.
Значение по умолчанию: <code>18125</code>


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


Default value: <code>18125</code>
Дополнительные сведения см. в разделе Прием метрик.


You can use the <code>--set-extensions-statsd-port=<arg></code> parameter to change the default DynatraceStatsD UDP listening port.
== Пользователь расширения ЕдиныйАгент ==
Значение по умолчанию: <code>LocalSystem</code> (ЕдиныйАгент версия 1.195+. Для более ранних версий - <code>dtuser</code>)


For more information, see Metric ingestion.
Используйте параметр <code>USER</code>, чтобы указать пользователя, запускающего процесс, отвечающий за функциональность расширений Ключ-Астром ЕдиныйАгент. Например:


== OneAgent extension user ==
<code>.\Key-Astrom-OneAgent-Windows.exe USER=LocalService</code>
The Default value: <code>LocalSystem</code> (OneAgent version 1.195+. For earlier versions, it's <code>dtuser</code>)


Use the <code>USER</code> parameter to define the user running the process responsible for Dynatrace OneAgent extensions functionality. For example:
Примечание. Этот параметр не поддерживается пользовательским интерфейсом установщика.


<code>.\Dynatrace-OneAgent-Windows.exe USER=LocalService</code>
Если вы не добавите параметр <code>USER</code>:


Note: This parameter is not supported by the installer UI.
* Для новых установок ЕдиногоАгента 1.195+ учетная запись <code>LocalSystem</code> по умолчанию будет использоваться для запуска расширений ЕдиногоАгента.
* Для новых развертываний ЕдиногоАгента до версии 1.195 ЕдиныйАгент будет использовать учетную запись <code>dtuser</code>.
* Обновление ЕдиногоАгента сохраняет ранее настроенную учетную запись пользователя. Чтобы изменить его, необходимо переустановить ЕдиныйАгент, задав для параметра <code>USER</code> новое значение.


If you don't add the <code>USER</code> parameter:


* For fresh OneAgent 1.195+ installations, the default <code>LocalSystem</code> account will be used to run OneAgent extensions.
Параметр <code>USER</code> может иметь одно из следующих значений:
* For fresh OneAgent deployments prior to version 1.195, OneAgent will use the <code>dtuser</code> account.
* Updating the OneAgent preserves the previously configured user account. To change it, you must reinstall OneAgent setting the <code>USER</code> parameter to a new value.


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


* Recommended <code>LocalSystem</code> is the default user account used to run OneAgent extensions starting with OneAgent version 1.195. Applied automatically when the <code>USER</code> parameter isn't used. This parameter value makes OneAgent use the <code>NT AUTHORITY\SYSTEM</code> privileged system account to run OneAgent extensions. Effectively, no local user account is created. As a result, all OneAgent modules, including all extensions, are fully functional. This is the recommended setting to use for all OneAgent Windows installations starting with OneAgent version 1.191.
При развертывании Ключ-Астром на контроллере домена Windows Server убедитесь, что для параметра <code>USER</code> установлено значение <code>LocalSystem</code> или, в качестве альтернативы, <code>LocalService</code>, чтобы избежать распространения <code>dtuser</code> по всему домену, что может вызвать помехи для существующих учетных записей <code>dtuser</code> на хостах, на которых установлен Ключ-Астром.
* <code>LocalService</code>: This parameter makes OneAgent use the <code>NT AUTHORITY\LOCAL SERVICE</code> system account to run OneAgent extensions. While this reduced set of privileges is enough for most of the extensions to operate, there are some that won't be able to produce data effectively (namely, extensions that collect Performance Monitor counters, such as MS SQL or .NET extensions). If you're unsure about which extensions you might use, it's best to use the <code>LocalSystem</code> parameter value instead.
* Deprecated <code>no_create</code> disabled user creation when installing OneAgent prior to OneAgent version 1.209. Starting with the version 1.209, when you use the <code>no_create</code> parameter, the OneAgent installer applies the <code>LocalSystem</code> parameter without any warning. The <code>no_create</code> setting is not converted to <code>LocalSystem</code> for existing installations when running an update. To convert, you must reinstall OneAgent setting the <code>USER</code> parameter to a new value.
* Deprecated <code>dtuser</code> was the default user account used to run OneAgent extensions prior to OneAgent version 1.195. It made the installer create a local user account with the same name in the system. Starting with the version 1.209, when you use the <code>dtuser</code> parameter, the OneAgent installer applies the <code>LocalSystem</code> parameter without any warning. Starting with OneAgent version 1.239, the <code>dtuser</code> setting is converted to <code>LocalSystem</code> for existing installations when running an update.


When deploying Dynatrace on Windows Server Domain Controller, make sure the <code>USER</code> parameter is set to <code>LocalSystem</code>, or alternatively <code>LocalService</code>, to avoid propagation of <code>dtuser</code> across the domain, which can cause interference with existing <code>dtuser</code> accounts on hosts that have Dynatrace installed.
== Тихая установка ==
При использовании режима тихой установки установщик ЕдиногоАгента должен быть предварительно настроен с соответствующими значениями параметров, поскольку интерактивные диалоговые окна и подсказки не будут отображаться во время установки.  


== Silent installation ==
'''Примечание''': Параметры среды предварительно настроены только для EXE-версии программы установки. При использовании установщика в виде MSI-пакета все эти параметры необходимо указать самостоятельно.
When using the silent installation mode, the OneAgent installer should be pre-configured with appropriate parameter values, since interactive dialogs and prompts will not be displayed during installation. Note: The environment specific parameters are preconfigured only for the EXE version of the installer. When using the installer in the form of an MSI package, you must specify all of these parameters yourself.


=== MSI package—silent installation ===
=== Пакет MSI — тихая установка ===
To set up silent command-line installation when using an MSI package, add <code>/quiet /qn</code> as in these examples:
Чтобы настроить тихую установку из командной строки при использовании пакета MSI, добавьте /quiet /qn, как в следующих примерах:


==== Command shell ====
==== 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>
  <code>msiexec /i C:\some\path\Key-Astrom-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+ ====
==== 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>msiexec /i C:\some\path\Key-Astrom-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>
Note the <code>--%</code> stop-parsing symbol used in the PowerShell command.
Обратите внимание на символ <code>--%</code> stop-parsing, используемый в команде PowerShell.


=== EXE installer—silent installation ===
=== EXE-установщик — тихая установка ===
To set up silent command-line installation for an EXE version of the installer, add <code>--quiet</code> as in this example:
Чтобы настроить тихую установку из командной строки для EXE-версии установщика, добавьте <code>--quiet</code>, как в этом примере:
  <code>.\Dynatrace-OneAgent-Windows.exe --set-host-group="myGroup" --quiet</code>
  <code>.\Key-Astrom-OneAgent-Windows.exe --set-host-group="myGroup" --quiet</code>


== Packet capture driver (pcap) ==
== Драйвер захвата пакетов (pcap) ==
OneAgent version 1.229+
ЕдиныйАгент версия 1.229+


The <code>PCAP_DRIVER</code> parameter allows you to specify which packet capture driver will be installed and used for network metrics collection.
Параметр <code>PCAP_DRIVER</code> позволяет указать, какой драйвер перехвата пакетов будет установлен и использован для сбора сетевых показателей.


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


<code>npcap</code>—install the <code>Npcap</code> driver. This option will uninstall any existing installation of <code>Npcap</code> or <code>WinPcap</code>
<code>npcap</code> — установить драйвер <code>Npcap</code>. Эта опция удалит любую существующую установку <code>Npcap</code> или <code>WinPcap</code>.


<code>winpcap</code>—install the <code>WinPcap</code> driver. This option will NOT uninstall or overlay any existing installation of <code>Npcap</code>or <code>WinPcap</code>.
<code>winpcap</code> — установить драйвер <code>WinPcap</code>. Эта опция '''НЕ''' удалит и не перекроет любую существующую установку <code>Npcap</code> или <code>WinPcap</code>.


<code>auto</code>—automatically determine which driver to install. This option will NOT uninstall or overlay any existing installation of <code>Npcap</code>or <code>WinPcap</code>. By default, <code>Npcap</code> is installed, except for <code>Windows Server 2019 build 1809 without hotfix KB4571748</code>, where, for compatibility reasons, <code>WinPcap</code> is installed.
<code>auto</code> — автоматически определяет, какой драйвер установить. Эта опция '''НЕ''' удалит и не перекроет любую существующую установку <code>Npcap</code> или <code>WinPcap</code>. По умолчанию установлен <code>Npcap</code>, за исключением <code>Windows Server 2019 build 1809 без исправления KB4571748</code>, где из соображений совместимости установлен <code>WinPcap</code>.


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


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


* This parameter is not supported by the installer UI.
* Этот параметр не поддерживается пользовательским интерфейсом установщика.
* The value of this parameter persists through updates.
* Значение этого параметра сохраняется при обновлениях.


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


* OneAgent security on Windows
* [[ЕдиныйАгент Безопасность в Windows]]
* Install OneAgent on Windows
* [[Установка ЕдиногоАгента в Windows]]

Версия 16:32, 30 июля 2022


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

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

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

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

Командная строка

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

Например, для EXE-версии установщика:

.\OneAgent-Windows.exe --set-host-group=my_host_group --set-infra-only=true INSTALL_PATH="C:\installdir"

При использовании установщика в качестве пакета MSI вы можете напрямую добавлять только параметры INSTALL_PATH, LOG_PATH, DATA_STORAGE, PCAP_DRIVER и USER. Этот тип установки обычно выполняется в автоматическом режиме как часть развертывания групповой политики. --set-param=<value> должен быть помещен внутри ADDITIONAL_CONFIGURATION (ADDITIONAL_CONFIGURATION="--set-param=<value>").

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

Пользовательский интерфейс установщика

Вы также можете добавить параметры --set-param=<value> на экране установки настроек конфигурации ЕдиногоАгента.

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

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

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

Удаленные параметры установки

Начиная с версии 1.213, следующие параметры принимаются только в том случае, если они заданы с использованием синтаксиса --set-param=<value>. Для этих конкретных параметров эквивалентный синтаксис PARAM=<value> больше не поддерживается:

Удаленный параметр PARAM=<value> Новый --set-param=<value> параметр
SERVER --set-server
TENANT --set-tenant
TENANT_TOKEN --set-tenant-token
PROXY --set-proxy
HOST_GROUP --set-host-group
APP_LOG_CONTENT_ACCESS --set-app-log-content-access
INFRA_ONLY --set-infra-only

Параметры установки MSI

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

Путь установки

Значение по умолчанию: %PROGRAMFILES%\key-astrom\oneagent

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

Например:

.\Key-Astrom-OneAgent-Windows.exe INSTALL_PATH="C:\test dir".

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

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

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

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

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

Путь к журналу

Значение по умолчанию: %PROGRAMDATA%\key-astrom\oneagent\log

Параметр LOG_PATH позволяет настроить каталог журналов одного агента.

Например:

.\Key-Astrom-OneAgent-Windows.exe LOG_PATH=C:\key-astrom\logs

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

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

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

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

Изменение расположения

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

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

Хранение данных

ЕдиныйАгент версии 1.199

Значение по умолчанию: %PROGRAMDATA%\key-astrom\oneagent\datastorage

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

Для примера:

.\Key-Astrom-OneAgent-Windows.exe DATA_STORAGE=D:\data\key-astom\runtime

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

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

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

Изменение расположения

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

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

Адрес конечной точки связи

Значение по умолчанию: зависит от окружения

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

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

--set-server=https://100.20.10.1:443

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

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

Идентификатор окружения

Значение по умолчанию: зависит от окружения

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

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

--set-tenant=mySampleEnv

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

Токен

Значение по умолчанию: зависит от окружения

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

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

--set-tenant-token=abcdefghij123456

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

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

Сетевые зоны

Значение по умолчанию: не задано

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

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

--set-network-zone=your.network.zone

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

Прокси

Значение по умолчанию: не задано

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

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

--set-proxy=172.1.1.128:8080

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

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

Диапазон портов

Значения по умолчанию: 50000:50100

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

--set-watchdog-portrange=50000:50100

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

Автоматическое обновление

Используйте --set-auto-update-enabled=<arg>, чтобы включить или отключить автоматическое обновление ЕдиногоАгента. Например:

--set-auto-update-enabled=true

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

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

Значение по умолчанию: не задано

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

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

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

--set-host-group=My.HostGroup_123-456

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

Режим мониторинга инфраструктуры

Значение по умолчанию: false

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

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

--set-infra-only=true

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

--set-infra-only=false

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

Пользовательское имя хоста

Значение по умолчанию: не задано

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

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

Чтобы задать имя хоста:

--set-host-name=myhostname

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

Пользовательские метаданные хоста

Значение по умолчанию: не задано

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

Чтобы добавить или изменить свойства хоста:

--set-host-property=AppName --set-host-property=Environment=Dev

Вы можете добавить или изменить несколько свойств в одной и той же команде.

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

Пользовательские теги хоста

Значение по умолчанию: не задано

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

Чтобы добавить или изменить теги хоста:

--set-host-tag=TestHost --set-host-tag=role=fallback --set-host-tag=Gdansk

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

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

Источник идентификатора хоста

Значение по умолчанию: auto

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

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

Чтобы определить источник для генерации идентификатора хоста, выберите user --set-host-id-source и установите для него одно из предопределенных значений:

  • auto — Пусть Ключ-Астром автоматически сгенерирует идентификатор хоста
  • ip-addresses — Генерировать идентификатор хоста на основе IP-адреса хоста
  • mac-address — Сгенерируйте идентификатор хоста на основе MAC адреса сетевой карты хоста
  • fqdn — Создайте идентификатор хоста на основе полного доменного имени хоста (FQDN) в формате host.domain. Если полное доменное имя не содержит символа точки, вместо него используется MAC-адрес сетевой карты.
  • Если вы отслеживаете несколько сред, вы можете разделить хосты с одинаковыми IP-адресами, MAC-адресами или полными доменными именами, используя разные пространства имен для каждой среды. Пространство имен может содержать только буквенно-цифровые символы, дефисы, подчеркивания и точки; максимальная длина - 256 символов:
  • ip-addresses;namespace=<namespace>
  • mac-addresses;namespace=<namespace>
  • fqdn;namespace=<namespace>

Например, чтобы установить для источника hostID ip-адреса и назначить его пространству имен с именем test, запустите программу установки ЕдиногоАгента со следующим параметром:

--set-host-id-source="ip-addresses;namespace=test"

Доступ к системным журналам

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

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

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

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

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

Мониторинг лога

Значение по умолчанию: true

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

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

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

Автоматическая инъекция

ЕдиныйАгент версия 1.213

Значение по умолчанию: true

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

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

Прием локальных метрик

ЕдиныйАгент версия 1.201

Значение по умолчанию: 14449

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

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

Получение метрик StatsD

ЕдиныйАгент версия 1.201

Значение по умолчанию: 18125

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

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

Пользователь расширения ЕдиныйАгент

Значение по умолчанию: LocalSystem (ЕдиныйАгент версия 1.195+. Для более ранних версий - dtuser)

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

.\Key-Astrom-OneAgent-Windows.exe USER=LocalService

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

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

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


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

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

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

Тихая установка

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

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

Пакет MSI — тихая установка

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

Command shell

msiexec /i C:\some\path\Key-Astrom-OneAgent-Windows.msi ADDITIONAL_CONFIGURATION="--set-server=https://someserver.com --set-tenant=xxx --set-tenant-token=xxx --set-host-group=myGroup" /quiet /qn

PowerShell 3.0+

msiexec /i C:\some\path\Key-Astrom-OneAgent-Windows.msi --% ADDITIONAL_CONFIGURATION="--set-server=https://someserver.com --set-tenant=xxx --set-tenant-token=xxx --set-host-group=myGroup" /quiet /qn

Обратите внимание на символ --% stop-parsing, используемый в команде PowerShell.

EXE-установщик — тихая установка

Чтобы настроить тихую установку из командной строки для EXE-версии установщика, добавьте --quiet, как в этом примере:

.\Key-Astrom-OneAgent-Windows.exe --set-host-group="myGroup" --quiet

Драйвер захвата пакетов (pcap)

ЕдиныйАгент версия 1.229+

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

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

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

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

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

Значение по умолчанию: auto

Например:

.\Key-Astrom-OneAgent-Windows.exe PCAP_DRIVER=npcap

Примечание:

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

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