Skip to contentSkip to navigationSkip to topbar
Rate this page:
On this page

Call Metric Resource


A Call Metric is an object representing

  • a set of quantitive measurements and
  • meta data

related to the quality of a voice call.

Using the Call Metrics Resource, you can read a list of Call Metrics for a specified voice call.

(warning)

Warning

Voice Insights Advanced Features must be active to use this API Resource.

(information)

Info

Metrics are typically available via the API within 90 seconds of call completion.


Call Metric properties

call-metric-properties page anchor

The following table details the properties of a single Call Metric sample instance.

Resource properties
timestamptype: stringNot PII

Timestamp of metric sample. Samples are taken every 10 seconds and contain the metrics for the previous 10 seconds.


call_sidtype: SID<CA>Not PII

The unique SID identifier of the Call.


account_sidtype: SID<AC>Not PII

The unique SID identifier of the Account.


edgetype: enum<STRING>Not PII

The Twilio media edge this Metric was captured on. One of unknown_edge, carrier_edge, sip_edge, sdk_edge or client_edge.

Possible values:
unknown_edgecarrier_edgesip_edgesdk_edgeclient_edge

directiontype: enum<STRING>Not PII

The Direction of the media stream from the perspective of the Twilio media edge. One of unknown, inbound, outbound or both.

Possible values:
unknowninboundoutboundboth

carrier_edgetype: objectNot PII

Contains metrics and properties for the Twilio media gateway of a PSTN call.


sip_edgetype: objectNot PII

Contains metrics and properties for the Twilio media gateway of a SIP Interface or Trunking call.


sdk_edgetype: objectNot PII

Contains metrics and properties for the SDK sensor library for Client calls.


client_edgetype: objectNot PII

Contains metrics and properties for the Twilio media gateway of a Client call.

Edge Metrics and properties

edge-metrics-and-properties page anchor

Metric samples from these edges contain the following properties:

PropertyDescription
codecRTP profile number of the detected codec
codec_nameName of the detected codec
cumulativeCumulative jitter (max/avg), packets lost, and packet count for the stream received at this edge
intervalsdk_edge: audio in/out, jitter, packet loss, rtt, and packet loss percentage for the sampling interval. _All other edge_s: packets received, packets lost, and packet loss percentage.
metadataTwilio media region of the selected edge, Twilio and endpoint IP media IP addresses

Read multiple Call Metric resources

read-multiple-call-metric-resources page anchor
GET https://insights.twilio.com/v1/Voice/{CallSid}/Metrics

Use this action to retrieve a list of Call Metrics for the specified voice call.

You can use the optional edge parameter to filter the list by media edge. See Understanding Twilio Media Edges for more information.

If no edge parameter is provided, the resulting list will depend on the call type:

Call TypeDefault EdgeAdditional Edge
Carriercarrier_edgeN/A
SIPsip_edgeN/A
Clientsdk_edgeclient_edge
Trunking Originatingcarrier_edgesip_edge
Trunking Terminatingsip_edgecarrier_edge

Parameters

list-parameters page anchor
URI parameters
CallSidtype: SID<CA>Not PII
Path Parameter

The unique SID identifier of the Call.


Edgetype: enum<STRING>Not PII
Query Parameter

The Edge of this Metric. One of unknown_edge, carrier_edge, sip_edge, sdk_edge or client_edge.

Possible values:
unknown_edgecarrier_edgesip_edgesdk_edgeclient_edge

Directiontype: enum<STRING>Not PII
Query Parameter

The Direction of this Metric. One of unknown, inbound, outbound or both.

Possible values:
unknowninboundoutboundboth

PageSizetype: integerNot PII
Query Parameter

How many resources to return in each list page. The default is 50, and the maximum is 1000.


Pagetype: integerNot PII
Query Parameter

The page index. This value is simply for client state.


PageTokentype: stringNot PII
Query Parameter

The page token. This is provided by the API.

Read multiple Call Metrics for a Call

read-multiple-call-metrics-for-a-call page anchor
Node.js
Python
C#
Java
Go
PHP
Ruby
twilio-cli
curl

_11
// Download the helper library from https://www.twilio.com/docs/node/install
_11
// Find your Account SID and Auth Token at twilio.com/console
_11
// and set the environment variables. See http://twil.io/secure
_11
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_11
const authToken = process.env.TWILIO_AUTH_TOKEN;
_11
const client = require('twilio')(accountSid, authToken);
_11
_11
client.insights.v1.calls('CAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX')
_11
.metrics
_11
.list({limit: 20})
_11
.then(metrics => metrics.forEach(m => console.log(m.timestamp)));

Output

