zabbix_agentd.conf

LogType=system - информация о работе агента будет записываться в ОС Windows (соответствующий раздел событий).

LogType=file - информация о работе агента будет записываться в файл, определенный параметром LogFile.

LogType=console - информация будет выводится в стандартный выходной поток Windows (STDOUT).

LogFile=C:\Program Files\Zabbix Agent\zabbix_agentd.log - Путь к лог-файлу и его имя.

Параметр устанавливает максимальный размер лог-файла.

Допустимые значения: 0-1024.

Значение по умолчанию: LogFileSize=1.

LogFileSize=0 - отключение автоперезаписи файла.

Устанавливает уровень детализации выдаваемой информации о работе программы.

DebugLevel=0 - основная информация о запусках/остановка процессов агента.

DebugLevel=1 - критическая информация.

DebugLevel=2 - сообщения об ошибках.

DebugLevel=3 - предупреждения.

DebugLevel=4 - большой объем информации для отладки программы.

DebugLevel=5 - максимальный объем информации для отладки программы.

Значение по умолчанию: DebugLevel=3.

IP-адрес для исходящих соединений.

Удаленные команды от Zabbix-сервера

EnableRemoteCommands=0 - запрещены.

EnableRemoteCommands=1 - разрешены.

Запись в лог-файл выполнение удаленных команд.

LogRemoteCommands=0 - отключена.

LogRemoteCommands=1 - включена.

Значение по умолчанию: LogRemoteCommands=0.

Один IP-адрес, или список IP-адресов Zabbix-серверов, разделенных запятыми. Соблюдение нотации CIDR (Classless Inter-Domain Routing - бесклассовая адресация) не обязательно. Вместо IP-адресов могут быть указаны DNS-имена Zabbix серверов или их прокси-сервера.

Если включена поддержка IPv6, то записи «127.0.0.1», «::127.0.0.1», «::ffff:127.0.0.1» будут обрабатываться одинаково, запись «::/0» означает любой адрес IPv4 или IPv6.

«0.0.0.0/0» может использоваться для разрешения любого адреса IPv4.

Пример: Server = 127.0.0.1,192.168.1.0 / 24, ::1,2001:db8::/32, zabbix.domain

Параметр определяет порт, который агент будет слушать, чтобы принять команды Zabbix-сервера.

Допустимый диапазон: 1024-32767

ListenPort=10050 - по умолчанию, Zabbix-агент принимает команды на 10050 порт.

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

Значение по умолчанию: ListenIP=0.0.0.0.

Допустимые значения: от 0 до 100

Количество экземпляров агента, которые будут обрабатывать пассивные проверки. Если StartAgents=0, то пассивные проверки будут отключены, и агент не будет прослушивать TCP-порт.

Значение по умолчанию: StartAgents=3.

Список пар 'IP: порт' или 'DNS-имя: порт', разделенных запятыми, Zabbix серверов и прокси Zabbix для активных проверок.

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

Адреса IPv6 должны быть заключены в квадратные скобки, если указан порт для этого хоста.

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

Если этот параметр не указан, активные проверки отключены.

Пример: ServerActive=127.0.0.1:20051,zabbix.domain,[::1]:30051,::1,[12fc::1]

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

Указание данного свойства требуется для проведения активных проверок.

Имя хоста может быть получено из параметра HostnameItem, если он определен. Если HostnameItem определен, то значение Hostname можно не устанавливать.

Установка значения этого параметра в HostnameItem=system.hostname позволяет получить имя хоста, если оно не определено в Hostname. Игнорируется, если имя определено в Hostname.

Ключ system.hostname всегда возвращает имя хоста NetBIOS, которое ограничено 15 символами и только в верхнем регистре, независимо от длины и наличия символов верхнего и/или нижнего регистров в имени. При этом, ключ system.hostname[host] вернет полное, реальное (с учетом регистра) имя хоста Windows.

Не поддерживаются UserParameters или псевдонимы.

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

Например, мы указываем следующее содержимое: Windows10_Any. Напоминаем, что данные произвольные и можно написать хоть hhhdhdjh_222, лишь бы они несли какой-то смысл.

В дальнейшем, на сервере можно настроить проверку содержания метаданных на наличие этих слов и выполнение каких-либо действий (Operations). Для систем с Windows 10 это будет одна группа действий, для систем с Linux - другая. Все зависит от того, по каким критериям вы разделите участников сети и что будете с ними делать. Иными словами: метаданные нужны для того, чтобы серверу знать, как поступить с данной машиной (или их группой):

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

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

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

Для генерации метаданных в данный параметр передаются специальные команды, например: system.uname. После применения которой, агент передает на сервер полученные данные вроде:

Linux: Linux server3 3.2.0-4-686-pae #1 SMP Debian 3.2.41-2 i686 GNU/Linux, или

Windows: Windows WIN-0PXGGSTYNHO 6.0.6001 Windows Server 2008 Service Pack 1 Intel IA-32

