Este producto no es compatible con el sitio de Datadog seleccionado. ().
Descripción general
Un proxy de retransmisión se sitúa entre su aplicación y Datadog. El SDK de Datadog Feature Flag envía solicitudes a una URL en su dominio, y su proxy las reenvía a Datadog.
Se deben reenviar dos tipos de solicitudes:
Solicitudes de configuración de Datadog Feature Flag: POST a la CDN de Datadog para obtener las asignaciones precalculadas de Datadog Feature Flag. El SDK de Datadog Feature Flag envía el contexto de evaluación en el cuerpo de la solicitud. Su proxy reenvía el cuerpo y los encabezados sin cambios.
Solicitudes de evento (exposiciones y evaluaciones): POST a los puntos de conexión de ingesta de Datadog. Los SDK móviles envían a rutas fijas en Datadog API. El SDK de navegador utiliza un parámetro de consulta ddforward que codifica la ruta de destino y los parámetros, los cuales su proxy debe decodificar y utilizar para construir la URL final de Datadog.
Los ejemplos de código en esta página utilizan el sitio US1 (datadoghq.com) como ejemplo. Reemplace los orígenes de Datadog con los valores correspondientes para su sitio de Datadog.
Sitio de Datadog
Origen de CDN de Datadog Feature Flag
Origen de ingesta móvil
Origen de ingesta de navegador
US1
preview.ff-cdn.datadoghq.com
api.datadoghq.com
browser-intake-datadoghq.com
EU1
preview.ff-cdn.datadoghq.eu
api.datadoghq.eu
browser-intake-datadoghq.eu
US3
preview.ff-cdn.us3.datadoghq.com
api.us3.datadoghq.com
browser-intake-us3-datadoghq.com
US5
preview.ff-cdn.us5.datadoghq.com
api.us5.datadoghq.com
browser-intake-us5-datadoghq.com
AP1
preview.ff-cdn.ap1.datadoghq.com
api.ap1.datadoghq.com
browser-intake-ap1-datadoghq.com
AP2
preview.ff-cdn.ap2.datadoghq.com
api.ap2.datadoghq.com
browser-intake-ap2-datadoghq.com
UK1
preview.ff-cdn.uk1.datadoghq.com
api.uk1.datadoghq.com
browser-intake-uk1-datadoghq.com
Elija una implementación de proxy
NGINX funciona como un proxy de retransmisión en cualquier infraestructura: máquinas virtuales en la nube, Kubernetes, Docker o bare metal.
Configuración de Datadog Feature Flag y retransmisión de eventos móviles
Añada el siguiente bloque server a su configuración de NGINX.
nginx.conf
server{listen443ssl;server_nameproxy.example.com;# ssl_certificate /etc/ssl/certs/proxy.example.com.crt;
# ssl_certificate_key /etc/ssl/private/proxy.example.com.key;
# Flag configuration relay (all platforms)
location/precompute-assignments{proxy_passhttps://preview.ff-cdn.datadoghq.com/precompute-assignments;proxy_ssl_server_nameon;proxy_set_headerHostpreview.ff-cdn.datadoghq.com;proxy_pass_request_bodyon;}# Mobile SDK event relay: exposures
location/api/v2/exposures{proxy_passhttps://api.datadoghq.com/api/v2/exposures;proxy_ssl_server_nameon;proxy_set_headerHostapi.datadoghq.com;proxy_pass_request_bodyon;}# Mobile SDK event relay: evaluations
location/api/v2/flagevaluation{proxy_passhttps://api.datadoghq.com/api/v2/flagevaluation;proxy_ssl_server_nameon;proxy_set_headerHostapi.datadoghq.com;proxy_pass_request_bodyon;}}
Después de implementar, establezca las opciones del SDK de Datadog Feature Flag de la siguiente manera:
Opción del SDK
Valor
Configuración de Datadog Feature Flag (useCustomFlagEndpoint / customFlagsEndpoint)
El SDK del navegador añade un parámetro de consulta ddforward que contiene la ruta de destino codificada en URL. El NGINX estándar no puede decodificar este parámetro en una directiva proxy_pass. Utilice OpenResty, que extiende NGINX con scripts de Lua, para gestionar los eventos del navegador.
Añada este bloque de ubicación a la configuración del servidor OpenResty junto a los bloques de NGINX estándar anteriores. El código Lua requiere la biblioteca lua-resty-http.
Un Cloudflare Worker gestiona todos los tipos de solicitudes en un solo script y se ejecuta en el borde sin infraestructura que administrar.
Cree un Worker en su panel de control de Cloudflare e implemente el siguiente script. Actualice DATADOG_SITE si su sitio de Datadog no es US1.
worker.js
constDATADOG_SITE='datadoghq.com';constFLAG_CDN_ORIGIN=`preview.ff-cdn.${DATADOG_SITE}`;constMOBILE_INTAKE_ORIGIN=`api.${DATADOG_SITE}`;const_parts=DATADOG_SITE.split('.');const_tld=_parts.pop();constBROWSER_INTAKE_ORIGIN=`browser-intake-${_parts.join('-')}.${_tld}`;exportdefault{asyncfetch(request){consturl=newURL(request.url);// Flag configuration relay: forward to Datadog CDN
if(url.pathname==='/precompute-assignments'){consttarget=`https://${FLAG_CDN_ORIGIN}/precompute-assignments`;returnfetch(target,{method:request.method,headers:request.headers,body:request.body,});}// Mobile SDK event relay: forward to Datadog API
if(url.pathname==='/api/v2/exposures'||url.pathname==='/api/v2/flagevaluation'){consttarget=`https://${MOBILE_INTAKE_ORIGIN}${url.pathname}`;returnfetch(target,{method:request.method,headers:request.headers,body:request.body,});}// Browser SDK event relay: decode ddforward and forward to browser intake
if(url.pathname==='/intake'){constddforward=url.searchParams.get('ddforward');if(!ddforward){returnnewResponse('missing ddforward',{status:400});}consttarget=`https://${BROWSER_INTAKE_ORIGIN}${ddforward}`;constforwardedHeaders=newHeaders(request.headers);forwardedHeaders.set('X-Forwarded-For',request.headers.get('CF-Connecting-IP')||'');forwardedHeaders.delete('cookie');returnfetch(target,{method:request.method,headers:forwardedHeaders,body:request.body,});}returnnewResponse('not found',{status:404});},};
Después de implementar, configure un dominio personalizado para su Worker (por ejemplo, proxy.example.com) y establezca las opciones del SDK de Datadog Feature Flag de la siguiente manera:
Opción del SDK
Valor
Configuración de Datadog Feature Flag
https://proxy.example.com/precompute-assignments
Exposiciones (móvil)
https://proxy.example.com/api/v2/exposures
Evaluaciones (móvil)
https://proxy.example.com/api/v2/flagevaluation
Eventos de navegador (proxy)
https://proxy.example.com/intake
Las rutas de API de Next.js funcionan como un proxy de retransmisión cuando se implementan en Vercel o en cualquier plataforma de alojamiento de Node.js.
Cree tres rutas de API: una para la configuración de Datadog Feature Flag, una para eventos móviles y una para eventos de navegador.
Ruta de configuración de Datadog Feature Flag
app/api/flag-config/route.ts
constFLAG_CDN=`https://preview.ff-cdn.datadoghq.com/precompute-assignments`;exportasyncfunctionPOST(req: Request){constheaders: HeadersInit={'Content-Type':req.headers.get('Content-Type')??'application/vnd.api+json',};// Pass through authentication headers from the SDK
constclientToken=req.headers.get('dd-client-token');constappId=req.headers.get('dd-application-id');if(clientToken)headers['dd-client-token']=clientToken;if(appId)headers['dd-application-id']=appId;constresponse=awaitfetch(FLAG_CDN,{method:'POST',headers,body: req.body,// @ts-ignore – required for streaming request body in Node.js
duplex:'half',});returnnewResponse(response.body,{status: response.status});}
Ruta de eventos móviles
Una ruta general maneja tanto /api/v2/exposures como /api/v2/flagevaluation y reenvía cada uno a la ingesta móvil de Datadog.
Después de implementar, configure las opciones del SDK de Datadog Feature Flag de la siguiente manera (reemplace proxy.example.com con su dominio de Vercel):
Opción del SDK
Valor
Configuración de Datadog Feature Flag
https://proxy.example.com/api/flag-config
Exposiciones (móvil)
https://proxy.example.com/api/v2/exposures
Evaluaciones (móvil)
https://proxy.example.com/api/v2/flagevaluation
Eventos del navegador (proxy)
https://proxy.example.com/api/intake
Lecturas adicionales
Documentación, enlaces y artículos útiles adicionales: