Zabbix agent mac os настройка

Zabbix Documentation 5.4

Sidebar

Table of Contents

2 Агент

Обзор

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

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

Zabbix агенты чрезвычайно эффективны, потому что используют родные системные вызовы для сбора информации статистики.

Пассивные и активные проверки

Zabbix агенты могут выполнять пассивные и активные проверки.

В случае пассивной проверки агент отвечает на запрос данных. Zabbix сервер (или прокси) запрашивает данные, например, загрузку CPU, и Zabbix агент возвращает результат.

Активные проверки требуют более сложной обработки. Агент сначала получает список элементов данных для независимой обработки от Zabbix сервера. Далее он будет периодически отправлять новые значения серверу.

Выбор между пассивной и активной проверкой осуществляется выбором соответствующего типа элемента данных. Zabbix агент обрабатывает элементы данных типов ‘Zabbix агент’ и ‘Zabbix агент (активный)’.

Поддерживаемые платформы

Zabbix агент поддерживается на:

Агент на UNIX системах

Zabbix агент на UNIX-подобных системах запускается на хостах, которые необходимо мониторить.

Установка

Смотрите раздел установки из пакетов для получения более детальных сведений по установке Zabbix агента из пакетов.

В качестве альтернативы вы можете обратиться к инструкциям по ручной установке, если вы не хотите использовать пакеты.

Если установлен пакетом

Zabbix агент работает как демон. Агент можно запустить, выполнив:

Эта команда будет работать на большинстве GNU/Linux системах. На других системах вам, возможно, потребуется выполнить:

Аналогично, для остановки/перезапуска/просмотра состояния Zabbix агента, используйте следующие команды:

Запуск вручную

Если выше приведенные команды не работают, вам необходимо запустить агент вручную. Найдите путь к бинарному файлу zabbix_agentd и выполните:

Агент на Windows системах

Zabbix агент на Windows работает как служба Windows.

Подготовка

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

Скопируйте bin\zabbix_agentd.exe и conf\zabbix_agentd.conf файлы в c:\zabbix.

Измените c:\zabbix\zabbix_agentd.conf файл в соответствии с вашими требованиями, убедитесь что указан корректный параметр “Hostname”.

Установка

После этого используйте следующую команду для установки Zabbix агента службой Windows:

Теперь у вас должна быть возможность настраивать службу “Zabbix agent” так же как и любую другую службу Windows.

Смотрите более детальные сведения по установке и запуску Zabbix агента на Windows.

Другие опции агента

Имеется возможность запуска нескольких экземпляров агента на одном узле сети. Одиночный экземпляр может быть настроен на использование файла конфигурации по умолчанию или файл конфигурации указанный в командной строке. В случае нескольких экземпляров каждый агент должен иметь свой собственный файл конфигурации (один из них может использовать файл конфигурации по умолчанию).

Следующие параметры командной строки могут быть использованы с Zabbix агентом:

Параметр	Описание
UNIX и Windows агент
-c —config	Путь к файлу конфигурации. Вы можете использовать данную опцию, чтобы задать файл конфигурации, размещенному в папке отличной от заданной по умолчанию. В UNIX, путь по умолчанию /usr/local/etc/zabbix_agentd.conf или как задано во время компиляции переменными —sysconfdir или —prefix В Windows, путь по умолчанию c:\zabbix_agentd.conf
-p —print	Вывод известных элементов данных и выход. Обратите внимание: Также для получения результатов пользовательских параметров, вы можете указать файл конфигурации (если он находится вне папки заданной по умолчанию).
-t —test	Тестирование указанного элемента данных и выход. Обратите внимание: Также для получения результатов пользовательских параметров, вы можете указать файл конфигурации (если он находится вне папки заданной по умолчанию).
-h —help	Вывод справочной информации.
-V —version	Вывод номера версии
Только для UNIX агента
-R —runtime-control	Выполнение административных функций. Смотрите управление работой .
Только для Windows агента
-m —multiple-agents	Использование нескольких экземпляров агента (с -i,-d,-s,-x функциями). Для отделения имени экземпляров служб, каждое имя службы будет в значении Hostvalue из указанного файла конфигурации.
Только для Windows агента (функции)
-i —install	Установка Zabbix агента службой
-d —uninstall	Удаление службы Zabbix Windows агента
-s —start	Запуск службы Zabbix Windows агента
-x —stop	Остановка службы Zabbix Windows агента

Специальные примеры использования параметров командной строки:

Управление работой

Используя опции административных функций, вы можете изменить уровень журналирования у процессов агента.

Опция	Описание	Цель
log_level_increase[= ]	Увеличение уровня журналирования. Действует на все процессы, если цель не указана.	Цель можно указать с помощью: pid — идентификатора процесса (от 1 до 65535) тип процесса — все процессы указанного типа (например, poller) тип процесса,N — тип процесса и номер (например, poller,3)
log_level_decrease[= ]	Уменьшение уровня журналирования. Действует на все процессы, если цель не указана.

