Параметры перечислены без дополнительной информации. Нажмите на параметр, чтобы увидеть полные сведения. Нажмите на параметр, чтобы увидеть полные сведения.

Parameter	Description
Alias	Задает псевдоним для ключа элемента данных.
AllowKey	Разрешает выполнение тех ключей элементов данных, которые соответствуют шаблону.
BufferSend	Не хранить данные в буфере дольше N секунд.
BufferSize	Максимальное количество значений в буфере памяти.
ControlSocket	Управляющий сокет, используемый для отправки команд во время выполнения с помощью параметра `-R`.
DebugLevel	Уровень отладки.
DenyKey	Запрещает выполнение тех ключей элементов данных, которые соответствуют шаблону.
EnablePersistentBuffer	Включает использование локального постоянного хранилища для активных элементов данных.
ForceActiveChecksOnStart	Выполнять активные проверки сразу после перезапуска для первой полученной конфигурации.
HeartbeatFrequency	Частота отправки сообщений heartbeat в секундах.
HostInterface	Необязательный параметр, определяющий интерфейс узла сети.
HostInterfaceItem	Необязательный параметр, определяющий элемент данных, используемый для получения интерфейса узла сети.
HostMetadata	Необязательный параметр, определяющий метаданные узла сети.
HostMetadataItem	Необязательный параметр, определяющий элемент данных агента Zabbix, используемый для получения метаданных узла сети.
Hostname	Необязательный параметр, определяющий имя узла сети.
HostnameItem	Необязательный параметр, определяющий элемент данных агента Zabbix, используемый для получения имени узла сети.
Include	В файл конфигурации можно включать отдельные файлы или все файлы в каталоге.
ListenIP	Список IP-адресов, разделенных запятыми, на которых должен прослушивать агент.
ListenPort	Агент будет прослушивать этот порт для подключений от сервера.
LogFile	Имя файла журнала.
LogFileSize	Максимальный размер файла журнала.
LogType	Тип вывода журнала.
PersistentBufferFile	Файл, в котором Zabbix agent 2 должен хранить базу данных SQLite.
PersistentBufferPeriod	Период времени, в течение которого данные должны храниться при отсутствии соединения с сервером или прокси.
PidFile	Имя файла PID.
Plugins.<PluginName>.System.Capacity	Ограничение на количество проверок на плагин, которые могут выполняться одновременно.
Plugins.Log.MaxLinesPerSecond	Максимальное количество новых строк, которое агент будет отправлять в секунду на сервер Zabbix или прокси при обработке активных проверок `log` и `logrt`.
Plugins.SystemRun.LogRemoteCommands	Включает ведение журнала выполненных команд оболочки как предупреждений.
PluginSocket	Путь к UNIX-сокету для взаимодействия с загружаемыми плагинами.
PluginTimeout	Тайм-аут для подключений к загружаемым плагинам, в секундах.
RefreshActiveChecks	Как часто обновляется список активных проверок.
Server	Список IP-адресов, разделенных запятыми, при необходимости в нотации CIDR, или DNS-имен серверов Zabbix и прокси Zabbix.
ServerActive	Адрес сервера Zabbix/прокси или конфигурация кластера, откуда получать активные проверки.
SourceIP	Исходный IP-адрес.
StatusPort	Если задан, агент будет прослушивать этот порт для HTTP-запросов состояния (http://localhost:<port>/status).
Timeout	Указывает, сколько времени ожидать (в секундах) установления соединения и обмена данными с прокси или сервером Zabbix.
TLSAccept	Уровень шифрования, требуемый для входящих подключений.
TLSCAFile	Полный путь к файлу, содержащему сертификаты CA верхнего уровня для проверки сертификата узла, используемые для шифрованного обмена данными между компонентами Zabbix.
TLSCertFile	Полный путь к файлу, содержащему сертификат агента или цепочку сертификатов, используемые для шифрованного обмена данными между компонентами Zabbix.
TLSCipherAll	Строка шифров OpenSSL (TLS 1.2). Переопределяет критерии выбора набора шифров по умолчанию для шифрования на основе сертификатов и PSK.
TLSCipherAll13	Строка шифров OpenSSL (TLS 1.3) для OpenSSL 1.1.1 или новее. Переопределяет критерии выбора набора шифров по умолчанию для шифрования на основе сертификатов и PSK.
TLSCipherCert	Строка шифров OpenSSL (TLS 1.2). Переопределяет критерии выбора набора шифров по умолчанию для шифрования на основе сертификатов.
TLSCipherCert13	Строка шифров OpenSSL (TLS 1.3) для OpenSSL 1.1.1 или новее. Переопределяет критерии выбора набора шифров по умолчанию для шифрования на основе сертификатов.
TLSCipherPSK	Строка шифров OpenSSL (TLS 1.2). Переопределяет критерии выбора набора шифров по умолчанию для шифрования на основе PSK.
TLSCipherPSK13	Строка шифров OpenSSL (TLS 1.3) для OpenSSL 1.1.1 или новее. Переопределяет критерии выбора набора шифров по умолчанию для шифрования на основе PSK.
TLSConnect	Уровень шифрования, требуемый для подключений агента к серверу или прокси Zabbix.
TLSCRLFile	Полный путь к файлу, содержащему отозванные сертификаты. Этот параметр используется для шифрованного обмена данными между компонентами Zabbix.
TLSKeyFile	Полный путь к файлу, содержащему закрытый ключ агента, используемый для шифрованного обмена данными между компонентами Zabbix.
TLSPSKFile	Полный путь к файлу, содержащему предварительно общий ключ агента, используемый для шифрованного обмена данными с сервером Zabbix.
TLSPSKIdentity	Строка идентификатора предварительно общего ключа, используемая для шифрованного обмена данными с сервером Zabbix.
TLSServerCertIssuer	Разрешенный издатель сертификата сервера (прокси).
TLSServerCertSubject	Разрешенный субъект сертификата сервера (прокси).
UnsafeUserParameters	Разрешает передавать все символы в аргументах пользовательских параметров.
UserParameter	Пользовательский параметр для мониторинга.
UserParameterDir	Путь поиска по умолчанию для команд UserParameter.

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

Обратите внимание:

Значения по умолчанию отражают значения по умолчанию процесса, а не значения в поставляемых файлах конфигурации.
Zabbix поддерживает файлы конфигурации только в кодировке UTF-8 без BOM.
Комментарии, начинающиеся с #, поддерживаются только в начале строки.

Подробности параметра

Псевдоним

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

Пример 1: Получение ID пользователя zabbix.

Alias=zabbix.userid:vfs.file.regexp[/etc/passwd,"^zabbix:.:([0-9]+)",,,,\1]

Теперь можно использовать сокращенный ключ zabbix.userid для получения данных.

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

Alias=cpu.util:system.cpu.util
Alias=cpu.util[*]:system.cpu.util[*]

Это позволяет использовать ключ cpu.util для получения процента загрузки CPU с параметрами по умолчанию, а также cpu.util[all, idle, avg15] для получения конкретных данных о загрузке CPU.

Пример 3: Запуск нескольких правил low-level discovery, обрабатывающих одни и те же элементы обнаружения.

Alias=vfs.fs.discovery[*]:vfs.fs.discovery

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

AllowKey

Разрешает выполнение тех ключей элементов данных, которые соответствуют шаблону. Шаблон ключа представляет собой выражение с подстановочными знаками, которое поддерживает символ * для сопоставления с любым количеством любых символов.
Несколько правил сопоставления ключей могут быть определены в сочетании с DenyKey. Параметры обрабатываются по одному в порядке их появления. См. также: Ограничение проверок агента.

BufferSend

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

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

BufferSize

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

По умолчанию: 1000
Диапазон: 2-65535

ControlSocket

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

По умолчанию: /tmp/agent.sock

DebugLevel

Укажите уровень отладки:

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

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

DenyKey

Запрещает выполнение тех ключей элементов данных, которые соответствуют шаблону.
Шаблон ключа — это выражение с подстановочными знаками, которое поддерживает символ * для сопоставления с любым количеством любых символов.
Несколько правил сопоставления ключей могут быть определены в сочетании с AllowKey. Параметры обрабатываются по одному в порядке их появления. См. также: Ограничение проверок агента.

EnablePersistentBuffer

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

По умолчанию: 0
Значения: 0 — отключено, 1 — включено

ForceActiveChecksOnStart

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

По умолчанию: 0
Значения: 0 — отключено, 1 — включено

Частота сердцебиения

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

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

HostInterface

Необязательный параметр, который определяет интерфейс узла сети (IP-адрес или DNS-имя), используемый в процессе авторегистрации узла сети. Это значение будет использовано для заполнения интерфейса в вновь созданном узле сети и позволяет явно задать либо IP-адрес, либо DNS-адрес. Подробнее см. Использование DNS в качестве интерфейса по умолчанию.

Если не задано, значение будет получено из HostInterfaceItem.

Агент выдаст ошибку и не запустится, если значение превышает лимит в 255 символов.

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

HostInterfaceItem

Необязательный параметр, который определяет элемент данных, используемый для определения интерфейса узла сети (IP-адреса или DNS-имени) во время процесса авторегистрации. Это значение используется только в том случае, если HostInterface не определен. Дополнительные сведения см. в разделе Использование DNS в качестве интерфейса по умолчанию.

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

Элемент данных system.run[] поддерживается независимо от настроек AllowKey/DenyKey.

HostMetadata

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

Если не задано, значение будет получено из HostMetadataItem.

Агент выдаст ошибку и не запустится, если указанное значение превышает лимит в 2034 байта или является строкой не в UTF-8. Когда параметр ожидает IP-адрес или DNS-имя, значения, которые являются допустимыми UTF-8, но не являются допустимыми IP-адресами или DNS-именами, также будут отклонены и помечены как недопустимые.

Многострочные метаданные не поддерживаются — вывод будет обрезан на первом разрыве строки.

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

HostMetadataItem

Необязательный параметр, который определяет элемент данных агента Zabbix, используемый для получения метаданных узла сети. Этот параметр используется только тогда, когда HostMetadata не задан.

Значение HostMetadataItem извлекается при каждой попытке авторегистрации и используется только в процессе авторегистрации узла сети. HostMetadataItem позволяет различать узлы сети не только по имени хоста.

Поддерживаются пользовательские параметры и псевдонимы. Элемент данных system.run[] поддерживается независимо от настроек AllowKey/DenyKey.

Во время запроса авторегистрации агент запишет предупреждение, если значение, возвращаемое указанным элементом данных, превышает лимит в 65535 кодовых точек UTF-8. Значение, возвращаемое элементом данных, должно быть строкой UTF-8, иначе оно будет проигнорировано. Если параметр ожидает IP-адрес или DNS-имя, значения, которые являются допустимыми UTF-8, но не являются допустимыми IP-адресами или DNS-именами, также будут отклонены и помечены как недопустимые.

Многострочные метаданные не поддерживаются — вывод будет обрезан на первом разрыве строки.

Имя узла сети

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

По умолчанию: задается через HostnameItem

HostnameItem

Необязательный параметр, который определяет элемент данных, используемый для получения имени узла сети. Этот параметр используется только тогда, когда Hostname не задан. Пользовательские параметры или псевдонимы не поддерживаются, но элемент данных system.run[] поддерживается независимо от значений AllowKey/DenyKey.

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

Включение

Вы можете включать отдельные файлы или все файлы в каталоге в файл конфигурации. Во время установки Zabbix создаст каталог include в /usr/local/etc, если он не был изменен во время компиляции. Путь может быть относительным к расположению файла zabbix_agent2.conf.
Чтобы включать только подходящие файлы в указанном каталоге, для сопоставления шаблонов поддерживается символ подстановки звездочка.
См. special notes о ограничениях.

Пример:

Include=/absolute/path/to/config/files/*.conf

ListenIP

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

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

ListenPort

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

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

LogFile

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

По умолчанию: /tmp/zabbix_agent2.log
Обязательно: Да, если LogType установлено в file; в противном случае — нет

LogFileSize

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

По умолчанию: 1
Диапазон: 0-1024

LogType

Тип вывода журнала:

file - записывать журнал в файл, указанный параметром LogFile;
system - записывать журнал в syslog;
console - записывать журнал в стандартный вывод.

По умолчанию: file

PersistentBufferFile

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

PersistentBufferPeriod

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

По умолчанию: 1h
Диапазон: 1m-365d

PidFile

Имя PID файла.

По умолчанию: /tmp/zabbix_agent2.pid

Plugins.<ИмяПлагина>.System.Capacity

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

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

Plugins.Log.MaxLinesPerSecond

Максимальное количество новых строк, которое агент будет отправлять в секунду на сервер Zabbix или прокси при обработке активных проверок log и logrt. Указанное значение будет переопределено параметром maxlines, заданным в ключе элемента данных log и logrt.
Примечание: Zabbix будет обрабатывать в 10 раз больше новых строк, чем задано в MaxLinesPerSecond, чтобы найти требуемую строку в элементах данных журнала.

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

Plugins.SystemRun.LogRemoteCommands

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

По умолчанию: 0
Значения: 0 - отключено, 1 - включено

PluginSocket

Путь к файлу Unix сокета для коммуникаций с подгружаемыми плагинами.

По умолчанию: /tmp/agent.plugin.sock

PluginTimeout

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

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

RefreshActiveChecks

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

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

Сервер

Список 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-порт.

Пример:

Server=127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com

ServerActive

Адрес Zabbix сервера/прокси или конфигурация кластера для получения активных проверок. Адрес сервера/прокси — это IP адрес или DNS имя и опционально порт, разделённые двоеточием.
Конфигурация кластера — один или более адресов серверов либо члено группы прокси, разделённые символом «точка с запятой». Можно указать несколько серверов/кластеров/прокси Zabbix, разделяя их запятой. От каждого сервера/кластера Zabbix должно быть указано не более одного Zabbix прокси, если только не используются группы прокси. Если указан Zabbix прокси, то сервер/кластер Zabbix для этого прокси не должны быть указаны.
Несколько адресов через запятую можно указать для использования нескольких независимых серверов Zabbix параллельно. Пробелы разрешены.
Если порт не указан, используется порт по умолчанию.
Адреса IPv6 должны быть заключены в квадратные скобки, если для этого хоста указан порт. Если порт не указан, квадратные скобки для адресов IPv6 опциональны.
Если этот параметр не указан, активные проверки отключены.

Пример для Zabbix прокси:

ServerActive=127.0.0.1:10051

Пример для группы Zabbix прокси:

ServerActive=proxy1.example.com;proxy2.example.com;proxy3.example.com;proxy4.example.com;proxy5.example.com

Пример для нескольких серверов:

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

Пример для кластера высокой доступности:

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

Пример для конфигурации высокой доступности с двумя кластерами и одним сервером:

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

SourceIP

Исходный IP-адрес для:

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

StatusPort

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

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

Timeout

Указывает, как долго (в секундах) следует ожидать установления соединения и обмена данными с Zabbix сервером или прокси.

Этот параметр определяет продолжительность различных коммуникационных операций, в том числе:

ожидание ответа от Zabbix сервера;
отправку запросов на Zabbix сервер, в том числе запросы конфигурации элементов данных и значения элементов данных в активных проверках;
получение данных журнала посредством мониторинга файла журнала;
отправка сообщений heartbeat;
максимальная длительность для проверок vfs.*;
служит в качестве запасного варианта в сценариях, где сервер или прокси версии старше 7.0 отправляет проверки без тайм-аутов.

Этот тайм-аут не будет использоваться для тех проверок агента, которые имеют настраиваемые параметры тайм-аута в веб-интерфейсе (на глобальном уровне, на уровне прокси-сервера или на уровне отдельных элементов данных).

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

TLSAccept

Уровень шифрования, требуемый для входящих подключений. Используется для пассивных проверок. Можно указать несколько значений, разделяя их запятыми:

unencrypted - принимать подключения без шифрования (по умолчанию);
psk - принимать подключения с TLS и предварительно общим ключом (PSK);
cert - принимать подключения с TLS и сертификатом.

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

TLSCAFile

Абсолютный путь к файлу, который содержит сертификаты удостоверяющих центров (certificate authority, CA) верхнего уровня для проверки сертификата узла, используется для зашифрованных соединений между компонентами Zabbix.

TLSCertFile

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

TLSCipherAll

Строка шифров OpenSSL (TLS 1.2). Переопределяет критерии выбора алгоритмов шифрования по умолчанию для шифрования на основе сертификатов и общего ключа (PSK).

Пример:

EECDH+aRSA+AES128:RSA+aRSA+AES128:kECDHEPSK+AES128:kPSK+AES128