Aug 11, 2025

MyDecisive - Designing Simplicity from Complexity

Alan Florsheim

MyDecisive - Designing Simplicity from Complexity

"Can you make OpenTelemetry feel like an easy button?"

That question, posed by one of our design partners during an early user research session, seemed almost impossible. OpenTelemetry is inherently complex—a powerful, distributed tracing and observability framework that requires deep technical knowledge to configure and manage effectively. How do you make something complex feel simple without sacrificing its power?

The answer wasn't in hiding the complexity. It was in designing with the complexity, creating an experience that feels intuitive even when dealing with sophisticated telemetry pipelines.

The Complexity Challenge

OpenTelemetry's power comes from its flexibility. It can instrument virtually any application, work with any observability backend, and handle massive scale. But that flexibility comes at a cost: configuration complexity that can overwhelm even experienced engineers.

Our initial user research painted a clear picture. Teams loved OpenTelemetry's capabilities but struggled with:

  • Configuration sprawl: Settings scattered across multiple files, services, and environments
  • Pipeline management: Manually coordinating data flow between collectors, processors, and exporters
  • Change management: Updates requiring restarts, redeployments, and careful coordination
  • Debugging: When something breaks in the pipeline, troubleshooting becomes archaeological work

The traditional approach might have been to build abstractions that hide this complexity. But our design philosophy was different: instead of hiding complexity, we wanted to organize it in a way that felt natural and approachable.

Information Architecture as the Foundation

Our breakthrough came from treating OpenTelemetry configuration not as a technical problem, but as an information architecture challenge. We spent months mapping how engineers actually think about telemetry:

Mental Model Discovery: Through card sorting exercises and concept mapping sessions, we discovered that engineers think about telemetry in layers:

  1. What data they want to collect (metrics, traces, logs)
  2. How they want to process it (filtering, sampling, enrichment)
  3. Where they want to send it (different backends for different purposes)
  4. When they want changes to take effect (immediately, gradually, scheduled)

Workflow Mapping: We shadowed teams through actual configuration changes, documenting every step, decision point, and potential failure mode. This revealed that complexity wasn't random—it followed predictable patterns that could be systematized.

Language Alignment: We discovered that different team members used different vocabularies for the same concepts. Operators talked about "pipelines," developers mentioned "instrumentation," and SREs focused on "collectors." Our design needed to speak everyone's language while maintaining conceptual consistency.

Design Principles for Taming Complexity

Based on these insights, we developed core design principles that guided every interface decision:

Progressive Disclosure: Start simple, reveal complexity on demand. New users see a streamlined interface for common tasks, while power users can access advanced configuration without switching tools.

Contextual Guidance: Instead of generic documentation, provide specific guidance based on what the user is trying to accomplish right now. If they're configuring a trace processor, show relevant examples and common patterns.

Immediate Feedback: Make the impact of configuration changes visible in real-time. Users shouldn't have to deploy and wait to understand if their changes work.

Graceful Degradation: When things go wrong, the system should fail informatively. Error messages should point toward solutions, not just problems.

The "Easy Button" Extrapolated

An "Easy Button" is more than a slick graphical user interface. These principles will lead to design decisions that could transform the OpenTelemetry experience (i.e. we're investigating some cool ideas). In the near future we may experience:

Configuration as Conversation: Instead of editing YAML files, users interact with a guided interface that asks questions like "What type of data do you want to collect?" and "How do you want to process it?" The system generates optimized configuration based on responses.

Visual Pipeline Builder: Complex telemetry pipelines are represented visually, with drag-and-drop components that show data flow in real-time. Users can see exactly how data moves through their system and spot bottlenecks instantly.

Smart Defaults with Easy Overrides: Every configuration starts with battle-tested defaults that work for 80% of use cases. The remaining 20% of customization is available but clearly separated from the core workflow.

Live Configuration Testing: Before deploying changes, users can test configurations against real data streams. This eliminates the deploy-and-pray cycle that made OpenTelemetry changes so stressful.

And more...

Beyond the Interface: Systemic Design Thinking

Making OpenTelemetry feel like an "easy button" required more than interface design—it demanded systemic thinking about the entire configuration lifecycle:

Version Control Integration: Configuration changes are automatically versioned and can be rolled back with a single click. This removes the fear that keeps teams from experimenting with improvements.

Collaborative Configuration: Multiple team members can work on the same telemetry pipeline without conflicts. Changes are merged intelligently, and conflicts are highlighted clearly.

Environment Parity: Configuration tested in development automatically works in production. No more "it worked on my machine" surprises.

Self-Healing Systems: When components fail or become unavailable, the system automatically routes around problems while alerting operators to underlying issues.

Measuring Success: From Hours to Minutes

The design transformation has measurable impact. Configuration tasks that previously took hours now complete in minutes:

  • Initial setup: From days to 30 minutes for basic instrumentation
  • Pipeline changes: From planned maintenance windows to live updates
  • Troubleshooting: From detective work to guided problem-solving
  • Onboarding: New team members become productive in hours, not weeks

But the real success metric is qualitative: teams that previously avoided OpenTelemetry because of complexity now choose it specifically because our Smart Telemetry Hub makes it approachable.

The Paradox of Simplified Complexity

The most surprising discovery in our design process was that making something feel simple often requires making it more sophisticated, not less. Our "easy button" for OpenTelemetry actually involves more underlying intelligence than traditional approaches:

  • Smart configuration validation prevents common mistakes before they happen
  • Automated optimization suggestions improve performance without manual tuning
  • Contextual help adapts to the user's experience level and current task
  • Predictive analytics identify potential issues before they impact operations

Lessons for Design Leaders

Creating simplicity from complexity requires a fundamental shift in design thinking:

Don't hide complexity—organize it: Users need access to sophisticated capabilities, but they shouldn't have to navigate through them for simple tasks.

Design for the journey, not just the destination: The configuration process itself should feel guided and natural, not just the final result.

Make expertise scalable: Design systems that help novices learn while empowering experts to work faster.

Embrace intelligent defaults: Well-chosen defaults eliminate 80% of configuration decisions while remaining easily customizable for edge cases.

The "easy button" isn't about making things simple—it's about making complex things feel manageable, approachable, and ultimately empowering. In the case of OpenTelemetry, that transformation opens up powerful observability capabilities to teams that previously couldn't access them.

Sometimes the best design work is invisible: when complex technology feels intuitive, users focus on their goals instead of the tools. That's when you know you've truly designed simplicity from complexity.

Is an easy button possible? How are you making OTel easy for your customers Join us on slack: MyDecisive community slack

Alan

For Media Inquiriespr@mydecisive.ai
Support via Slack

We will respond within 48 business hours

Core Business Hours

Monday - Friday

9am - 5pm PDT

LinkedIn logoGithub logoYouTube logoSlack logo