_51
{
_51
"meta": {
_51
"page": 10,
_51
"page_size": 5,
_51
"first_page_url": "https://insights.twilio.com/v1/Voice/CAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Metrics?Direction=both&Edge=sdk_edge&PageSize=5&Page=0",
_51
"previous_page_url": "https://insights.twilio.com/v1/Voice/CAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Metrics?Direction=both&Edge=sdk_edge&PageSize=5&Page=9&PageToken=DP10",
_51
"next_page_url": "https://insights.twilio.com/v1/Voice/CAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Metrics?Direction=both&Edge=sdk_edge&PageSize=5&Page=1",
_51
"key": "metrics",
_51
"url": "https://insights.twilio.com/v1/Voice/CAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Metrics?Direction=both&Edge=sdk_edge&PageSize=5&Page=10"
_51
},
_51
"metrics": [
_51
{
_51
"timestamp": "2019-10-07T22:32:06Z",
_51
"call_sid": "CA7569efe0253644fa4a88aa97beca3310",
_51
"account_sid": "AC998c10b68cbfda9f67277f7d8f4439c9",
_51
"edge": "sdk_edge",
_51
"direction": "both",
_51
"sdk_edge": {
_51
"interval": {
_51
"packets_received": 50,
_51
"packets_lost": 0,
_51
"audio_in": {
_51
"value": 81.0
_51
},
_51
"audio_out": {
_51
"value": 5237.0
_51
},
_51
"jitter": {
_51
"value": 9
_51
},
_51
"mos": {
_51
"value": 4.39
_51
},
_51
"rtt": {
_51
"value": 81
_51
}
_51
},
_51
"cumulative": {
_51
"bytes_received": 547788,
_51
"bytes_sent": 329425,
_51
"packets_received": 3900,
_51
"packets_lost": 0,
_51
"packets_sent": 3934
_51
}
_51
},
_51
"client_edge": null,
_51
"carrier_edge": null,
_51
"sip_edge": null
_51
}
_51
]
_51
}

Read multiple Call Metrics for a Call filtered by Media Edge

read-multiple-call-metrics-for-a-call-filtered-by-media-edge page anchor
Node.js
Python
C#
Java
Go
PHP
Ruby
twilio-cli
curl

_11
// Download the helper library from https://www.twilio.com/docs/node/install
_11
// Find your Account SID and Auth Token at twilio.com/console
_11
// and set the environment variables. See http://twil.io/secure
_11
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_11
const authToken = process.env.TWILIO_AUTH_TOKEN;
_11
const client = require('twilio')(accountSid, authToken);
_11
_11
client.insights.v1.calls('CAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX')
_11
.metrics
_11
.list({edge: 'sdk_edge', limit: 20})
_11
.then(metrics => metrics.forEach(m => console.log(m.timestamp)));

Output

_51
{
_51
"meta": {
_51
"page": 0,
_51
"page_size": 50,
_51
"first_page_url": "https://insights.twilio.com/v1/Voice/CAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Metrics?PageSize=50&Page=0",
_51
"previous_page_url": "https://insights.twilio.com/v1/Voice/CAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Metrics?PageSize=50&Page=0",
_51
"next_page_url": "https://insights.twilio.com/v1/Voice/CAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Metrics?PageSize=50&Page=1",
_51
"key": "metrics",
_51
"url": "https://insights.twilio.com/v1/Voice/CAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Metrics?PageSize=50&Page=0"
_51
},
_51
"metrics": [
_51
{
_51
"timestamp": "2019-10-07T22:32:06Z",
_51
"call_sid": "CA7569efe0253644fa4a88aa97beca3310",
_51
"account_sid": "AC998c10b68cbfda9f67277f7d8f4439c9",
_51
"edge": "sdk_edge",
_51
"direction": "both",
_51
"sdk_edge": {
_51
"interval": {
_51
"packets_received": 50,
_51
"packets_lost": 0,
_51
"audio_in": {
_51
"value": 81.0
_51
},
_51
"audio_out": {
_51
"value": 5237.0
_51
},
_51
"jitter": {
_51
"value": 9
_51
},
_51
"mos": {
_51
"value": 4.39
_51
},
_51
"rtt": {
_51
"value": 81
_51
}
_51
},
_51
"cumulative": {
_51
"bytes_received": 547788,
_51
"bytes_sent": 329425,
_51
"packets_received": 3900,
_51
"packets_lost": 0,
_51
"packets_sent": 3934
_51
}
_51
},
_51
"client_edge": null,
_51
"carrier_edge": null,
_51
"sip_edge": null
_51
}
_51
]
_51
}


Rate this page: