Site Monitoring and Analytics

Frappe Cloud continuously collects performance and usage data for your site, including request logs, CPU usage, background jobs, and uptime. These insights help you monitor your site’s health, troubleshoot performance issues, and make informed scaling decisions.

Site Analytics

The Analytics tab on your site’s dashboard provides detailed charts to help you monitor resource usage and performance.

• Requests – Number of incoming requests per minute.
• CPU Usage – CPU consumed while processing web requests.
• Background Jobs – Number of background jobs being processed.
• Background Jobs CPU Usage – CPU consumed by background workers.
• Usage Counter – Cumulative CPU usage compared against your daily CPU limit.
• Uptime – Availability of your site’s web workers and scheduler.

Investigate High Resource Usage

If your site is consuming more CPU than expected, review the following analytics:

• Requests Duration by Path – Shows which API endpoints or pages consume the most request time.
• Background Job Duration by Path – Identifies long-running background jobs.

These reports are sorted by execution time, making it easy to identify the slowest endpoints or jobs that may require optimization.

Database Storage Usage

Automatic Synchronization

Database usage is automatically synchronized with the Frappe Cloud dashboard approximately every 6 hours.

Refresh Database Usage

If you’ve recently deleted data or want the latest storage information, you can manually refresh database usage.

1. Open your Site Overview page or the DB Analyzer.
2. Click the option to Refresh Database Usage.

Why Storage Reports May Differ

You may notice differences between the storage reported by Frappe Cloud and the Framework’s Database Storage Report.

This happens because:

• Frappe Cloud calculates storage using its own parser without relying on cached metadata.
• The Framework’s DB Storage Report and DB Analyzer rely on MariaDB’s Information Schema, which may contain cached values.

If you notice a discrepancy, simply refresh the database usage to synchronize the reported values.

Site Monitoring

Frappe Cloud periodically checks whether your site is online by sending a request to your site’s health endpoint:

https://your-site-domain/api/method/ping

Your site should return the following response with an HTTP 200 OK status:

{
  "message": "pong"
}

Why Monitoring May Be Disabled

Monitoring may be disabled automatically if Frappe Cloud cannot verify your site’s availability. Common reasons include:

• An expired primary domain.
• Incorrect DNS configuration.
• Cloudflare or another CDN blocking health check requests.
• Custom application changes affecting the ping endpoint.

If monitoring is disabled, Frappe Cloud sends a notification email explaining the reason.

Re-enable Monitoring

1. Open your Site Overview page.
2. Click Enable Monitoring.
3. Review the reason monitoring was disabled.
4. Click Check & Enable Monitoring.

If the verification succeeds, monitoring is enabled again. If it fails, Frappe Cloud displays the issue so you can correct your configuration before trying again.