Mercurial > hg > nginx-site
view xml/en/docs/http/ngx_http_split_clients_module.xml @ 2846:fdf1464e1977
Moved banner to the external file to make partial rollout possible.
An idea is to have several banners and show them with different probability
specified by split directive in the nginx.conf
author | Sergey Budnevitch <sb@waeme.net> |
---|---|
date | Tue, 10 May 2022 18:07:27 +0400 |
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>