Documentation
Table of Contents
5 Zabbix агент (Windows)
Установка
Установка очень проста и включает в себя 3 шага:
Шаг 1
Создайте конфигурационный файл.
Создайте конфигурационный файл c:/zabbix_agentd.conf (он имеет схожий синтаксис с конфигурационным файлом UNIX агента).
Пример конфигурационного файла доступен в архиве исходных кодов Zabbix в misc/confzabbix_agentd.win.conf.
Шаг 2
Установите агента как сервиса Windows.
Если вы хотите использовать конфигурационный файл, отличный от c:\zabbix_agentd.conf, вы должны использовать следующую команду для установки сервиса:
Должен быть указан полный путь к конфигурационному файл.
Шаг 3
Запустите агента.
Теперь вы можете использовать Панель управления для запуска агента как сервиса или из командной строки выполните:
Примечание к 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 агент для 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 | нет | Указывает 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 | нет | Имя файла журнала. Если не указан, то используется Журнал событий 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 | Частота обновления списка активных проверок, в секундах. |
| 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-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 прокси не запустится, если в конфигурационном файле указан ошибочный (не подходящий под обозначение параметр=значение) или неизвестный параметр.