# - \#2 Zabbix прокси

Zabbix прокси - процесс, который собирает данные о производительности и
доступности с одного или более наблюдаемых устройств и затем отправляет
данные Zabbix серверу. Zabbix прокси может быть запущен командой:

    shell> cd sbin
    shell> ./zabbix_proxy

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

      -c --config <файл> Абсолютный путь к конфигурационному файлу
      -R --runtime-control <опция>   выполнение административных функций
      -h --help Отображает это сообщение помощи
      -V --version Отображает номер версии

::: noteclassic
Опция -R или --runtime-control поддерживается начиная с
Zabbix 1.8.6.\
Управление runtime не поддерживается в OpenBSD и NetBSD.
:::

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

    shell> zabbix_proxy -h

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

    shell> zabbix_proxy -c /usr/local/etc/zabbix_proxy.conf
    shell> zabbix_proxy --help
    shell> zabbix_proxy -V

## Контроль выполнения

Опции контроля выполнения:

|Опция|Описание|
|----------|----------------|
|config\_cache\_reload|Перезагрузка кэша конфигурации. Игнорируется если кэш уже загружается.<br>Активный Zabbix прокси подключается к Zabbix серверу запрашивает данные конфигурации.|

Пример использования контроля выполнения для перезагрузки сервером кэша
конфигурации:

    shell> zabbix_proxy -c /usr/local/etc/zabbix_proxy.conf -R config_cache_reload

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

Файл конфигурации содержит параметры настроек zabbix\_proxy. Этот файл
должен существовать и должен иметь права чтения для пользователя
'zabbix'. Поддерживаемые параметры:

