Environment Performance Monitoring

In this guide, you'll learn how to monitor your environment's performance in Cloud.

Monitoring Overview#

Medusa allows you to monitor the performance of your deployed environment's backend in Cloud.

By monitoring key metrics, you can ensure that your environment is running smoothly, identify potential performance bottlenecks, and troubleshoot issues effectively.

You can monitor metrics like:

  • Servers: Monitor CPU usage, memory consumption, and restarts of your environment's server instances.
  • Workers: Monitor CPU usage, memory consumption, and restarts of your environment's worker instances, which handle background jobs.
  • HTTP: Monitor HTTP request patterns, response times, and HTTP-related performance data.

Access Environment Monitoring#

To view your project environment's server performance:

  1. Go to your environment's dashboard
  2. Click Monitoring in the sidebar. This will expand a submenu where you can choose either Servers, Workers, or HTTP to view the corresponding monitoring dashboard.

Troubleshooting Performance Issues#

If you notice performance issues in your environment, such as slow response times or increased error rates, use the monitoring dashboards to identify potential causes.

Issue

Potential Cause

Monitoring Dashboard

Slow response times

High CPU or memory usage in server instances due to inefficient code.

Servers

Increased error rates

Endpoints with crashes or timeouts due to inefficient code.

HTTP

High latency in HTTP requests

Inefficient database queries or external API calls in specific endpoints.

HTTP

Background jobs not executing or slow execution

High CPU or memory usage in worker instances due to inefficient background job implementation.

Workers

Frequent worker or server restarts

Crashes due to memory leaks or unhandled exceptions in your application code.

Workers and Servers

High Flex Usage

High resource consumption in servers or workers due to inefficient code.

Workers and Servers

Note: If the monitoring dashboards don't show a cause related to your application, check the Cloud status page for ongoing Cloud incidents that may be affecting your environment.
Was this guide helpful?
Ask Bloom
For assistance in your development, use Claude Code Plugins or Medusa MCP server in Cursor, VSCode, etc...FAQ
What is Medusa?
How can I create a module?
How can I create a data model?
How do I create a workflow?
How can I extend a data model in the Product Module?
Recipes
How do I build a marketplace with Medusa?
How do I build digital products with Medusa?
How do I build subscription-based purchases with Medusa?
What other recipes are available in the Medusa documentation?
Chat is cleared on refresh
Line break