3 Процессы Zabbix
1 Журналирование (логирование)
Для настройки журналирования в демонах Zabbix используется параметр “LogFile” конфигурационного файла. Если этот параметр оставить пустым (LogFile=), тогда будет осуществляться журналирование с помощью syslog.
Все демоны Zabbix на Unix-подобных платформах журналируют свои сообщения из среды “Daemon”.
Ниже указано соответствие между уровнями журналирования (сообщениями соответствующего типа) в Zabbix и в syslog:
| Уровень журнала Zabbix | Уровень журнала syslog | Комментарии |
|---|---|---|
| 0 – пусто (LOG_LEVEL_EMPTY) |
syslog не используется. | Все сообщения пропускаются. |
| 1 – критичная информация (LOG_LEVEL_CRIT) |
при условии критичных ошибок (LOG_CRIT) |
|
| 2 – сообщения об ошибке (LOG_LEVEL_ERR) |
при условии ошибок (LOG_ERR) |
|
| 3 – предупреждающие сообщения (LOG_LEVEL_WARNING) |
при условии предупреждений (LOG_WARNING) |
|
| 4 – для отладки (LOG_LEVEL_DEBUG) |
сообщения уровня отладки (LOG_DEBUG) |
Для настройки syslog необходимо обратится за помощью к соответствующей литературе.
Zabbix агент под Windows использует Журнал событий, если параметр конфигурации “LogFile” был оставлен пустым.
Ниже указано соответствие между уровнями журналирования (сообщениями соответствующего типа) в Zabbix и в Журнале событий Windows:
| Уровень журнала Zabbix | Уровень журнала Журнала событий Windows | Комментарии |
|---|---|---|
| 0 – пусто (LOG_LEVEL_EMPTY) |
Журнал событий не используется. | Все сообщения пропускаются. |
| 1 – критичная информация (LOG_LEVEL_CRIT) 2 – информация об ошибке (LOG_LEVEL_ERR) |
EVENTLOG_ERROR_TYPE | Ошибка |
| 3 – предупреждающие сообщения (LOG_LEVEL_WARNING) |
EVENTLOG_WARNING_TYPE | Предупреждение |
| 4 – для отладки (LOG_LEVEL_DEBUG) |
EVENTLOG_INFORMATION_TYPE | Информация |
1 Zabbix сервер
Zabbix сервер – это ядро программного обеспечения Zabbix. Zabbix сервер может быть запущен командой:
shell> cd sbin shell> ./zabbix_server
Zabbix сервер стартует как демон.
Zabbix сервер поддерживает следующие параметры командной строки:
-c --config <файл> Параметр указывает на конфигурационный файл, по умолчанию это /etc/zabbix/zabbix_server.conf -n --new-nodeid <nodeid> конвертирование данных базы данных для новой nodeid -R --runtime-control <опция> выполнение административных функций -h --help Отображает это сообщение помощи -v --version Отображает номер версии
Опция -R или –runtime-control поддерживается начиная с Zabbix 1.8.6.
Управление runtime не поддерживается в OpenBSD и NetBSD.
Управление runtime не поддерживается в OpenBSD и NetBSD.
Для получения более подробной помощи по параметрам командной строки выполните:
shell> zabbix_server -h
Примеры параметров командой строки:
shell> zabbix_server -c /usr/local/etc/zabbix_server.conf shell> zabbix_server --help shell> zabbix_server -V
Контроль выполнения
Опции контроля выполнения:
| Опция | Описание |
|---|---|
| config_cache_reload | Перезагрузка кэша конфигурации. Игнорируется если кэш уже загружается. |
Пример использования контроля выполнения для перезагрузки сервером кэша конфигурации:
shell> zabbix_server -c /usr/local/etc/zabbix_server.conf -R config_cache_reload
Конфигурационный файл
Файл конфигурации содержит параметры настроек zabbix_server. Этот файл должен существовать и должен иметь права чтения для пользователя 'zabbix'. Поддерживаемые параметры:
| Параметр | Обязательный | Диапазон | По умолчанию | Описание |
|---|---|---|---|---|
| AlertScriptsPath | нет | /home/zabbix/bin/ | Размещение пользовательских скриптов оповещений | |
| CacheSize | нет | 128K-1G | 8M | Размер кэша конфигурации, в байтах. Размер распределяемой памяти (shared memory) для данных о хранимых узлах сети и элементах данных. |
| CacheUpdateFrequency | нет | 1-3600 | 60 | Как часто Zabbix будет выполнять процедуру обновления кэша конфигурации, в секундах. |
| DBHost | нет | В зависимости от реализации используемой библиотеки. | Имя хоста базы данных. Если установлен localhost, то для СУБД MySQL используется сокет. |
|
| DBName | да | Имя базы данных. Для SQLite3 должен быть указан путь к файлу базы данных. DBUser и DBPassword игнорируются. |
||
| DBPassword | нет | Пароль к базе данных. Игнорируется при СУБД SQLite. Закомментируйте эту строку, если пароль не используется. |
||
| DBPort | нет | 1024-65535 | 3306 | Порт базы данных, когда не используется локальный сокет. Игнорируется при СУБД SQLite. |
| DBSocket | нет | /tmp/mysql.sock | Путь к сокету СУБД MySQL. | |
| DBUser | нет | Пользователь базы данных. Игнорируется при СУБД SQLite. | ||
| DebugLevel | нет | 0-4 | 3 | Задает уровень журналирования (для отладки) 0 – без отладки 1 – критичная информация 2 – информация об ошибках 3 – предупреждения 4 – для отладки (записывает очень много информации) |
| DisableHousekeeping | нет | 0-1 | 0 | Если установлена 1, то очистка базы данных от устаревших данных отключена. |
| ExternalScripts | нет | /etc/zabbix/externalscripts | Размещение внешних скриптов | |
| Fping6Location | нет | /usr/sbin/fping6 | Размещение fping6. Убедитесь, что исполняемый файл fping6 имеет владельца root и флаг SUID установлен. Оставьте пустым (“Fping6Location=”), если ваша утилита fping совместима с обработкой адресов IPv6. |
|
| FpingLocation | нет | /usr/sbin/fping | Размещение fping. Убедитесь, что исполняемый файл fping имеет владельца root и флаг SUID установлен! |
|
| HistoryCacheSize | нет | 128K-1G | 8M | Размер кэша истории, в байтах. Размер распределяемой памяти (shared memory) для хранения данных истории. |
| HistoryTextCacheSize | нет | 128K-1G | 16M | Размер кэша текстовой истории, в байтах. Размер распределяемой памяти (shared memory) для хранения данных: символов, текста или журналов. |
| HousekeepingFrequency | нет | 1-24 | 1 | Как часто Zabbix запускает процедуру очистки базы данных от устаревшей информации (в часах). Удаление ненужной информации из таблиц истории, оповещений и сигнализаций. Если используется PostgreSQL, то предлагаемое значение 24, так как выполняется VACUUM. |
| MaxHousekeeperDelete | нет | 0-1000000 | 500 | Не более чем 'MaxHousekeeperDelete' строк (в соответствии с [tablename], [field], [value]) будет удалено за один цикл задачей очистки истории. SQLite3 не использует этот параметр, удаляются все подходящие строки без лимита. Если установлен 0, то удаляются все подходящие строки без ограничений. В этом случае вы должны понимать, что вы делаете! Эта опция поддерживается начиная с версии 1.8.2. |
| Include | нет | Вы можете включить индивидуальные файлы или все файлы в папке в файл конфигурации. | ||
| ListenIP | нет | 0.0.0.0 | Список IP адресов разделенный запятыми, которые нужно прослушивать для траппера Траппер будет прослушивать все сетевые интерфейсы, если параметр не указан. Несколько IP адресов поддерживается начиная с версии 1.8.3 и выше. |
|
| ListenPort | нет | 1024-32767 | 10051 | Прослушиваемый порт для траппера. |
| LogFileSize | нет | 0-1024 | 1 | Максимальный размер файла журнала в МБ. 0 – отключение автоматической ротации журнала. |
| LogFile | нет | Имя файла журнала. | ||
| LogSlowQueries | нет | 0-3600000 | 0 | Как долго должен выполняться запрос к базе данных чтобы он был занесен в журнал (в миллисекундах). 0 – не журналировать медленные запросы Эта опция поддерживается начиная с версии 1.8.2 |
| NodeID | нет | 0-999 | 0 | Уникальный NodeID для распределенной установки. 0 – одиночный сервер |
| NodeNoEvents | нет | 0-1 | 0 | Если установлена '1', тогда локальные события не будут отправлены мастер ноде. Эта опция не влияет на способность этой ноды распространять события от своих дочерних нод. |
| NodeNoHistory | нет | 0-1 | 0 | Если установлена '1', тогда локальная история не будет отправлена мастер ноде. Эта опция не влияет на способность этой ноды распространять историю от своих дочерних нод. |
| PidFile | нет | /tmp/zabbix_server.pid | Имя PID файла. | |
| ProxyConfigFrequency | нет | 1-604800 | 3600 | Частота отправки в секундах Zabbix сервером данных о конфигурации для Zabbix прокси. Используется только для прокси в пассивном режиме. Эта опция поддерживается начиная с версии 1.8.3. |
| ProxyDataFrequency | нет | 1-3600 | 1 | Частота запроса в секундах Zabbix сервером данных истории с Zabbix прокси. Используется только для прокси в пассивном режиме. Эта опция поддерживается начиная с версии 1.8.3. |
| SSHKeyLocation | нет | Размещение публичных и приватных ключей для проверок по SSH | ||
| SenderFrequency | нет | 5-3600 | 30 | Как часто Zabbix будет пытаться повторно отправлять не отправленные оповещения (в секундах). |
| SourceIP | нет | Исходный IP адрес для исходящих подключений. | ||
| StartDBSyncers | нет | 1-100 | 4 | Количество форков Синхронизаторов БД. Верхний предел 64 до версии 1.8.5. Эта опция поддерживается в версии 1.8.3 и в более новых |
| StartDiscoverers | нет | 0-250 | Количество форков автообнаружения. Верхний предел 255 до версии 1.8.5. |
|
| StartHTTPPollers | нет | 0-1000 | 1 | Количество форков пуллеров HTTP. Верхний предел 255 до версии 1.8.5. |
| StartIPMIPollers | нет | 0-1000 | 0 | Количество форков пуллеров IPMI. Верхний предел 255 до версии 1.8.5. |
| StartPingers | нет | 0-1000 | 1 | Количество форков пингеров по ICMP. Верхний предел 255 до версии 1.8.5. |
| StartPollersUnreachable | нет | 0-1000 | 1 | Количество форков пуллеров для недоступных узлов сети (включая IPMI). Верхний предел 255 до версии 1.8.5. Эта опция отсутствует в версии 1.8.3. |
| StartPollers | нет | 0-1000 | 5 | Количество форков для пуллеров. Верхний предел 255 до версии 1.8.5. |
| StartProxyPollers | нет | 0-250 | 1 | Количество форков пуллеров для пассивных прокси. Верхний предел 255 до версии 1.8.5. Эта опция поддерживается в версии 1.8.3 и в более новых |
| StartTrappers | нет | 0-1000 | 5 | Количество форков трапперов. Верхний предел 255 до версии 1.8.5. |
| Timeout | нет | 1-30 | 3 | Параметр указывает как долго ждать ответа от агента, устройства SNMP или внешней проверки (в секундах). |
| TmpDir | нет | /tmp | Папка для временных данных. | |
| TrapperTimeout | нет | 1-300 | 300 | Параметр указывает как много секунд траппер может потратить на обработку новых данных. |
| TrendCacheSize | нет | 128K-1G | 4M | Размер кэша тенденций, в байтах. Размер распределяемой памяти (shared memory) для хранения данных о тенденциях. |
| UnavailableDelay | нет | 1-3600 | 60 | Как часто узел сети будет проверяться на доступность в период его недоступности, в секундах. |
| UnreachableDelay | нет | 1-3600 | 15 | Как часто узел сети будет проверяться на доступность в период его недостижимости, в секундах. |
| UnreachablePeriod | нет | 1-3600 | 45 | Через сколько секунд недостижимости узел сети считается недоступным. |
Начиная с версии 1.8.6 Zabbix прокси не запустится, если в конфигурационном файле указан ошибочный (не подходящий под обозначение параметр=значение) или неизвестный параметр.
2 Zabbix прокси
Zabbix прокси – процесс, который собирает данные о производительности и доступности с одного или более наблюдаемых устройств и затем отправляет данные Zabbix серверу. Zabbix прокси может быть запущен командой:
shell> cd sbin shell> ./zabbix_proxy
Zabbix прокси стартует как демон.
Zabbix прокси поддерживает следующие параметры командной строки:
-c --config <файл> Абсолютный путь к конфигурационному файлу -R --runtime-control <опция> выполнение административных функций -h --help Отображает это сообщение помощи -V --version Отображает номер версии
Опция -R или –runtime-control поддерживается начиная с Zabbix 1.8.6.
Управление runtime не поддерживается в OpenBSD и NetBSD.
Управление 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 | Перезагрузка кэша конфигурации. Игнорируется если кэш уже загружается. Активный Zabbix прокси подключается к Zabbix серверу запрашивает данные конфигурации. |
Пример использования контроля выполнения для перезагрузки сервером кэша конфигурации:
shell> zabbix_proxy -c /usr/local/etc/zabbix_proxy.conf -R config_cache_reload
Конфигурационный файл
Файл конфигурации содержит параметры настроек zabbix_proxy. Этот файл должен существовать и должен иметь права чтения для пользователя 'zabbix'. Поддерживаемые параметры:
| Параметр | Обязательный | Диапазон | По умолчанию | Описание |
|---|---|---|---|---|
| CacheSize | нет | 128K-1G | 8M | Размер кэша конфигурации, в байтах. Размер распределяемой памяти (shared memory) для данных о хранимых узлах сети и элементах. |
| ConfigFrequency | нет | 1-604800 | 3600 | Как часто прокси будет получать данные о конфигурации от Zabbix сервера (в секундах). Игнорируется для прокси в пассивном режиме. |
| DBHost | нет | В зависимости от реализации используемой библиотеки. | Имя хоста базы данных. Если установлен localhost, то для СУБД MySQL используется сокет. |
|
| DBName | да | Имя базы данных. Для СУБД SQLite3 должен быть указан путь к файлу базы данных. DBUser и DBPassword игнорируются. |
||
| DBPassword | нет | Пароль к базе данных. Игнорируется при СУБД SQLite. Закомментируйте эту строку, если пароль не используется. |
||
| DBSocket | нет | /tmp/mysql.sock | Путь к сокету MySQL. Если не используется локальный сокет, тогда это порт БД. Игнорируется для SQLite. | |
| DBUser | нет | Пользователь базы данных. Игнорируется при СУБД SQLite. | ||
| DataSenderFrequency | нет | 1-3600 | 1 | Прокси будет отправлять собранную информацию каждые N секунд Zabbix серверу. |
| DebugLevel | нет | 0-4 | 3 | Задает уровень журналирования 0 – без отладки 1 – критичная информация 2 – информация об ошибках 3 – предупреждения 4 – для отладки (записывает очень много информации) |
| ExternalScripts | нет | /etc/zabbix/externalscripts | Размещение внешних скриптов | |
| Fping6Location | нет | /usr/sbin/fping6 | Размещение fping6. Убедитесь, что исполняемый файл fping6 имеет владельца root и флаг SUID установлен. Оставьте пустым (“Fping6Location=”), если ваша утиллита fping совместима с обработкой адресов IPv6. |
|
| FpingLocation | нет | /usr/sbin/fping | Размещение fping. Убедитесь, что исполняемый файл fping имеет владельца root и флаг SUID установлен! |
|
| HeartbeatFrequency | нет | 0-3600 | 60 | Частота сообщений доступности в секундах. Используется для мониторинга доступности прокси на стороне сервера. 0 – сообщение о доступности отключено. Игнорируется для прокси в пассивном режиме. |
| HistoryCacheSize | нет | 128K-1G | 8M | Размер кэша истории, в байтах. Размер распределяемой памяти (shared memory) для хранения данных истории. |
| HistoryTextCacheSize | нет | 128K-1G | 16M | Размер кэша текстовой истории, в байтах. Размер распределяемой памяти (shared memory) для хранения данных: символов, текста или журналов. |
| Hostname | нет | Устанавливается через HostnameItem | Уникальное имя прокси. Убедитесь, что имя прокси известно Zabbix серверу!
Регистрозависимо! Разрешенные символы: буквенно-цифровые, '.', ' ', '_' и '-'. |
|
| HostnameItem | нет | system.hostname | Элемент данных, используемый для установки параметра Hostname если он не определен (это будет работать на прокси так же как и на агенте). Не поддерживаются пользовательские параметры, счетчики производительности или псевдонимы, но поддерживается system.run[]. Игнорируется если Hostname установлен. Эта опция поддерживается начиная с версии 1.8.6. |
|
| HousekeepingFrequency | нет | 1-24 | 1 | Как часто Zabbix запускает процедуру очистки базы данных от устаревшей информации (в часах). Удаление ненужной информации из таблиц истории, оповещений и сигнализаций. Если используется PostgreSQL, то предлагаемое значение 24, так как выполняется VACUUM. |
| Include | нет | Вы можете включить индивидуальные файлы или все файлы в папке в файл конфигурации. | ||
| ListenIP | нет | 0.0.0.0 | Список IP адресов разделенный запятыми, которые нужно прослушать для траппера Траппер будет прослушивать все сетевые интерфейсы, если параметр не указан. Несколько IP адресов поддерживается начиная с версии 1.8.3 и выше. |
|
| ListenPort | нет | 1024-32767 | 10051 | Слушаемый порт для траппера. |
| LogFileSize | нет | 0-1024 | 1 | Максимальный размер файла журнала в МБ. 0 – отключение автоматической ротации журнала. |
| LogFile | нет | Имя файла журнала. | ||
| LogSlowQueries | нет | 0-3600000 | 0 | Как долго должен выполняться запрос к базе данных чтобы он был занесен в журнал (в миллисекундах). 0 – не журналировать медленные запросы Эта опция поддерживается начиная с версии 1.8.2 |
| PidFile | нет | /tmp/zabbix_proxy.pid | Имя PID файла. | |
| ProxyLocalBuffer | нет | 0-720 | 0 | Прокси будет локально хранить данные N часов. Этот параметр может быть использован для хранения данных локально, если они будут использоваться сторонними приложениями. |
| ProxyMode | нет | 0-1 | 0 | Режим работы прокси. 0 – прокси в активном режиме 1 – прокси в пассивном режиме Эта опция поддерживается начиная с версии 1.8.3 и в более поздних |
| ProxyOfflineBuffer | нет | 0-720 | 1 | Прокси будет локально хранить данные N часов, если нет связи с Zabbix сервером. Более старые данные будут потеряны. |
| SSHKeyLocation | нет | Размещение публичных и приватных ключей для проверок по SSH | ||
| ServerPort | нет | 1024-32767 | 10051 | Порт траппера на Zabbix сервере. Игнорируется для прокси в пассивном режиме. |
| Server | да | IP адрес (или имя хоста) Zabbix сервера. Прокси будет получать данные о конфигурации с этого сервера. |
||
| SourceIP | нет | Исходный IP адрес для исходящих подключений. | ||
| StartDBSyncers | нет | 1-100 | 4 | Количество префорков Синхронизаторов БД. Верхний предел был 64 до версии 1.8.5. Эта опция поддерживается в версии 1.8.3 и в более новых |
| StartDiscoverers | нет | 0-250 | 1 | Количество форков автообнаружения. Верхний предел был 255 до версии 1.8.5. |
| StartIPMIPollers | нет | 0-1000 | 0 | Количество форков пуллеров IPMI. Верхний предел был 255 до версии 1.8.5. |
| StartPingers | нет | 0-1000 | 1 | Количество форков пингеров по ICMP. Верхний предел был 255 до версии 1.8.5. |
| StartPollersUnreachable | нет | 0-1000 | 1 | Количество форков пуллеров для недоступных узлов сети (включая IPMI). Верхний предел был 255 до версии 1.8.5. Эта опция отсутствует в версии 1.8.3. |
| StartPollers | нет | 0-1000 | 5 | Количество форков для пуллеров. Верхний предел был 64 до версии 1.8.5. |
| StartTrappers | нет | 0-1000 | 5 | Количество форков трапперов. Верхний предел был 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 | Через сколько секунд недостижимости узел сети считается недоступным. |
Начиная с версии 1.8.6 Zabbix прокси не запустится, если в конфигурационном файле указан ошибочный (не соответствующий форме параметр=значение) или неизвестный параметр.
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 | нет | Наборы псевдонимов для параметра. Может быть полезным для замены длинных и сложных имен параметров на более простые и короткие.
Начиная с версии 1.8.6 Zabbix агент будет завершен в случае некорректной записи Alias или в случае если найден дубликат ключа Alias в конфигурационном файле. |
||
| AllowRoot | нет | 0 | Разрешает запуск агента из под 'root'. Если параметр отключен и агент запускается из под 'root', то агент попытается переключиться на пользователя 'zabbix'. Параметр не имеет эффекта, если агент запускается под обычным пользователем. 0 – не разерешено 1 – разрешено |
|
| 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 сервере. Регистрозависимо! Допустимые символы: буквенночисловые, '.', ' ', '_' и '-'. |
|
| 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 | нет | Имя файла журнала. Если не указан, тогда используется syslog |
||
| LogRemoteCommands | нет | 0 | Включение журналирования выполненных команд как предупреждений. 0 – отключено 1 – включено |
|
| MaxLinesPerSecond | нет | 1-1000 | 100 | Максимальное количество новых строк в секунду, которые агент будет отправлять серверу или прокси при обработке активных проверок 'log', 'logrt' и 'eventlog'. Указаное значение будет перезаписано параметром 'maxlines', указанном в ключах элементов данных 'log', 'logrt' или 'eventlog'. Обратите внимание: Zabbix будет обрабатывать в 4 раза больше новых строк, чем задано в MaxLinesPerSecond, для поиска требуемой строки в элементах данных журналов. |
| PidFile | нет | /tmp/zabbix_agentd.pid | Имя PID файла. | |
| 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-100 | 3 | Количество форков zabbix_agentd, для обработки пассивных проверок. Верхний предел был 16 до версии 1.8.5. |
| Timeout | нет | 1-30 | 3 | Не тратить на обработку времени, больше чем указано в значении |
| UnsafeUserParameters | нет | 0,1 | 0 | Разрешить передачу всех символов, которые указаны в качестве аргументов пользовательских параметров. Поддерживается начиная с 1.8.2 |
| UserParameter | нет | Пользовательский параметр для мониторинга. Можно указать несколько пользовательских параметров. Формат: UserParameter=<ключ>,<команда> Обратите внимание, что команда не должна возвращать пустую строку или только символ конца строки. Пример: UserParameter=system.test,who|wc -l Начиная с версии 1.8.6 Zabbix агент будет завершен в случае некорректной записи UserParameter или в случае если найден дубликат ключа UserParameter в конфигурационном файле. |
4 Zabbix агент (UNIX, Inetd версия)
Файл конфигурации содержит параметры настроек zabbix_agent. Этот файл должен существовать и должен иметь права чтения для пользователя 'zabbix'. Поддерживаемые параметры:
| Параметр | Обязательный | По умолчанию | Описание |
|---|---|---|---|
| Alias | нет | Наборы псевдонимов для параметра. Может быть полезным для замены длинных и сложных имен параметров на более простые и короткие.
Начиная с версии 1.8.6 Zabbix агент будет завершен в случае некорректной записи Alias или в случае если найден дубликат ключа Alias в конфигурационном файле. |
|
| Include | нет | Вы можете включать индивидуальные файлы или все файлы в папке во конфигурационный файл. | |
| Server | да | – | Список разделенных запятыми IP адресов (или имен хостов) Zabbix серверов. Подключения с других IP адресов будут отклонены. |
| Timeout | нет | 3 | Не тратить на обработку времени больше указанного значения. Агент не завершает пользовательские процессы попавшие под таймаут! |
| UnsafeUserParameters | нет | 0 | Разрешить все символы, которые передаются в качестве аргументов пользовательским параметрам |
| UserParameter | нет | – | Пользовательский параметр для мониторинга. Можно указать несколько пользовательских параметров Формат: UserParameter=<ключ>,<команда> Обратите внимание, что не должна возвращать пустую строку или только символ конца строки. Пример: UserParameter=system.test,who|wc -l Начиная с версии 1.8.6 Zabbix агент будет завершен в случае некорректной записи UserParameter или в случае если найден дубликат ключа UserParameter в конфигурационном файле. |
Начиная с версии 1.8.6 Zabbix агент будет завершен, если в конфигурационном файле указан ошибочный (не соответствующий форме параметр=значение) или неизвестный параметр.
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 сервере. Регистрозависимо! Допустимые символы: буквенно-цифровые, '.', ' ', '_' и '-'. |
|
| 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 прокси не запустится, если в конфигурационном файле указан ошибочный (не подходящий под обозначение параметр=значение) или неизвестный параметр.
6 Zabbix Sender (UNIX)
Zabbix UNIX Sender это утилита командной строки, с помощью которой вы можете отправить Zabbix серверу данные о производительности для последующей обработки.
Обычно эта утилита используется в долго работающих пользовательских скриптах для периодичной отправки данных о доступности и производительности.
Zabbix Sender может быть запущен командой:
shell> cd bin shell> ./zabbix_sender -z zabbix -s LinuxDB3 -k db.connections -o 43
Начиная с версии Zabbix 1.8.4 утилита zabbix_sender была улучшена для отсылки данных в реальном времени. Имеется ввиду, что большое количество значений, полученное за короткий промежуток времени, будут накапливаться во временном стеке и затем будут отправлены серверу за одно соединение. Данные, которые приходят с интервалом более 0,2 сек. могут накапливаться в одном стеке, но максимальное время их накапливания и последующей отправки все же 1 секунда.
Если отправлять много значений из входного файла, то Zabbix sender будет отправлять их партиями по 250 значений за раз (при этом будут обработаны все значения), например:
# zabbix_sender -z 127.0.0.1 -i /tmp/traptest.txt Info from server: "Processed 250 Failed 0 Total 250 Seconds spent 0.002668" Info from server: "Processed 50 Failed 0 Total 50 Seconds spent 0.000540" sent: 300; skipped: 0; total: 300
Все записи из входящего файла отправляются в последовательном порядке сверху-вниз.
Если целевой элемент данных имеет связанные с ним триггеры, то все штампы времени во входящем файле должны быть отсортированы в порядке возрастания, иначе вычисление события будет некорректным.
Начиная с версии 1.8.6 Zabbix прокси не запустится, если в конфигурационном файле указан ошибочный (не подходящий под обозначение параметр=значение) или неизвестный параметр.
Для получения подробной информации смотрите Zabbix Sender manpage.
7 Zabbix Get (UNIX)
Zabbix get это утилита, которая может взаимодействовать с Zabbix агентом и получать от него запрашиваемую информацию.
Эта утилита обычно используется для устранения неполадок с Zabbix агентами.
Zabbix get может быть запущен командой:
shell> cd bin shell> ./zabbix_get -s 127.0.0.1 -p 10050 -k "system.cpu.load[all,avg1]"
Zabbix get поддерживает следующие параметры командной строки:
-p --port <номер порта> Указывает номер порта запущенного агента на узле сети. По умолчанию 10050. -s --host <имя хоста или IP> Указывает имя хоста или IP адрес для требуемого узла сети -I --source-address <IP адрес> Указывает IP адрес для исходящего подключения -k -key <ключ элемента данных> Указывает ключ элемента данных, значение которого мы хотим получить. -h --help Отображение этого сообщения помощи -V --version Отображение номера версии
Для получения помощи по параметрам командной строки выполните:
shell> zabbix_get --help
Data source: Zabbix