| 1 | # Playbook: Zabbix — мониторинг (v1) |
| 2 | |
| 3 | > **Scope:** общие практики мониторинга с Zabbix, типовые интеграции (в т.ч. nginx), без привязки к конкретным хостам. |
| 4 | |
| 5 | --- |
| 6 | |
| 7 | ## Ключевые понятия |
| 8 | |
| 9 | - **Шаблон (template):** набор элементов данных, триггеров и действий, подключаемый к хосту. |
| 10 | - **Элемент данных (item):** метрика, собираемая агентом, SNMP, HTTP и т.д. |
| 11 | - **Триггер (trigger):** условие на основе данных элемента; при срабатывании — инцидент/уведомление. |
| 12 | - **Интеграция с nginx:** через модуль stub_status и Zabbix agent или HTTP-проверки; метрики: соединения (accepted, active, waiting), запросы в секунду. |
| 13 | |
| 14 | --- |
| 15 | |
| 16 | ## Типовая проблема: 413 Request Entity Too Large |
| 17 | |
| 18 | - **Причина:** размер тела запроса превышает лимит nginx (`client_max_body_size`, по умолчанию 1 МБ). |
| 19 | - **Решение:** в конфигурации nginx (http / server / location) задать `client_max_body_size <значение>;` (например 50M), затем `nginx -t && nginx -s reload`. |
| 20 | - **Мониторинг:** при необходимости — триггеры по коду 413 в access log или по доле ошибок; для загрузки файлов (например карты) лимит задавать в том location, который обслуживает загрузку. |
| 21 | |
| 22 | --- |
| 23 | |
| 24 | ## Анти-паттерны |
| 25 | |
| 26 | - Не проверять синтаксис nginx перед reload (`nginx -t`). |
| 27 | - Создавать триггеры без порога или с порогом «всегда срабатывает» — шум и усталость от алертов. |
| 28 | - Хранить пароли и токены Zabbix в репозитории. |
| 29 | |
| 30 | --- |
| 31 | |
| 32 | ## Диагностика |
| 33 | |
| 34 | Сводка: [`troubleshooting/playbook-ops-observability-network-troubleshooting-v1.md`](troubleshooting/playbook-ops-observability-network-troubleshooting-v1.md) § Zabbix. |
| 35 | |
| 36 | --- |
| 37 | |
| 38 | ## Создание/правка триггера и шаблона (кратко) |
| 39 | |
| 40 | - Триггер: выражение с окном (например `max(/,5m)>80`), описание и вероятные причины, severity; при необходимости — recovery expression (предпочтительно статические значения). |
| 41 | - Шаблон: не передавать пароли через макросы; value mapping для дискретных состояний; зависимые item'ы вместо лишних опросов; при LLD — «Discard unchanged with heartbeat» на мастер-item. |
| 42 | |
| 43 | --- |
| 44 | |
| 45 | *Источники: документация Zabbix, best practices, интеграции nginx. Конкретные серверы и шаблоны — в локальном контексте. Глубокий справочник: kb-zabbix-reference-v1.md.* |
| 46 | |
| 47 | |