Introducing Redwood Studio

Introducing Redwood Studio

A Welcome Note from DT

Many years ago, I visited friends in Portland and when I arrived was told that I’d be staying in their “boffudio” — their “bedroom, office, studio”. They explained that this was a place they could rest, work, and be creative.

And - that’s what Redwood Studio is: a place to enjoy where you can be productive, and build.

I want Studio to be an essential tool for every RedwoodJS developer.

  • It aids in collaboration, visualization, and measurement of your application.

  • It provides a seamless experience, enhancing the enjoyment and insightfulness of developing with RedwoodJS.

  • It can serve as a hub for your team, facilitating calls and meetings to demonstrate and discuss new features as they are built, used, and improved.

  • It also acts as a gateway to the community and documentation, enabling quick assistance without significant context shifting.

Features

Here are the features that make Studio a productive and enjoyable tool for creating with RedwoodJS.

Dashboard

A quick overview of your app.

  • Monitor Database, GraphQL, API, and Network performance in real-time.
  • Instantly view the most executed SQL and GraphQL Operations.

Monitoring

Studio leverages OpenTelemetry data sent from your Redwood app.

  • Observe what traces and spans indicate about your app’s health.
  • Found a problem? Make adjustments and then compare the difference to assess the improvement.

GraphQL

Explore your GraphQL API with ease.

  • Visualize your GraphQL Schema.
  • Evaluate GraphQL Operations and performance.
  • Test your GraphQL API effortlessly in a fully-integrated GraphiQL Playground.
  • Supports authenticated User Impersonation.

Database

Enhance your understanding and usage of your Database and SQL.

  • Visualize your Prisma database diagram.
  • Explore your data model and its relations.
  • Evaluate the performance of SQL statements in detail.

Mailer

Redwood Studio is closely integrated with Redwood Mailer.

  • Intercept emails during development.
  • Monitor the emails being sent and received.
  • Test and preview your email templates.

Community Search

We’re always here to help.

  • Quickly search the RedwoodJS Community, Documentation, and more.
  • Get help to build your app faster.
  • Just Command-K and go!

Built with RedwoodJS

Did you know that Studio is built with RedwoodJS?

It showcases:

  • Realtime GraphQL to update data

  • Cells for data fetching

  • Routing for navigation

  • Authentication

  • … and more.

Get Started

To begin using Redwood Studio simply execute the following command from your applixcation’s root directory:


yarn rw studio

The first time you run this command, it will install the Studio package, which may take a bit of time. Future launches won’t require additional installations.

To start using, visit: [http://localhost:4318](http://localhost:4318)

What’s Next

We’re super excited about the future versions of Studio. Based on your valuable feedback and needs, we’re planning to refine and expand Studio’s features even further.

Keep an eye out for enhanced monitoring capabilities and even more integrations with your favorite tools and platforms.

Stay tuned, we’ve got some cool updates and features in the pipeline.

Troubleshooting

We hope you don’t encounter any issues, but here are some ways to troubleshoot Studio. As always, you can find us on Discourse Forums or GitHub issues to report problems.

Concurrency Limit Reached

If you see an ‘OpenTelemetry concurrency limit reached’ error in your logs, consider increasing the concurrencyLimit value in your OpenTelemetry configuration.


// api/src/opentelemetry.ts

// ...

const studioPort = getConfig().studio.basePort

const exporter = new OTLPTraceExporter({
  // Update this URL to point to where your OTLP compatible collector is listening
  // The redwood development studio (`yarn rw studio`) can collect your
  // telemetry at `http://127.0.0.1:<PORT>/.redwood/functions/otel-trace`
  // (default PORT is 4318)
  url: `http://127.0.0.1:${studioPort}/.redwood/functions/otel-trace`,
  concurrencyLimit: 64, // <- increase 
})

// ...

Timeouts

If your application experiences any timeouts while sending telemetry data to Studio, you can increase the timeout by adding a timeoutMillis value (the default is 10 seconds).


// api/src/opentelemetry.ts

// ...

const studioPort = getConfig().studio.basePort

const exporter = new OTLPTraceExporter({
  // Update this URL to point to where your OTLP compatible collector is listening
  // The redwood development studio (`yarn rw studio`) can collect your
  // telemetry at `http://127.0.0.1:<PORT>/.redwood/functions/otel-trace`
  // (default PORT is 4318)
  url: `http://127.0.0.1:${studioPort}/.redwood/functions/otel-trace`,
  concurrencyLimit: 64,
  timeoutMillis: 30000, // <-- set a timout greater than 10 seconds
})

// ...

Connection Refused

If your application cannot connect to Studio, please ensure the following:

  • Studio should be running before you launch your app’s development server.

  • If you stop Studio while your app is running in development mode, remember to restart your app after restarting Studio.

Thank You’s

Many thanks to

8 Likes