metrics
Директива metrics позволяет модулю NGINX Proxy-Wasm определять и записывать metrics во время своей работы.
Описание
Директива metrics является неотъемлемой частью функциональности модуля NGINX Proxy-Wasm, позволяя ему определять и обрабатывать metrics для мониторинга производительности и поведения WebAssembly modules, встроенных в NGINX. Она предназначена для помощи разработчикам в отслеживании различных показателей производительности, таких как количество запросов, задержки и частота ошибок, связанных с выполнением WASM modules. Записывая metrics, разработчики могут получить представление о характеристиках производительности своего приложения и при необходимости выявить узкие места или проблемы, требующие внимания.
Директива функционирует, позволяя настраивать различные типы metrics, включая counters и histograms. Каждый metric может быть определён для отслеживания конкретных точек данных, релевантных выполнению WebAssembly modules. Например, counter может увеличиваться при каждом входящем запросе, который обрабатывает WASM module, тогда как histogram может использоваться для фиксации распределения задержек для этих запросов. Эти данные затем могут экспортироваться в инструменты мониторинга для аналитики и отчетности.
Важно, что metrics могут записываться через Proxy-Wasm interface, что позволяет экземпляру NGINX взаимодействовать с внешними системами мониторинга. Эта гибкость необходима для поддержания наблюдаемости в сложных архитектурах, использующих микросервисы и serverless functions. Отсутствие параметров или аргументов в этой директиве отражает её простую цель — инициировать отслеживание metrics без дополнительной конфигурационной нагрузки.
Пример конфига
wasm {
module my_filter /path/to/filter.wasm;
metrics;
}Убедитесь, что директива metrics размещена в конфигурации в правильном месте, чтобы избежать ошибок контекста.
Метрики могут не записываться, если возникают проблемы с выполнением модуля WASM или если подсистема метрик не инициализирована должным образом.