Работа с логами WAF‑ноды¶

Расположение лог‑файлов WAF‑ноды¶

WAF‑нода хранит следующие лог‑файлы в директории /var/log/wallarm:

• brute-detect.log: логи получения данных по счетчикам bruteforce-атак в кластере WAF‑нод.

• export-attacks.log: лог экспорта информации об атаках из модуля постаналитики в облако Вебмониторэкс.

• export-counters.log: лог выгрузки данных счетчиков (см. «Мониторинг WAF‑ноды»).

• export-environment.log: лог сбора и выгрузки в Вычислительный кластер Вебмониторэкс информации о версиях установленных пакетов ноды. Версии пакетов, выгруженные в Вычислительный кластер, отображаются в информации о ноде в Консоли управления Вебмониторэкс. Скрипт для сбора и выгрузки версий запускается один раз в час.

• syncnode.log: лог синхронизации WAF‑ноды с облаком Вебмониторэкс (включая получение файлов ЛОМ и proton.db из облака).

• tarantool.log: лог работы модуля постаналитики.

• sync-ip-lists.log (в предыдущих версиях ноды — sync-blacklist.log): лог синхронизации WAF‑ноды и IP‑адресов, которые были добавлены в списки IP‑адресов как одиночные объекты или подсети.

• sync-ip-lists-source.log (в предыдущих версиях ноды — sync-mmdb.log): лог синхронизации WAF‑ноды и IP‑адресов, которые зарегистрированы в странах, регионах или дата-центрах, добавленных в списки IP‑адресов.

• appstructure.log (только в Docker‑контейнере): лог ПроAPI Структура.

• addnode_loop.log (только в Docker‑контейнере): лог wrapper‑скрипта, который перезапускает скрипт addnode до успешного выполнения.

Настройка расширенного логирования для WAF‑ноды на основе NGINX¶

NGINX записывает логи обработанных запросов (англ. «access logs») в отдельный лог‑файл.

По умолчанию NGINX использует предопределенный формат логирования combined:

log_format combined '$remote_addr - $remote_user [$time_local] '
                    '"$request" $request_id $status $body_bytes_sent '
                    '"$http_referer" "$http_user_agent" ';

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

Переменные WAF‑ноды¶

При определении формата логирования NGINX могут быть использованы следующие переменные WAF‑ноды:

Пример настройки¶

Пусть необходимо задать расширенный формат логирования с именем wallarm_combined, включающий в себя:

• все переменные, используемые в формате combined;

• все переменные WAF‑ноды.

Чтобы это сделать, выполните следующие действия:

1. Добавьте в блок http файла конфигурации NGINX следующие строки, описывающие формат логирования:

   log_format wallarm_combined '$remote_addr - $remote_user [$time_local] '
                               '"$request" $request_id $status $body_bytes_sent '
                               '"$http_referer" "$http_user_agent" '
                               '$wallarm_request_time $wallarm_serialized_size $wallarm_is_input_valid $wallarm_attack_type $wallarm_attack_type_list';
   

2. Включите логирование в расширенном формате, добавив в тот же блок директиву:

   access_log /var/log/nginx/access.log wallarm_combined;

   Логи обработанных запросов будут записываться в формате wallarm_combined в файл /var/log/nginx/access.log.

   Логирование по условию

   При использовании директивы, приведенной выше, в лог‑файл попадут данные по всем обработанным запросам. В том числе данные, которые не относятся к какой-либо атаке.

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

   `access_log /var/log/nginx/access.log wallarm_combined if=$wallarm_attack_type;`
   

   Это может быть полезно для сокращения объема лог‑файла и для интеграции WAF‑ноды с SIEM‑системами.

3. Перезапустите NGINX, выполнив одну из следующих команд в зависимости от используемой операционной системы:

   DebianUbuntuCentOSAlmaLinux, Rocky Linux или Oracle Linux 8.x

   sudo systemctl restart nginx
   

   sudo service nginx restart
   

   sudo systemctl restart nginx
   

   sudo systemctl restart nginx