[comment]: # attributes: notoc [comment]: # ({7f44ce82-7f44ce82}) # 4. Zabbix агент 2 (UNIX) [comment]: # ({/7f44ce82-7f44ce82}) [comment]: # ({ea15c697-d5608d34}) ### Обзор Zabbix agent 2 — это агент Zabbix нового поколения, который может использоваться вместо Zabbix agent. Параметры, поддерживаемые файлом конфигурации Zabbix agent 2 (zabbix\_agent2.conf), перечислены в этом разделе. Параметры приведены без дополнительной информации. Нажмите на параметр, чтобы увидеть полные сведения. |Parameter|Description| |--|--------| |[Alias](#alias)|Задает псевдоним для ключа элемента данных.| |[AllowKey](#allowkey)|Разрешает выполнение тех ключей элементов данных, которые соответствуют шаблону.| |[BufferSend](#buffersend)|Не хранить данные в буфере дольше N секунд.| |[BufferSize](#buffersize)|Максимальное количество значений в буфере памяти.| |[ControlSocket](#controlsocket)|Управляющий сокет, используемый для отправки команд во время выполнения с помощью опции '-R'.| |[DebugLevel](#debuglevel)|Уровень отладки.| |[DenyKey](#denykey)|Запрещает выполнение тех ключей элементов данных, которые соответствуют шаблону.| |[EnablePersistentBuffer](#enablepersistentbuffer)|Включает использование локального постоянного хранилища для активных элементов данных.| |[ForceActiveChecksOnStart](#forceactivechecksonstart)|Выполнять активные проверки сразу после перезапуска для первой полученной конфигурации.| |[HeartbeatFrequency](#heartbeatfrequency)|Частота сообщений heartbeat в секундах.| |[HostInterface](#hostinterface)|Необязательный параметр, определяющий интерфейс узла сети.| |[HostInterfaceItem](#hostinterfaceitem)|Необязательный параметр, определяющий элемент данных, используемый для получения интерфейса узла сети.| |[HostMetadata](#hostmetadata)|Необязательный параметр, определяющий метаданные узла сети.| |[HostMetadataItem](#hostmetadataitem)|Необязательный параметр, определяющий элемент данных Zabbix agent, используемый для получения метаданных узла сети.| |[Hostname](#hostname)|Необязательный параметр, определяющий имя узла сети.| |[HostnameItem](#hostnameitem)|Необязательный параметр, определяющий элемент данных Zabbix agent, используемый для получения имени узла сети.| |[Include](#include)|В файл конфигурации можно включать отдельные файлы или все файлы из каталога.| |[ListenIP](#listenip)|Список IP-адресов, разделенных запятыми, на которых агент должен прослушивать соединения.| |[ListenPort](#listenport)|Агент будет прослушивать этот порт для соединений с сервера.| |[LogFile](#logfile)|Имя файла журнала.| |[LogFileSize](#logfilesize)|Максимальный размер файла журнала.| |[LogType](#logtype)|Тип вывода журнала.| |[PersistentBufferFile](#persistentbufferfile)|Файл, в котором Zabbix agent 2 должен хранить базу данных SQLite.| |[PersistentBufferPeriod](#persistentbufferperiod)|Период времени, в течение которого данные должны храниться при отсутствии соединения с сервером или прокси.| |[PidFile](#pidfile)|Имя файла PID.| |[Plugins..System.Capacity](#plugins.systemcapacity)|Ограничение на количество проверок на плагин, которые могут выполняться одновременно.| |[Plugins.Log.MaxLinesPerSecond](#plugins.log.maxlinespersecond)|Максимальное количество новых строк, которое агент будет отправлять в секунду на сервер Zabbix или прокси при обработке активных проверок 'log' и 'logrt'.| |[Plugins.SystemRun.LogRemoteCommands](#plugins.systemrun.logremotecommands)|Включает ведение журнала выполненных команд оболочки как предупреждений.| |[PluginSocket](#pluginsocket)|Путь к UNIX-сокету для взаимодействия загружаемых плагинов.| |[PluginTimeout](#plugintimeout)|Тайм-аут для соединений с загружаемыми плагинами, в секундах.| |[RefreshActiveChecks](#refreshactivechecks)|Как часто обновляется список активных проверок.| |[Server](#server)|Список IP-адресов, разделенных запятыми, при необходимости в нотации CIDR, или DNS-имен серверов Zabbix и прокси Zabbix.| |[ServerActive](#serveractive)|Адрес сервера Zabbix/прокси или конфигурация кластера, откуда получать активные проверки.| |[SourceIP](#sourceip)|Исходный IP-адрес.| |[StatusPort](#statusport)|Если задан, агент будет прослушивать этот порт для HTTP-запросов состояния (http://localhost:/status).| |[Timeout](#timeout)|Определяет, сколько времени ожидать (в секундах) установления соединения и обмена данными с прокси или сервером Zabbix.| |[TLSAccept](#tlsaccept)|Какие входящие соединения принимать.| |[TLSCAFile](#tlscafile)|Полный путь к файлу, содержащему сертификаты корневого CA, используемые для проверки сертификата узла, при зашифрованной связи между компонентами Zabbix.| |[TLSCertFile](#tlscertfile)|Полный путь к файлу, содержащему сертификат агента или цепочку сертификатов, используемые для зашифрованной связи между компонентами Zabbix.| |[TLSCipherAll](#tlscipherall)|Строка шифров OpenSSL (TLS 1.2). Переопределяет критерии выбора набора шифров по умолчанию для шифрования на основе сертификатов и PSK.| |[TLSCipherAll13](#tlscipherall13)|Строка шифров OpenSSL (TLS 1.3) для OpenSSL 1.1.1 или новее. Переопределяет критерии выбора набора шифров по умолчанию для шифрования на основе сертификатов и PSK.| |[TLSCipherCert](#tlsciphercert)|Строка шифров OpenSSL (TLS 1.2). Переопределяет критерии выбора набора шифров по умолчанию для шифрования на основе сертификатов.| |[TLSCipherCert13](#tlsciphercert13)|Строка шифров OpenSSL (TLS 1.3) для OpenSSL 1.1.1 или новее. Переопределяет критерии выбора набора шифров по умолчанию для шифрования на основе сертификатов.| |[TLSCipherPSK](#tlscipherpsk)|Строка шифров OpenSSL (TLS 1.2). Переопределяет критерии выбора набора шифров по умолчанию для шифрования на основе PSK.| |[TLSCipherPSK13](#tlscipherpsk13)|Строка шифров OpenSSL (TLS 1.3) для OpenSSL 1.1.1 или новее. Переопределяет критерии выбора набора шифров по умолчанию для шифрования на основе PSK.| |[TLSConnect](#tlsconnect)|Способ подключения агента к серверу Zabbix или прокси.| |[TLSCRLFile](#tlscrlfile)|Полный путь к файлу, содержащему отозванные сертификаты. Этот параметр используется для зашифрованной связи между компонентами Zabbix.| |[TLSKeyFile](#tlskeyfile)|Полный путь к файлу, содержащему закрытый ключ агента, используемый для зашифрованной связи между компонентами Zabbix.| |[TLSPSKFile](#tlspskfile)|Полный путь к файлу, содержащему предварительно общий ключ агента, используемый для зашифрованной связи с сервером Zabbix.| |[TLSPSKIdentity](#tlspskidentity)|Строка идентификатора предварительно общего ключа, используемая для зашифрованной связи с сервером Zabbix.| |[TLSServerCertIssuer](#tlsservercertissuer)|Разрешенный издатель сертификата сервера (прокси).| |[TLSServerCertSubject](#tlsservercertsubject)|Разрешенный субъект сертификата сервера (прокси).| |[UnsafeUserParameters](#unsafeuserparameters)|Разрешает передавать все символы в аргументах пользовательских параметров.| |[UserParameter](#userparameter)|Пользовательский параметр для мониторинга.| |[UserParameterDir](#userparameterdir)|Путь поиска по умолчанию для команд UserParameter.| Все параметры являются необязательными, если явно не указано, что параметр обязателен. Обратите внимание: - Значения по умолчанию отражают значения по умолчанию процесса, а не значения в поставляемых файлах конфигурации. - Значения поддерживают [переменные среды](/manual/appendix/config/environment_variables). - Zabbix поддерживает файлы конфигурации только в кодировке UTF-8 без [BOM](https://en.wikipedia.org/wiki/Byte_order_mark). - Комментарии, начинающиеся с "\#", поддерживаются только в начале строки. [comment]: # ({/ea15c697-d5608d34}) [comment]: # ({8085875f-1de2b54e}) ### Подробности параметра [comment]: # ({/8085875f-1de2b54e}) [comment]: # ({f3842378-29f73be6}) ##### Alias Задаёт алиас для ключа элемента данных. Его можно использовать для замены длинных и сложных ключей элементов данных на более короткие и простые.
Можно добавлять несколько параметров *Alias*. Несколько параметров с одинаковым ключом *Alias* не разрешены.
Различные ключи параметра *Alias* могут ссылаться на тот же ключ элемента данных.
Алиасы можно использовать в параметре *HostMetadataItem*, но нельзя в параметре *HostnameItem*. Пример 1: Получение числового идентификатора пользователя «zabbix». ```default Alias=zabbix.userid:vfs.file.regexp[/etc/passwd,"^zabbix:.:([0-9]+)",,,,\1] ``` Теперь для получения данных можно использовать сокращённый ключ **zabbix.userid**. Пример 2: Получение утилизации CPU с параметрами по умолчанию и с пользовательскими параметрами. ```default Alias=cpu.util:system.cpu.util Alias=cpu.util[*]:system.cpu.util[*] ``` Такая запись позволяет использовать ключ **cpu.util** для получения утилизации CPU в процентах с параметрами по умолчанию, а также использовать **cpu.util[all, idle, avg15]** для получения конкретных данных об утилизации CPU. Пример 3: Выполнение нескольких правил [низкоуровневого обнаружения](/manual/discovery/low_level_discovery), которые обрабатывают одни и те же элементы данных обнаружения. ```default Alias=vfs.fs.discovery[*]:vfs.fs.discovery ``` Теперь имеется возможность настроить несколько правил обнаружения, используя **vfs.fs.discovery** с разными параметрами для каждого правила, например, **vfs.fs.discovery[foo]**, **vfs.fs.discovery[bar]** и т.д. [comment]: # ({/f3842378-29f73be6}) [comment]: # ({3ed0c834-2ef10025}) ##### AllowKey Разрешение выполнения тех ключей элементов данных, которые соответствуют шаблону. Шаблон ключа — это выражение с подстановочным знаком, которое поддерживает символ «\*» для соответствия с любым количеством любых символов.
Можно задать несколько правил соответствия ключей в сочетании с DenyKey. Параметры обрабатываются по очереди в соответствии с порядком их появления. Смотрите также: [Ограничение проверок агента](/manual/config/items/restrict_checks). [comment]: # ({/3ed0c834-2ef10025}) [comment]: # ({b6e171ac-9a03d2b3}) ##### BufferSend Интервал времени в секундах, определяющий, как часто значения из буфера отсылаются на Zabbix сервер. Обратите внимание, что если буфер заполнен, данные будут отосланы раньше. По умолчанию: `5`
Диапазон: 1-3600 [comment]: # ({/b6e171ac-9a03d2b3}) [comment]: # ({94a46063-2df09503}) ##### BufferSize Максимальное количество значений в буфере памяти. При заполнении буфера агент будет отправлять все собранные данные Zabbix серверу или прокси. Этот параметр должен использоваться только если постоянный буфер отключён (*EnablePersistentBuffer=0*). По умолчанию: `1000`
Диапазон: 2-65535 [comment]: # ({/94a46063-2df09503}) [comment]: # ({566ec225-17ac979b}) ##### ControlSocket Сокет управления, используется при отправке команд управления при помощи опции «-R». По умолчанию: `/tmp/agent.sock` [comment]: # ({/566ec225-17ac979b}) [comment]: # ({9c071f70-3b3005f3}) ##### DebugLevel Укажите уровень отладки:
*0* — основная информация о запуске и остановке процессов Zabbix
*1* — критическая информация;
*2* — информация об ошибках;
*3* — предупреждения;
*4* — для отладки (выдает много информации);
*5* — расширенная отладка (выдает еще больше информации). По умолчанию: `3`
Диапазон: 0-5 [comment]: # ({/9c071f70-3b3005f3}) [comment]: # ({26eddabd-df723533}) ##### DenyKey Запрет выполнения тех ключей элементов данных, которые соответствуют шаблону. Шаблон ключа — это выражение с подстановочным знаком, которое поддерживает символ «\*» для соответствия с любым количеством любых символов.
Можно задать несколько правил соответствия ключей в сочетании с AllowKey. Параметры обрабатываются по очереди в соответствии с порядком их появления. Смотрите также: [Ограничение проверок агента](/manual/config/items/restrict_checks). [comment]: # ({/26eddabd-df723533}) [comment]: # ({ae3ff74a-c92bd455}) ##### EnablePersistentBuffer Включить использование локального постоянного хранилища для активных элементов данных. Если постоянное хранилище отключено, будет использован буфер памяти. По умолчанию: `0`
Значения: 0 — отключено, 1 — включено [comment]: # ({/ae3ff74a-c92bd455}) [comment]: # ({da2ce1bd-23af4c3e}) ##### ForceActiveChecksOnStart Выполнить активные проверки сразу после перезапуска для первой полученной конфигурации. Также доступно как параметр конфигурации плагина, например: `Plugins.Uptime.System.ForceActiveChecksOnStart=1` По умолчанию: `0`
Значения: 0 — отключено, 1 — включено [comment]: # ({/da2ce1bd-23af4c3e}) [comment]: # ({70ff69c8-5609258c}) ##### Частота сердцебиения Частота контрольных сообщений (heartbeat) в секундах. Используется для контроля доступности активных проверок.
0 — контрольные сообщения отключены. По умолчанию: `60`
Диапазон: 0-3600 [comment]: # ({/70ff69c8-5609258c}) [comment]: # ({cd35abda-e228570b}) ##### HostInterface Опциональный параметр, который задаёт интерфейс узла сети (IP адрес или DNS имя), используемый в процессе [авторегистрации](/manual/discovery/auto_registration) узла сети. Это значение будет использовано для заполнения интерфейса у свежесоздаваемого узла сети, можно явно настроить либо IP, либо DNS адрес. Для дополнительной информации смотрите [Использование DNS в качестве интерфейса по умолчанию](/manual/discovery/auto_registration#использование-dns-в-качестве-интерфейса-по-умолчанию). Если не задано, значение будет получено из HostInterfaceItem. Агент выдаст ошибку и не запустится, если значение превышает ограничение в 255 символов. Диапазон: 0–255 символов. [comment]: # ({/cd35abda-e228570b}) [comment]: # ({dc29c465-34145839}) ##### HostInterfaceItem Опциональный параметр, который задаёт элемент данных, используемый для получения интерфейса узла сети (IP адрес либо DNS имя) в процессе [авторегистрации](/manual/discovery/auto_registration) узла сети. Это значение используется, только если HostInterface не определён. Для дополнительной информации смотрите [Использование DNS в качестве интерфейса по умолчанию](/manual/discovery/auto_registration#использование-dns-в-качестве-интерфейса-по-умолчанию). Во время запроса на авторегистрацию агент будет выводить в журнал предупреждение, если значение, возвращаемое указанным элементом данных, превышает ограничение в 255 символов. Элемент данных [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run) поддерживается независимо от значений параметров AllowKey/DenyKey. [comment]: # ({/dc29c465-34145839}) [comment]: # ({f344dc84-0351f0ec}) ##### HostMetadata Опциональный параметр, который задаёт [метаданные](/manual/discovery/auto_registration#использование-метаданных-узла-сети) узла сети, используемые, чтобы идентифицировать или отличить узел сети в процессе [авторегистрации](/manual/discovery/auto_registration) узлов сети. HostMetadata позволяет различать узлы сети не только по имени хоста. Если не определено, то значение берётся от HostMetadataItem. Агент выдаст ошибку и не запустится, если указанное значение превышает ограничение 2034 байта или не является UTF-8 строкой. Если параметр ожидает IP адрес или DNS имя, то значения, которые являются допустимыми значениями UTF-8, но не являются допустимыми IP адресами или DNS именами, также будут отклонены и сообщены как недействительные. Многострочные метаданные не поддерживаются — вывод будет усечён по первому переводу строки. Диапазон: 0–2034 байта. [comment]: # ({/f344dc84-0351f0ec}) [comment]: # ({de201076-62d441b2}) ##### HostMetadataItem Опциональный параметр, который задаёт элемент данных, используемый для получения [метаданных узла сети](/manual/discovery/auto_registration#использование-метаданных-узла-сети). Этот параметр используется только если HostMetadata не определён. Значение HostMetadataItem извлекается на каждую попытку [авторегистрации](/manual/discovery/auto_registration) и используется только в процессе автоматической регистрации узлов сети. HostMetadata позволяет различать узлы сети не только по имени хоста. Поддерживаются UserParameters и алиасы. Элемент данных [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run) поддерживается независимо от значений параметров AllowKey/DenyKey. При запросе на авторегистрацию агент запишет в журнал предупреждение, если полученное от указанного элемента данных значение превышает ограничение в 65535 кодовых позиций (code points) UTF-8. Значение, возвращаемое указанным элементом данных, должно являться UTF-8 строкой, в противном случае оно будет игнорироваться. Если параметр ожидает IP адрес или DNS имя, то значения, которые являются допустимыми значениями UTF-8, но не являются допустимыми IP адресами или DNS именами, также будут отклонены и сообщены как недействительные. Многострочные метаданные не поддерживаются — вывод будет усечён по первому переводу строки. [comment]: # ({/de201076-62d441b2}) [comment]: # ({39406dda-14a36542}) ##### Hostname Список (через запятую) уникальных, регистрозависимых имён узла сети. Требуется для активных проверок и должно совпадать с именами узла сети, указанными на сервере. Если не задано, значение будет браться из HostnameItem.
Допустимые символы: алфавитно-цифровые, «.», « », «\_» и «-». Максимальная длина: 128 символов на имя узла сети, 2048 символов для всей строки. По умолчанию: Задаётся параметром HostnameItem [comment]: # ({/39406dda-14a36542}) [comment]: # ({77a62307-cbe03ed0}) ##### HostnameItem Опциональный параметр, который задаёт элемент данных Zabbix агента, используемый для получения имени узла сети. Этот параметр используется, только если Hostname не определён. Не поддерживает UserParameters или алиасы, но поддерживает [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run), независимо от значений AllowKey/DenyKey. По умолчанию: `system.hostname` [comment]: # ({/77a62307-cbe03ed0}) [comment]: # ({1f402df9-ba2f3511}) ##### Include Вы можете включить отдельные файлы или все файлы в каталоге в файл конфигурации. В процессе инсталляции Zabbix создаст директорию для включения файлов в /usr/local/etc, если только она не была изменена во время компиляции. Путь может быть относительным по отношению к местоположению файла *zabbix\_agent2.conf*.
Чтобы включить в указанный каталог только соответствующие файлы, для сопоставления с шаблоном поддерживается подстановочный знак звёздочки.
Смотрите [специальные заметки](special_notes_include) по поводу ограничений. Пример: ```default Include=/абсолютный/путь/к/конфиг/файлам/*.conf ``` [comment]: # ({/1f402df9-ba2f3511}) [comment]: # ({43e741ee-f99953c8}) ##### ListenIP Список (через запятую) IP адресов, которые должен слушать агент. Первый IP адрес отсылается на Zabbix сервер при подключении к нему для получения списка активных проверок. По умолчанию: `0.0.0.0` [comment]: # ({/43e741ee-f99953c8}) [comment]: # ({5f95bc53-f0fb838a}) ##### ListenPort Агент будет слушать этот порт на предмет подключений с сервера. По умолчанию: `10050`
Диапазон: 1024-32767 [comment]: # ({/5f95bc53-f0fb838a}) [comment]: # ({493335d8-b6d7fb90}) ##### LogFile Имя файла журнала. По умолчанию: `/tmp/zabbix_agent2.log`
Обязательное: Да, если LogType выставлен в *file*; в противном случае — нет [comment]: # ({/493335d8-b6d7fb90}) [comment]: # ({f7604f8f-3428c3ce}) ##### LogFileSize Максимальный размер файла журнала в МБ.
0 — отключение автоматической ротации журнала.
*Примечание*: Если лимит размера файла достигнут, а ротация по каким-либо причинам не удалась, существующий файл журнала усекается и начинается заново. По умолчанию: `1`
Диапазон: 0-1024
[comment]: # ({/f7604f8f-3428c3ce}) [comment]: # ({ae46be35-51e38b5f}) ##### Тип журнала Тип вывода журнала:
*file* — запись журнала в файл, указанный в параметре LogFile;
*system* — запись журнала в syslog;
*console* — вывод журнала в стандартный вывод. По умолчанию: `file` [comment]: # ({/ae46be35-51e38b5f}) [comment]: # ({357a4f09-5b3e2c7e}) ##### PersistentBufferFile Файл, в котором Zabbix агент 2 должен хранить базу данных SQLite. Имя файла должно быть указано с абсолютным путём. Этот параметр используется, только если включён постоянный буфер (*EnablePersistentBuffer=1*). [comment]: # ({/357a4f09-5b3e2c7e}) [comment]: # ({2937cc76-148a8da3}) ##### PersistentBufferPeriod Период времени, в течение которого должны храниться данные, когда нет соединения с сервером или прокси. Более старые данные будут потеряны. Журнальные данные будут сохранены. Этот параметр используется, только если включён постоянный буфер (*EnablePersistentBuffer=1*). По умолчанию: `1h`
Диапазон: 1m-365d [comment]: # ({/2937cc76-148a8da3}) [comment]: # ({27678307-8cadd2c5}) ##### PidFile Имя PID файла. По умолчанию: `/tmp/zabbix_agent2.pid` [comment]: # ({/27678307-8cadd2c5}) [comment]: # ({9b0fb2d6-184426b4}) ##### Plugins.<ИмяПлагина>.System.Capacity {#plugins.systemcapacity} Ограничение количества проверок на плагин `<ИмяПлагина>`, которые могут выполняться одновременно. По умолчанию: `1000` Диапазон: 1-1000 [comment]: # ({/9b0fb2d6-184426b4}) [comment]: # ({21943486-c391a1f7}) ##### Plugins.Log.MaxLinesPerSecond Максимальное количество новых строк в секунду, которые агент будет отправлять Zabbix серверу или прокси при обработке активных проверок «log» и «logrt». Указаное значение будет переопределено параметром «maxlines», указанным в ключах элементов данных «log» и «logrt».
*Примечание*: при поиске нужной строки в элементах данных журналов Zabbix будет обрабатывать в 10 раз больше новых строк, чем указано в параметре *MaxLinesPerSecond*. По умолчанию: `20`
Диапазон: 1-1000 [comment]: # ({/21943486-c391a1f7}) [comment]: # ({487e5b60-5e488d60}) ##### Plugins.SystemRun.LogRemoteCommands Разрешение журналировать выполняемые команды оболочки как предупреждения. Команды будут записаны в журнал, только если они выполняются удалённо. Записи в журнале не создаются, если system.run\[\] запускается локально параметрами HostMetadataItem, HostInterfaceItem или HostnameItem. По умолчанию: `0`
Значения: 0 — запрещено, 1 — разрешено [comment]: # ({/487e5b60-5e488d60}) [comment]: # ({ab2236de-60653974}) ##### PluginSocket Путь к файлу Unix сокета для коммуникаций с подгружаемыми плагинами. По умолчанию: `/tmp/agent.plugin.sock` [comment]: # ({/ab2236de-60653974}) [comment]: # ({14afe8ce-1bc7efe1}) ##### PluginTimeout Тайм-аут для соединений с подгружаемыми плагинами, в секундах. По умолчанию: `Timeout`
Диапазон: 1-30 [comment]: # ({/14afe8ce-1bc7efe1}) [comment]: # ({3d47a4c2-cc91d3f3}) ##### RefreshActiveChecks Как часто обновлять список активных проверок, в секундах. Обратите внимание, что после неуспешного обновления активных проверок, следующая попытка будет предпринята через 60 секунд. По умолчанию: `5`
Диапазон: 1-86400 [comment]: # ({/3d47a4c2-cc91d3f3}) [comment]: # ({bb2bfe8d-26a8e7e8}) ##### Server Список (через запятую) 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 адрес. Пробелы разрешены. Если этот параметр не указан, пассивные проверки отключаются, и агент не будет прослушивать ни один порт TCP. Пример: ```default Server=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com ``` [comment]: # ({/bb2bfe8d-26a8e7e8}) [comment]: # ({06a586ad-c466b0b1}) ##### ServerActive Адрес Zabbix сервера/прокси или конфигурация кластера для получения активных проверок. Адрес сервера/прокси — это IP адрес или DNS имя и опционально порт, разделённые двоеточием.
Конфигурация кластера — один или более адресов серверов либо члено группы прокси, разделённые символом «точка с запятой». Можно указать несколько серверов/кластеров/прокси Zabbix, разделяя их запятой. От каждого сервера/кластера Zabbix должно быть указано не более одного Zabbix прокси, если только не используются группы прокси. Если указан Zabbix прокси, то сервер/кластер Zabbix для этого прокси не должны быть указаны.
Несколько адресов через запятую можно указать для использования нескольких независимых серверов Zabbix параллельно. Пробелы разрешены.
Если порт не указан, используется порт по умолчанию.
Адреса IPv6 должны быть заключены в квадратные скобки, если для этого хоста указан порт. Если порт не указан, квадратные скобки для адресов IPv6 опциональны.
Если этот параметр не указан, активные проверки отключены. Пример для Zabbix прокси: ```default ServerActive=127.0.0.1:10051 ``` Пример для группы Zabbix прокси: ServerActive=proxy1.example.com;proxy2.example.com;proxy3.example.com;proxy4.example.com;proxy5.example.com Пример для нескольких серверов: ```default ServerActive=127.0.0.1:20051,zabbix.domain,[::1]:30051,::1,[12fc::1] ``` Пример для кластера высокой доступности: ```default ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051;zabbix.cluster.node3 ``` Пример для конфигурации высокой доступности с двумя кластерами и одним сервером: ```default ServerActive=zabbix.cluster.node1;zabbix.cluster.node2:20051,zabbix.cluster2.node1;zabbix.cluster2.node2,zabbix.domain ``` [comment]: # ({/06a586ad-c466b0b1}) [comment]: # ({76194937-5212a055}) ##### IP-адрес источника Локальный IP адрес для: - исходящих подключений к Zabbix серверу или прокси; - создания подключений при выполнении некоторых элементов данных (web.page.get, net.tcp.port и т.п.). [comment]: # ({/76194937-5212a055}) [comment]: # ({7d3f343b-14a0e16c}) ##### StatusPort Если задан, агент будет слушать указанный порт для HTTP запросов состояния (http://localhost:<порт>/status). Диапазон: 1024-32767 [comment]: # ({/7d3f343b-14a0e16c}) [comment]: # ({4f69df7d-c0cd090f}) ##### Timeout Указывает, как долго (в секундах) следует ожидать установления соединения и обмена данными с Zabbix сервером или прокси.
Этот параметр определяет продолжительность различных коммуникационных операций, в том числе: - ожидание ответа от Zabbix сервера; - отправку запросов на Zabbix сервер, в том числе запросы конфигурации элементов данных и значения элементов данных в [активных проверках](/manual/appendix/items/activepassive#активные-проверки); - получение данных журнала посредством мониторинга файла журнала; - отправка сообщений heartbeat; - максимальная длительность для проверок `vfs.*`; - служит в качестве запасного варианта в сценариях, где сервер или прокси версии старше 7.0 отправляет проверки без тайм-аутов. Этот тайм-аут **не** будет использоваться для тех проверок агента, которые имеют настраиваемые параметры тайм-аута в веб-интерфейсе (на глобальном уровне, на уровне прокси-сервера или на уровне отдельных элементов данных). По умолчанию: `3`
Диапазон: 1-30 [comment]: # ({/4f69df7d-c0cd090f}) [comment]: # ({2200adc7-50f15389}) ##### TLSAccept Какие входящие соединения принимать. Используется для пассивных проверок. Можно указать несколько значений через запятую:
*unencrypted* — принимать соединения без шифрования (по умолчанию)
*psk* — принимать подключения с TLS и общим ключом (pre-shared key, PSK)
*cert* — принимать подключения с TLS и сертификатом Обязательное: да, если заданы TLS сертификат или параметры PSK (даже для *незашифрованных* подключений), в противном случае — нет [comment]: # ({/2200adc7-50f15389}) [comment]: # ({65d07bda-7014d327}) ##### TLSCAFile Абсолютный путь к файлу, который содержит сертификаты удостоверяющих центров (certificate authority, CA) верхнего уровня для проверки сертификата узла, используется для зашифрованных соединений между компонентами Zabbix. [comment]: # ({/65d07bda-7014d327}) [comment]: # ({005f60f1-76da8f86}) ##### TLSCertFile Абсолютный путь к файлу, который содержит сертификат агента или цепочку сертификатов, используется для зашифрованных соединений между компонентами Zabbix. [comment]: # ({/005f60f1-76da8f86}) [comment]: # ({8f81e3ca-f06fce3e}) ##### TLSCipherAll Строка шифров OpenSSL (TLS 1.2). Переопределяет критерии выбора набора шифров по умолчанию для шифрования на основе сертификатов и PSK. Пример: ```default EECDH+aRSA+AES128:RSA+aRSA+AES128:kECDHEPSK+AES128:kPSK+AES128 ``` [comment]: # ({/8f81e3ca-f06fce3e}) [comment]: # ({834af6c4-78547ea1}) ##### TLSCipherAll13 Строка шифров OpenSSL (TLS 1.3) для OpenSSL 1.1.1 или более новой версии. Переопределяет критерии выбора набора шифров по умолчанию для шифрования на основе сертификатов и PSK. Пример: ```default TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256 ``` [comment]: # ({/834af6c4-78547ea1}) [comment]: # ({902617f7-02de1fc7}) ##### TLSCipherCert Строка шифров OpenSSL (TLS 1.2). Переопределяет критерии выбора набора шифров по умолчанию для шифрования на основе сертификатов. Пример: ```default EECDH+aRSA+AES128:RSA+aRSA+AES128 ``` Обратите внимание, что этот параметр нельзя использовать вместе с `TLSAccept=cert,psk`; для подключения по сертификату (`TLSConnect=cert`) вместо него используйте TLSCipherAll. [comment]: # ({/902617f7-02de1fc7}) [comment]: # ({1ec853eb-1bd16790}) ##### TLSCipherCert13 Строка шифров OpenSSL (TLS 1.3) для OpenSSL 1.1.1 или новее. Переопределяет критерии выбора набора шифров по умолчанию для шифрования на основе сертификатов. Обратите внимание, что этот параметр нельзя использовать вместе с `TLSAccept=cert,psk`; для подключения по сертификату (`TLSConnect=cert`) вместо него используйте TLSCipherAll13. [comment]: # ({/1ec853eb-1bd16790}) [comment]: # ({a7c9008e-b6a97164}) ##### TLSCipherPSK Строка шифров OpenSSL (TLS 1.2). Переопределяет критерии выбора набора шифров по умолчанию для шифрования на основе PSK. Пример: ```default kECDHEPSK+AES128:kPSK+AES128 ``` [comment]: # ({/a7c9008e-b6a97164}) [comment]: # ({d37c55b4-d4a7f685}) ##### TLSCipherPSK13 Строка шифров OpenSSL (TLS 1.3) для OpenSSL 1.1.1 или более новой версии. Переопределяет критерии выбора набора шифров по умолчанию для шифрования на основе PSK. Пример: ```default TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256 ``` [comment]: # ({/d37c55b4-d4a7f685}) [comment]: # ({e2ebc18f-48c650d6}) ##### TLSConnect Как агент должен подключаться к Zabbix серверу или прокси. Используется для активных проверок. Можно указать только одно значение:
*unencrypted* — подключаться без шифрования (по умолчанию)
*psk* — подключаться, используя TLS и общий ключ (pre-shared key, PSK)
*cert* — подключаться, используя TLS и сертификат Обязательное: да, если заданы TLS сертификат или параметры PSK (даже при *незашифрованном* соединении), в противном случае — нет [comment]: # ({/e2ebc18f-48c650d6}) [comment]: # ({ad4dc889-9039238d}) ##### TLSCRLFile Абсолютный путь к файлу, содержащему отозванные сертификаты. Этот параметр используется для зашифрованных коммуникаций между компонентами Zabbix. [comment]: # ({/ad4dc889-9039238d}) [comment]: # ({c2aa4315-27bba150}) ##### TLSKeyFile Абсолютный путь к файлу, содержащему закрытый ключ агента (private key), используется для зашифрованных коммуникаций между компонентами Zabbix. [comment]: # ({/c2aa4315-27bba150}) [comment]: # ({11defa44-e05527e5}) ##### TLSPSKFile Абсолютный путь к файлу, содержащему общий ключ (pre-shared key) агента. Используется для зашифрованных коммуникаций с сервером Zabbix. [comment]: # ({/11defa44-e05527e5}) [comment]: # ({92d3eff0-4365ff43}) ##### TLSPSKIdentity Строка идентификатора PSK, используется для зашифрованных соединений с Zabbix сервером. [comment]: # ({/92d3eff0-4365ff43}) [comment]: # ({ae5c568f-8a75a0d0}) ##### TLSServerCertIssuer Разрешённый эмитент сертификата сервера (прокси). [comment]: # ({/ae5c568f-8a75a0d0}) [comment]: # ({fb69617f-f59b720f}) ##### TLSServerCertSubject Разрешённый субъект сертификата сервера (прокси). [comment]: # ({/fb69617f-f59b720f}) [comment]: # ({8fffe818-29d4cb8b}) ##### UnsafeUserParameters Разрешить передавать аргументами в пользовательские параметры все символы. Не разрешены следующие символы: \\ ' " \` \* ? \[ \] { } \~ $ ! & ; ( ) < > \| \# @
Кроме того, не разрешены символы новой строки. По умолчанию: `0`
Значения: 0 — не разрешать, 1 — разрешить [comment]: # ({/8fffe818-29d4cb8b}) [comment]: # ({1a5d86ec-d6a6fd16}) ##### UserParameter Пользовательский параметр для мониторинга. Можно указать несколько пользовательских параметров.
Формат: UserParameter=<ключ>,<команда оболочки>
Обратите внимание, что команда не должна возвращать только пустую строку или EOL. Команды оболочки могут иметь относительные пути, если указан параметр UserParameterDir. Пример: ```default UserParameter=system.test,who|wc -l UserParameter=check_cpu,./custom_script.sh ``` [comment]: # ({/1a5d86ec-d6a6fd16}) [comment]: # ({0a46abda-7246224d}) ##### UserParameterDir Путь поиска по умолчанию для команд UserParameter. Если используется, агент перед выполнением команды сменит свою рабочую директорию на указанную здесь. Таким образом, команды UserParameter могут иметь относительный префикс `./` вместо полного пути.
Допустимо только одно значение. Пример: ```default UserParameterDir=/opt/myscripts ``` [comment]: # ({/0a46abda-7246224d})