Эти метаданные можно проверять на наличие включений Windows или Linux, чтобы назначать соответствующие шаблоны проверок.

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

В качестве значений можно применять собственные псевдонимы, установленные в параметре Aliases вместо длинных команд.

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

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

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

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

Диапазон допустимых значений (секунды): 60-3600

Значение по умолчанию: RefreshActiveChecks=120.

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

Диапазон допустимых значений (секунды): 1-3600

Значение по умолчанию: BufferSend=5.

Максимальное количество значений, хранимых в буфере.

Диапазон допустимого количества значений: 2-65535

Значение по умолчанию: BufferSize=100.

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

Максимальное количество новых строк, которые агент может отправлять за 1 секунду на Zabbix сервер или прокси, обрабатывающий активные проверки 'log', 'logrt' и 'eventlog'.

Предоставленное значение будет переопределено параметром 'maxlines', который содержится в ключах элемента 'log', 'logrt' или 'eventlog'.

Zabbix будет обрабатывать в 10 раз больше новых строк, чем установлено в MaxLinesPerSecond, для поиска необходимой строки в log-файлах.

Диапазон допустимых значений: 1-1000.

Значение по умолчанию: BufferSize=20.

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

Множество функций могут быть связаны с одним псевдонимом, как и на одну функцию могут ссылаться несколько псевдонимов.

Примеры:

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

Alias=pg_usage:perf_counter[\Paging File(_Total)\% Usage]

Псевдоним - pg_usage, функция - perf_counter[\Paging File(_Total)\% Usage]. Т.е. для получения информации об использовании файла подкачки достаточно использовать pg_usage.

2. Получение информации о загрузке CPU:

Alias=cpu.load:system.cpu.load

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

Можно использовать псевдоним cpu.load сам по себе для получения стандартной информации о загрузке процессора, так и с каким-нибудь параметром: cpu.load[percpu,avg15] для получения специфических данных о загрузке CPU.

Псевдонимы можно использовать в параметре HostMetadataItem, но не в параметрахHostnameItem и PerfCounter

Время, которое агент может потратить на получение информации с хоста.

Диапазон допустимых значений: 1-30 (секунды).

Значение по умолчанию: Timeout=3.

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

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

PerfCounter = CPUInterrupts, "\Processor(0)\Interrupts/sec", 60

Где CPUInterrupts - Название нового источника данных, которое является ключом элемента данных и указывается при его создании на сервере.

"\Processor(0)\Interrupts/sec" - получение количества прерываний CPU за секунду и расчет значения их среднего числа в течение 60 сек. Наличие двойных кавычек обязательно

Получение значений для вычисления среднего значения происходит один раз в секунду.

Получить перечень всех счетчиков производительности и состояния системы в операционой системе Windows можно командой “typeperf -qx”.

Отличается от PerfCounter тем, что пути к счётчикам производительности должны быть указаны на Английском языке.

Поддерживается только на Windows Server 2008/Vista и более новых версиях.

Получить перечень всех счетчиков производительности и состояния системы можно в следующей ветке реестра: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Perflib\009

Позволяет подключить в дополнение к данному конфигурационному файлу другие. Примеры:

Include=c:\zabbix\zabbix_agentd.userparams.conf

Include=c:\zabbix\zabbix_agentd.conf.d\

Include=c:\zabbix\zabbix_agentd.conf.d\*.conf

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

Символы, которые можно запретить, либо разрешить: \ ' " ` * ? [ ] { } ~ $ ! & ; ( ) < > | # @, а также символ новой строки.

UnsafeUserParameters=1 - разрешить.

UnsafeUserParameters=0 - запретить.

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

Формат: UserParameter=<ключ>,

Пример: UserParameter=runecho,echo 1

Где, runecho - Произвольное название пользовательского ключа, echo hello - команда вывод информации на экран (будет выведено слово 'hello', но в данном случае - будет присвоено в ключу runecho для последующей передачи на сервер).

Команда не должна возвращать пустую строку или EOL (End of Line).

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

Допускает одно из трех значений:

unencrypted - передаваемые данные не будут шифроваться (по умолчанию).

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

cert - данные будут шифроваться с применением TLS и сертификата.

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

unencrypted - принимать не шифрованные подключения (по умолчанию).

psk - принимать подключения с TLS и парой ключей (один открытый, а другой - закрытый).

cert - принимать подключения с TLS и сертификата.

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

Абсолютный путь к файлу со списком отозванных сертификатов.

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

TLSServerCertIssuer=CN=Signing CA,OU=Development group,O=Zabbix SIA,DC=zabbix,DC=com - данные взяты из сертификата.

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

TLSServerCertSubject=CN=Zabbix server,OU=Development group,O=Zabbix SIA,DC=zabbix,DC=com - данные взяты из сертификата.

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

Абсолютный путь к файлу, содержащему приватный ключ.

Уникальная, чувствительная к регистру строка, используемая для идентификации предварительного общего ключа (pre-shared key).

Полный путь к файлу с предварительным общим ключом (pre-shared key).