# Сетевой агент — справка по компоненту

## Назначение

Сетевой агент — служба, которая сканирует IP-адреса устройств, диапазоны и\или подсети, опрашивает принтеры и МФУ по SNMP. Передаёт данные в Мониторинг.

## Когда используется

- Один сетевой агент всегда устанавливается автоматически вместе с Мониторингом.
- Дополнительные агенты — для сегментов сети, недоступных с основного сервера.

## Основные функции

- Обнаружение сетевых принтеров и МФУ по IP-адресам, диапазонам и\или подсетям, заданным в локациях.
- Опрос устройств по протоколу SNMP: состояние, счётчики, расходные материалы.
- Передача данных на сервер Мониторинга.
- Один агент может обслуживать несколько локаций и до 200 000 IP-адресов устройств (при дополнительной настройке опроса и сканирования).

## Связанные компоненты

- Мониторинг — сервер, к которому подключается агент.
- МФУ и Принтер — устройства, которые агент опрашивает по SNMP.
---
## Ключевые параметры конфигурации

#### Windows
- Расположение файла конфигурации:
```
C:\Program Files\printum\agent\config.env
```
#### Linux
- Расположение файла конфигурации:
```
/opt/printum-agent/config.env
```

| Параметр              | Значение по умолчанию | Описание                                                                  |
| --------------------- | --------------------- | ------------------------------------------------------------------------- |
| DEFAULT_SCAN_INTERVAL | 3600 сек              | Интервал сканирования сети                                                |
| DEFAULT_POLL_INTERVAL | 300 сек               | Интервал опроса устройств                                                 |
| LOG_LEVEL             | WARNING               | Уровень логирования.<br>Уровень для диагностики - DEBUG                   |
| TOKEN                 | home.mist             | Токен агента из ЛК → Настройки → Интеграции → Сетевые агенты.             |
| BACKEND               | http://127.0.0.1/     | Адрес сервера Мониторинга.                                                |
| WORKER_COUNT          | 100                   | Количество процессов (воркеров) для опроса устройств и сканирования сети. |
| SNMP_RETRIES          | 2                     | Количество попыток опроса IP-адреса в случае отсутствия ответа.           |
| SNMP_TIMEOUT          | 10                    | Время в секундах, после которого агент фиксирует отсутствие ответа.       |

## Что важно для диагностики

- Лог работы Windows:
```
C:\Program Files\printum\agent\agent.log
```
- Лог работы Linux и статус работы службы:
```
/opt/printum-agent/agent.log
systemctl status printum-agent.service
```

## Что проверить перед эскалацией

- Доступность IP-адресов устройств из локации по протоколу SNMP: `snmpwalk -v 2c -c public <ip>`
- Логи работы агента в режиме DEBUG.

---
## Типовые проблемы

| Проблема                              | Причина                                                                         | Решение                                                                                                                                                                   |
| ------------------------------------- | ------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Не все устройства обнаружены          | Неверный IP в локации, SNMP отключён на устройстве, агент не опрашивает локацию | Проверить IP в настройках локации.<br>Убедиться, что локация отмечена для опроса в настройках агента.<br>Проверить ответ по SNMP: `snmpwalk -v 2c -c public <printer-ip>` |
| Версия агента не обновляется в панели | Агент не перезапустился после обновления                                        | Проверить статус сервиса агента                                                                                                                                           |

## Связанные страницы

- [Мониторинг — справка по компоненту](http://wiki.printum.io/books/2-komponenty-sistemy/page/monitoring-spravka-po-komponentu)
- [Установка Сетевого агента на Linux](http://wiki.printum.io/books/3-ustanovka/page/ustanovka-setevogo-agenta-na-linux)
- [Принтер не обнаружен при сетевом сканировании](http://wiki.printum.io/books/7-ustranenie-neispravnostei/page/printer-ne-obnaruzen-pri-setevom-skanirovanii)