5 Zabbix агент (Windows) [Zabbix]

- - 5 Zabbix агент (Windows)

5 Zabbix агент (Windows)

Установка

Установка очень проста и включает в себя 3 шага:

Шаг 1

Создайте конфигурационный файл.

Создайте конфигурационный файл c:/zabbix_agentd.conf (он имеет схожий синтаксис с конфигурационным файлом UNIX агента).

Пример конфигурационного файла доступен в архиве исходных кодов Zabbix в misc/confzabbix_agentd.win.conf.

Шаг 2

Установите агента как сервиса Windows.

zabbix_agentd.exe --install

Если вы хотите использовать конфигурационный файл, отличный от c:\zabbix_agentd.conf, вы должны использовать следующую команду для установки сервиса:

zabbix_agentd.exe --config <ваш_конфигурационный_файл> --install

Должен быть указан полный путь к конфигурационному файл.

Шаг 3

Запустите агента.

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

zabbix_agentd.exe --start

Примечание к Windows NT 4.0. Zabbix_agentd.exe использует PDH (Performance Data Helper) API для сбора различной информации о системе, поэтому требуется PDH.DLL. Эта библиотека не поставляется вместе с NT 4.0, поэтому вам потребуется загрузить и установить её самостоятельно. В статье базы знаний Microsoft под номером 284996 это подробно описано, а также имеется ссылка на загрузку библиотеки. Вы можете найти эту статью по адресу http://support.microsoft.com/default.aspx?scid=kb;en-us;284996

Использование

Синтаксис командой строки:

zabbix_agentd.exe [-Vhp] [-idsx] [-c <file>] [-t <metric>]

Конфигурационный файл

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

Опции:

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

Функции:

  -i --install   Установка Zabbix агента как сервиса.
  -d --uninstall Удаление сервиса Zabbix агента.
  -s --start     Запуск сервиса Zabbix агента.
  -x --stop      Остановка сервиса Zabbix агента.

Конфигурационный файл (c:/zabbix_agentd.conf) содержит параметры настроек для zabbix_agentd.exe. Поддерживаемые параметры:

Параметр	Обязательный	Диапазон	По умолчанию	Описание
Alias	нет			Наборы псевдонимов для параметра. Может быть полезным для замены длинных и сложных имен параметров на более простые и короткие. Например, если вы хотите вернуть использование файла подкачки сервера в процентах, вы можете использовать параметр “perf_counter[\Paging File(_Total)\% Usage]”, или вы можете установить алиас, добавив следующую строку в конфигурационный файл: Alias = pg_usage:perf_counter[\Paging File(_Total)\% Usage]. После этого вы можете использовать имя параметра “pg_usage”, чтобы получить эту же информацию. Вы можете создать столько записей “Alias”, сколько пожелаете. Обратите внимание, что алиасы не могут быть использованы для параметров, определенных в записях “PerfCounter” конфигурационного файла. Начиная с версии 1.8.6 Zabbix агент будет завершен в случае некорректной записи Alias или в случае если найден дубликат ключа Alias в конфигурационном файле.
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			system.hostname	Уникальное имя узла сети. Требуется для активных проверок и должно точно совпадать (в т.ч. регистр) с именем узла сети, настроенном в Zabbix сервере.
Include	нет			Вы можете включить в конфигурационный файл индивидуальный файл в папке.
ListenIP	нет		0.0.0.0	Список IP адресов, разделенный запятыми, которые агент должен прослушивать. Несколько IP адресов поддерживаются начиная с версии 1.8.3 и выше.
ListenPort	нет	1024-32767	10050	Агент будет прослушивать указанный порт, ожидая подключений с сервера.
LogFileSize	нет	0-1024	1	Максимальный размер файла журнала в МБ. 0 - отключает автоматическую ротацию файла журнала.
LogFile	нет			Имя файла журнала. Если не указан, то используется Журнал событий Windows
LogRemoteCommands	нет		0	Включение журналирования выполненных команд как предупреждений. 0 - отключено 1 - включено
MaxLinesPerSecond	нет	1-1000	100	Максимальное количество новых строк в секунду, которые агент будет отправлять серверу или прокси при обработке активных проверок 'log', 'logrt' и 'eventlog'. Указанное значение будет перезаписано параметром 'maxlines', если оно определено в ключах элементов данных 'log', 'logrt' или 'eventlog'.
PerfCounter	нет			Синтаксис: <parameter_name>,”<perf_counter_path>”,<period> Это определяет новый параметр <parameter_name>, и это будет среднее значение для системного счетчика производительности <perf_counter_path> для указанного периода времени <period> (в секундах). Например, если вы хотите получать среднее количество прерываний процессора в секунду за последнюю минуту, вы должны определить новый параметр “interrupts” в следующего вида: PerfCounter = interrupts,”\Processor(0)\Interrupts/sec”,60 Пожалуйста, обратите внимание на двойные кавычки на концах пути счетчика производительности. Опрос системного счетчика для расчета среднего значения будет производится каждую секунду. Вы можете выполнить typeperf –qx для получения списка всех счетчиков производительности доступных в Windows. Начиная с версии 1.8.6 Zabbix агент будет завершен в случае некорректной записи PerfCounter или в случае если найден дубликат ключа PerfCounter в конфигурационном файле.
RefreshActiveChecks	нет	60-3600	120	Частота обновления списка активных проверок, в секундах.
ServerPort	нет		10051	Порт сервера для получения списка активных проверок и для отправки их результатов.
Server	да			Список IP адресов (или имен хостов) Zabbix серверов, разделенных запятыми. Пробелы недопустимы. Первая запись используется для получения списка активных проверок и для отправки их результатов. Если поддержка IPv6 включена, тогда '127.0.0.1', '::127.0.0.1', '::ffff:127.0.0.1' воспринимаются одинаково.
SourceIP	нет			IP адрес источника для исходящих подключений.
StartAgents	нет	1-16	3	Количество потоков zabbix_agentd, для обработки пассивных проверок.
Timeout	нет	1-30	3	Не тратить на обработку времени, больше чем указано в значении.
UnsafeUserParameters	нет	0-1	0	Разрешить передачу всех символов, которые указаны в качестве аргументов пользовательских параметров. 0 - не разрешено 1 - разрешено
UserParameter				Пользовательский параметр для мониторинга. Можно указать несколько пользовательских параметров. Формат: UserParameter=<ключ>,<команда> Обратите внимание, что команда не должна возвращать пустую строку или только символ конца строки. Пример: UserParameter=system.test,echo 1 Начиная с версии 1.8.6 Zabbix агент будет завершен в случае некорректной записи UserParameter или в случае если найден дубликат ключа UserParameter в конфигурационном файле.

Начиная с версии 1.8.6 Zabbix прокси не запустится, если в конфигурационном файле указан ошибочный (не подходящий под обозначение параметр=значение) или неизвестный параметр.