# - \#3 Zabbix агент (UNIX, Standalone демон)

Демон Zabbix UNIX агент работает на наблюдаемом узле сети. Агент
предоставляет Zabbix серверу данные о своей производительности и
доступности. Zabbix агент работает с элементами данных типа 'Zabbix
агент' или 'Zabbix агент (активный)'.

Zabbix агент может быть запущен командой:

    shell> cd sbin
    shell> ./zabbix_agentd

Zabbix агент стартует как демон.

Zabbix агент поддерживает следующие параметры командной строки:

      -c --config <файл> Определяет конфигурационный файл, по умолчанию это /etc/zabbix/zabbix_agentd.conf
      -h --help Отображение этого сообщения помощи
      -V --version Отображение номера версии
      -p --print Вывод списка поддерживаемых элементов данных и выход
      -t --test <ключ элемента данных> Тест указанного элемента данных и выход

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

    shell> zabbix_agentd -h

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

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