bird voice stats summary
Usage
Ejemplo de código
bird voice stats summary [flags]Description
One aggregate row of voice call-quality metrics for a period: total and answered legs, answer-seizure ratio (asr), and average call duration (acd_ms). It is also the usage answer for the period: total_duration_ms covers every leg and total_billable_ms the answered ones, which is what voice charges are computed from. from/to are both calendar days (YYYY-MM-DD) or both RFC 3339 instants (hour grain), and mixing the forms returns 422; add compare=previous_period for deltas against the preceding window. asr is null when no calls were placed and acd_ms when none were answered. For a per-day or per-hour series use voice_stats_daily or voice_stats_hourly; to find where failures concentrate use voice_stats_by_country or voice_stats_by_response_code.
Procedure
Step 3 of 8 of "Watch voice calls and find out why one was refused". Previous: bird voice get. Next: bird voice stats by-country.
Examples
Ejemplo de código
bird voice stats summaryOptions
| Name | Description |
|---|---|
| --compare | Set to previous_period to also include the same statistics for the immediately preceding window of equal length, plus the change between the two, so you can show '+X% vs last period' without a second request. Possible values: previous_period. |
| --direction | When set, limits the statistics to call legs in this direction. Omit to include all legs. Possible values: inbound, outbound. |
| --from | Inclusive start of the window: a calendar day (YYYY-MM-DD) or an RFC 3339 instant (rounded down to the hour). Interpreted in timezone (a calendar day names a local day and an instant is rounded down to the local hour), or in UTC when timezone is omitted. A numeric UTC offset (for example +05:45) is rejected when timezone is set; use a calendar day or a Z (UTC) instant. Must use the same form as to. Defaults to 30 days before to for day windows, or 168 hours (7 days) before to for hour windows, when omitted. |
| --response-schema | Print the fields this command returns, then exit |
| --timezone | IANA timezone identifier (for example Asia/Kathmandu) to report in; defaults to UTC. Day and hour boundaries and the default window when from and to are omitted both follow it, so a calendar-day from or to names a local day. A from or to carrying its own UTC offset is rejected while this is set: pass a calendar day or a Z instant. |
| --to | Inclusive end of the window: a calendar day (YYYY-MM-DD) or an RFC 3339 instant (rounded down to the hour). Interpreted in timezone (a calendar day names a local day and an instant is rounded down to the local hour), or in UTC when timezone is omitted. A numeric UTC offset is rejected when timezone is set; use a calendar day or a Z (UTC) instant. Must use the same form as from. Defaults to today for day windows, or the current hour for hour windows, in that timezone, when omitted. Day windows may not exceed 365 days; hour windows may not exceed 720 hours (30 days). |
Related
| Name | Description |
|---|---|
| bird voice stats by-country | Voice stats by country |
| bird voice stats by-response-code | Voice stats by response code |
| bird voice stats daily | Daily voice statistics |
| bird voice stats hourly | Hourly voice statistics |