Documentation
Table of Contents
3 Zabbix агент (UNIX, Standalone демон)
Демон Zabbix UNIX агент работает на наблюдаемом узле сети. Агент предоставляет Zabbix серверу данные о своей производительности и доступности. Zabbix агент работает с элементами данных типа 'Zabbix агент' или 'Zabbix агент (активный)'.
Zabbix агент может быть запущен командой:
Zabbix агент стартует как демон.
Zabbix агент поддерживает следующие параметры командной строки:
-c --config <файл> Определяет конфигурационный файл, по умолчанию это /etc/zabbix/zabbix_agentd.conf
-h --help Отображение этого сообщения помощи
-V --version Отображение номера версии
-p --print Вывод списка поддерживаемых элементов данных и выход
-t --test <ключ элемента данных> Тест указанного элемента данных и выходДля получения помощи по параметрам командной строки выполните:
Примеры параметров командой строки:
shell> zabbix_agentd -c /usr/local/etc/zabbix_agentd.conf
shell> zabbix_agentd --help
shell> zabbix_agentd --print
shell> zabbix_agentd -t "system.cpu.load[all,avg1]"Конфигурационный файл
Файл конфигурации содержит параметры настроек zabbix_agentd. Этот файл должен существовать и должен иметь права чтения для пользователя 'zabbix'. Поддерживаемые параметры:
| Параметр | Обязательный | Диапазон | По умолчанию | Описание |
|---|---|---|---|---|
| Alias | нет | Наборы псевдонимов для параметра. Может быть полезным для замены длинных и сложных имен параметров на более простые и короткие. Начиная с версии 1.8.6 Zabbix агент будет завершен в случае некорректной записи Alias или в случае если найден дубликат ключа Alias в конфигурационном файле. |
||
| AllowRoot | нет | 0 | Разрешает запуск агента из под 'root'. Если параметр отключен и агент запускается из под 'root', то агент попытается переключиться на пользователя 'zabbix'. Параметр не имеет эффекта, если агент запускается под обычным пользователем. 0 - не разерешено 1 - разрешено |
|
| BufferSend | нет | 1-3600 | 5 | Не удерживать данные в буфере больше чем N секунд. |
| BufferSize | нет | 2-65535 | 100 | Максимальное количество значений в памяти буфера. Агент отправляет все собранные данные Zabbix серверу или прокси при заполнении буфера. |
| DebugLevel | нет | 0-4 | 3 | Задает уровень журналирования 0 - без отладки 1 - критичная информация 2 - информация об ошибках 3 - предупреждения 4 - для отладки (записывает очень много информации) |
| DisableActive | нет | 0 | Отключение активных проверок. Агент переходит в пассивный режим, ожидая подключений от сервера. | |
| DisablePassive | нет | 0 | Отключение пассивных проверок. Агент не слушает никакой TCP порт. Будут работать только активные проверки. 0 - не отключать 1 - отключить |
|
| EnableRemoteCommands | нет | 0 | Разрешены ли удаленные команды от Zabbix сервера. 0 - не разрешены 1 - разрешены |
|
| Hostname | нет | Устанавливается HostnameItem | Уникальное имя узла сети. Требуется для активных проверок и должно точно совпадать (в т.ч. регистр) с именем узла сети, настроенном в Zabbix сервере. Регистрозависимо! Допустимые символы: буквенночисловые, '.', ' ', '_' и '-'. Максимальная длина: 64 |
|
| HostnameItem | нет | system.hostname | Элемент данных используется для установки Hostname, если он не определен. Не поддерживает UserParameters, счетчики производительности или псевдонимы, но поддерживает system.run[] независимо от значения EnableRemoteCommands. Игнорируется, если установлен Hostname. Эта опция поддерживается в версии 1.8.6 и более новых. |
|
| Include | нет | Вы можете включить в файл конфигурации индивидуальные файлы или все файлы в папке. | ||
| ListenIP | нет | 0.0.0.0 | Список IP адресов, разделенный запятыми, которые агент должен прослушивать. Несколько IP адресов поддерживаются начиная с версии 1.8.3 и выше. |
|
| ListenPort | нет | 1024-32767 | 10050 | Агент будет прослушивать указанный порт, ожидая подключений с сервера. |
| LogFileSize | нет | 0-1024 | 1 | Максимальный размер файла журнала в МБ. 0 - отключает автоматическую ротацию файла журнала. |
| LogFile | нет | Имя файла журнала. Если не указан, тогда используется syslog |
||
| LogRemoteCommands | нет | 0 | Включение журналирования выполненных команд как предупреждений. 0 - отключено 1 - включено |
|
| MaxLinesPerSecond | нет | 1-1000 | 100 | Максимальное количество новых строк в секунду, которые агент будет отправлять серверу или прокси при обработке активных проверок 'log', 'logrt' и 'eventlog'. Указаное значение будет перезаписано параметром 'maxlines', указанном в ключах элементов данных 'log', 'logrt' или 'eventlog'. Обратите внимание: Zabbix будет обрабатывать в 4 раза больше новых строк, чем задано в MaxLinesPerSecond, для поиска требуемой строки в элементах данных журналов. |
| PidFile | нет | /tmp/zabbix_agentd.pid | Имя PID файла. | |
| RefreshActiveChecks | нет | 60-3600 | 120 | Частота обновления списка активных проверок, в секундах. |
| Server | нет | Список IP адресов (или имен хостов) Zabbix серверов, разделенных запятыми. Пробелы недопустимы. Если ServerActive не указан, то первая запись из списка будет использоваться для получения списка активных проверок и отправки результатов активных проверок. Обратите внимание, что имена хостов должны резолвиться имя хоста→IP адрес и IP адрес→имя хоста. Если включена поддержка IPv6, тогда '127.0.0.1', '::127.0.0.1', '::ffff:127.0.0.1' обрабатываются одинаково. |
||
| ServerActive | нет | Список пар IP:порт (или имя хоста:порт) разделенных запятыми Zabbix серверов для активных проверок. Пробелы недопустимы. Если ServerActive указан, то первый хост из опции Server не будет использоваться для активных проверок, только для пассивных. Если порт не указывается, то используется порт по умолчанию. Если ServerPort не указан, то будет использован порт по умолчанию. IPv6 адреса должны быть заключены в квадратные скобки, если для хоста указывается порт. Если порт порт не указан, то квадратные скобки для IPv6 адресов опциональны. Эта опция поддерживается версией 1.8.13 и выше. |
||
| ServerPort | нет | 10051 | Порт сервера для получения списка и для отправки активных проверок. | |
| SourceIP | нет | IP адрес источника для исходящих подключений. | ||
| StartAgents | нет | 1-100 | 3 | Количество форков zabbix_agentd, для обработки пассивных проверок. Верхний предел был 16 до версии 1.8.5. |
| Timeout | нет | 1-30 | 3 | Не тратить на обработку времени, больше чем указано в значении |
| UnsafeUserParameters | нет | 0,1 | 0 | Разрешить передачу всех символов, которые указаны в качестве аргументов пользовательских параметров. Поддерживается начиная с 1.8.2 |
| UserParameter | нет | Пользовательский параметр для мониторинга. Можно указать несколько пользовательских параметров. Формат: UserParameter=<ключ>,<команда> Обратите внимание, что команда не должна возвращать пустую строку или только символ конца строки. Пример: UserParameter=system.test,who|wc -l Начиная с версии 1.8.6 Zabbix агент будет завершен в случае некорректной записи UserParameter или в случае если найден дубликат ключа UserParameter в конфигурационном файле. |
||