Zabbix Documentation 1.8

2.23.04.0 (current)In development:4.2 (devel)Unsupported:1.82.02.43.23.4

User Tools

Site Tools

This translation is older than the original page and might be outdated. See what has changed.

Sidebar

ru:manual:processes:zabbix_agentd_win

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 нет Указывает 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 прокси не запустится, если в конфигурационном файле указан ошибочный (не подходящий под обозначение параметр=значение) или неизвестный параметр.