Calculating CPU usage from the monitoring API

Question

I want to get CPU metrics of a droplet, I used the monitoring API also I used godo golang library I got the metrics for user, system… etc and I did this formula

totalCpu := (userCpu + systemCpu + stealCpu + softirqCpu + irqCpu + niceCpu + iowaitCpu + idleCpu)
idle := (idleCpu * 100) / totalCpu
 cpuUsage := 100 - idleCpu

but the value is not like the one on the CPU graph on the website

thanks in advance

Bobby · Accepted Answer

Hi there, Your formula looks correct. I believe that the crucial part here is to pass the time frame that you want to get the CPU usage for by defining the start and end parameters. start: Timestamp to start metric window. Example: start=1620683817 end: Timestamp to end metric window. Example: end=162070541 That way you can define which time period you want the CPU usage for, as if you don’t pass this you will get an average for the complete CPU usage. Here is a simple bash script as an example: #!/bin/bash TOKEN="your_digitalocean_token" HOST_ID="your_host_id" API_ENDPOINT="https://api.digitalocean.com/v2/monitoring/metrics/droplet/cpu?host_id=$HOST_ID&start=$(date +%s)&end=$(date +%s)" # Get the metrics RESPONSE=$(curl -X GET -H "Content-Type: application/json" -H "Authorization: Bearer $TOKEN" $API_ENDPOINT) # Parse the metrics IDLE=$(echo $RESPONSE | jq -r '[.data.result[] | select(.metric.mode == "idle") | .values[0][1]] | add') TOTAL=$(echo $RESPONSE | jq -r '[.data.result[] | .values[0][1] | tonumber] | add') echo "IDLE: $IDLE" echo "TOTAL: $TOTAL" USED=$(echo "$TOTAL - $IDLE" | bc) echo "USED: $USED" ZERO_CHECK=$(echo "$TOTAL == 0" | bc) if [ $ZERO_CHECK -eq 1 ] then echo "No change in TOTAL, can't calculate CPU Usage" else CPU_USAGE=$(echo "scale=2; ($USED / $TOTAL) * 100" | bc) echo "CPU Usage: $CPU_USAGE%" fi This uses the same formula but gives you the CPU usage for the current time being. I just tested this and it seems to be reporting the same information as in the DigitalOcean Control panel. Hope that this helps! Best, Bobby

Kent Muller · Answer

For anyone else coming across this question and also coming in with, like me, very little knowledge of what the stats returned by the OS mean, this might help. In order to determine CPU % from the data returned from the CPU Monitoring API it is required to calculate it based on the difference between 2 data points divided by the time between the 2 data points, then convert to a percentage. You can calculate the total as per the OP’s calculation for a given data point, and also obtain the idle value for that data point. Then you can do something like this, which I’m providing as an example of what I needed to do: const totalCpuDiff = dataPoint.totalCpu - previousDataPoint.totalCpu; const idleCpuDiff = dataPoint.idleCpu - previousDataPoint.idleCpu; const timeDiff = dataPoint.timeStamp - previousDataPoint.timeStamp; const cpuUsagePercent = ((totalCpuDiff-idleCpuDiff)/timeDiff)*100; Something like this will give you the CPU percentage for that one data point. If your request returns many data points you can iterate through the API response to obtain CPU usage over time.

Become a contributor for community

DigitalOcean Documentation

Resources for startups and AI-native businesses

The developer cloud

Start building today

Report this

Calculating CPU usage from the monitoring API

Related questions

Is Apidog CLI a Good Choice for API Testing in CI/CD?

OAuth refresh token lifetime?

How to create Gradient KB via API?

Does DigitalOcean OAuth Authorization Code Flow Support Public Desktop Clients Using PKCE (Without client_secret)?

Why is my requirements.txt not being used?

How do I add requirements.txt to Digital Ocean's Serverless Functions? Runtime Python:3.11 does not have all the libraries I need Installed

SSH Connection Timed Out after Droplet Rebuild

Modifier Cannot Access Namespace Function Using doctl CLI with Full Access Token

Activation records and log messages not appearing for my Serverless Function

Apply weekly backup plan to the servlet using API

How to copy files from app platform to local machine

Monitoring API Empty Response - Used PAT token

Report this

Calculating CPU usage from the monitoring API

Related questions

Is Apidog CLI a Good Choice for API Testing in CI/CD?

OAuth refresh token lifetime?

How to create Gradient KB via API?

Does DigitalOcean OAuth Authorization Code Flow Support Public Desktop Clients Using PKCE (Without client_secret)?

Why is my requirements.txt not being used?

How do I add requirements.txt to Digital Ocean's Serverless Functions? Runtime Python:3.11 does not have all the libraries I need Installed

SSH Connection Timed Out after Droplet Rebuild

Modifier Cannot Access Namespace Function Using doctl CLI with Full Access Token

Activation records and log messages not appearing for my Serverless Function

Apply weekly backup plan to the servlet using API

How to copy files from app platform to local machine

Monitoring API Empty Response - Used PAT token