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 on the "Monitoring" tab.

This opens the monitoring dashboard, where you can select the specific metrics you want to view from the sidebar.


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

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