For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Sign inTry it free
DocsGuidesSDKsIntegrationsAPI docsTutorialsFlagship blog
DocsGuidesSDKsIntegrationsAPI docsTutorialsFlagship blog
  • Tutorials
    • The AI Iteration Loop for Deploying Reliable Agents with LangGraph
    • Using LaunchDarkly feature flags and Experimentation with Wordpress
    • Migrate a Hardcoded LangGraph Agent to LaunchDarkly AgentControl in 20 Minutes
    • Offline Evaluation of RAG-Grounded Answers in AgentControl
    • Beyond n8n for Workflow Automation: Agent Graphs as Your Universal Agent Harness
    • Catch your first silent AI failure with Vega AI in under 10 minutes
    • Evaluate LLM code generation with LLM-as-judge evaluators
    • OpenTelemetry for LLM Applications: A Practical Guide with LaunchDarkly and Langfuse
    • Use LaunchDarkly Agent Skills in Claude Code and Cursor
    • Detection to Resolution: Real World Debugging with Rage Clicks and Session Replay
    • Compare AI orchestrators: LangGraph vs Strands vs OpenAI Swarm
    • Building a data extraction pipeline with LaunchDarkly
    • Day 12 | 🎊 New Year, New Observability
    • Day 11 | ✉️ Letters to Santa: What engineering teams really want from Observability in 2026
    • Day 10 | Why observability and feature flags go together like milk and cookies
    • Day 9 | 👻 The Three Ghosts Haunting Your AI This Holiday Season
    • Day 7 | 🎄✨The Rockefeller tree in NYC: SLOs that actually drive decisions
    • Day 6 | 💸 The famous green character that stole your cloud budget: the cardinality problem
    • Day 5 | 🧹 Using a Popular Tidying Method to Consolidate Your Observability Stack
    • Day 4 | ❄️ Tracing the impact of holiday styling in your Node.js app
    • Day 8 | 🎁 Observable Multi-Modal Agentic Systems
    • Day 3 | 🔔 Jingle All the Way to Zero-Config Observability
    • Day 2 | 🎅 He knows if you have been bad or good... But what if he gets it wrong?
    • Collecting user feedback in your app with feature flags
    • Day 1 | 🎄 Observability Under the Tree: What Changed in 2025
    • Build a User Frustration Detection & Response System
    • When to Add Online Evals to Your AgentControl
    • Detecting User Frustration: Understanding Rage Clicks and Session Replay
    • AgentControl config CI/CD Pipeline: Automated Quality Gates and Safe Deployment
    • A Deeper Look at LaunchDarkly Architecture: More than Feature Flags
    • Add Observability to Your React Native App in 5 minutes
    • Smart AI Agent Targeting with MCP Tools
    • Build a LangGraph Multi-Agent System in 20 Minutes with LaunchDarkly AgentControl
    • Snowflake Cortex Completion API + LaunchDarkly SDK Integration
    • Using AgentControl to review database changes
    • How to implement WebSockets and kill switches in a Python application
    • 4 hacks to turbocharge your Cursor productivity
    • Create a feature flag in your IDE in 5 minutes with LaunchDarkly's MCP server
    • Observability for Your Go ORM: OpenTelemetry Integration with GORM
    • The complete guide to OpenTelemetry in Next.js
    • How to instrument your React Native app with OpenTelemetry
    • The complete guide to OpenTelemetry in Python
    • Monitoring Browser Applications with OpenTelemetry
    • How to Use OpenTelemetry to Monitor Next.js Applications
    • What is OpenTelemetry and Why Should I Care?
    • Distributed Tracing in Next.js Apps
    • Tracing Distributed Systems in Next.js
    • Real-time Monitoring in Django: Essential Tools and Techniques
    • DeepSeek vs Qwen: local model showdown featuring LaunchDarkly AgentControl
    • Application Tracing in .NET for Performance Monitoring
    • The Ultimate Guide to Ruby Logging: Best Libraries and Practices
    • Using Materialized Views in ClickHouse (vs. Postgres)
    • Filtering and Sampling LaunchDarkly Ingest
    • How to Set Up Your Production AWS MSK Kafka Cluster
    • Publishing an NPM Package with Private pnpm Monorepo Dependencies
    • How To Use The Chrome Inspector & Debugger
    • 3 Levels of Data Validation in a Full Stack Application With React
    • The power of the monorepo: Keep your fullstack app in sync!
    • Compression: The simple, powerful upgrade for your web stack
    • Video tutorials
