How to View Insights in App Platform

DigitalOcean App Platform includes metrics visualizations so you can monitor your app’s performance and health.

View Insights Using the Control Panel

Your app’s Insights tab displays metrics about your app’s resource usage, including the following:

• CPU usage. This tracks the percentage of CPU power your app is using.
• Memory usage. This tracks the percentage of memory your app is using in the container. This metrics may differ slightly from the memory usage reported by the operating system as App Platform always allots slightly more memory to your app. App redeployments and DigitalOcean maintenance operations do not contribute to this metric.
• Restart count. This tracks the number of times your app has been restarted. Restarts often indicate that your application has crashed or exited.
• CDN ingress bandwidth. This tracks the bandwidth transmitted by our edge CDN network on behalf of your app. This includes both cache requests served by the CDN and non-cached requests forwarded to your application instance.
• CDN ingress average latency by status code. This tracks the average latency of requests to your app from the CDN, by status code.
• CDN ingress throughput (requests) by status code. This tracks the number of requests to your app from the CDN, by status code.

To view your app’s insights from the control panel, click your app and then click the Insights tab. From here, you can click a resource to filter insights by resource.

Use the Select Object drop-down to select insights for specific components in your app. Use the Select Period drop-down to select the time interval for which insights are being displayed.

Additionally, you can create alerts for your app and its resources.

View Insights Using the API

You can view the following metrics using the DigitalOcean API:

curl -X GET \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DIGITALOCEAN_TOKEN" \
  "https://api.digitalocean.com/v2/monitoring/metrics/apps/cpu_percentage?app_id=2db3c021-15ad-4088-bfe8-99dc972b9cf6&app_component=sample-application&start=1636051668&end=1636051668"

curl -X GET \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DIGITALOCEAN_TOKEN" \
  "https://api.digitalocean.com/v2/monitoring/metrics/apps/memory_percentage?app_id=2db3c021-15ad-4088-bfe8-99dc972b9cf6&app_component=sample-application&start=1636051668&end=1636051668"

curl -X GET \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DIGITALOCEAN_TOKEN" \
  "https://api.digitalocean.com/v2/monitoring/metrics/apps/restart_count?app_id=2db3c021-15ad-4088-bfe8-99dc972b9cf6&app_component=sample-application&start=1636051668&end=1636051668"

curl -X GET \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DIGITALOCEAN_TOKEN" \
  "https://api.digitalocean.com/v2/apps/{id}/metrics/bandwidth_daily"

import os
from pydo import Client

client = Client(token=os.environ.get("DIGITALOCEAN_TOKEN"))

get_resp = client.apps.get_metrics_bandwidth_daily(app_id="4f6c71e2")