실험 평가 프록시

평가 프록시는 귀하의 인프라 내에서 실행되는 로컬 평가를 활성화, 개선 및 최적화하기 위한 서비스입니다.

• 지원되지 않는 플랫폼에서 로컬 평가 활성화: 원격 평가 API 및 SDK를 사용하여 인프라에서 로컬 평가를 실행하십시오.

• 로컬 평가를 위해 노출 이벤트를 자동으로 추적: 프록시는 동일한 노출 이벤트를 24시간 동안 중복 제거합니다.

• 대규모 코호트 타겟팅을 통해 로컬 평가를 개선: 타겟팅된 코호트는 매시간 평가 프록시와 동기화되며, 프록시는 평가 전에 사용자에게 코호트를 추가합니다.

구성

평가 프록시는 yaml 파일(권장되며 더 많은 구성 옵션이 있음)을 사용하거나 환경 변수를 사용하여 구성됩니다.

구성 yaml 파일의 기본 위치는 /etc/evaluation-proxy-config.yaml입니다. PROXY_CONFIG_FILE_PATH환경 변수를 사용하여 파일 위치를 구성할 수도 있습니다.

• projects (필수)
• configuration (선택 사항).

projects:
  - apiKey: "YOUR API KEY"
    secretKey: "YOUR SECRET KEY"
    managementKey: "YOUR MANAGEMENT API KEY"
configuration:
  redis:
    uri: "YOUR REDIS URI" # e.g. "redis://localhost:6379"

환경 구성은 단일 프로젝트만 지원합니다. 프록시는 구성 파일을 찾을 수 없는 경우에만 환경 변수 구성을 사용합니다.

• AMPLITUDE_API_KEY
  • 설명: 프로젝트의 API 키입니다.
• AMPLITUDE_SECRET_KEY
  • 설명: 프로젝트의 비밀 키입니다.
• AMPLITUDE_EXPERIMENT_MANAGEMENT_API_KEY
  • 설명: 실험 API 관리 키입니다. 구성된 API 및 암호 키와 동일한 프로젝트에 대해 생성되어야 합니다. 프로젝트에 사용된 배포에 자동으로 액세스하고 업데이트하는 데 사용됩니다.
• AMPLITUDE_REDIS_URI
  • 설명: 선택 사항입니다. Redis에 연결하기 위한 전체 URI입니다. 프로토콜, 호스트, 포트와 선택 사항인 사용자 이름, 암호, 경로(예: redis://localhost:6379)를 포함합니다.
• AMPLITUDE_REDIS_PREFIX
  • 설명: 선택 사항입니다. 연결할 접두사
• AMPLITUDE_REDIS_USE_CLUSTER
  • 설명: 선택 사항입니다. AMPLITUDE_REDIS_URI가 클러스터 URL인 경우 이를 true로 전달하십시오. 기본값은 false입니다.
• AMPLITUDE_REDIS_READ_FROM
  • 설명: 선택 사항입니다. Redis 클러스터에 대한 라우팅 전략을 읽습니다. 옵션: REPLICA_PREFERRED(기본값, 복제본 선호) 또는 ANY(클러스터의 모든 노드에서 읽기).
• AMPLITUDE_SERVER_URL
  • 설명: 선택 사항입니다. 플래그를 가져올 서버 URL(프로토콜과 호스트를 포함)입니다.
• AMPLITUDE_COHORT_SERVER_URL
  • 설명: 선택 사항입니다. 코호트를 다운로드할 서버 URL(프로토콜과 호스트를 포함)입니다.

프로젝트

다음 필드를 포함하는 객체의 필수 배열입니다. 이 필드는 모두 필수입니다.

• id
  • 설명: 프로젝트의 ID입니다. 프로젝트 설정에서 찾을 수 있습니다.
• apiKey
  • 설명: 프로젝트의 API 키입니다.
• secretKey
  • 설명: 프로젝트의 비밀 키입니다.
• managementKey
  • 설명: 실험 API 관리 키입니다. 구성된 API 및 암호 키와 동일한 프로젝트에 대해 생성되어야 합니다. 프로젝트에 사용된 배포에 자동으로 액세스하고 업데이트하는 데 사용됩니다.

구성

추가 구성의 선택적 객체입니다.

• redis
  • 설명: 선택 사항(권장됨). redis를 참조하십시오. Redis를 영구 스토리지로 사용하도록 프록시를 구성합니다.
• flagSyncIntervalMillis
  • 설명: 선택 사항입니다. 플래그 구성을 업데이트하기 위한 폴링 간격(기본값 10000).
• maxCohortSize
  • 설명: 선택 사항입니다. 프록시가 다운로드할 수 있는 대상 코호트의 최대 크기(기본값 2147483647).
• serverUrl
  • 설명: 선택 사항입니다. 플래그를 가져올 서버 URL(프로토콜과 호스트를 포함함). (기본값https://api.lab.amplitude.com)
• cohortServerUrl
  • 설명: 선택 사항입니다. 코호트를 다운로드할 서버 URL(프로토콜과 호스트를 포함함)(기본값https://cohort.lab.amplitude.com)

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

Redis

Redis를 영구 스토리지로 사용하도록 평가 프록시를 구성합니다. 평가 프록시를 효율적으로 실행할 수 있도록 활성화하는 것을 적극 권장합니다.

• uri
  • 설명: 필수입니다. Redis에 연결할 때 사용할 전체 URI입니다. 프로토콜, 호스트, 포트 및 선택적 사용자 이름, 암호 및 경로를 포함하십시오.
• readOnlyUri
  • 설명: 선택 사항입니다. Redis 읽기 복제본에 대한 고확장성 대용량 읽기를 위해 읽기 전용 복제본에 연결하기 위한 선택적 URI입니다.
• useCluster
  • 설명: 선택 사항입니다. uri가 클러스터 URL인 경우 이 값을 true로 설정하십시오. 기본값은 false입니다.
• readFrom
  • 설명: 선택 사항입니다. 클러스터 모드에만 해당하는 읽기 라우팅 전략: REPLICA_PREFERRED (기본값, 복제본 선호) 또는 ANY (클러스터의 임의 노드에서 읽기).
• prefix
  • 설명: 선택 사항입니다. 평가 프록시에서 저장된 모든 키에 대한 접두어입니다. 기본값은 amplitude입니다.

배포

평가 프록시는 상태가 없습니다. 고가용성과 확장성을 위해 로드 밸런서 뒤에 여러 인스턴스를 배포하십시오.

예를 들어 하나 이상의 복제본을 사용하는 쿠버네티스 배포가 있습니다.

쿠버네티스

평가 프록시 Helm 차트를 사용하여 쿠버네티스에 프록시 서비스를 설치하거나 서비스를 수동으로 배포하는 데 필요한 파일을 생성하십시오. 이 저장소에는 minikube를 사용하여 쿠버네티스에서 평가 프록시를 로컬로 실행하는 예도 포함되어 있습니다.

Helm

Helm 저장소 추가

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

구성 values.yaml

차트 값을 구성합니다. Helm 차트를 구성하고 설치하는 데 권장되는 방법은 values.yaml 구성 파일을 사용하는 것입니다.

차트의 evaluationProxy 값 내용은 평가 프록시의 구성 파일 필드와 정확히 일치합니다.

evaluationProxy:
  # At least one project is required.
  projects:
    - apiKey: "YOUR API KEY"
      secretKey: "YOUR SECRET KEY"
      managementKey: "YOUR MANAGEMENT API KEY"
  configuration: {}
#    redis:
#      uri: "redis://redis-master.default.svc.cluster.local:6379"

Helm 차트 설치

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

도커

도커 이미지를 직접 실행할 수도 있습니다. 먼저 구성 파일을 생성한 다음 해당 파일을 컨테이너의 예상 디렉토리에 볼륨으로 마운트하는 도커 이미지를 실행하십시오.

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

평가

평가 프록시는 원격 평가 API 및 SDK 엔드포인트를 노출시켜 클러스터 첫 사용 후 로컬 평가를 실행합니다. 이 기능은 로컬 평가 SDK에서 지원하지 않는 플랫폼과 언어를 활성화하는 데 유용합니다. 추가적인 이점으로, 평가 프록시에 대한 가져오기 요청은 사용자 코호트를 대상으로 할 수 있으며 할당 이벤트가 Amplitude로 자동 추적됩니다.

포트 3546의 http를 사용하여 서비스에 요청을 전송해야 합니다.

- name: JAVA_TOOL_OPTIONS
  value: "-Xms128m -Xmx6144m"

configuration:
  redis:
    uri: "rediss://primary:6379"
    readOnlyUri: "rediss://replica:6379"  # Optional, for high-volume read scaling.

configuration:
  redis:
    uri: "rediss://cluster:6379"
    useCluster: true

# Error rate > 1%
rate(http_requests_total{status=~"5.."}[5m]) > 0.01
# P95 latency > 100ms sustained (ignore during cohort refresh spikes)
histogram_quantile(0.95, rate(http_request_duration_seconds_bucket[5m])) > 0.1
# Memory > 85%
container_memory_usage_bytes / container_spec_memory_limit_bytes > 0.85
# Redis errors
rate(redis_errors_total[5m]) > 0