Features

Endpoint Backend Profiles

Source

Endpoint backend profiles split production and development traffic into separate backend lanes. This lets operators keep production traffic on the lowest-latency path while sending human, agent, JIT, review, or masking-heavy traffic through a governed development route.

Profiles are useful when the same logical endpoint needs different operational posture for application traffic and human or agent workflows. The endpoint name can stay stable while Gateway chooses the correct backend lane from policy and request context.

Profiles

ProfileUse it for
productionLive application traffic with predictable latency and pool capacity.
developmentDeveloper access, JIT access, SQL review, request analysis, full endpoint masking, per-user checks, and richer audit attribution.

Endpoint Shape

json
{
  "backend_profile": "development",
  "backend_pool_limits": {
    "total_max_connections": 80,
    "production_max_connections": 64,
    "development_max_connections": 32
  }
}

Profiled routing uses explicit production and development branches:

json
{
  "routing": {
    "type": "Profiled",
    "production": {
      "type": "Direct",
      "endpoint": "11111111-1111-1111-1111-111111111111"
    },
    "development": {
      "type": "Direct",
      "endpoint": "22222222-2222-2222-2222-222222222222"
    }
  }
}

Safety Guarantees

  • A development-profile endpoint without an explicit development route fails closed.
  • PostgreSQL, MySQL, and MongoDB direct gateways may use production identity

and deny-style request masking. Other database, cache, and service/API structure masking requires the development profile; production also permits supported LLM and agent request-content PII masking.

  • Eden keys upstream pools by endpoint UUID, keeping production and development backend connections isolated.
  • Development endpoints should use lower-priority or developer credentials.
  • Production capacity is allocated first when a shared total_max_connections limit is configured.

Operational Patterns

PatternWhy it helps
Production application laneKeeps latency-sensitive application traffic on a direct backend route.
Development analysis laneSends human and agent work through lower-privilege credentials and richer audit controls.
Review or JIT laneAllows temporary access without changing the production application's backend path.
Masking-heavy laneApplies inspection or redaction controls away from the production pool budget.
Migration validation laneSeparates validation traffic from normal client traffic while the target is being evaluated.

Capacity Planning

Use backend_pool_limits to keep lower-priority lanes from exhausting total endpoint capacity. When a total pool limit and per-profile limits are both configured, reserve production capacity first and size development lanes for bursty operator or agent workflows.

Profile decisions should be visible in telemetry so operators can distinguish production, development, review, and validation traffic when debugging latency or pool pressure.

Help improve Eden Docs

Find something unclear or incomplete? Review the source and propose an update.

View on GitLab Updated August 2, 2026