Skip to content
Cloudflare Docs

Querying Container Metrics with GraphQL

In this example, we are going to use the GraphQL Analytics API to query for Container Metrics over a specified time period. We can query up to one month of data for dates up to three months ago.

In the following examples, be sure to replace <CLOUDFLARE_ACCOUNT_TAG> and <API_TOKEN>1 with your API credentials, and adjust the datetimeStart, and datetimeEnd variables as needed. The results returned will be in JSON (as requested), so piping the output to jq ↗ will make them easier to read.

Container Application Level Metrics

This API call will request aggregate memory, CPU load, disk usage, and network bandwidth (egress and ingress) over a one hour period for all of the instances of a Container application.

Set applicationId to the ID of the Container application you want to query by replacing <CONTAINER_APPLICATION_ID>. This can be copied from the top of the Container application page in your dashboard.

Terminal window
echo '{
  "query": "query GetContainersMetrics($accountTag: string!, $datetimeStart: Time, $datetimeEnd: Time, $applicationId: string) {
    viewer {
      accounts(filter: { accountTag: $accountTag }) {
        containersMetricsAdaptiveGroups(
          limit: 100
          filter: {
            applicationId: $applicationId
            datetimeMinute_geq: $datetimeStart
            datetimeMinute_leq: $datetimeEnd
            procType: \"user\"
          }
        ) {
          avg {
            memory
            cpuLoad
            rxBandwidth
            txBandwidth
          }
          max {
            diskUsage
          }
          quantiles {
            memoryP50
            memoryP90
            memoryP99
            cpuLoadP50
            cpuLoadP90
            cpuLoadP99
            diskUsageP50
            diskUsageP90
            diskUsageP99
            rxBandwidthBpsP50
            rxBandwidthBpsP90
            rxBandwidthBpsP99
            txBandwidthBpsP50
            txBandwidthBpsP90
            txBandwidthBpsP99
          }
          dimensions {
            datetimeFiveMinutes
            durableObjectId
          }
        }
      }
    }
  }",
  "variables": {
    "accountTag": "<CLOUDFLARE_ACCOUNT_TAG>",
    "datetimeStart": "2025-07-23T00:00:00.000Z",
    "datetimeEnd": "2025-07-23T01:00:00.000Z",
    "applicationId": "<CONTAINER_APPLICATION_ID>"
  }
}' | curl --silent \
  https://api.cloudflare.com/client/v4/graphql \
  --header "Authorization: Bearer <API_TOKEN>" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --data @-

To get metrics for each specific instance of the Container application, you can add 'deploymentId' to the dimensions field in the query:

Terminal window
dimensions {
  datetimeFiveMinutes
  deploymentId
  durableObjectId
}

Footnotes

  1. Refer to Configure an Analytics API token for more information on configuration and permissions. ↩