proxy_wasm_log_dispatch_errors

Директива `proxy_wasm_log_dispatch_errors` включает логирование ошибок при сбоях WebAssembly-прокси во время диспетчеризации.

Синтаксисproxy_wasm_log_dispatch_errors on | off;
По умолчаниюoff
Контекст
Аргументы1

Описание

Директива proxy_wasm_log_dispatch_errors настраивает NGINX на запись ошибок, возникающих при диспетчеризации событий в модуль фильтра WebAssembly. Эта возможность имеет решающее значение для диагностики проблем, которые появляются при выполнении WebAssembly в прокси-контексте. Когда директива установлена в on, любые ошибки, возникшие в процессе диспетчеризации, будут записаны в журналы ошибок NGINX с подробной информацией, что позволяет разработчикам и администраторам эффективно устранять проблемы, связанные с WebAssembly.

Директива принимает один аргумент: булево значение, которое может быть on или off. Установка в on включает функцию логирования ошибок, тогда как состояние off отключает её. Поведение директивы в основном влияет на то, как выполняется обработка ошибок в связке с модулями WebAssembly, интегрированными в конфигурацию NGINX. Используя эту директиву, пользователи могут убедиться, что собрали всю необходимую информацию об ошибках выполнения WebAssembly, что может быть бесценным как при тестировании, так и в рабочих средах.

В целом, когда фильтры WebAssembly применяются в NGINX, рекомендуется использовать proxy_wasm_log_dispatch_errors on; для получения сведений о потенциальных сбоях, вызванных проблемами в WASM-бинарниках или в самом NGINX, что в итоге повышает надёжность системы и наблюдаемость.

Пример конфига

http {
    proxy_wasm_log_dispatch_errors on;
    server {
        listen 8080;
        location / {
            proxy_pass http://backend;
            proxy_wasm my_filter;
        }
    }
}

Убедитесь, что уровень логирования установлен корректно для записи ошибок; в противном случае ошибки могут не отображаться в логах.

Отключение логирования с помощью off может затруднить отладку при возникновении проблем с модулями WebAssembly.

← Ко всем директивам