[comment]: # translation:outdated

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

Zabbix агент 2 - новое поколение Zabbix агента и может использоваться в
качестве замены Zabbix агента.

В этом разделе перечислены параметры, поддерживаемые в файле
конфигурации Zabbix агента 2 (zabbix\_agent2.conf). Обратите внимание,
что:

-   Значения по умолчанию отражают значения по умолчанию процесса, а не
    значения в поставляемых файлах конфигурации;
-   Zabbix поддерживает файлы конфигурации только в кодировке UTF-8 без
    [BOM](https://ru.wikipedia.org/wiki/%D0%9C%D0%B0%D1%80%D0%BA%D0%B5%D1%80_%D0%BF%D0%BE%D1%81%D0%BB%D0%B5%D0%B4%D0%BE%D0%B2%D0%B0%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D0%BE%D1%81%D1%82%D0%B8_%D0%B1%D0%B0%D0%B9%D1%82%D0%BE%D0%B2);
-   Комментарии, начинающиеся с "\#", поддерживаются только в начале
    строки.

[comment]: # ({/new-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]: # ({new-b5b19596})
#### Parameters

|Parameter|<|Mandatory|Range|Default|Description|
|---------|-|---------|-----|-------|-----------|
|Alias|<|no|<|<|Sets an alias for an item key. It can be used to substitute long and complex item key with a smaller and simpler one.<br>Multiple *Alias* parameters may be present. Multiple parameters with the same *Alias* key are allowed.<br>Different *Alias* keys may reference the same item key.<br>Aliases can be used in *HostMetadataItem* but not in *HostnameItem* parameters.<br><br>Examples:<br><br>1. Retrieving the ID of user 'zabbix'.<br>Alias=zabbix.userid:vfs.file.regexp\[/etc/passwd,"\^zabbix:.:(\[0-9\]+)",,,,\\1\]<br>Now shorthand key **zabbix.userid** may be used to retrieve data.<br><br>2. Getting CPU utilization with default and custom parameters.<br>Alias=cpu.util:system.cpu.util<br>Alias=cpu.util\[\*\]:system.cpu.util\[\*\]<br>This allows use **cpu.util** key to get CPU utilization percentage with default parameters as well as use **cpu.util\[all, idle, avg15\]** to get specific data about CPU utilization.<br><br>3. Running multiple [low-level discovery](/manual/discovery/low_level_discovery) rules processing the same discovery items.<br>Alias=vfs.fs.discovery\[\*\]:vfs.fs.discovery<br>Now it is possible to set up several discovery rules using **vfs.fs.discovery** with different parameters for each rule, e.g., **vfs.fs.discovery\[foo\]**, **vfs.fs.discovery\[bar\]**, etc.|
|AllowKey|<|no|<|<|Allow execution of those item keys that match a pattern. Key pattern is a wildcard expression that supports "\*" character to match any number of any characters.<br>Multiple key matching rules may be defined in combination with DenyKey. The parameters are processed one by one according to their appearance order.<br>This parameter is supported since Zabbix 5.0.0.<br>See also: [Restricting agent checks](/manual/config/items/restrict_checks).|
|BufferSend|<|no|1-3600|5|The time interval in seconds which determines how often values are sent from the buffer to Zabbix server.<br>Note, that if the buffer is full, the data will be sent sooner.|
|BufferSize|<|no|2-65535|100|Maximum number of values in a memory buffer. The agent will send all collected data to Zabbix server or proxy if the buffer is full.<br>This parameter should only be used if persistent buffer is disabled (*EnablePersistentBuffer=0*).|
|ControlSocket|<|no|<|\\\\.\\pipe\\agent.sock|The control socket, used to send runtime commands with '-R' option.|
|DebugLevel|<|no|0-5|3|Specifies debug level:<br>0 - basic information about starting and stopping of Zabbix processes<br>1 - critical information<br>2 - error information<br>3 - warnings<br>4 - for debugging (produces lots of information)<br>5 - extended debugging (produces even more information)|
|DenyKey|<|no|<|<|Deny execution of those item keys that match a pattern. Key pattern is a wildcard expression that supports "\*" character to match any number of any characters.<br>Multiple key matching rules may be defined in combination with AllowKey. The parameters are processed one by one according to their appearance order.<br>This parameter is supported since Zabbix 5.0.0.<br>See also: [Restricting agent checks](/manual/config/items/restrict_checks).|
|EnablePersistentBuffer|<|no|0-1|0|Enable usage of local persistent storage for active items.<br>0 - disabled<br>1 - enabled<br>If persistent storage is disabled, the memory buffer will be used.|
|HostInterface|<|no|0-255 characters|<|Optional parameter that defines host interface.<br>Host interface is used at host autoregistration process.<br>An agent will issue an error and not start if the value is over the limit of 255 characters.<br>If not defined, value will be acquired from HostInterfaceItem.<br>Supported since Zabbix 4.4.0.|
|HostInterfaceItem|<|no|<|<|Optional parameter that defines an item used for getting host interface.<br>Host interface is used at host autoregistration process.<br>During an autoregistration request an agent will log a warning message if the value returned by specified item is over limit of 255 characters.<br>This option is only used when HostInterface is not defined.<br>Supported since Zabbix 4.4.0.|
|HostMetadata|<|no|0-255 characters|<|Optional parameter that defines host metadata. Host metadata is used at host autoregistration process.<br>An agent will issue an error and not start if the specified value is over the limit or a non-UTF-8 string.<br>If not defined, the value will be acquired from HostMetadataItem.|
|HostMetadataItem|<|no|<|<|Optional parameter that defines an item used for getting host metadata. Host metadata item value is retrieved on each autoregistration attempt for host autoregistration process.<br>During an autoregistration request an agent will log a warning message if the value returned by the specified item is over the limit of 255 characters.<br>This option is only used when HostMetadata is not defined.<br>Supports UserParameters and aliases. Supports *system.run\[\]* regardless of *EnableRemoteCommands* value.<br>The value returned by the item must be a UTF-8 string otherwise it will be ignored.|
|Hostname|<|no|<|Set by HostnameItem|List of comma-delimited unique, case-sensitive hostnames.<br>Required for active checks and must match hostnames as configured on the server. Value is acquired from HostnameItem if undefined.<br>Allowed characters: alphanumeric, '.', ' ', '\_' and '-'.<br>Maximum length: 128 characters per hostname, 2048 characters for the entire line.|
|HostnameItem|<|no|<|system.hostname|Item used for generating Hostname if it is not defined. Ignored if Hostname is defined.<br>Does not support UserParameters or aliases, but does support *system.run\[\]* regardless of *EnableRemoteCommands* value.<br>The output length is limited to 512KB.|
|Include|<|no|<|<|You may include individual files or all files in a directory in the configuration file.<br>During installation Zabbix will create the include directory in /usr/local/etc, unless modified during the compile time.<br>To only include relevant files in the specified directory, the asterisk wildcard character is supported for pattern matching. For example: `/absolute/path/to/config/files/*.conf`.<br>See [special notes](special_notes_include) about limitations.|
|ListenIP|<|no|<|0.0.0.0|List of comma-delimited IP addresses that the agent should listen on.<br>The first IP address is sent to Zabbix server, if connecting to it, to retrieve the list of active checks.|
|ListenPort|<|no|1024-32767|10050|Agent will listen on this port for connections from the server.|
|LogFile|<|yes, if LogType is set to *file*, otherwise<br>no|<|c:\\zabbix\_agent2.log|Log file name if LogType is 'file'.|
|LogFileSize|<|no|0-1024|1|Maximum size of log file in MB.<br>0 - disable automatic log rotation.<br>*Note*: If the log file size limit is reached and file rotation fails, for whatever reason, the existing log file is truncated and started anew.|
|LogType|<|no|<|file|Specifies where log messages are written to:<br>*system* - syslog,<br>*file* - file specified by LogFile parameter,<br>*console* - standard output.|
|PersistentBufferFile|<|no|<|<|The file, where Zabbix Agent2 should keep SQLite database.<br>Must be a full filename.<br>This parameter is only used if persistent buffer is enabled (*EnablePersistentBuffer=1*).|
|PersistentBufferPeriod|<|no|1m-365d|1h|The time period for which data should be stored, when there is no connection to the server or proxy. Older data will be lost. Log data will be preserved.<br>This parameter is only used if persistent buffer is enabled (*EnablePersistentBuffer=1*).|
|Plugins|<|no|<|<|A plugin can have one or more plugin-specific configuration parameters in the format:<br>Plugins.<PluginName>.<Parameter1>=<value1><br>Plugins.<PluginName>.<Parameter2>=<value2>|
|<|Plugins.<PluginName>.KeepAlive|no|60-900|300|The maximum time of waiting (in seconds) before unused plugin connections are closed.<br>Supported for the following plugins: *Ceph, Memcached, MongoDB, MySQL, Oracle, Redis, PostgreSQL*.<br>**<PluginName>** - name of the plugin.<br>Example: `Plugins.Memcached.KeepAlive=200`|
|<|Plugins.<PluginName>.Timeout|no|1-30|global timeout|Request execution timeout (how long to wait for a request to complete before shutting it down).<br>Supported for the following plugins: *Docker, Memcached, Modbus, MongoDB, MQTT, MySQL, Redis, PostgreSQL, Smart, WebCertificate*.|
|<|Plugins.Ceph.InsecureSkipVerify|no|false / true|false|Determines whether an http client should verify the server's certificate chain and host name.<br>If *true*, TLS accepts any certificate presented by the server and any host name in that certificate. In this mode, TLS is susceptible to man-in-the-middle attacks (should be used only for testing).|
|<|Plugins.Docker.Endpoint|no|<|unix:///var/run/docker.sock|Docker daemon unix-socket location.<br>Must contain a scheme (only `unix://` is supported).|
|<|Plugins.Log.MaxLinesPerSecond|no|1-1000|20|Maximum number of new lines the agent will send per second to Zabbix server or proxy when processing 'log' and 'eventlog' active checks.<br>The provided value will be overridden by the parameter 'maxlines',<br>provided in 'log' or 'eventlog' item key.<br>*Note*: Zabbix will process 10 times more new lines than set in *MaxLinesPerSecond* to seek the required string in log items.<br>This parameter is supported since 4.4.2 and replaces MaxLinesPerSecond.|
|<|Plugins.Oracle.CallTimeout|no|1-30|global timeout|The maximum wait time in seconds for a request to be completed.|
|<|Plugins.Oracle.ConnectTimeout|no|1-30|global timeout|The maximum wait time in seconds for a connection to be established.|
|<|Plugins.Oracle.CustomQueriesPath|no|<|<|Full pathname of a directory containing .sql files with custom queries.<br>Disabled by default.<br>Example: `/etc/zabbix/oracle/sql`|
|<|Plugins.Oracle.Service|no|<|XE|A service name to be used for connection (SID is not supported).|
|<|Plugins.Postgres.Host|no|<|localhost|IP address or DNS name of the host used for PostgreSQL.<br>Examples: `localhost`, `192.168.1.1`<br>|
|<|Plugins.Postgres.Port|no|<|5432|A port to be used for PostgreSQL.|
|<|Plugins.Smart.Path|no|<|smartctl|Path to the smartctl executable.|
|<|Plugins.SystemRun.LogRemoteCommands|no|<|0|Enable logging of executed shell commands as warnings.<br>0 - disabled<br>1 - enabled<br>Commands will be logged only if executed remotely. Log entries will not be created if system.run\[\] is launched locally by HostMetadataItem, HostInterfaceItem or HostnameItem parameters.<br>This parameter is supported since 4.4.2 and replaces LogRemoteCommands.|
|<|Plugins.WindowsEventlog.MaxLinesPerSecond|no|1-1000|20|Maximum number of new lines the agent will send per second to Zabbix Server or Proxy processing 'eventlog' checks.<br>The provided value will be overridden by the parameter 'maxlines', provided in 'eventlog' item keys.|
|Plugins' named sessions|<|no|<|<|If Zabbix agent is used to monitor several instances of the same kind, you can create a named session with own set of authorization parameters for each instance. Named session parameters format:<br>Plugins.<PluginName>.<SessionName1>.<Parameter1>=<value1><br>Plugins.<PluginName>.<SessionName2>.<Parameter1>=<value2>|
|<|Plugins.<PluginName>.Sessions.<SessionName>.Password|no|<|<|Named session password.<br>Supported for: *Memcached, MongoDB, MySQL, Oracle, PostgreSQL, Redis*.<br>**<PluginName>** - name of the plugin.<br>**<SessionName>** - name of a session for using in item keys.|
|<|Plugins.<PluginName>.Sessions.<SessionName>.TLSCAFile|no|<|<|Full pathname of a file containing the top-level CA(s) certificates for peer certificate verification, used for encrypted communications between Zabbix agent 2 and monitored databases.<br>Supported for: *MySQL, PostgreSQL*.<br>**<PluginName>** - name of the plugin.<br>**<SessionName>** - name of a session for using in item keys.|
|<|Plugins.<PluginName>.Sessions.<SessionName>.TLSCertFile|no|<|<|Full pathname of a file containing the agent certificate or certificate chain, used for encrypted communications between Zabbix agent 2 and monitored databases.<br>Supported for: *MySQL, PostgreSQL*.<br>**<PluginName>** - name of the plugin.<br>**<SessionName>** - name of a session for using in item keys.|
|<|Plugins.<PluginName>.Sessions.<SessionName>.TLSConnect|no|<|<|Encryption type for communications between Zabbix agent 2 and monitored databases.<br>Supported for: *MySQL, PostgreSQL*.<br>**<PluginName>** - name of the plugin.<br>**<SessionName>** - name of a session for using in item keys.<br><br>Accepted values:<br>*required* - require TLS connection;<br>*verify\_ca* - verify certificates;<br>*verify\_full* - verify certificates and IP address.|
|<|Plugins.<PluginName>.Sessions.<SessionName>.TLSKeyFile|no|<|<|Full pathname of a file containing the database private key used for encrypted communications between Zabbix agent 2 and monitored databases.<br>Supported for: *MySQL, PostgreSQL*.<br>**<PluginName>** - name of the plugin.<br>**<SessionName>** - name of a session for using in item keys.|
|<|Plugins.<PluginName>.Sessions.<SessionName>.User|no|<|<|Named session username.<br>Supported for: *Ceph, Memcached, MongoDB, MySQL, Oracle, PostgreSQL*.<br>**<PluginName>** - name of the plugin.<br>**<SessionName>** - name of a session for using in item keys.|
|<|Plugins.Ceph.Sessions.<SessionName>.ApiKey|no|<|<|Named session API key.<br>Supported for: *Ceph*.<br>**<PluginName>** - name of the plugin.<br>**<SessionName>** - name of a session for using in item keys.|
|<|Plugins.Ceph.Sessions.<SessionName>.Uri|no|<|https://localhost:8003|Connection string of a named session.<br>**<SessionName>** - name of a session for using in item keys.<br><br>Should not include embedded credentials (they will be ignored).<br>Must match the URI format.<br>Only `https` scheme is supported; a scheme can be omitted (since version 5.2.3).<br>A port can be omitted (default=8003).<br>Examples: `https://127.0.0.1:8003`<br>`localhost`|
|<|Plugins.Memcached.Sessions.<SessionName>.Uri|no|<|tcp://localhost:11211|Connection string of a named session.<br>**<SessionName>** - name of a session for using in item keys.<br><br>Should not include embedded credentials (they will be ignored).<br>Must match the URI format.<br>Supported schemes: `tcp`, `unix`; a scheme can be omitted (since version 5.2.3).<br>A port can be omitted (default=11211).<br>Examples: `tcp://localhost:11211`<br>`localhost`<br>`unix:/var/run/memcached.sock`|
|<|Plugins.Modbus.Sessions.<SessionName>.Endpoint|no|<|<|Endpoint of a named session.<br>Supported for: *Modbus*.<br>**<SessionName>** - name of a session for using in item keys.<br>Example: `Plugins.Modbus.Sessions.MB1.Endpoint=tcp://127.0.0.1:502`<br>*Note* that this named session parameter is checked only if the value provided in the [item key](/manual/config/items/itemtypes/zabbix_agent) endpoint parameter is empty.|
|<|Plugins.Modbus.Sessions.<SessionName>.SlaveID|no|<|<|Slave ID of a named session.<br>Supported for: *Modbus*.<br>**<SessionName>** - name of a session for using in item keys.<br>Example: `Plugins.Modbus.Sessions.MB1.SlaveID=20`<br>*Note* that this named session parameter is checked only if the value provided in the [item key](/manual/config/items/itemtypes/zabbix_agent) slave ID parameter is empty.|
|<|Plugins.Modbus.Sessions.<SessionName>.Timeout|no|<|<|Timeout of a named session.<br>Supported for: *Modbus*.<br>**<SessionName>** - name of a session for using in item keys.<br>Example: `Plugins.Modbus.Sessions.MB1.Timeout=2`|
|<|Plugins.Mongo.Sessions.<SessionName>.Uri|no|<|<|Connection string of a named session.<br>**<SessionName>** - name of a session for using in item keys.<br><br>Should not include embedded credentials (they will be ignored).<br>Must match the URI format.<br>Only `tcp` scheme is supported; a scheme can be omitted.<br>A port can be omitted (default=27017).<br>Examples: `tcp://127.0.0.1:27017`, `tcp:localhost`, `localhost`|
|<|Plugins.Mysql.Sessions.<SessionName>.Uri|no|<|tcp://localhost:3306|Connection string of a named session.<br>**<SessionName>** - name of a session for using in item keys.<br><br>Should not include embedded credentials (they will be ignored).<br>Must match the URI format.<br>Supported schemes: `tcp`, `unix`; a scheme can be omitted (since version 5.2.3).<br>A port can be omitted (default=3306).<br>Examples: `tcp://localhost:3306`<br>`localhost`<br>`unix:/var/run/mysql.sock`|
|<|Plugins.Oracle.Sessions.<SessionName>.Service|no|<|<|Named session service name to be used for connection (SID is not supported).<br>Supported for: *Oracle*.<br>**<PluginName>** - name of the plugin.<br>**<SessionName>** -name of a session for using in item keys.|
|<|Plugins.Oracle.Sessions.<SessionName>.Uri|no|<|tcp://localhost:1521|Named session connection string for Oracle.<br>**<SessionName>** - name of a session for using in item keys.<br><br>Should not include embedded credentials (they will be ignored).<br>Must match the URI format.<br>Only `tcp` scheme is supported; a scheme can be omitted (since version 5.2.3).<br>A port can be omitted (default=1521).<br>Examples: `tcp://127.0.0.1:1521`<br>`localhost`|
|<|Plugins.Postgres.Sessions.<SessionName>.Database|no|<|postgres|Database name of a named session.<br>**<SessionName>** - name of a session for using in item keys.|
|<|Plugins.Redis.Sessions.<SessionName>.Uri|no|<|tcp://localhost:6379|Connection string of a named session.<br>**<SessionName>** - name of a session for using in item keys.<br><br>Should not include embedded credentials (they will be ignored).<br>Must match the URI format.<br>Supported schemes: `tcp`, `unix`; a scheme can be omitted (since version 5.2.3).<br>A port can be omitted (default=6379).<br>Examples: `tcp://localhost:6379`<br>`localhost`<br>`unix:/var/run/redis.sock`|
|RefreshActiveChecks|<|no|60-3600|120|How often the list of active checks is refreshed, in seconds.<br>Note that after failing to refresh active checks the next refresh will be attempted after 60 seconds.|
|Server|<|yes|<|<|List of comma-delimited IP addresses, optionally in CIDR notation, or DNS names of Zabbix servers and Zabbix proxies.<br>Incoming connections will be accepted only from the hosts listed here.<br>If IPv6 support is enabled then '127.0.0.1', '::ffff:127.0.0.1' are treated equally and '::/0' will allow any IPv4 or IPv6 address.<br>'0.0.0.0/0' can be used to allow any IPv4 address.<br>Example: Server=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com<br>Spaces are allowed.|
|ServerActive|<|no|<|<|List of comma-delimited IP:port (or DNS name:port) pairs of Zabbix servers and Zabbix proxies for active checks.<br>Multiple addresses can be provided to use several independent Zabbix servers in parallel. Spaces are allowed.<br>If port is not specified, default port is used.<br>IPv6 addresses must be enclosed in square brackets if port for that host is specified.<br>If port is not specified, square brackets for IPv6 addresses are optional.<br>If this parameter is not specified, active checks are disabled.<br>Example: ServerActive=127.0.0.1:20051,zabbix.example.com,\[::1\]:30051,::1,\[12fc::1\]|
|SourceIP|<|no|<|<|Source IP address for:<br>- outgoing connections to Zabbix server or Zabbix proxy;<br>- making connections while executing some items (web.page.get, net.tcp.port, etc.)|
|StatusPort|<|no|1024-32767|<|If set, agent will listen on this port for HTTP status requests (http://localhost:<port>/status).|
|Timeout|<|no|1-30|3|Spend no more than Timeout seconds on processing.|
|TLSAccept|<|yes, if TLS certificate or PSK parameters are defined (even for *unencrypted* connection), otherwise no|<|<|What incoming connections to accept. Used for a passive checks. Multiple values can be specified, separated by comma:<br>*unencrypted* - accept connections without encryption (default)<br>*psk* - accept connections with TLS and a pre-shared key (PSK)<br>*cert* - accept connections with TLS and a certificate|
|TLSCAFile|<|no|<|<|Full pathname of a file containing the top-level CA(s) certificates for peer certificate verification, used for encrypted communications between Zabbix components.|
|TLSCertFile|<|no|<|<|Full pathname of a file containing the agent certificate or certificate chain, used for encrypted communications with Zabbix components.|
|TLSConnect|<|yes, if TLS certificate or PSK parameters are defined (even for *unencrypted* connection), otherwise no|<|<|How the agent should connect to Zabbix server or proxy. Used for active checks. Only one value can be specified:<br>*unencrypted* - connect without encryption (default)<br>*psk* - connect using TLS and a pre-shared key (PSK)<br>*cert* - connect using TLS and a certificate|
|TLSCRLFile|<|no|<|<|Full pathname of a file containing revoked certificates. This parameter is used for encrypted communications with Zabbix components.|
|TLSKeyFile|<|no|<|<|Full pathname of a file containing the agent private key used for encrypted communications with Zabbix components.|
|TLSPSKFile|<|no|<|<|Full pathname of a file containing the agent pre-shared key used for encrypted communications with Zabbix components.|
|TLSPSKIdentity|<|no|<|<|Pre-shared key identity string, used for encrypted communications with Zabbix server.|
|TLSServerCertIssuer|<|no|<|<|Allowed server (proxy) certificate issuer.|
|TLSServerCertSubject|<|no|<|<|Allowed server (proxy) certificate subject.|
|UnsafeUserParameters|<|no|0,1|0|Allow all characters to be passed in arguments to user-defined parameters.<br>The following characters are not allowed:<br>\\ ' " \` \* ? \[ \] { } \~ $ ! & ; ( ) < > \| \# @<br>Additionally, newline characters are not allowed.|
|UserParameter|<|no|<|<|User-defined parameter to monitor. There can be several user-defined parameters.<br>Format: UserParameter=<key>,<shell command><br>Note that shell command must not return empty string or EOL only.<br>Shell commands may have relative paths, if UserParameterDir parameter is specified.<br>Examples:<br>UserParameter=system.test,who\|wc -l<br>UserParameter=check\_cpu,./custom\_script.sh|
|UserParameterDir|<|no|<|<|Default search path for UserParameter commands. If used, the agent will change its working directory to the one specified here before executing a command. Thereby, UserParameter commands can have a relative `./` prefix instead of a full path.<br>Only one entry is allowed.<br>Example: UserParameterDir=/opt/myscripts|

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