Help Center/ FunctionGraph/ API Reference/ APIs/ Function Metrics/ Querying Tenant-Level Function Statistics

Updated on 2024-03-26 GMT+08:00

Online Debugging

CLI Examples

View PDF

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
limit	No	String	Maximum number of data records returned in a request. Max.: 500. Default: 100. Default: 100 Minimum: 1 Maximum: 64
marker	No	String	Start position of the current query. The default value is 0. Default: 0 Minimum: 1 Maximum: 64

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.
Content-Type	Yes	String	Message body type (format).

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.
gpu_gbs	Array of MonthUsed objects	Monthly GPU 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.
function_error_count	Array of SlaReportsValue objects	Number of function errors.
system_error_count	Array of SlaReportsValue objects	Number of system errors.
reserved_instance_num	Array of SlaReportsValue objects	Reserved instance metrics.
concurrency_num	Array of SlaReportsValue objects	Elastic instance metrics.

**Table 7** SlaReportsValue
Parameter	Type	Description
timestamp	Integer	Timestamp.
value	Double	Value. If the value is -1, the metric has no data in the current period. The possible cause is that the function is not executed.

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
    } ]
  }
}