wasm_socket_large_buffers

Директива wasm_socket_large_buffers задаёт максимальное количество больших буферов и их размеры для сокетной коммуникации WebAssembly в NGINX.

Синтаксисwasm_socket_large_buffers number size;
По умолчаниюnone
Контекстhttp, server, location
Аргументы2

Описание

Директива wasm_socket_large_buffers используется в контекстах NGINX http, server и location для установки максимального количества больших буферов, доступных для сокетных операций WebAssembly при взаимодействии между сервером NGINX и модулями Wasm. Эта директива принимает два аргумента: первый — целое число, обозначающее количество больших буферов, а второй — размер каждого буфера.

В сценариях, где модули WebAssembly требуют обработки больших объёмов данных, например в потоковых приложениях или при ресурсоёмких операциях с данными, использование больших буферов становится необходимым. Значения, заданные этой директивой, позволяют администраторам настраивать объём памяти, выделяемый для этих буферов, тем самым оптимизируя производительность в зависимости от ожидаемой нагрузки и доступности памяти. Если указанный размер буфера будет превышен, операции могут либо завершиться с ошибкой, либо потребовать дополнительной обработки, поэтому важно правильно настроить эту директиву для высокопроизводительных приложений.

По умолчанию, если директива не задана, NGINX не выделяет большие буферы для сокетной коммуникации WebAssembly, что может привести к узким местам в управлении памятью при высокой нагрузке. Поэтому рекомендуется задавать эту директиву в соответствии с потребностями приложения и ожидаемыми объёмами трафика.

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

# nginx.conf example
http {
    wasm_socket_large_buffers 32 16k;
}

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

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

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

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