Sign inTry it free
LogoLogo
On this page
  • Overview
  • The Foundation: Feature Flag Management
  • The Four Pillars (Or how to sleep through deployments)
  • 1. Release Management (Yellow)
  • 2. Observability & Monitoring (Blue)
  • 3. Analytics & Experimentation (Green)
  • 4. AgentControl (Purple)
  • How the Pillars are Interconnected
  • The Infrastructure: Flag Delivery Network (FDN)
  • What is the FDN?
  • How the FDN Works
  • SDK Modes: Polling vs. Streaming
  • The Six Layers of Resilience
  • Putting It All Together: A Real-World Scenario
  • Why This Architecture Matters
  • Conclusion
Tutorials

A Deeper Look at LaunchDarkly Architecture: More than Feature Flags

Was this page helpful?
Previous

Add observability to your React Native application in 5 minutes

Next
Built with

Published October 08, 2025

portrait of Alexis Roberson.

by Alexis Roberson

Overview

When developers first encounter LaunchDarkly, they often see it as a feature flag management tool. Turns out calling LaunchDarkly a feature flag tool is like calling a Swiss Army knife “a device for opening wine bottles.” Even though that would still be useful. Although technically true, you’re missing about 90% of the picture.

LaunchDarkly has quietly evolved into a full feature delivery platform that happens to use flags as the foundation for four interconnected pillars: Release Management, Observability & Monitoring, and Analytics & Experimentation, and AgentControl. Understanding how these pillars work together, including the backend infrastructure reveals why LaunchDarkly has become mission-critical for modern software delivery.

The Foundation: Feature Flag Management

At the heart of LaunchDarkly lies its feature flag management system. Think of feature flags as the control switches for your application’s behavior. But unlike traditional configuration management, LaunchDarkly’s flags are dynamic, real-time, and incredibly sophisticated.

Feature flag management serves as the foundation layer because it enables everything else. Without the ability to control feature visibility and behavior at runtime, none of the other pillars could function. This foundation includes:

  • Feature Flags: Binary or multi-variant toggles that control feature availability.
  • AgentControl: Dynamic configuration for AI model parameters and behaviors.
  • Targeting Rules: Sophisticated logic for determining who sees what features.
  • Context Management: User, device, and organizational context for personalized experiences.

I spent an embarrassing amount of time in my hammock thinking about why this is the foundation layer. The answer is simple: without runtime control over features, you’re back to deploying code every time you want to change something. And if you’ve ever been on-call during a Friday deployment that went sideways, you know that’s its own level of trauma.

The Four Pillars (Or how to sleep through deployments)

Image of LaunchDarkly Architecture Overview..

LaunchDarkly Architecture Overview.

1. Release Management (Yellow)

The Release Management pillar focuses on safely delivering features to production. This includes:

Releases: Traditional feature rollouts with full control over timing and audience.

Guarded Rollouts: Progressive rollouts combined with real-time monitoring and automatic rollback capabilities. This is the feature that will single-handedly help you get more sleep. When you enable a guarded rollout, LaunchDarkly monitors metrics like error rates, latency, and custom business metrics. If it detects a regression, it can automatically roll back the change before users are impacted.

Progressive Rollouts: Automated gradual rollouts that increase traffic to a new feature over time (e.g., 10% -> 25% -> 50% -> 100%)

The key insight here is Release Management isn’t about deploying code anymore. It’s about deploying business value while your code sits safely in production, waiting for permission to run.

2. Observability & Monitoring (Blue)

This pillar answers life’s most important production question: “Wait, what’s happening right now?” This includes:

Session Replay: Record and replay user sessions to understand exactly what users experienced. For instance, if the user says a button didn’t work, then you can literally watch what they did.

Feature Monitoring: Track feature health, performance, and adoption in real-time.

Alerts: Proactive notifications when metrics breach thresholds.

Errors, Logs, Traces: The ultimate trio of debugging, all in one place, all correlated with which flags were active when things went sideways.

Dashboards: Customizable visualizations of all observability data.

