max_metric_name_length
Директива `max_metric_name_length` задаёт максимально допустимую длину имён метрик в модуле NGINX WebAssembly.
Описание
Директива max_metric_name_length имеет ключевое значение при определении метрик в модуле NGINX WebAssembly, поскольку она задаёт верхний предел количества символов для имён метрик. Это ограничение помогает гарантировать корректную форму метрик и соответствие ожиданиям, установленным базовыми APIs, взаимодействующими с WebAssembly runtime. Параметр директивы — это одно целое число, обозначающее максимальную длину имени метрики. При правильном задании оно предотвращает чрезмерную длину, которая может вызывать ошибки при регистрации метрик или сборе данных.
При регистрации метрик предоставленные имена будут сравниваться с этим ограничением длины, чтобы определить, являются ли они допустимыми или следует сгенерировать ошибку из-за нарушения допустимой длины. Эта функциональность соответствует лучшим практикам в отношении производительности и сопровождаемости, навязывая общие соглашения об именовании, подходящие для логирования и мониторинга. Кроме того, некорректно настроенные длины метрик могут привести к ошибкам в конфигурации или исключениям во время выполнения, поэтому правильное использование этой директивы помогает поддерживать стабильную работу в средах, использующих Proxy-Wasm module.
Пример конфига
wasm {
max_metric_name_length 256;
module my_metrics /path/to/metrics_module.wasm;
}Использование имени метрики, превышающего установленную длину, приведет к ошибке регистрации.
Убедитесь, что все имена метрик соответствуют указанной длине, чтобы избежать ошибок выполнения во время сбора метрик.