Mercurial > hg > nginx-site
view xml/en/docs/http/ngx_http_split_clients_module.xml @ 1521:e3d3e2ed4275
Added example configuration to mail and stream ssl modules.
author | Yaroslav Zhuravlev <yar@nginx.com> |
---|---|
date | Tue, 30 Jun 2015 17:08:34 +0300 |
parents | 95c3c3bbf1ce |
children |
line wrap: on
line source
<?xml version="1.0"?> <!-- Copyright (C) Igor Sysoev Copyright (C) Nginx, Inc. --> <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> <module name="Module ngx_http_split_clients_module" link="/en/docs/http/ngx_http_split_clients_module.html" lang="en" rev="2"> <section id="summary"> <para> The <literal>ngx_http_split_clients_module</literal> module creates variables suitable for A/B testing, also known as split testing. </para> </section> <section id="example" name="Example Configuration"> <para> <example> http { split_clients "${remote_addr}AAA" $variant { 0.5% .one; 2.0% .two; * ""; } server { location / { index index${variant}.html; </example> </para> </section> <section id="directives" name="Directives"> <directive name="split_clients"> <syntax block="yes"> <value>string</value> <value>$variable</value></syntax> <default/> <context>http</context> <para> Creates a variable for A/B testing, for example: <example> split_clients "${remote_addr}AAA" $variant { 0.5% .one; 2.0% .two; * ""; } </example> The value of the original string is hashed using MurmurHash2. In the example given, hash values from 0 to 21474835 (0.5%) correspond to the value <literal>".one"</literal> of the <var>$variant</var> variable, hash values from 21474836 to 107374180 (2%) correspond to the value <literal>".two"</literal>, and hash values from 107374181 to 4294967295 correspond to the value <literal>""</literal> (an empty string). </para> </directive> </section> </module>