getCpuLoadStats()

getCpuLoadStats() Returns a snapshot of the current CPU load state and video encode/decode statistics. Stats in the latest field are updated approximately every two seconds — poll this method to monitor CPU performance over time.

Applies to video calls only.

Return value

Returns a Promise<DailyCpuLoadStats>:

string

Current CPU load assessment: 'low' or 'high'.

string

Reason for the current state:

'none' — load is low
'encode' — video encoding is the primary cause of high load
'decode' — video decoding is the primary cause of high load
'scheduleDuration' — Daily code is not completing within its scheduled interval

object

Statistics from the most recent measurement period.

Show stats.latest fields

number

Unix timestamp (ms) of when the stats were recorded.

number

Target encode frame rate.

number

Target decode frame rate.

number

Average time in seconds to encode a frame.

number

Average time in seconds to decode a frame.

number

CPU usage estimate based on encode frame rate (0–1).

number

CPU usage estimate based on decode frame rate (0–1).

string

Browser-reported CPU pressure: 'nominal', 'fair', 'serious', 'critical', or null if not supported.

number

Actual schedule interval duration in ms.

number

Expected schedule interval duration in ms.

number

Number of incoming video tracks currently being decoded.

object[]

Per-track decode stats. Each entry includes trackId, ssrc, frameWidth, frameHeight, fps, frameDecodeTimeSec, interFrameDelayStandardDeviation, and cpuUsageBasedOnTargetDecode.

Example

const { cpuLoadState, cpuLoadStateReason, stats } = await call.getCpuLoadStats();

if (cpuLoadState === 'high') {
  console.log('High CPU load — reason:', cpuLoadStateReason);
  // Consider reducing video quality
  call.updateSendSettings({ video: { maxQuality: 'low' } });
}

Methods

Events

cpu-load-change

Guides

Call quality

getCameraFacingMode()getInputDevices()

Daily Call Client

Types

Static Methods

Instance Methods

Events

getCpuLoadStats()

Return value

Example

See also

Methods

Events

Guides

​Return value

​Example

​See also

Methods

Events

Guides

Return value

Example

See also