Monitoring

Frappe Cloud logs a lot of data while your site is running like Request Logs, Site Logs, CPU Time, etc.

Site Analytics

The Analytics tabs shows a lot of charts:

1. Requests - Number of Requests (per minute)
2. CPU Usage - CPU Usage of Requests
3. Background Jobs - Number of Background Jobs
4. Background Jobs CPU Usage - CPU Usage of Background Jobs
5. Usage Counter - Cumulative CPU Usage of Requests. You can also see the Daily CPU Time Limit line, you can monitor this chart to know when you need to upgrade your Plan.
6. Uptime - Uptime of the web worker and scheduler. Collected every 3 minutes.

Analytics are only available after Setup Wizard is completed. Uptime status is collected every minute.

Investigating high usage

Primarily for investigating high usage, you should look at the Requests Duration By Path and Background Job Duration By Path graphs. This will give you an idea of which endpoints in your site take most time/requests.

Here, the red bars are seem to take relatively long and should be looked into.

It is sorted in descending order, so the first endpoints in the list are usually slowest.

Monitoring Disabled

Frappe Cloud uses a monitoring server to check if your site is online and healthy.

For example, if your site domain is example.com, our monitoring server will send a request to:

https://example.com/api/method/ping

Your site should reply with:

{"message": "pong"}

and return an HTTP 200 status code.

Why Monitoring May Be Disabled

Monitoring can be turned off automatically if your site can’t be reached. Common reasons include:

• The primary domain has expired
• DNS records are incorrect
• The domain is behind Cloudflare or another CDN that blocks the ping request
• Custom app changes cause the ping endpoint to fail

If our system detects that your site is active but can’t verify uptime through your domain, monitoring will be disabled and you’ll get an mail for the same.

How to Re-Enable Monitoring

1. Go to your Frappe Cloud Dashboard and open your Site Overview page.

2. At the top, you’ll see an option to Enable Monitoring.

   

3. Click the button — you’ll see the reason why monitoring was disabled.

   

4. Click Check & Enable Monitoring to verify your setup and turn monitoring back on.

   

   If the check fails, you’ll see details about what went wrong and how to fix it.