[comment]: # attributes: notoc

[comment]: # translation:outdated

[comment]: # ({4963afdf-4963afdf})
# 6 Zabbix агент 2 (Windows)

[comment]: # ({/4963afdf-4963afdf})

[comment]: # ({new-9fe069f9})
#### Параметры

|Параметр|<|Обязательный|Диапазон|Умолчание|Описание|<|
|----------------|-|------------------------|----------------|------------------|----------------|-|
|Alias|<|нет|<|<|Задает алиас ключу элемента данных. Его можно использовать для замены длинных и сложных ключей элементов данных на более простые и короткие.<br>Можно добавлять несколько параметров *Alias*. Разрешено указывать несколько параметров с одинаковым ключом *Alias*.<br>Несколько ключей *Alias* могут ссылаться на один и тот же ключ.<br>Алиасы можно использовать в *HostMetadataItem*, но нельзя в *HostnameItem* параметрах.<br><br>Примеры:<br><br>1. Получение ID пользователя 'zabbix'.<br>Alias=zabbix.userid:vfs.file.regexp\[/etc/passwd,"\^zabbix:.:(\[0-9\]+)",,,,\\1\]<br>Теперь можно использовать сокращенный ключ **zabbix.userid**, чтобы получать данные.<br><br>2. Получение утилизации CPU с параметрами по умолчанию и с пользовательскими параметрами.<br>Alias=cpu.util:system.cpu.util<br>Alias=cpu.util\[\*\]:system.cpu.util\[\*\]<br>Такая запись позволяет использовать **cpu.util** ключ для получения утилизации CPU в процентах с параметрами по умолчанию, а также использовать **cpu.util\[all, idle, avg15\]** для получения конкретных данных об утилизации CPU.<br><br>3. Выполнение нескольких правил [низкоуровневого обнаружения](ru/manual/discovery/low_level_discovery), которые обрабатывают одни и те же элементы данных обнаружения.<br>Alias=vfs.fs.discovery\[\*\]:vfs.fs.discovery<br>Теперь имеется возможность добавить несколько правил обнаружения, используя **vfs.fs.discovery** с разными параметрами для каждого правила, например, **vfs.fs.discovery\[foo\]**, **vfs.fs.discovery\[bar\]**, и т.д.|<|
|AllowKey|<|нет|<|<|Разрешить выполнение тех ключей элементов данных, которые соответствуют шаблону. Шаблон ключа - это выражение, которое поддерживает символ «\*» для соответствия любому количеству любых символов.<br>Несколько правил соответствия ключей могут быть определены в сочетании с DenyKey. Параметры обрабатываются по очереди в соответствии с порядком их появления.<br>Этот параметр поддерживается, начиная с Zabbix 5.0.0.<br>См. также: [ограничение проверок агента](/manual/config/items/restrict_checks).|<|
|BufferSend|<|нет|1-3600|5|Не хранить данные в буфере дольше N секунд.|<|
|BufferSize|<|нет|2-65535|100|Максимальное количество значений в буфере памяти. Агент будет отправлять<br>все собранные данные Zabbix серверу или прокси при заполнении буфера.<br>Обратите внимание, что если буфер заполнен, данные будут отправлены раньше.|<|
|ControlSocket|<|нет|<|/tmp/agent.sock|Сокет управления, используется при отправке команд управления при помощи '-R' опции.|<|
|DebugLevel|<|нет|0-5|3|Задает уровень журналирования:<br>0 - основная информация о запуске и остановки процессов Zabbix<br>1 - критичная информация<br>2 - информация об ошибках<br>3 - предупреждения<br>4 - для отладки (записывается очень много информации)<br>5 - расширенная отладка (записывается еще больше информации)|<|
|DenyKey|<|нет|<|<|Запретить выполнение тех ключей элементов данных, которые соответствуют шаблону. Шаблон ключа - это выражение, которое поддерживает символ «\*» для соответствия любому количеству любых символов.<br>Несколько правил соответствия ключей могут быть определены в сочетании с AllowKey. Параметры обрабатываются по очереди в соответствии с порядком их появления.<br>Этот параметр поддерживается, начиная с Zabbix 5.0.0.<br>См. также: [ограничение проверок агента](/manual/config/items/restrict_checks).|<|
|EnablePersistentBuffer|<|нет|0-1|0|Включить использование локального постоянного хранилища.<br>0 - отключено<br>1 - включено<br>Если постоянное хранилище отключено, будет использован буфер памяти.|<|
|HostInterface|<|нет|0-255 символов|<|Необязательный параметр, определяющий интерфейс узла сети.<br>Интерфейс хоста используется в процессе автоматической регистрации узла сети.<br>Агент выдаст ошибку и не запустится, если значение превышает ограничение в 255 символов.<br>Если значение не определено, значение будет получено от HostInterfaceItem.<br>Поддерживается, начиная с Zabbix 4.4.0.|<|
|HostInterfaceItem|<|нет|<|<|Необязательный параметр, который определяет элемент данных, используемый для получения интерфейса узла сети.<br>Интерфейс узла сети используется в процессе автоматической регистрации узла сети.<br>Во время запроса на автоматическую регистрацию агент регистрирует предупреждающее сообщение, если значение, возвращаемое указанным элементом данных, превышает ограничение в 255 символов.<br>Эта опция используется только когда HostInterface не определен.<br>Поддерживается, начиная с Zabbix 4.4.0.|<|
|HostMetadata|<|нет|0-255 символов|<|Опциональный параметр, который задает метаданные узла сети. Метаданные узла сети используются только в процессе автоматической регистрации узлов сети (активный агент).<br>Агент выдаст ошибку и не запустится, если указанное значение выходит за лимит длины строки или не является UTF-8 строкой.<br>Если не определено, то значение берётся от HostMetadataItem.|<|
|HostMetadataItem|<|нет|<|<|Опциональный параметр, который задает элемент данных, чтобы затем использовать его для получения метаданных узла сети.<br>В процессе запроса авторегистрации агент запишет в журнал предупреждающее сообщение, если полученное значение от указанного элемента данных выходит за лимит в 255 символов.<br>Этот параметр используется только, если HostMetadata не определен.<br>Поддерживаются UserParameters и алиасы. Поддерживается *system.run\[\]* независимо от значения *EnableRemoteCommands*.<br>Значение полученное от указанного элемента данных должно являться UTF-8 строкой, в противном случае оно будет игнорироваться.|<|
|Hostname|<|нет|<|Задается HostnameItem'ом|Уникальное, регистрозависимое имя хоста.<br>Требуется для активных проверок и должно совпадать с именем узла сети указанном на сервере.<br>Допустимые символы: буквенно-цифровые, '.', ' ', '\_' и '-'.<br>Максимальная длина: 128|<|
|HostnameItem|<|нет|<|system.hostname|Элемент данных, который используется для формирования Hostname, если этот параметр не указан. Игнорируется, если задан параметр Hostname.<br>Не поддерживает UserParameters, счетчики производительности и алиасы, но поддерживает *system.run\[\]*, независимо от значения *EnableRemoteCommands*.|<|
|Include|<|нет|<|<|Вы можете включить отдельные файлы или все файлы из папки с файлом конфигурации.<br>В процессе инсталляции Zabbix будет создана директория для включения файлов в /usr/local/etc, независимо от того изменена она или нет в процессе компиляции.<br>Для включения только необходимых файлов из указанной папки, поддерживается символ звездочки для поиска совпадения по маске. Например: `/абсолютный/путь/к/файлам/конфигурации/*.conf`.<br>Смотрите [специальные заметки](special_notes_include) по поводу ограничений.|<|
|ListenIP|<|нет|<|0.0.0.0|Список IP адресов разделенных запятыми, которые должен слушать агент.<br>Первый IP адрес отправляется на Zabbix сервер, если удается подключиться к нему, тогда происходит получение списка активных проверок.|<|
|ListenPort|<|нет|1024-32767|10050|Агент будет слушать этот порт для подключений с сервера.|<|
|LogFile|<|Да, если LogType задан как *file*, иначе<br>нет.|<|/tmp/zabbix\_agentd.log|Имя файла журнала, если LogType равен значению 'file'.|<|
|LogFileSize|<|нет|0-1024|1|Максимальный размер файла журнала в МБ.<br>0 - отключение автоматической ротации журнала.<br>*Примечание*: Если лимит достигнут и ротация не удалась, по каким-либо причинам, существующий файл журнала очищается и начинается новый.|<|
|LogType|<|нет|<|file|Задает место куда будут записываться сообщения журнала:<br>*system* - запись журнала в syslog,<br>*file* - запись журнала в файл указанный в LogFile параметре,<br>*console* - вывод журнала в стандартный вывод.|<|
|PersistentBufferFile|<|нет|<|<|Файл, в котором Zabbix агент 2 должен хранить базу данных SQLite.<br>Обязательно указывать полное имя файла.<br>Этот параметр используется, только если включен постоянный буфер (*EnablePersistentBuffer=1*).|<|
|PersistentBufferPeriod|<|нет|1m-365d|1h|Период времени, в течение которого должны храниться данные, когда нет соединения с сервером или прокси. Более старые данные будут потеряны. Данные журнала будут сохранены.<br>Этот параметр используется, только если включен постоянный буфер (*EnablePersistentBuffer=1*).|<|
|Plugins|<|нет|<|<|Плагины могут иметь один и более специфичных параметров конфигурации в формате:<br>Plugins.<ИмяПлагина>.<Параметр1>=<значение1><br>Plugins.<ИмяПлагина>.<Параметр2>=<значение2>|<|
|<|Plugins.<PluginName>.KeepAlive|нет|60-900|300|Максимальное время ожидания (в секундах) до закрытия неиспользуемых подключаемых модулей.<br>Пример: `Plugins.Memcached.KeepAlive=200`<br>Поддерживается для следующих плагинов: *Memcached, MySQL, Redis, PostgreSQL*.|<|
|<|Plugins.<PluginName>.Sessions.<sessionName>.<sessionParameter>|нет|<|<|Параметры именованых сессий.<br>**<sessionName>** - имя объекта мониторинга.<br>**<sessionParameter>** - название параметра (допустимые: *Uri*, *Username*, *Password*).<br>Пример: `Plugins.Memcached.Sessions.Memcached1.Uri=tcp://localhost:11211`<br>`Plugins.Memcached.Sessions.Memcached1.Username=boss`<br>`Plugins.Memcached.Sessions.Memcached1.Password=secret`<br>`Plugins.Memcached.Sessions.Memcached2.Uri=tcp://localhost:11212` \\\\Поддерживается для плагинов: *Memcached, MySQL, Redis, PostgreSQL*.|<|
|<|Plugins.<PluginName>.Timeout|нет|1-30|Глобальный таймаут|Максимальное время ожидания (в секундах) для завершения запроса плагина.<br>\\Поддерживается для плагинов: *Memcached, MySQL, Redis, Docker, PostgreSQL*.|<|
|<|Plugins.Log.MaxLinesPerSecond|нет|1-1000|20|Максимальное количество новых строк, которые агент будет отправлять в секунду на Zabbix сервер или прокси при обработке активных проверок 'log' и 'eventlog'.<br>Предоставленное значение будет переопределено параметром 'maxlines',<br>предоставленным в ключе элемента 'log' или 'eventlog'.<br>*Обратите внимание*: Zabbix обработает в 10 раз больше новых строк, чем установлено в *MaxLinesPerSecond* в процессе поиска нужной строки в элементах журнала.<br>Этот параметр поддерживается начиная с 4.4.2 и заменяет MaxLinesPerSecond.|<|
|<|Plugins.Postgres.Database|нет|<|postgres|Имя базы данных, которое будет использоваться для PostgreSQL.|<|
|<|Plugins.Postgres.Host|нет|<|localhost|IP адрес или DNS имя узла сети, используемого для PostgreSQL.<br>Примеры: `localhost`, `192.168.1.1`<br>|<|
|<|Plugins.Postgres.Port|нет|<|5432|Порт, который будет использоваться для PostgreSQL.|<|
|<|Plugins.SystemRun.EnableRemoteCommands|нет|<|0|Разрешены ли удаленные команды с Zabbix сервера.<br>0 - не разрешены<br>1 - разрешены<br>Этот параметр поддерживается начиная с 4.4.2 и заменяет EnableRemoteCommands.<br>Этот параметр **не поддерживается** начиная с 5.0.2, вместо этого используйте параметры AllowKey / DenyKey.|<|
|<|Plugins.SystemRun.LogRemoteCommands|нет|<|0|Включение журналирования выполняемых shell команд как предупреждений.<br>0 - отключено<br>1 - включено<br>Этот параметр поддерживается начиная с 4.4.2 и заменяет LogRemoteCommands.|<|
|<|Plugins.WindowsEventlog.MaxLinesPerSecond|нет|1-1000|20|Максимальное количество новых строк, которые агент будет отправлять в секунду на Zabbix Server или Proxy, обрабатывающих проверки «eventlog».<br>Предоставленное значение будет переопределено параметром 'maxlines', указанным в ключах элемента 'eventlog'.|<|
|RefreshActiveChecks|<|нет|60-3600|120|Как часто обновлять список активных проверок, в секундах.<br>Обратите внимание, что после неуспешного обновления активных проверок, следующая попытка будет предпринята через 60 секунд.|<|
|Server|<|да|<|<|Список разделенных запятой IP адресов, опционально в CIDR нотации, или имен хостов Zabbix серверов и Zabbix прокси.<br>Входящие соединения будут приниматься только с хостов указанных в этом списке.<br>Если включена поддержка IPv6, то '127.0.0.1', '::127.0.0.1', '::ffff:127.0.0.1' обрабатываются одинаково и '::/0' разрешает все IPv4 и IPv6 адреса.<br>'0.0.0.0/0' можно использовать, чтобы разрешить любой IPv4 адрес.<br>Обратите внимание, что "IPv4-совместимые IPv6 адреса" (0000::/96 prefix) поддерживаются, но являются устаревшими согласно [RFC4291](https://tools.ietf.org/html/rfc4291#section-2.5.5) \[en\].<br>Пример: Server=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.domain<br>Пробелы допускаются.|<|
|ServerActive|<|нет|<|<|Список пар IP:порт (или имя хоста:порт) Zabbix серверов или Zabbix прокси для активных проверок.<br>Можно указывать несколько адресов разделенных запятыми, чтобы параллельно использовать несколько независимых Zabbix серверов. Пробелы допускаются.<br>Если порт не указан, то используется порт по умолчанию.<br>IPv6 адреса должны быть заключены в квадратные скобки, если для хоста указывается порт.<br>Если порт порт не указан, то квадратные скобки для IPv6 адресов опциональны.<br>Если параметр не указан, активные проверки будут отключены.<br>Пример: ServerActive=127.0.0.1:20051,zabbix.example.com,\[::1\]:30051,::1,\[12fc::1\]|<|
|SourceIP|<|нет|<|<|Локальный IP адрес для исходящих подключений.|<|
|StatusPort|<|нет|1024-32767|<|Если задан, агент будет слушать указанный порт для HTTP запросов состояния (http://localhost:<порт>/status).|<|
|Timeout|<|нет|1-30|3|Тратить не более Timeout секунд при обработке.|<|
|TLSAccept|<|да, если заданы TLS сертификат или параметры PSK (даже при *незашифрованном* соединении), в противном случае - нет|<|<|Какие принимаются входящие подключения. Используется пассивными проверками. Можно указывать несколько значений, разделенных запятой:<br>*unencrypted* - принимать подключения без шифрования (по умолчанию)<br>*psk* - принимать подключения с TLS и pre-shared ключом (PSK)<br>*cert* - принимать подключения с TLS и сертификатом|<|
|TLSCAFile|<|нет|<|<|Абсолютный путь к файлу, который содержит сертификаты верхнего уровня CA(и) для верификации сертификата узла, используется для зашифрованных соединений между Zabbix компонентами.|<|
|TLSCertFile|<|нет|<|<|Абсолютный путь к файлу, который содержит сертификат или цепочку сертификатов, используется для зашифрованных соединений между Zabbix компонентами.|<|
|TLSConnect|<|да, если заданы TLS сертификат или параметры PSK (даже при *незашифрованном* соединении), в противном случае - нет|<|<|Как агент должен соединяться с Zabbix сервером или прокси. Используется активными проверками. Можно указать только одно значение:<br>*unencrypted* - подключаться без шифрования (по умолчанию)<br>*psk* - подключаться, используя TLS и pre-shared ключом (PSK)<br>*cert* - подключаться, используя TLS и сертификат|<|
|TLSCRLFile|<|нет|<|<|Абсолютный путь к файлу, который содержит отозванные сертификаты. Этот параметр используется для зашифрованных соединений между Zabbix компонентами.|<|
|TLSKeyFile|<|нет|<|<|Абсолютный путь к файлу, который содержит приватный ключ агента, используется для зашифрованных соединений между Zabbix компонентами.|<|
|TLSPSKFile|<|нет|<|<|Абсолютный путь к файлу, который содержит pre-shared ключ агента, используется для зашифрованных соединений с Zabbix сервером.|<|
|TLSPSKIdentity|<|нет|<|<|Строка идентификатор pre-shared ключа, используется для зашифрованных соединений с Zabbix сервером.|<|
|TLSServerCertIssuer|<|нет|<|<|Разрешенный эмитент сертификата сервера (прокси).|<|
|TLSServerCertSubject|<|нет|<|<|Разрешенная тема сертификата сервера (прокси).|<|
|UnsafeUserParameters|<|нет|0,1|0|Разрешить все символы, которые можно передать аргументами в пользовательские параметры.<br>Не разрешены следующие символы:<br>\\ ' " \` \* ? \[ \] { } \~ $ ! & ; ( ) < > \| \# @<br>Кроме того, не разрешены символы новой строки.|<|
|UserParameter|<|нет|<|<|Пользовательский параметр для мониторинга. Можно указать нескольких пользовательских параметров.<br>Формат: UserParameter=<ключ>,<shell команда><br>Обратите внимание, что команда не должна возвращать только пустую строку или только EOL.<br>Например: UserParameter=system.test,who\|wc -l|<|

[comment]: # ({/new-9fe069f9})

[comment]: # ({8085875f-e6d02d31})
### Подробности параметра

[comment]: # ({/8085875f-e6d02d31})

[comment]: # ({84239a98-fa6993fd})
##### Псевдоним

Устанавливает псевдоним для ключа элемента. Его можно использовать для замены длинного и сложного ключа элемента более коротким и простым.<br>
Может присутствовать несколько параметров *Alias*. Несколько параметров с одним и тем же ключом *Псевдоним* не допускаются.<br>
Разные ключи *Псевдонимы* могут ссылаться на один и тот же ключ элемента.<br>
Псевдонимы можно использовать в *HostMetadataItem*, но не в параметре *HostnameItem*.

Пример 1. Получение данных об использовании файла подкачки в процентах с сервера.

    Alias=pg_usage:perf_counter[\Файл подкачки(_Total)\% использования]
    
Теперь сокращенный ключ **pg_usage** можно использовать для получения данных.

Пример 2: Получение загрузки ЦП с параметрами по умолчанию и пользовательскими параметрами.

    Псевдоним = cpu.load:system.cpu.load
    Псевдоним=cpu.load[*]:system.cpu.load[*]

Это позволяет использовать ключ **cpu.load** для получения загрузки ЦП с параметрами по умолчанию, а также использовать **cpu.load[percpu,avg15]** для получения конкретных данных о загрузке ЦП.

Пример 3. Запуск нескольких правил [низкоуровневого обнаружения](/manual/discovery/low_level_discovery), обрабатывающих одни и те же элементы обнаружения.

    Псевдоним=vfs.fs.discovery[*]:vfs.fs.discovery

Теперь можно настроить несколько правил обнаружения, используя **vfs.fs.discovery** с разными параметрами для каждого правила, например, **vfs.fs.discovery[foo]**, **vfs.fs.discovery[ бар]** и т. д.

[comment]: # ({/84239a98-fa6993fd})

[comment]: # ({6c104b7b-e05b8a23})
##### AllowKey

Разрешить выполнение тех ключей элементов, которые соответствуют шаблону. Шаблон ключа – это подстановочное выражение, которое поддерживает символ "\*" для соответствия любому количеству любых символов.<br>В сочетании с DenyKey можно определить несколько правил сопоставления ключей. Параметры обрабатываются один за другим в порядке их появления. См. также: [Ограничение проверок агента](/manual/config/items/restrict_checks).

[comment]: # ({/6c104b7b-e05b8a23})

[comment]: # ({fc56d912-5d573779})
##### BufferSend

Временной интервал в секундах, который определяет, как часто значения отправляются из буфера на сервер Zabbix.<br>Обратите внимание, что если буфер заполнен, данные будут отправлены раньше.

По умолчанию: `5`<br>
Диапазон: 1-3600

[comment]: # ({/fc56d912-5d573779})

[comment]: # ({8701c363-adbf2018})
##### BufferSize

Максимальное количество значений в буфере памяти. Агент отправит все собранные данные на сервер Zabbix или прокси-сервер, если буфер заполнен.<br>Этот параметр следует использовать только в том случае, если постоянный буфер отключен (*EnablePersistentBuffer=0*).

По умолчанию: `100`<br>
Диапазон: 2-65535

[comment]: # ({/8701c363-adbf2018})

[comment]: # ({78069119-dee4d084})
##### ControlSocket

Управляющий сокет, используемый для отправки команд времени выполнения с опцией '-R'.

По умолчанию: `\\.\pipe\agent.sock`

[comment]: # ({/78069119-dee4d084})

[comment]: # ({9c071f70-74594585})
##### DebugLevel

Укажите уровень отладки:<br>*0* - основная информация о запуске и остановке процессов Zabbix<br>*1* - критическая информация;<br>*2* - информация об ошибках;<br>*3* - предупреждения; <br>*4* — для отладки (выдает много информации);<br>*5* — расширенная отладка (выдает еще больше информации).

По умолчанию: `3`<br>
Диапазон: 0-5

[comment]: # ({/9c071f70-74594585})

[comment]: # ({13d6d3a4-ad027e43})
##### DenyKey

Запретить выполнение тех ключей элементов, которые соответствуют шаблону. Шаблон ключа – это подстановочное выражение, которое поддерживает символ "\*", соответствующий любому количеству любых символов.<br>В сочетании с AllowKey можно определить несколько правил сопоставления ключей. Параметры обрабатываются один за другим в порядке их появления. См. также: [Ограничение проверок агента](/manual/config/items/restrict_checks).

[comment]: # ({/13d6d3a4-ad027e43})

[comment]: # ({52ac8f96-d9d538db})
##### EnablePersistentBuffer

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

По умолчанию: `0`<br>
Значения: 0 – отключено, 1 – включено

[comment]: # ({/52ac8f96-d9d538db})

[comment]: # ({5fe3c615-1970c2c5})
##### ForceActiveChecksOnStart

Выполните активные проверки сразу после перезагрузки для первой полученной конфигурации. Также доступен как параметр конфигурации для каждого плагина, например: `Plugins.Uptime.System.ForceActiveChecksOnStart=1`

По умолчанию: `0`<br>
Значения: 0 – отключено, 1 – включено

[comment]: # ({/5fe3c615-1970c2c5})

[comment]: # ({dbb05958-bce527af})
##### Частота сердцебиения

Частота сообщений о пульсе в секундах. Используется для контроля наличия активных проверок.<br>0 — контрольные сообщения отключены.

По умолчанию: `60`<br>
Диапазон: 0-3600

[comment]: # ({/dbb05958-bce527af})

[comment]: # ({48de1a7d-9d3624af})
##### HostInterface

Необязательный параметр, определяющий интерфейс хоста. Интерфейс хоста используется в процессе [авторегистрации](/manual/discovery/auto_registration#using_dns_as_default_interface) хоста. Если не определено, значение будет получено из HostInterfaceItem.<br>Агент выдаст ошибку и не запустится, если значение превышает предел в 255 символов.

Диапазон: 0–255 символов.

[comment]: # ({/48de1a7d-9d3624af})

[comment]: # ({6f6b06b5-7378e07f})
##### HostInterfaceItem

Необязательный параметр, определяющий элемент, используемый для получения интерфейса хоста.<br>Интерфейс хоста используется в процессе [авторегистрации](/manual/discovery/auto_registration#using_dns_as_default_interface) хоста. Эта опция используется только в том случае, если HostInterface не определен.<br>Элемент [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.runcommandmode) поддерживается независимо от значений AllowKey/DenyKey.<br >Во время запроса на авторегистрацию агент записывает предупреждающее сообщение, если значение, возвращаемое указанным элементом, превышает ограничение в 255 символов.

[comment]: # ({/6f6b06b5-7378e07f})

[comment]: # ({5bcd7757-3b42353f})
##### HostMetadata

Необязательный параметр, определяющий метаданные хоста. Метаданные хоста используются только в процессе авторегистрации хоста (активный агент). Если не определено, значение будет получено из HostMetadataItem.<br>Агент выдаст ошибку и не запустится, если указанное значение превышает предел в 2034 байта или строку, отличную от UTF-8.

Диапазон: 0–2034 байта.

[comment]: # ({/5bcd7757-3b42353f})

[comment]: # ({68e9d47c-eff97518})
##### HostMetadataItem

Необязательный параметр, определяющий элемент, используемый для получения метаданных хоста. Этот параметр используется только в том случае, если HostMetadata не определена. Поддерживаются пользовательские параметры и псевдонимы. Элемент [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.runcommandmode) поддерживается независимо от значений AllowKey/DenyKey.<br>Значение HostMetadataItem извлекается при каждой попытке авторегистрации и используется только в процессе авторегистрации хоста.<br>Во время запроса на авторегистрацию агент записывает предупреждающее сообщение, если значение, возвращаемое указанным элементом, превышает предел в 65535 кодовых точек UTF-8. Значение, возвращаемое элементом, должно быть строкой UTF-8, иначе оно будет проигнорировано.

[comment]: # ({/68e9d47c-eff97518})

[comment]: # ({6e272ef0-542b591a})
##### Hostname

Список уникальных имен хостов, разделенных запятыми, чувствительных к регистру. Требуется для активных проверок и должен соответствовать именам хостов, настроенным на сервере. Значение получается из HostnameItem, если оно не определено.<br>Допустимые символы: буквенно-цифровые, '.', ' ', '\_' и '-'. Максимальная длина: 128 символов на имя хоста, 2048 символов на всю строку.

По умолчанию: устанавливается HostnameItem.

[comment]: # ({/6e272ef0-542b591a})

[comment]: # ({5e0a958d-085b8ddc})
##### HostnameItem

Необязательный параметр, определяющий элемент, используемый для получения имени хоста. Эта опция используется только в том случае, если имя хоста не определено. Пользовательские параметры или псевдонимы не поддерживаются, но элемент [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.runcommandmode) поддерживается независимо от значений AllowKey/DenyKey.

По умолчанию: `system.hostname`

[comment]: # ({/5e0a958d-085b8ddc})

[comment]: # ({e0c1c193-d06cc342})
##### Включать

Вы можете включить отдельные файлы или все файлы в каталоге в файл конфигурации (по умолчанию он расположен в `C:\Program Files\Zabbix Agent 2`, если агент Zabbix установлен с использованием пакетов установщика Windows MSI; находится в папке, указанной во время установки, если Агент Zabbix устанавливается в виде zip-архива). Все включенные файлы должны иметь
правильный синтаксис, иначе агент не запустится. Путь может быть относительным к местоположению файла *zabbix_agent2.conf*.
(например, `Include=.\zabbix_agent2.d\plugins.d\*.conf`).<br>Чтобы включить только соответствующие файлы в указанный каталог,
для сопоставления с образцом поддерживается подстановочный знак звездочки.<br>Об ограничениях см. [специальные примечания](special_notes_include).

Пример:

    Include=C:\Program Files\Zabbix Agent2\zabbix_agent2.d\*.conf

[comment]: # ({/e0c1c193-d06cc342})

[comment]: # ({f710f108-21abf7b1})
##### ListenIP

Список IP-адресов, разделенных запятыми, которые агент должен прослушивать. Первый IP-адрес отправляется на сервер Zabbix при подключении к нему для получения списка активных проверок.

По умолчанию: `0.0.0.0`

[comment]: # ({/f710f108-21abf7b1})

[comment]: # ({5f95bc53-2f2c8140})
##### ListenPort

Агент будет прослушивать этот порт на предмет соединений с сервером.

По умолчанию: `10050`<br>
Диапазон: 1024-32767

[comment]: # ({/5f95bc53-2f2c8140})

[comment]: # ({1c88a5a6-988826b6})
##### LogFile

Имя файла журнала агента.

По умолчанию: `c:\\zabbix_agent2.log`<br>
Обязательно: Да, если для LogType установлено значение *file*; иначе нет

[comment]: # ({/1c88a5a6-988826b6})

[comment]: # ({f7604f8f-ae05fc8d})
##### LogFileSize

Максимальный размер файла журнала в МБ.<br>0 — отключить автоматическую ротацию журналов.<br>*Примечание*: если достигнут предел размера файла журнала и ротация файла по какой-либо причине не удалась, существующий файл журнала усекается и запускается заново.

По умолчанию: `1`<br>
Диапазон: 0–1024

[comment]: # ({/f7604f8f-ae05fc8d})

[comment]: # ({4226072e-e8dc6df9})
##### LogType

Тип вывода журнала:<br>*file* - запись журнала в файл, указанный параметром LogFile;<br>*console* - запись журнала в стандартный вывод.

По умолчанию: `файл`

[comment]: # ({/4226072e-e8dc6df9})

[comment]: # ({de1f0041-dde3e6b9})
##### PersistentBufferFile

Файл, в котором агент Zabbix 2 должен хранить базу данных SQLite. Должно быть полное имя файла. Этот параметр используется только в том случае, если постоянный буфер включен (*EnablePersistentBuffer=1*).

[comment]: # ({/de1f0041-dde3e6b9})

[comment]: # ({4c6b037f-379dc265})
##### PersistentBufferPeriod

Период времени, в течение которого должны храниться данные при отсутствии соединения с сервером или прокси. Более старые данные будут потеряны. Данные журнала будут сохранены. Этот параметр используется только в том случае, если постоянный буфер включен (*EnablePersistentBuffer=1*).

По умолчанию: `1h`<br>
Диапазон: 1м-365д

[comment]: # ({/4c6b037f-379dc265})

[comment]: # ({4d036ffd-3ddd6ccb})

##### Plugins.<Имя плагина>.System.Capacity {#plugins.systemcapacity}

Предел проверок для каждого плагина `<Имя плагина>`, который может выполняться одновременно.

По умолчанию: `100`
Диапазон: 1-1000

[comment]: # ({/4d036ffd-3ddd6ccb})

[comment]: # ({d537c2b6-c6daef84})
##### Plugins.Log.MaxLinesPerSecond

Максимальное количество новых строк, которые агент будет отправлять в секунду на Zabbix-сервер или прокси-сервер при обработке активных проверок «log», «logrt» и «eventlog». Предоставленное значение будет переопределено параметром 'maxlines', указанным в ключе элемента 'log', 'logrt' или 'eventlog'.<br>*Примечание*: Zabbix будет обрабатывать в 10 раз больше новых строк, чем установлено в *MaxLinesPerSecond * для поиска необходимой строки в элементах журнала.

По умолчанию: `20`<br>
Диапазон: 1-1000

[comment]: # ({/d537c2b6-c6daef84})

[comment]: # ({62fb8c26-d7133c6e})
##### Plugins.SystemRun.LogRemoteCommands

Включите регистрацию выполненных команд оболочки в виде предупреждений. Команды будут регистрироваться только в том случае, если они выполняются удаленно. Записи журнала не будут созданы, если system.run\[\] запускается локально с помощью параметров HostMetadataItem, HostInterfaceItem или HostnameItem.

По умолчанию: `0`<br>
Значения: 0 – отключено, 1 – включено

[comment]: # ({/62fb8c26-d7133c6e})

[comment]: # ({9450d7ef-c712bfb8})
##### PluginSocket

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

По умолчанию: `\\.\pipe\agent.plugin.sock`

[comment]: # ({/9450d7ef-c712bfb8})

[comment]: # ({14afe8ce-1db534a6})
##### PluginTimeout

Таймаут соединений с загружаемыми плагинами, в секундах.

По умолчанию: `Timeout`<br>
Диапазон: 1-30

[comment]: # ({/14afe8ce-1db534a6})

[comment]: # ({d3de4e11-25e3871b})
##### Обновить активные проверки

Как часто обновляется список активных проверок (в секундах). Обратите внимание, что после неудачного обновления активных проверок следующая попытка обновления будет предпринята через 60 секунд.

По умолчанию: `5`<br>
Диапазон: 1-86400

[comment]: # ({/d3de4e11-25e3871b})

[comment]: # ({22be08ff-0ad80cbc})
##### Сервер

Список IP-адресов, разделенных запятыми, опционально в нотации CIDR, или DNS-имен серверов Zabbix или прокси-серверов Zabbix. Входящие соединения будут приниматься только от хостов, перечисленных здесь. Если поддержка IPv6 включена, то «127.0.0.1», «::127.0.0.1», «::ffff:127.0.0.1» обрабатываются одинаково, а «::/0» разрешает любой адрес IPv4 или IPv6. «0.0.0.0/0» можно использовать для разрешения любого адреса IPv4. Пробелы разрешены.

Пример: 

    Сервер=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com

Обязательно: да

[comment]: # ({/22be08ff-0ad80cbc})

[comment]: # ({new-0d31e03a})
##### `ServerActive`
Zabbix server/proxy address or cluster configuration to get active checks from. The server/proxy address is an IP address or DNS name and optional port separated by colon.<br>The cluster configuration is one or more server addresses separated by semicolon. Multiple Zabbix servers/clusters and Zabbix proxies can be specified, separated by comma. More than one Zabbix proxy should not be specified from each Zabbix server/cluster. If a Zabbix proxy is specified then Zabbix server/cluster for that proxy should not be specified.<br>Multiple comma-delimited addresses can be provided to use several independent Zabbix servers in parallel. Spaces are allowed.<br>If the port is not specified, default port is used.<br>IPv6 addresses must be enclosed in square brackets if port for that host is specified. If port is not specified, square brackets for IPv6 addresses are optional.<br>If this parameter is not specified, active checks are disabled.

Example for Zabbix proxy: 

    ServerActive=127.0.0.1:10051

Example for multiple servers: 

    ServerActive=127.0.0.1:20051,zabbix.domain,\[::1\]:30051,::1,\[12fc::1\]

Example for high availability:

    ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051;zabbix.cluster.node3

Example for high availability with two clusters and one server:

    ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051,zabbix.cluster2.node1;zabbix.cluster2.node2,zabbix.domain

[comment]: # ({/new-0d31e03a})

[comment]: # ({3628af0a-f96761ad})
##### IP-адрес источника

Исходный IP-адрес для:<br>- исходящих подключений к Zabbix-серверу или Zabbix-прокси;<br>- установления соединений при выполнении некоторых элементов (web.page.get, net.tcp.port и т. д.).

[comment]: # ({/3628af0a-f96761ad})

[comment]: # ({7d3f343b-8b9a658a})
##### StatusPort

Если установлено, агент будет прослушивать этот порт на предмет запросов статуса HTTP (http://localhost:<port>/status).

Диапазон: 1024-32767

[comment]: # ({/7d3f343b-8b9a658a})

[comment]: # ({1b1125a4-baa42b03})
##### Timeout

Затрачивайте на обработку не более Timeout секунд.

По умолчанию: `3`<br>
Диапазон: 1-30

[comment]: # ({/1b1125a4-baa42b03})

[comment]: # ({412cbce9-5fffe23e})
##### TLSAccept

Входящие соединения принять. Используется для пассивных проверок. Можно указать несколько значений, разделенных запятой:<br>*unencrypted* — принимать соединения без шифрования (по умолчанию)<br>*psk* — принимать соединения с TLS и предварительным общим ключом (PSK)<br>*cert* - принимать соединения с TLS и сертификатом

Обязательно: да, если определены сертификат TLS или параметры PSK (даже для *нешифрованного* соединения); иначе нет

[comment]: # ({/412cbce9-5fffe23e})

[comment]: # ({65d07bda-01a58fb9})
#####TLSCAFile

Полный путь к файлу, содержащему сертификаты ЦС верхнего уровня для проверки одноранговых сертификатов, используемый для зашифрованной связи между компонентами Zabbix.

[comment]: # ({/65d07bda-01a58fb9})

[comment]: # ({005f60f1-64ff2b38})
##### TLSCertFile

Полный путь к файлу, содержащему сертификат агента или цепочку сертификатов, используемый для зашифрованной связи с компонентами Zabbix.

[comment]: # ({/005f60f1-64ff2b38})

[comment]: # ({be99c4c7-0c14341a})
##### TLSConnect

Как агент должен подключаться к Zabbix серверу или прокси. Используется для активных проверок. Можно указать только одно значение:<br>*unencrypted* — подключение без шифрования (по умолчанию)<br>*psk* — подключение с использованием TLS и предварительного общего ключа (PSK)<br>*cert* — подключение с использованием TLS и сертификат

Обязательно: да, если определены сертификат TLS или параметры PSK (даже для *нешифрованного* соединения); иначе нет

[comment]: # ({/be99c4c7-0c14341a})

[comment]: # ({94a4b758-353fa6b2})
##### TLSCRLFile

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

[comment]: # ({/94a4b758-353fa6b2})

[comment]: # ({c2aa4315-40db7da5})
##### TLSKeyFile

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

[comment]: # ({/c2aa4315-40db7da5})

[comment]: # ({11defa44-216346d5})
#####TLSPSKFile

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

[comment]: # ({/11defa44-216346d5})

[comment]: # ({92d3eff0-d9d037af})
##### TLSPSKIdentity

Строка идентификации предварительного общего ключа, используемая для зашифрованной связи с сервером Zabbix.

[comment]: # ({/92d3eff0-d9d037af})

[comment]: # ({ae5c568f-4a08c667})
##### TLSServerCertIssuer

Разрешенный эмитент сертификата сервера (прокси).

[comment]: # ({/ae5c568f-4a08c667})

[comment]: # ({fb69617f-6446ac76})
##### TLSServerCertSubject

Разрешенный субъект сертификата сервера (прокси).

[comment]: # ({/fb69617f-6446ac76})

[comment]: # ({e61ac186-42a95de3})
##### UnsafeUserParameters

Разрешить передачу всех символов в аргументах пользовательских параметров. Следующие символы не допускаются: \\ ' " \` \* ? \[ \] { } \~ $ ! & ; ( ) < > \| \# @<br>Кроме того, символы новой строки не допускаются.

По умолчанию: `0`<br>
Значения: 0 – не разрешать, 1 – разрешать

[comment]: # ({/e61ac186-42a95de3})

[comment]: # ({de3660b7-cba7618d})
##### UserParameter

Определяемый пользователем параметр для мониторинга. Может быть несколько пользовательских параметров.<br>Формат: UserParameter=<ключ>,<команда оболочки><br>Обратите внимание, что команда оболочки не должна возвращать пустую строку или только EOL. Команды оболочки могут иметь относительные пути, если указан параметр UserParameterDir.

Пример:

    UserParameter=system.test,who|wc -l
    UserParameter=check_cpu,./custom_script.sh

[comment]: # ({/de3660b7-cba7618d})

[comment]: # ({fefd119e-f6be7620})
##### UserParameterDir

Путь поиска по умолчанию для команд UserParameter. Если используется, агент перед выполнением команды изменит свой рабочий каталог на указанный здесь. Таким образом, команды UserParameter могут иметь относительный префикс `./` вместо полного пути.<br>Допускается только одна запись.

Пример:

    UserParameterDir=/opt/myscripts

[comment]: # ({/fefd119e-f6be7620})