What makes LaunchDarkly’s observability unique is the feature-level granularity. Traditional monitoring says “error rate increased at 2:47pm.” LaunchDarkly says “error rate increased at 2:47pm when you toggled the new-payment-processor flag to 30% rollout.” One of these lets you fix the problem from your hammock. The other leads you down a git rabbit hole.

3. Analytics & Experimentation (Green)

The Analytics & Experimentation pillar helps teams make data-driven decisions:

Experimentation: Full-featured A/B testing and multivariate experiments. Run controlled experiments to measure the impact of features on business metrics.

Metrics: Track both engineering metrics (error rates, latency) and business metrics (conversion, revenue, engagement).

Guarded Rollouts (also appears here): While primarily a release mechanism, Guarded Rollouts use Experimentation methodology to automatically detect regressions during rollouts.

The Experimentation pillar transforms feature flags from simple on/off switches into scientific instruments for measuring impact.

4. AgentControl (Purple)

The unveiling of AgentControl marks a shift in LaunchDarkly’s shift from simply creating and storing feature flag values to storing values related to Large Language Models (LLMs). This gives way to pretty neat opportunities like customizing, testing, and rolling out new LLMs.

How the Pillars are Interconnected

The four pillars aren’t just sitting next to each other making awkward small talk. They’re in a deeply committed relationship with constant communication. Here’s how:

  1. Release Management -> Observability: When you toggle a flag or start a rollout, observability tools immediately begin tracking the impact. Error rates, traces, and logs are automatically correlated with the flag change.
  2. Observability -> Analytics: The data collected through monitoring feeds directly into Experimentation and analytics. You’re not just watching for errors; you’re measuring business impact.
  3. Analytics -> Release Management: Experiment results inform which variations to roll out. Metrics from guarded rollouts trigger automatic decisions (rollback or continue).
  4. AgentControl -> All Pillars: AgentControl configs add a dynamic layer across the ecosystem:
  • To Release Management: Model versions, prompts, and parameters can be toggled like features, enabling safe AI deployments.
  • To Observability: Track model performance, latency, token usage, and output quality in real-time.
  • To Analytics: A/B test different prompts, models, or parameters to optimize AI outcomes and measure business impact.
  1. Feature Flags Enable Everything: Without the foundational flag management system, none of these capabilities would work. Flags are the control point that makes progressive delivery, real-time monitoring, and controlled Experimentation possible.

The Infrastructure: Flag Delivery Network (FDN)

Image of Flag Delivery Network Infrastructure.

Image of Flag Delivery Network Infrastructure.

Understanding the pillars is only half the story. The infrastructure that delivers flags to your applications is equally crucial. LaunchDarkly’s Flag Delivery Network is what makes real-time feature control possible at massive scale.

What is the FDN?

The Flag Delivery Network is LaunchDarkly’s proprietary infrastructure combining:

  • LaunchDarkly’s core infrastructure: Central flag management and rule evaluation engine.
  • Content Delivery Network (CDN): Over 100 points of presence globally.
  • Multi-region streaming service: Real-time flag updates via persistent connections.

Think of it as a specialized CDN, but instead of delivering static assets, it delivers feature flag configurations and streams real-time updates.

How the FDN Works

  1. Flag Creation: A developer, PM, or operator creates or modifies a flag in the LaunchDarkly dashboard.
  2. Global Distribution: The flag configuration is immediately pushed to all CDN edge locations worldwide.
  3. SDK Connection: Your application’s LaunchDarkly SDK connects to the nearest CDN point of presence.
  4. Initial Load: The SDK retrieves all flag configurations and stores them in memory.
  5. Real-time Updates: The SDK maintains a streaming connection; when flags change, updates arrive in milliseconds.
  6. Local Evaluation: Flag rules are evaluated locally in your application, which means no round-trip to LaunchDarkly required for each flag check.

SDK Modes: Polling vs. Streaming

LaunchDarkly SDKs can operate in two modes: streaming mode or polling mode.

Streaming Mode (recommended for server-side SDKs):

  • Maintains a persistent connection to the FDN.
  • Receives flag updates in real-time.
  • Ideal for long-running applications like backend services.

Polling Mode (common for mobile/client-side SDKs):

  • Periodically checks for flag updates.
  • Lower resource usage on mobile devices.
  • Configurable polling interval.

The Six Layers of Resilience

