Skip to main content
This guide shows how to add Muxx to an existing application with minimal changes.

Before You Start

You’ll need:
  • A Muxx account
  • Your Muxx API key
  • 5 minutes

Gateway Migration (Fastest)

The gateway approach requires just a base URL change.

Before

After

Changes required: 2 lines

SDK Migration

For deeper tracing, use the SDK wrapper.

Before

After

Changes required: 3 lines (import, init, wrap)

Adding Traces

Once migrated, optionally add traces for better organization:

Environment Variables

Store keys in environment variables:

Rollback Plan

If you need to rollback:
  1. Gateway: Remove base_url and headers
  2. SDK: Remove muxx.wrap() call
Your application will work as before, just without Muxx logging.

Gradual Migration

Migrate gradually by project or feature:
  1. Start with non-critical features
  2. Verify logs appear in dashboard
  3. Expand to more features
  4. Enable for production

Troubleshooting

Logs not appearing

  1. Check API key is correct
  2. Verify project has provider keys configured
  3. Check network allows gateway.muxx.dev

Increased latency

  1. Gateway adds minimal overhead
  2. Enable caching for repeated queries
  3. Check if rate limited