Обратите внимание, что допустимый диапазон PID изменения уровня журналирования одного процесса с 1 до 65535. На системах с большими значениями PID опция может использоваться для изменения уровня журналирования отдельных процессов.

Пользователь процесса

Zabbix агент спроектирован для запуска от не привилегированного пользователя (non-root). Он будет работать от любого не привилегированного пользователя от которого был запущен. Таким образом, вы можете запускать агент от имени любого не привилегированного пользователя, без каких либо последствий.

Если вы попытаетесь запустить агента от ‘root’, он сразу переключится на пользователя ‘zabbix’, который должен присутствовать в вашей системе. Единственный способ запустить агента от пользователя ‘root’ — соответствующим образом отредактировать параметр ‘AllowRoot’ в файле конфигурации агента.

Файл конфигурации

Для получения подробной информации смотрите параметры файла конфигурации по настройке zabbix_agentd или Windows агента.

Региональные настройки (локаль)

Обратите внимание что сервер требует UTF-8 локаль чтобы некоторые текстовые элементы данных могли быть интерпретированы корректно. Большинство современных Unix-подобных систем имеют локаль UTF-8 установленной по умолчанию, тем не менее, есть некоторые системы где это необходимо задать вручную.

Код завершения процесса

До версии Zabbix 2.2, Zabbix агент возвращал 0 в случае успешного завершения процесса и код 255 в случае ошибки. Начиная с версии Zabbix 2.2 и выше Zabbix агент возвращает код 0 в случае корректного завершения процесса и код 1 в случае отказа/аварийного завершения процесса.

Источник

Zabbix Documentation 5.4

Sidebar

Table of Contents

5 Установка Mac OS агента с PKG

Обзор

Установка агента

Агента можно установить с использованием графического интерфейса пользователя или через командную строку, например:

Убедитесь, что используете в команде корректную версию Zabbix пакета. Имя файла должно совпадать с именем загруженного пакета.

Запуск агента

Агент автоматически запустится после инсталляции или перезапуска.

Вы можете отредактировать файл конфигурации в /usr/local/etc/zabbix/zabbix_agentd.conf , если требуется.

Чтобы запустить агента вручную, вы можете выполнить:

Чтобы остановить агента вручную:

В процессе обновления существующий файл конфигурации не перезаписывается. Вместо этого создается новый zabbix_agentd.conf.NEW файл, который можно использовать для проверки и обновления существующего файла конфигурации, если требуется. Не забудьте перезапустить агента после изменений в файле конфигурации.

Устранение неполадок и удаление агента

Этот раздел перечисляет некоторые полезные команды, которые можно использовать для поиска неполадок и удаления инсталляции Zabbix агента.

Просмотр, запущен ли Zabbix агент:

Просмотр, установлен ли Zabbix агент из пакетов:

Просмотр списка файлов, которые установлены пакетом установщика (обратите внимание, начальный символ / не отображается в выводе ниже):

Остановка Zabbix агента, если он запущен при помощи launchctl :

Удаление файлов (включая конфигурацию и журналов), которые установлены пакетом установщика:

Источник

Zabbix Documentation 5.4

Sidebar

Table of Contents

Сборка Zabbix агента на macOS

Обзор

Этот раздел демонстрирует как собрать бинарные файлы Zabbix macOS агента из исходного кода с или без TLS.

Предварительные требования

Вам потребуются средства разработки командной строки (Xcode не потребуется), Automake, pkg-config and PCRE (v8.x). Если вы хотите собирать бинарные файла агента с TLS, вам также понадобится OpenSSL или GnuTLS.

Чтобы установить Automake и pkg-config, вам потребуется менеджер пакетов Homebrew с https://brew.sh/. Чтобы его установить, откройте терминал и выполните следующую команду:

Затем установите Automake и pkg-config:

Подготовка библиотек PCRE, OpenSSL и GnuTLS зависит от того, каким образом они будут скомпонованы с агентом.

Если вы намереваетесь запускать бинарные файлы агента на компьютере MacOS, на котором уже имеются эти библиотеки, вы можете использовать уже скомпилированные библиотеки, которые поставляются Homebrew. Обычно это машины macOS, которые используют Homebrew для сборки бинарных файлов Zabbix агента или для других целей.

Если бинарные файлы агента будут использоваться на компьютерах macOS, на которых отсутствуют разделяемые версии библиотек, вам потребуется скомпилировать статические версии этих библиотек из исходных кодов и скомпоновать Zabbix агента с ними.

Сбора бинарных файлов агента с разделяемыми библиотеками

При сборке с TLS, установите OpenSSL и / или GnuTLS:

Загрузите исходный код Zabbix:

Соберите агента без TLS:

Соберите агента с OpenSSL:

