Revision as of 15:39, 21 April 2012

Synopsis

ngx_http_split_clients_module is used to split clients based on some conditions(e.g ip addresses, headers, cookies, etc).

Example configuration:

http {
    split_clients "${remote_addr}AAA" $variant {
        0.5% .one;
        2.0% .two;
        - "";
    }
 
    server {
        location / {
             index index${variant}.html;

$cookie_..., etc, may be used as a source for splitting. The source string is hashed using MurmurHash2 (as of 1.0.1; previously CRC32) and the percent of the hash is used as source value.

Directives

split_clients

syntax: split_clients $variable { ... }

default: none

context: http

References

• Original Documentation
• Naming convention discussion