How to run an A/B test

Basic example

This rule:

Uses rand.double() to generate a random double between 0 and 1 when traffic reaches the endpoint

Checks if the value is less than or equal to 0.5

If so, it routes the traffic to a different internal Agent Endpoint.

on_http_request:
- expressions:
  - rand.double() <= 0.5
  actions:
  - type: forward-internal
    config:
      url: https://a.internal
- actions:
  - type: forward-internal
    config:
      url: https://b.internal

{
  "on_http_request": [
    {
      "expressions": [
        "rand.double() <= 0.5"
      ],
      "actions": [
        {
          "type": "forward-internal",
          "config": {
            "url": "https://a.internal"
          }
        }
      ]
    },
    {
      "actions": [
        {
          "type": "forward-internal",
          "config": {
            "url": "https://b.internal"
          }
        }
      ]
    }
  ]
}

You can change the value the random number is checked against to split the traffic in different ratios. For example,>=0.8 would send 80% of the traffic to one endpoint and 20% to the other.

Using rewrites

You can also send the traffic to a different route using URL rewrites.

on_http_request:
- expressions:
  - rand.double() <= 0.5
  actions:
  - type: url-rewrite
    config:
      from: "/path/to/test"
      to: "/path/to/test-b"
- actions:
  - type: forward-internal
    config:
      url: https://b.internal

{
  "on_http_request": [
    {
      "expressions": [
        "rand.double() <= 0.5"
      ],
      "actions": [
        {
          "type": "url-rewrite",
          "config": {
            "from": "/path/to/test",
            "to": "/path/to/test-b"
          }
        }
      ]
    },
    {
      "actions": [
        {
          "type": "forward-internal",
          "config": {
            "url": "https://b.internal"
          }
        }
      ]
    }
  ]
}

See the URL Rewrite Example for another example using rewrites.

Getting Started

Use Cases

Examples

Connectivity

Traffic Policy

Observability

Network

Resources

Identity & Access

Basic example

Using rewrites

​Basic example

​Using rewrites

Basic example

Using rewrites