Соберите агента с GnuTLS:

Сборка бинарных файлов агента со статическими библиотеками без TLS

Давайте предположим, что статическая библиотека PCRE будут установлены в $HOME/static-libs . Мы будем использовать PCRE 8.42.

Загрузите и соберите PCRE с поддержкой Юникод свойств:

Загрузите исходный код Zabbix и соберите агента:

Сборка бинарных файлов агента со статическими библиотеками с OpenSSL

После успешной сборки OpenSSL рекомендуется выполнить make test . Даже, если сборка прошла успешно, тесты иногда завершаются с ошибками. Если это как раз ваш случай, тогда проблемы необходимо исследовать и решить перед тем как продолжить.

Давайте предположим, что статические библиотеки PCRE и OpenSSL будут установлены в $HOME/static-libs . Мы будем использовать PCRE 8.42 и OpenSSL 1.1.1a.

Давайте собирать статические библиотеки в static-libs-source :

Загрузите и соберите PCRE с поддержкой Юникод свойств:

Загрузите и соберите OpenSSL:

Загрузите исходный код Zabbix и соберите агента:

Сборка бинарных файлов агента со статическими библиотеками с GnuTLS

GnuTLS зависит от крипто серверной библиотеки Nettle и арифметической библиотеки GMP. Вместо использования полной библиотеки GMP, в этом руководстве используется mini-gmp, которая включена в Nettle.

После успешной сборки GnuTLS и Nettle рекомендуется выполнить make check . Даже, если сборка прошла успешно, тесты иногда завершаются с ошибками. Если это как раз ваш случай, тогда проблемы необходимо исследовать и решить перед тем как продолжить.

Давайте предположим, что статические библиотеки PCRE, Nettle и GnuTLS будут установлены в $HOME/static-libs . Мы будем использовать PCRE 8.42, Nettle 3.4.1 и GnuTLS 3.6.5.

Давайте собирать статические библиотеки в static-libs-source :

Загрузите и соберите Nettle:

Загрузите и соберите GnuTLS:

Загрузите исходный код Zabbix и соберите агента:

Источник

Zabbix Documentation 4.2

Sidebar

Table of Contents

Building Zabbix agent on macOS

Overview

This section demonstrates how to build Zabbix macOS agent binaries from sources with or without TLS.

Prerequisites

You will need command line developer tools (Xcode is not required), Automake, pkg-config and PCRE (v8.x). If you want to build agent binaries with TLS, you will also need OpenSSL or GnuTLS.

To install command line developer tools, open terminal and run svn command. Instead of printing short help message, it will display informative message about missing command line developer tools and open new GUI window for installing them. Press “Install” in the dialog window.

To install Automake and pkg-config, you will need a Homebrew package manager from https://brew.sh/. To install it, open terminal and run the following command:

Then install Automake and pkg-config:

Preparing PCRE, OpenSSL and GnuTLS libraries depends on the way how they are going to be linked to the agent.

If you intend to run agent binaries on a macOS machine that already has these libraries, you can use precompiled libraries that are provided by Homebrew. These are typically macOS machines that use Homebrew for building Zabbix agent binaries or for other purposes.

If agent binaries will be used on macOS machines that don’t have the shared version of libraries, you should compile static libraries from sources and link Zabbix agent with them.

Building agent binaries with shared libraries

When building with TLS, install OpenSSL and/or GnuTLS:

Download Zabbix source:

Build agent without TLS:

Build agent with OpenSSL:

Build agent with GnuTLS:

Building agent binaries with static libraries without TLS

Let’s assume that PCRE static libraries will be installed in $HOME/static-libs . We will use PCRE 8.42.

Download and build PCRE with Unicode properties support:

Download Zabbix source and build agent:

Building agent binaries with static libraries with OpenSSL

When building OpenSSL, it’s recommended to run make test after successful building. Even if building was successful, tests sometimes fail. If this is the case, problems should be researched and resolved before continuing.

Let’s assume that PCRE and OpenSSL static libraries will be installed in $HOME/static-libs . We will use PCRE 8.42 and OpenSSL 1.1.1a.

Let’s build static libraries in static-libs-source :

Download and build PCRE with Unicode properties support:

Download and build OpenSSL:

Download Zabbix source and build agent:

Building agent binaries with static libraries with GnuTLS

GnuTLS depends on the Nettle crypto backend and GMP arithmetic library. Instead of using full GMP library, this guide will use mini-gmp which is included in Nettle.

When building GnuTLS and Nettle, it’s recommended to run make check after successful building. Even if building was successful, tests sometimes fail. If this is the case, problems should be researched and resolved before continuing.

Let’s assume that PCRE, Nettle and GnuTLS static libraries will be installed in $HOME/static-libs . We will use PCRE 8.42, Nettle 3.4.1 and GnuTLS 3.6.5.

Let’s build static libraries in static-libs-source :

Источник