Experiment Evaluation Proxy

The Evaluation Proxy is a Service to enable, enhance, and optimize local evaluation running within your infrastructure.

• Enable local evaluation on unsupported platforms: Use remote Evaluation APIs and SDKs to run local evaluation in your infrastructure.

• Automatically track assignment events for local evaluations: Identical assignment events are deduplicated for 24 hours.

• Enhance local evaluation with large cohort targeting: Targeted cohorts are synced hourly to the Evaluation Proxy and added to the user prior to evaluation.

Configuration

The evaluation proxy is either configured via a yaml file (recommended, more configuration options), or using environment variables.

The default location for the configuration yaml file is /etc/evaluation-proxy-config.yaml. You may also configure the file location using the PROXY_CONFIG_FILE_PATH environment variable.

• projects (required)
• configuration (optional).

1projects:
2  - apiKey: "YOUR API KEY"
3    secretKey: "YOUR SECRET KEY"
4    managementKey: "YOUR MANAGEMENT API KEY"
5 
6configuration:
7  redis:
8    uri: "YOUR REDIS URI" # e.g. "redis://localhost:6379"

Environment configuration can only configure a single project. Environment variable configuration is only considered if the configuration file is not found.

projects

A required array of objects with the following fields, all which are required.

configuration

An optional object of extra configuration.

1configuration:
2  # Other configurations...
3  serverUrl: "https://api.lab.eu.amplitude.com"
4  cohortServerUrl: "https://cohort.lab.eu.amplitude.com"

redis

Configure the evaluation proxy to use Redis as a persistent storage. Highly recommended to enable the evaluation proxy to run efficiently.

Deployment

The evaluation proxy is stateless, and should be deployed with multiple instances behind a load balancer for high availability and scalability.

For example, a kubernetes deployment with greater than one replica.

Kubernetes

Use the evaluation proxy Helm chart to install the proxy service on kubernetes or generate the files needed to deploy the service manually. The repository also contains an example of running the evaluation proxy on kubernetes locally using minikube.

Helm

Add helm repo

1helm repo add \
2    evaluation-proxy-helm https://amplitude.github.io/evaluation-proxy-helm

Configure values.yaml

Configure the chart values. The recommended approach to configuring and installing the helm chart is using a values.yaml configuration file.

The chart's evaluationProxy value contents exactly match the evaluation proxy's configuration file fields.

1evaluationProxy:
2  # At least one project is required.
3  projects:
4    - apiKey: "YOUR API KEY"
5      secretKey: "YOUR SECRET KEY"
6      managementKey: "YOUR MANAGEMENT API KEY"
7  configuration: {}
8#    redis:
9#      uri: "redis://redis-master.default.svc.cluster.local:6379"

Install helm chart

1helm install -f values.yaml \
2    evaluation-proxy evaluation-proxy-helm/evaluation-proxy

Docker

You may run the docker image directly. First, create a configuration file, then run the docker image mounting the file as a volume to the expected directory in the container.

1docker run \
2    -v CONFIG_FILE_PATH:/etc/evaluation-proxy-config.yaml \
3    amplitudeinc/evaluation-proxy

Evaluation

The Evaluation Proxy exposes remote Evaluation API and SDK endpoints to run local evaluation within your cluster. This is useful to enable platforms and languages which aren't supported by local evaluation SDKs. As an added benefit, fetch requests made to the evaluation proxy can target cohorts of users, and have assignment events tracked automatically to Amplitude.

You must send requests to the service using http on port 3546.