[comment]: # ({0f9ecee9-0f9ecee9})
# 2. Агент 

[comment]: # ({/0f9ecee9-0f9ecee9})

[comment]: # ({10b26f52-f5143fcc})
#### Обзор

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

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

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

На узле сети можно запустить несколько экземпляров агента.

[comment]: # ({/10b26f52-f5143fcc})

[comment]: # ({dc947f39-41e6af7c})
##### Пассивные и активные проверки

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

-   [Пассивные проверки](/manual/appendix/items/activepassive#passive-checks) - агент Zabbix отвечает на запрос от сервера Zabbix (или прокси).
Например, сервер запрашивает данные (например, загрузку CPU), а агент возвращает результат.
-   [Активные проверки](/manual/appendix/items/activepassive#active-checks) - агент Zabbix собирает и отправляет данные, не ожидая запроса от сервера Zabbix (или прокси).
Сначала он получает список элементов мониторинга от сервера (загрузка CPU, доступная память и т. д.), затем собирает необходимые данные и периодически отправляет новые значения обратно.

Тип проверки агента настраивается путем выбора соответствующего [типа элемента данных](/manual/config/items/itemtypes/zabbix_agent).
Агент Zabbix обрабатывает элементы данных типа *Zabbix agent* или *Zabbix agent (active)*.

[comment]: # ({/dc947f39-41e6af7c})

[comment]: # ({ec9f8f5e-b05a4949})
#### Поддерживаемые платформы

Поддерживаемые платформы смотрите на странице [Требования](/manual/installation/requirements#поддерживаемые-платформы).

[comment]: # ({/ec9f8f5e-b05a4949})

[comment]: # ({2e2acc1c-5bbb67d9})
#### Агент в Unix-подобных системах

Агент Zabbix в Unix-подобных системах запускается на узле сети, который находится под мониторингом.

[comment]: # ({/2e2acc1c-5bbb67d9})

[comment]: # ({32a80a93-32937b35})
##### Установка

Агент Zabbix можно установить в системах на базе Linux одним из следующих способов:

-   [Пакеты Zabbix](https://www.zabbix.com/download?zabbix=7.4) - выберите компонент Agent (после выбора версии Zabbix, дистрибутива ОС и версии ОС) и следуйте приведенным инструкциям;
-   [Исходные тексты Zabbix](https://www.zabbix.com/download_sources#74) - загрузите исходные файлы и скомпилируйте агент Zabbix, [настроив исходные тексты](/manual/installation/install) с параметром `--enable-agent`.

::: noteimportant
Как правило, 32-разрядные агенты Zabbix работают в 64-разрядных системах, но в некоторых случаях могут не работать.
:::

::: noteclassic
Предварительно скомпилированные двоичные файлы агента Zabbix доступны для [загрузки](https://www.zabbix.com/download_agents?version=7.4&os=macOS) для macOS, IBM AIX, FreeBSD, OpenBSD и Solaris.
Устаревшие двоичные файлы, совместимые с текущей версией сервера/прокси Zabbix, доступны для [NetBSD](https://www.zabbix.com/download_agents?os=NetBSD&show_legacy=1) и [HP-UX](https://www.zabbix.com/download_agents?os=HPUX&show_legacy=1).
:::

[comment]: # ({/32a80a93-32937b35})

[comment]: # ({e1bcff86-99f37c64})
##### При установке из пакета

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

```bash
systemctl start zabbix-agent
```

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

```default
/etc/init.d/zabbix-agent start
```

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

```bash
systemctl stop zabbix-agent
systemctl restart zabbix-agent
systemctl status zabbix-agent
```

[comment]: # ({/e1bcff86-99f37c64})

[comment]: # ({5478d496-5e83177d})
##### Запуск вручную

Вы можете запустить Zabbix агент, найдя бинарный файл `zabbix_agentd` и запустив его напрямую; например:

```bash
zabbix_agentd
```

[comment]: # ({/5478d496-5e83177d})

[comment]: # ({f276f35a-f276f35a})
#### Агент на Windows системах

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

[comment]: # ({/f276f35a-f276f35a})

[comment]: # ({9a5d7521-af2aa3a5})
##### Установка

Агент Zabbix можно установить в Windows одним из следующих способов:

-   [Предварительно скомпилированные двоичные файлы агента Zabbix](https://www.zabbix.com/download_agents?version=7.4) - загрузите MSI-пакет установщика агента Zabbix и следуйте инструкциям на странице [Установка агента Windows из MSI](/manual/installation/install_from_packages/win_msi);
-   [Исходные тексты Zabbix](https://www.zabbix.com/download_sources#74) - загрузите исходные файлы и следуйте инструкциям на странице [Сборка агента Zabbix в Windows](/manual/installation/install/win_agent).

Дополнительные сведения об установке агента Zabbix (из ZIP-архива) в качестве службы Windows см. на странице [Агент Zabbix в Microsoft Windows](/manual/appendix/install/windows_agent#installing-agent-as-windows-service).

[comment]: # ({/9a5d7521-af2aa3a5})

[comment]: # ({c2144b71-fa025a89})
#### Параметры

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

|Parameter|Description|
|--|--------|
|**Агент UNIX и Windows**|<|
|`-c --config <config-file>`|Путь к [файлу конфигурации](/manual/concepts/agent#configuration-file).<br>Этот параметр можно использовать, чтобы указать файл конфигурации, отличный от файла по умолчанию.|
|`-f --foreground`|Запускать агент Zabbix в режиме переднего плана (по умолчанию: true).|
|`-p --print`|Вывести известные элементы данных и завершить работу.<br>Обратите внимание: чтобы также вернуть результаты [пользовательского параметра](/manual/config/items/userparameters), необходимо указать файл конфигурации (если он не находится в расположении по умолчанию).|
|`-t --test <item key>`|Проверить указанный элемент данных и завершить работу.<br>Обратите внимание: чтобы также вернуть результаты [пользовательского параметра](/manual/config/items/userparameters), необходимо указать файл конфигурации (если он не находится в расположении по умолчанию).|
|`-T --test-config`|Проверить файл конфигурации и завершить работу.|
|`-h --help`|Показать справочную информацию.|
|`-V --version`|Показать номер версии.|
|**Только агент UNIX**|<|
|`-R --runtime-control <option>`|Выполнить административные функции. См. [управление во время выполнения](/manual/concepts/agent#runtime-control).|
|**Только агент Windows**|<|
|`-m --multiple-agents`|Использовать несколько экземпляров агента (с параметрами `-i`, `-d`, `-s`, `-x`).<br>Чтобы различать имена служб экземпляров, каждое имя службы будет включать значение Hostname из указанного файла конфигурации.|
|`-S --startup-type <value>`|Установить тип запуска службы агента Zabbix для Windows. Допустимые значения:<br>`automatic` - *(по умолчанию)* запускать службу автоматически при старте Windows;<br>`delayed` - отложить запуск службы до завершения запуска служб, которые стартуют автоматически (доступно в Windows Server 2008/Vista и более поздних версиях);<br>`manual` - запускать службу вручную (пользователем или приложением);<br>`disabled` - отключить службу, чтобы ее нельзя было запустить пользователем или приложением.<br>Этот параметр можно использовать вместе с параметром `-i` или отдельно, чтобы изменить тип запуска уже установленной службы.|
|`-i --install`|Установить агент Zabbix для Windows как службу.|
|`-d --uninstall`|Удалить службу агента Zabbix для Windows.|
|`-s --start`|Запустить службу агента Zabbix для Windows.|
|`-x --stop`|Остановить службу агента Zabbix для Windows.|

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

-   Вывод всех встроенных элементов данных агента со значениями.
-   Проверка пользовательского параметра с ключом `mysql.ping`, определенного в указанном файле конфигурации.
-   Установка службы Zabbix Agent для Windows с использованием пути по умолчанию к файлу конфигурации `C:\\Program Files\\Zabbix Agent\\zabbix_agentd.conf`.
-   Установка службы Zabbix Agent \[Hostname\] для Windows с использованием файла конфигурации `zabbix_agentd.conf`, расположенного в той же папке, что и исполняемый файл агента, и обеспечение уникальности имени службы путем добавления к нему значения Hostname из файла конфигурации.
-   Изменение типа запуска установленной службы Zabbix Agent для Windows с использованием файла конфигурации `zabbix_agentd.conf`, расположенного в той же папке, что и исполняемый файл агента.

```bash
zabbix_agentd --print
zabbix_agentd -t "mysql.ping" -c /etc/zabbix/zabbix_agentd.conf
zabbix_agentd.exe -i
zabbix_agentd.exe -i -m -c zabbix_agentd.conf
zabbix_agentd.exe -c zabbix_agentd.conf -S delayed
```

[comment]: # ({/c2144b71-fa025a89})

[comment]: # ({fb1bdff2-6ad4cc3c})
##### Управление во время работы

С помощью параметров управления во время работы можно изменить уровень логирования процессов агента.

|Option|Description|Target|
|--|------|------|
|`log_level_increase[=<target>]`|Увеличить уровень логирования.<br>Если цель не указана, это затрагивает все процессы.|Цель можно указать как:<br>**тип процесса** - все процессы указанного типа (например, `listener`)<br>См. все [типы процессов агента](#agent-process-types).<br>**тип процесса,N** - тип процесса и номер (например, `listener,3`)<br>**pid** - идентификатор процесса (`1` to `65535`). Для больших значений указывайте цель как 'тип процесса,N'.|
|`log_level_decrease[=<target>]`|Уменьшить уровень логирования.<br>Если цель не указана, это затрагивает все процессы.|^|
|`userparameter_reload`|Перезагрузить значения параметров `UserParameter` и `Include` из текущего файла конфигурации.| |

Примеры:

-   Увеличение уровня логирования всех процессов
-   Увеличение уровня логирования третьего процесса listener
-   Увеличение уровня логирования процесса с PID 1234
-   Уменьшение уровня логирования всех процессов active checks


```bash
zabbix_agentd -R log_level_increase
zabbix_agentd -R log_level_increase=listener,3
zabbix_agentd -R log_level_increase=1234
zabbix_agentd -R log_level_decrease="active checks"
```

::: noteclassic
Управление во время работы не поддерживается в OpenBSD, NetBSD и Windows.
:::

[comment]: # ({/fb1bdff2-6ad4cc3c})

[comment]: # ({6eff0f17-929667fd})
#### Типы процессов агента

Типы процессов агента следующие:

-   `active checks` - процесс для выполнения активных проверок;
-   `collector` - процесс для сбора данных;
-   `listener` - процесс для прослушивания пассивных проверок.

Файл журнала агента можно использовать для наблюдения за этими типами процессов.

Начиная с Zabbix 7.4.6, файл журнала агента создается с правами чтения и записи только для владельца файла.
Кроме того, файл доступен для чтения группе владельца.
Все остальные разрешения запрещены.

[comment]: # ({/6eff0f17-929667fd})

[comment]: # ({e08842cb-18ab16f1})
#### Пользователь процесса

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

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

[comment]: # ({/e08842cb-18ab16f1})

[comment]: # ({697331c0-fc6b2c61})
#### Файл конфигурации

Путь по умолчанию к файлу конфигурации:

-   В UNIX по умолчанию используется `/usr/local/etc/zabbix_agentd.conf` или путь, заданный переменными [compile-time](/manual/installation/install#configure-the-sources) `--sysconfdir` или `--prefix`.
-   В Windows по умолчанию используется `C:\\Program Files\\Zabbix Agent\\zabbix_agentd.conf`.

Если на узле сети запущен один экземпляр агента, он может использовать файл конфигурации по умолчанию или файл конфигурации, указанный в [командной строке](/manual/concepts/agent#options).
В случае нескольких экземпляров каждый экземпляр агента должен иметь собственный файл конфигурации (один из экземпляров может использовать файл конфигурации по умолчанию).

Подробнее о настройке агента Zabbix см. параметры файла конфигурации для [агента Zabbix для Unix](/manual/appendix/config/zabbix_agentd) или [агента Zabbix для Windows](/manual/appendix/config/zabbix_agentd_win).

[comment]: # ({/697331c0-fc6b2c61})

[comment]: # ({87186bfa-7c3bd34c})
#### Региональные настройки (локаль)

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

[comment]: # ({/87186bfa-7c3bd34c})

[comment]: # ({4d6a8dc1-5581c546})
#### Код выхода

Агент Zabbix возвращает `0` в случае успешного завершения и `1` в случае ошибки.

[comment]: # ({/4d6a8dc1-5581c546})