From 1eb7fb7641f8ca1d66c38157c5802c1c388e53cc Mon Sep 17 00:00:00 2001
From: lobanov_v <vasiliy2klobanov@gmail.com>
Date: Wed, 23 Sep 2026 14:30:35 +0000
Subject: [PATCH] =?UTF-8?q?=D0=94=D0=BE=D0=B1=D0=B0=D0=B2=D0=B8=D1=82?=
 =?UTF-8?q?=D1=8C=20README.md?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 48 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..be3988b
--- /dev/null
+++ b/README.md
@@ -0,0 +1,48 @@
+# Мониторинг AmneziaWG в Zabbix
+
+Красивый и структурированный шаблон для мониторинга **AmneziaWG** с возможностью автообнаружения (LLD) туннелей.
+
+## Инструкция по установке
+
+### Шаг 1. Импорт шаблона
+1. Перейдите в веб-интерфейс Zabbix: **Data collection** → **Templates** (Сбор данных → Шаблоны).
+2. Нажмите кнопку **Import** (Импорт) в правом верхнем углу.
+3. Выберите файл шаблона `zbx_export_templates.yaml` (или `.xml`) и подтвердите импорт.
+
+### Шаг 2. Размещение скриптов на сервере AmneziaWG
+Перенесите скрипты мониторинга на целевой сервер в директорию `/etc/zabbix/`:
+* `/etc/zabbix/amnezia_zabbix.sh` — основной bash-скрипт для работы с агентом.
+* `/etc/zabbix/amnezia_stats.py` — python-скрипт для парсинга метрик AmneziaWG.
+
+### Шаг 3. Настройка прав доступа
+Сделайте bash-скрипт исполняемым, выполнив команду в терминале сервера:
+```bash
+sudo chmod +x /etc/zabbix/amnezia_zabbix.sh
+```
+
+### Шаг 4. Настройка Zabbix-агента
+Добавьте в конфигурационный файл агента (обычно `/etc/zabbix/zabbix_agent2.conf` или отдельный файл в `/etc/zabbix/zabbix_agent2.d/`) следующие параметры **UserParameter**:
+
+```ini
+UserParameter=amnezia.discovery,/etc/zabbix/amnezia_zabbix.sh discovery
+UserParameter=amnezia.rx[*],/etc/zabbix/amnezia_zabbix.sh rx $1
+UserParameter=amnezia.tx[*],/etc/zabbix/amnezia_zabbix.sh tx $1
+UserParameter=amnezia.handshake[*],/etc/zabbix/amnezia_zabbix.sh handshake $1
+```
+
+### Шаг 5. Перезапуск службы агента
+Примените изменения, перезапустив Zabbix-агент:
+```bash
+systemctl restart zabbix-agent2
+```
+
+### Шаг 6. Привязка шаблона
+1. В интерфейсе Zabbix откройте настройки нужного узла сети (**Hosts**).
+2. Вкладка **Templates** → начните вводить имя импортированного шаблона и выберите его.
+3. Нажмите **Update** (Обновить).
+
+---
+
+## Использование и метрики
+Для вывода информации на дашборды или создания кастомных графиков используйте ключевой элемент данных:
+* **`AmneziaWG: Connected users`** — отображает текущее количество активных пользователей в сети.