LaunchDarkly’s architecture includes multiple layers of failover to ensure flags are always available:

  1. In-memory cache: SDKs store flags locally; if the network fails, your app continues working.
  2. Fallback values: Every flag evaluation includes a default fallback value.
  3. CDN redundancy: 100+ global Points of Presence (POPs) ensure low latency and high availability.
  4. Multi-region infrastructure: LaunchDarkly’s core systems span multiple cloud regions.
  5. SDK resilience: Automatic retry logic and circuit breakers.
  6. Relay Proxy option: Deploy your own local flag cache for maximum control.

What this means in practice: your app never depends on LaunchDarkly being reachable. Flags work even during a complete LaunchDarkly outage.

Putting It All Together: A Real-World Scenario

Let me walk you through how this actually works in practice. Picture this: your team wants to launch a new checkout flow. In the old days (2023), this would involve:

  • Extensive staging testing.
  • A carefully planned deployment window.
  • Someone’s weekend.
  • Hoping for the best.

Now, it looks more like:

Step 1: Release

  • Create feature flag new-checkout-flow.
  • Configure configs for the personalized product recommendation model (prompt version, temperature, model selection).
  • Configure targeting rules (start with your internal test accounts, because you’re not a monster).
  • Start a guarded rollout to 10% of production traffic.

Step 2: Flag Delivery

  • Flag configuration and config hit the FDN globally (this happens in milliseconds, which is faster than you can say “Jenkins pipeline”).
  • Your mobile and web SDKs receive the update via their streaming connections.
  • Flags are evaluated locally in-memory, adding exactly zero latency to your checkout flow.

Step 3: Observability Does Its Thing

  • Session replay starts capturing user interactions with the new flow.
  • Traces show checkout API performance in real-time.
  • Error monitoring tracks any exceptions (there will be exceptions, there are always exceptions).
  • Dashboards update with adoption metrics and AI performance indicators.
  • Everything comes back as green.

Step 4: Analytics & Decision Making

  • Metrics automatically track conversion rate, cart abandonment, purchase value.
  • AI-specific metrics measure recommendation click-through rates and relevance scores.
  • Guarded rollout monitors for regressions (error rate, latency, AI hallucinations, angry user emails).
  • A/B test different prompt variations or model parameters to optimize recommendations.
  • If metrics look good: automatic progression to 25% -> 50% -> 100%.
  • If metrics look bad: automatic rollback before your on-call engineer finishes their coffee.
  • You receive a Slack notification.

Step 5: The Result

  • Feature safely released with automated safeguards.
  • AI models deployed and optimized without risking production.
  • Full visibility into user experience and system health.
  • Data-driven decision on whether to keep the feature and which config performs best.
  • Zero code deploys after the initial setup.
  • You solved this entire problem without leaving your hammock.

Why This Architecture Matters

LaunchDarkly’s architecture represents a fundamental shift in how we think about software delivery:

Traditional Approach: Deploy -> Hope -> React to incidents -> Debug -> Fix -> Deploy again.

LaunchDarkly Approach: Deploy once -> Control via flags -> Monitor continuously -> Experiment safely -> Optimize based on data.

The key innovation is making the feature flag the control point for delivery, observability, Experimentation and AgentControl. This creates a closed feedback loop:

  • Release Management provides the controls (the steering wheel).
  • Observability provides the visibility (the headlights and dashboard).
  • Analytics provides the insights (the GPS telling you which route is actually faster).
  • AgentControl provide the intelligence (the adaptive cruise control that adjusts based on conditions).
  • Feature flags tie it all together (they’re the guardrails, ensuring the car stays on the road).

Conclusion

LaunchDarkly isn’t just a feature flag tool, but it’s a complete feature delivery platform built on four interconnected pillars. The Flag Delivery Network ensures that control decisions made in the dashboard reach your applications globally in milliseconds, while multiple layers of resilience guarantee availability even during outages. Understanding this architecture helps explain why LaunchDarkly has become essential infrastructure for companies that need to ship software quickly without breaking things.

The combination of real-time control, comprehensive observability, data-driven experimentation, and intelligent AI management, built on a foundation of reliable, fast feature flag evaluation, enables true continuous delivery.

Whether you’re managing a handful of flags, orchestrating complex progressive rollouts across a global user base, or safely deploying and iterating on AI models with the same rigor as your traditional features, LaunchDarkly’s architecture scales to meet your needs while keeping the developer experience simple and the operational risk low.