labels_hash_bucket_size

定义在 NGINX 中用于存储全局键值标签的哈希桶大小。

语法labels_hash_bucket_size number;
默认值none
上下文http
参数1

说明

The labels_hash_bucket_size 指令配置用于存储在 NGINX 配置中定义的全局键值标签的哈希表的桶大小。该指令对于高效管理这些标签的存储至关重要,这些标签可在请求处理、日志记录和配置等方面动态使用。

该指令接受一个数值参数,用于以字节为单位指定桶大小。桶大小的选择会影响哈希表的性能和内存消耗。较大的桶大小可能会减少哈希冲突,但会增加内存使用;而较小的桶大小可能导致更多冲突,从而降低性能。为平衡内存效率和访问速度,应根据预期的标签数量及其总大小选择合适的桶大小。

通常,默认的桶大小根据体系结构的缓存行大小设置为 32、64 或 128 字节。建议用户根据具体使用场景调整此设置以优化性能,尤其是在使用大量标签的情况下。

配置示例

http {
    labels_hash_bucket_size 64;
    label environment production;
    label region us-west-1;
}

将桶大小设置得过小会因哈希冲突增多而导致性能下降。

更改此值需要重启 NGINX 才能使新设置生效。

← 返回所有指令