|Параметр|Обязательный|Диапазон|По умолчанию|Описание|
|----------------|------------------------|----------------|-----------------------|----------------|
|CacheSize|нет|128K-1G|8M|Размер кэша конфигурации, в байтах.<br>Размер распределяемой памяти (shared memory) для данных о хранимых узлах сети и элементах.|
|ConfigFrequency|нет|1-604800|3600|Как часто прокси будет получать данные о конфигурации от Zabbix сервера (в секундах).<br>Игнорируется для прокси в пассивном режиме.|
|DBHost|нет|<|В зависимости от реализации используемой библиотеки.|Имя хоста базы данных.<br>Если установлен localhost, то для СУБД MySQL используется сокет.|
|DBName|да|<|<|Имя базы данных.<br>Для СУБД SQLite3 должен быть указан путь к файлу базы данных. DBUser и DBPassword игнорируются.|
|DBPassword|нет|<|<|Пароль к базе данных. Игнорируется при СУБД SQLite.<br>Закомментируйте эту строку, если пароль не используется.|
|DBSocket|нет|<|/tmp/mysql.sock|Путь к сокету MySQL. Если не используется локальный сокет, тогда это порт БД. Игнорируется для SQLite.|
|DBUser|нет|<|<|Пользователь базы данных. Игнорируется при СУБД SQLite.|
|DataSenderFrequency|нет|1-3600|1|Прокси будет отправлять собранную информацию каждые N секунд Zabbix серверу.|
|DebugLevel|нет|0-4|3|Задает уровень журналирования<br>0 - без отладки<br>1 - критичная информация<br>2 - информация об ошибках<br>3 - предупреждения<br>4 - для отладки (записывает очень много информации)|
|ExternalScripts|нет|<|/etc/zabbix/externalscripts|Размещение внешних скриптов|
|Fping6Location|нет|<|/usr/sbin/fping6|Размещение fping6.<br>Убедитесь, что исполняемый файл fping6 имеет владельца root и флаг SUID установлен.<br>Оставьте пустым ("Fping6Location="), если ваша утиллита fping совместима с обработкой адресов IPv6.|
|FpingLocation|нет|<|/usr/sbin/fping|Размещение fping.<br>Убедитесь, что исполняемый файл fping имеет владельца root и флаг SUID установлен!|
|HeartbeatFrequency|нет|0-3600|60|Частота сообщений доступности в секундах.<br>Используется для мониторинга доступности прокси на стороне сервера.<br>0 - сообщение о доступности отключено.<br>Игнорируется для прокси в пассивном режиме.|
|HistoryCacheSize|нет|128K-1G|8M|Размер кэша истории, в байтах.<br>Размер распределяемой памяти (shared memory) для хранения данных истории.|
|HistoryTextCacheSize|нет|128K-1G|16M|Размер кэша текстовой истории, в байтах.<br>Размер распределяемой памяти (shared memory) для хранения данных: символов, текста или журналов.|
|Hostname|нет|<|Устанавливается через HostnameItem|Уникальное имя прокси. Убедитесь, что имя прокси известно Zabbix серверу!<br><br>Регистрозависимо!<br><br>Разрешенные символы: буквенно-цифровые, '.', ' ', '\_' и '-'.<br>Максимальная длина: 64|
|HostnameItem|нет|<|system.hostname|Элемент данных, используемый для установки параметра Hostname если он не определен (это будет работать на прокси так же как и на агенте).<br>Не поддерживаются пользовательские параметры, счетчики производительности или псевдонимы, но поддерживается system.run\[\].<br><br>Игнорируется если Hostname установлен.<br><br>**Эта опция поддерживается начиная с версии 1.8.6.**|
|HousekeepingFrequency|нет|1-24|1|Как часто Zabbix запускает процедуру очистки базы данных от устаревшей информации (в часах).<br>Удаление ненужной информации из таблиц истории, оповещений и сигнализаций.<br>Если используется PostgreSQL, то предлагаемое значение 24, так как выполняется VACUUM.|
|Include|нет|<|<|Вы можете включить индивидуальные файлы или все файлы в папке в файл конфигурации.|
|ListenIP|нет|<|0.0.0.0|Список IP адресов разделенный запятыми, которые нужно прослушать для траппера<br>Траппер будет прослушивать все сетевые интерфейсы, если параметр не указан.<br>**Несколько IP адресов поддерживается начиная с версии 1.8.3 и выше.**|
|ListenPort|нет|1024-32767|10051|Слушаемый порт для траппера.|
|LogFileSize|нет|0-1024|1|Максимальный размер файла журнала в МБ.<br>0 - отключение автоматической ротации журнала.|
|LogFile|нет|<|<|Имя файла журнала.|
|LogSlowQueries|нет|0-3600000|0|Как долго должен выполняться запрос к базе данных чтобы он был занесен в журнал (в миллисекундах).<br>0 - не журналировать медленные запросы<br>**Эта опция поддерживается начиная с версии 1.8.2**|
|PidFile|нет|<|/tmp/zabbix\_proxy.pid|Имя PID файла.|
|ProxyLocalBuffer|нет|0-720|0|Прокси будет локально хранить данные N часов.<br>Этот параметр может быть использован для хранения данных локально, если они будут использоваться сторонними приложениями.|
|ProxyMode|нет|0-1|0|Режим работы прокси.<br>0 - прокси в активном режиме<br>1 - прокси в пассивном режиме<br>**Эта опция поддерживается начиная с версии 1.8.3 и в более поздних**|
|ProxyOfflineBuffer|нет|0-720|1|Прокси будет локально хранить данные N часов, если нет связи с Zabbix сервером.<br>Более старые данные будут потеряны.|
|SSHKeyLocation|нет|<|<|Размещение публичных и приватных ключей для проверок по SSH|
|ServerPort|нет|1024-32767|10051|Порт траппера на Zabbix сервере.<br>Игнорируется для прокси в пассивном режиме.|
|Server|да|<|<|IP адрес (или имя хоста) Zabbix сервера.<br>Прокси будет получать данные о конфигурации с этого сервера.|
|SourceIP|нет|<|<|Исходный IP адрес для исходящих подключений.|
|StartDBSyncers|нет|1-100|4|Количество префорков Синхронизаторов БД.<br>Верхний предел был 64 до версии 1.8.5.<br>**Эта опция поддерживается в версии 1.8.3 и в более новых**|
|StartDiscoverers|нет|0-250|1|Количество форков автообнаружения.<br>Верхний предел был 255 до версии 1.8.5.|
|StartIPMIPollers|нет|0-1000|0|Количество форков пуллеров IPMI.<br>Верхний предел был 255 до версии 1.8.5.|
|StartPingers|нет|0-1000|1|Количество форков пингеров по ICMP.<br>Верхний предел был 255 до версии 1.8.5.|
|StartPollersUnreachable|нет|0-1000|1|Количество форков пуллеров для недоступных узлов сети (включая IPMI).<br>Верхний предел был 255 до версии 1.8.5.<br>**Эта опция отсутствует в версии 1.8.3.**|
|StartPollers|нет|0-1000|5|Количество форков для пуллеров.<br>Верхний предел был 64 до версии 1.8.5.|
|StartTrappers|нет|0-1000|5|Количество форков трапперов.<br>Верхний предел был 255 до версии 1.8.5.|
|Timeout|нет|1-30|3|Указывает как долго ждать ответа от агента, устройства SNMP или внешней проверки (в секундах).|
|TmpDir|нет|<|/tmp|Папка для временных данных.|
|TrapperTimeout|нет|1-300|300|Параметр указывает как много секунд траппер может потратить на обработку новых данных.|
|UnavailableDelay|нет|1-3600|60|Как часто узел сети будет проверяться на доступность в период его недоступности, в секундах.|
|UnreachableDelay|нет|1-3600|15|Как часто узел сети будет проверяться на доступность в период его недостижимости, в секундах.|
|UnreachablePeriod|нет|1-3600|45|Через сколько секунд недостижимости узел сети считается недоступным.|

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