# 4 Zabbix агент (Windows)

Поддерживаемые параметры в файле конфигурации Zabbix агента (Windows):

|Параметр|Обязательный|Диапазон|Умолчание|Описание|
|----------------|------------------------|----------------|------------------|----------------|
|Alias|нет|<|<|Задает алиас ключу элемента данных. Его можно использовать для замены длинных и сложных ключей элементов данных на более простые и короткие.<br>Можно добавлять несколько параметров *Alias*. Несколько параметров с одинаковым ключем *Alias* не допускаются.<br>Несколько ключей *Alias* могут ссылаться на один и тот же ключ.<br>Например, получение с сервера использования файла подкачки в процентах:<br>Alias=pg\_usage:perf\_counter\[\\Paging File(\_Total)\\% Usage\]<br>Теперь можно использовать сокращенный ключ pg\_usage, чтобы получать данные.<br>Алиасы можно использовать в *HostMetadataItem*, но нельзя в *HostnameItem* и *PerfCounter* параметрах.|
|BufferSend|нет|1-3600|5|Не хранить данные в буфере дольше N секунд.|
|BufferSize|нет|2-65535|100|Максимальное количество значений в буфере памяти. Агент будет отправлять<br>все собранные данные Zabbix серверу или прокси при заполнении буфера.|
|DebugLevel|нет|0-4|3|Задает уровень журналирования:<br>0 - основная информация о запуске и остановки процессов Zabbix<br>1 - критичная информация<br>2 - информация об ошибках<br>3 - предупреждения<br>4 - для отладки (записывается очень много информации)<br>5 - расширенная отладка (В настоящее время идентичен уровню 4. Можно задать только с помощью опций контроля управления.)|
|EnableRemoteCommands|нет|<|0|Разрешены ли удаленные команды с Zabbix сервера.<br>0 - не разрешены<br>1 - разрешены|
|HostMetadata|нет|0-255 символов|<|Опциональный параметр, который задает метаданные узла сети. Метаданные узла сети используются только в процессе автоматической регистрации узлов сети (активный агент).<br>Если не определено, то значение берётся от HostMetadataItem.<br>Агент выдаст ошибку и не запустится, если указанное значение выходит за лимит длины строки или не является UTF-8 строкой.<br>Этот параметр поддерживается с версии 2.2.0 и выше.|
|HostMetadataItem|нет|<|<|Опциональный параметр, который задает элемент данных *Zabbix агент*, который используется для получения метаданных узла сети. Этот параметр используется только, если HostMetadata не определен.<br>Поддерживаются UserParameters и алиасы. Поддерживается *system.run\[\]* независимо от значения *EnableRemoteCommands*.<br>Метаданные узла сети используются только в процессе автоматической регистрации узлов сети (активный агент).<br>В процессе запроса авторегистрации агент запишет в журнал предупреждающее сообщение, если полученное значение от указанного элемента данных выходит за лимит в 255 символов.<br>Значение полученное от указанного элемента данных должно являться UTF-8 строкой, в противном случае оно будет игнорироваться.<br>Этот параметр поддерживается с версии 2.2.0 и выше.|
|Hostname|нет|<|Задается HostnameItem'ом|Уникальное, регистрозависимое имя хоста.<br>Требуется для активных проверок и должно совпадать с именем узла сети указанном на сервере.<br>Допустимые символы: буквенно-цифровые, '.', ' ', '\_' и '-'.<br>Максимальная длина: 64|
|HostnameItem|нет|<|system.hostname|Опциональный параметр, который задает элемент данных *Zabbix агент*, который используется для получения имени хоста. Этот параметр используется только, если Hostname не определен.<br>Не поддерживает UserParameters, счетчики производительности и алиасы, но поддерживает system.run\[\], независимо от значения EnableRemoteCommands.<br>Этот параметр поддерживается с версии 1.8.6 и более новыми.<br>Смотрите также [более детальное описание](/ru/manual/appendix/install/windows_agent#настройка).|
|Include|нет|<|<|Вы можете включить отдельные файлы или все файлы из папки с файлом конфигурации.<br>Для включения только необходимых файлов из указанной папки, поддерживается символ звездочки для поиска совпадения по маске. Например: `/абсолютный/путь/к/файлам/конфигурации/*.conf`. Совпадение с маской поддерживается начиная с **Zabbix 2.4.0.**<br>Смотрите [специальные заметки](special_notes_include) по поводу ограничений.|
|ListenIP|нет|<|0.0.0.0|Список IP адресов, разделенных запятой, на которых агент должен слушать.<br>Несколько IP адресов поддерживаются начиная с Zabbix 1.8.3.|
|ListenPort|нет|1024-32767|10050|Агент будет слушать этот порт для подключений с сервера.|
|LogFile|нет|<|<|Имя файла журнала.<br>Если не задано, используется Журнал событий Windows.|
|LogFileSize|нет|0-1024|1|Максимальный размер файла журнала в МБ.<br>0 - отключение автоматической ротации журнала.<br>*Примечание*: Если лимит достигнут и ротация не удалась, по каким-либо причинам, существующий файл журнала очищается и начинается новый.|
|LogRemoteCommands|нет|<|0|Включение журналирования выполняемых shell команд как предупреждений.<br>0 - отключено<br>1 - включено|
|MaxLinesPerSecond|нет|1-1000|100|Максимальное количество новых строк в секунду, которые агент будет отправлять серверу или прокси при обработке активных проверок 'log', 'logrt' и 'eventlog'.<br>Указаное значение будет перезаписано параметром 'maxlines',<br>указанное в ключах элементов данных 'log', 'logrt' и 'eventlog'.|
|PerfCounter|нет|<|<|Синтаксис: <имя\_параметра>,"<путь\_к\_счетчику\_производительности>",<период><br>Определяет новый параметр <имя\_параметра>, который является усредненным значением < путь\_к\_счетчику\_производительности > счетчика производительности системы за указанный период времени <период> (в секундах).<br>Например, если хотите получать среднее количество прерываний процессора в секунду за последнюю минуту, вы можете задать новый параметр "interrupts", как:<br>PerfCounter = interrupts,"\\Processor(0)\\Interrupts/sec",60<br>Пожалуйста, обратите внимание на двойные кавычки вокруг пути счетчика производительности.<br>Имя параметра (interrupts) используется как ключ элемента данных, при создании элемента данных.<br>Образцы для вычисления среднего значения берутся каждую секунду.<br>Вы можете выполнить "typeperf -qx", чтобы получить список всех счетчиков производительности доступных в Windows.|
|RefreshActiveChecks|нет|60-3600|120|Как часто обновлять список активных проверок, в секундах.<br>Обратите внимание, что после неуспешного обновления активных проверок, следующая попытка будет предпринята через 60 секунд.|
|Server|нет|<|<|Список разделенных запятой IP адресов (или имен хостов) Zabbix серверов. Пробелы допустимы начиная с Zabbix 2.2.<br>Входящие соединения будут приниматься только с хостов указанных в этом списке.<br>Если включена поддержка IPv6, то '127.0.0.1', '::127.0.0.1', '::ffff:127.0.0.1' обрабатываются одинаково.|
|ServerActive|нет|<|<|Список пар IP:порт (или имя хоста:порт) Zabbix серверов или Zabbix прокси для активных проверок.<br>Можно указывать несколько адресов разделенных запятыми, чтобы параллельно использовать несколько независимых Zabbix серверов. Пробелы не допустимы.<br>Если порт не указан, то используется порт по умолчанию.<br>IPv6 адреса должны быть заключены в квадратные скобки, если для хоста указывается порт.<br>Если порт порт не указан, то квадратные скобки для IPv6 адресов опциональны.<br>Если параметр не указан, активные проверки отключены.|
|SourceIP|нет|<|<|Локальный IP адрес для исходящих подключений.|
|StartAgents|нет|0-63 (\*)|3|Количество пре-форков экземпляров zabbix\_agentd, которые обрабатывают пассивные проверки.<br>Если указано значение равное 0, то пассивные проверки будут отключены и агент не будет слушать какой-либо TCP порт.<br>Максимальное количество 16 до версии 1.8.5.|
|Timeout|нет|1-30|3|Тратить не более Timeout секунд при обработке|
|UnsafeUserParameters|нет|0,1|0|Разрешить все символы, которые можно передать аргументами в пользовательские параметры.<br>0 - не разрешать<br>1 - разрешать|
|UserParameter|нет|<|<|Пользовательский параметр для мониторинга. Можно указать нескольких пользовательских параметров.<br>Формат: UserParameter=<ключ>,<shell команда><br>Обратите внимание, что команда не должна возвращать только пустую строку или EOL.<br>Например: UserParameter=system.test,echo 1|

::: noteclassic
 (\*) Количество активных серверов, перечисленных в
ServerActive, плюс количество пре-форк экземпляров для пассивных
проверок, указанных в StartAgents, должно быть меньше 64.
:::

::: noteclassic
В Zabbix агенте версии 2.0.0 параметры конфигурации
связанные с активными и пассивными проверками изменены.\
Смотрите раздел ["Смотрите также"](#see_also) внизу этой страницы для
получения более подробных сведений об эти изменениях.
:::

::: noteclassic
Zabbix поддерживает файлы конфигурации только в кодировке
UTF-8 без
[BOM](https://ru.wikipedia.org/wiki/Маркер_последовательности_байтов).\
\
Комментарии, начинающиеся с "\#", поддерживаются только в начале
строки.
:::

### Смотрите также

1.  [Различия в конфигурациях Zabbix агента активных и пассивных
    проверок начиная с версии 2.0.0
    \[en\]](http://blog.zabbix.com/multiple-servers-for-active-agent-sure/858)