直播流量统计查询接口

最近更新时间:2018-08-23 16:38:53

流量统计指标查询接口

入口地址

Host: pili.qiniuapi.com

规格

GET /statd/<table>?start=<start>&end=<end>&g=<granule>&group=<groupField>&select=<selectField>
Authorization: <QiniuToken>
Host: pili.qiniuapi.com

注:QiniuToken 签算方式

通用参数

table

table通常对应一个业务的统计数据

start

起始时间的日期字符串,闭区间,支持以下几种格式

  • 时间戳(秒)
  • 20060102
  • 20060102/00:00
  • 2006-01-02
  • 2006-01-02/00:00
  • 20060102150405
  • 2006-01-02T15:04:05Z07:00 (RFC3339)

end

截止时间的日期字符串,开区间,支持的格式同上。超过当前时间,则以当前时间为准

g

查询的时间粒度,支持5min hour day month四种

select

需要查询的值字段,可有多个,具体见对应table

group

分组名,把结果集按group分组,可选参数

条件参数

条件参数与具体table相关,支持如下形式

  • $src=inner等价于src == inner
  • $src=!inner等价于src != inner=
  • $area=cn&$area=ov等价于area == cn || area == ov
  • $area=!cn&$area=!ov等价于area != cn && area != ov

返回结果

根据有无group参数,有两种形式。 返回的结果是json格式,以下示例以golang数据结构表示

无group参数

[]struct {
    Time time.Time      `json:"time"`
    Vals map[string]int `json:"values"`
}

有group参数

[]struct {
    Time time.Time                 `json:"time"`
    Vals map[string]map[string]int `json:"values"`
}

table列表

域名级别下行流量(downflow)

延迟5分钟左右

条件字段

  • hub 可选
  • domain 可选
  • area 可选 (中国大陆(cn)、香港(hk)、台湾(tw)、亚太(apac)、美洲(am)、欧洲/中东/非洲(emea))

值字段

  • flow 流量 单位byte,带宽数据可以从flow转化,bandwidth=flow*8/300

示例

用户在某段时间内的每天下行流量

GET /statd/downflow?begin=20151201000000&end=20151203000000&g=day&select=flow
Host: pili.qiniuapi.com

返回

[
    {
        "time":"2015-12-01T00:00:00+08:00",
        "values":
            {
                "flow":4527162977
            }
    },
    {
        "time":"2015-12-02T00:00:00+08:00",
        "values":
            {
                "flow":5407323840
            }
    }
]

查询流级别下行流量(stream_down_flow)

延迟1天,保留最近90天

条件字段

  • hub 必选
  • domain 可选
  • area 可选 (中国大陆(cn)、香港(hk)、台湾(tw)、亚太(apac)、美洲(am)、欧洲/中东/非洲(emea))
  • scheme 可选 (http|https|rtmp)
  • streamTitle 可选 播放流名,各值意义如下

值字段

  • flow 流量 单位byte,带宽数据可以从flow转化,bandwidth=flow*8/300

示例

某路流在某段时间内的每天下行流量

GET /statd/stream_down_flow?begin=20151201000000&end=20151203000000&g=day&$hub=qiniutest&$streamTitle=sid1234&select=flow
Host: pili.qiniuapi.com

返回

[
    {
        "time":"2015-12-01T00:00:00+08:00",
        "values":
            {
                "flow":4527162977
            }
    },
    {
        "time":"2015-12-02T00:00:00+08:00",
        "values":
            {
                "flow":5407323840
            }
    }
]
以上内容是否对您有帮助?
  • Icon free helper
    Close