Querying Tenant-Level Function Statistics

Function

This API is used to query tenant-level function statistics.

The statistics include function format, quota and usage, and traffic report.

You can query data in a specific period using the filter and period parameters.

URI

GET /v2/{project_id}/fgs/functions/statistics

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. For details, see Obtaining a Project ID.

**Table 2** Query Parameters
Parameter	Mandatory	Type	Description
filter	Yes	String	Parameter filter. monitor_data: Query detailed statistics. monthly_report: Query monthly statistics. Enumeration values: monitor_data monthly_report
period	No	String	The unit is minute. This parameter must be used together with the filter parameter metric.
option	No	String	Monthly statistical period. This parameter is valid only when filter is set to monthly_report. If a value beyond the preceding range is specified, the default value 0 will be used. 0: current month 1: last month 2: last three months 3: last six months

Request Parameters

**Table 3** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	User token. It can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is the user token.

Response Parameters

Status code: 200

**Table 4** Response body parameters
Parameter	Type	Description
count	Array of MonthUsed objects	Number of monthly invocations.
gbs	Array of MonthUsed objects	Monthly resource usage.
statistics	ListFunctionStatisticsResponseBody object	Function Metrics

**Table 5** MonthUsed
Parameter	Type	Description
date	String	Date.
value	Number	Usage.

**Table 6** ListFunctionStatisticsResponseBody
Parameter	Type	Description
count	Array of SlaReportsValue objects	Function invocations.
duration	Array of SlaReportsValue objects	Average latency, in milliseconds.
fail_count	Array of SlaReportsValue objects	Number of errors.
max_duration	Array of SlaReportsValue objects	Maximum latency, in milliseconds.
min_duration	Array of SlaReportsValue objects	Minimum latency, in milliseconds.
reject_count	Array of SlaReportsValue objects	Number of throttles.

**Table 7** SlaReportsValue
Parameter	Type	Description
timestamp	Integer	Timestamp.
value	Double	Value.

Status code: 400

**Table 8** Response body parameters
Parameter	Type	Description
error_code	String	Error code.
error_msg	String	Error message.

Example Requests

Query tenant-level function statistics.

GET /v2/{project_id}/fgs/functions/statistics

Example Responses

Status code: 200

Query successful.

{
  "statistics" : {
    "count" : [ {
      "timestamp" : 1596679200000,
      "value" : -1
    }, {
      "timestamp" : 1596682800000,
      "value" : 2
    }, {
      "timestamp" : 1596686400000,
      "value" : -1
    } ],
    "duration" : [ {
      "timestamp" : 1596679200000,
      "value" : -1
    }, {
      "timestamp" : 1596682800000,
      "value" : 950
    }, {
      "timestamp" : 1596686400000,
      "value" : -1
    } ],
    "fail_count" : [ {
      "timestamp" : 1596679200000,
      "value" : -1
    }, {
      "timestamp" : 1596682800000,
      "value" : 0
    }, {
      "timestamp" : 1596686400000,
      "value" : -1
    } ],
    "max_duration" : [ {
      "timestamp" : 1596679200000,
      "value" : -1
    }, {
      "timestamp" : 1596682800000,
      "value" : 740
    }, {
      "timestamp" : 1596686400000,
      "value" : -1
    } ],
    "min_duration" : [ {
      "timestamp" : 1596679200000,
      "value" : -1
    }, {
      "timestamp" : 1596682800000,
      "value" : 210
    }, {
      "timestamp" : 1596686400000,
      "value" : -1
    } ],
    "reject_count" : [ {
      "timestamp" : 1596679200000,
      "value" : -1
    }, {
      "timestamp" : 1596682800000,
      "value" : 0
    }, {
      "timestamp" : 1596686400000,
      "value" : -1
    } ]
  }
}