Help Center> FunctionGraph> API Reference> APIs> Function Metrics> Querying Instance Usage Metrics of a Specified Function

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

View PDF

Querying Instance Usage Metrics of a Specified Function

Function

Query instance usage metrics of a function.

The metric unit is minute. If the query time range is less than 1 hour, the metric period is 1 minute. If the query time range is less than 1 day, the metric period is 30 minutes. If the query time range is greater than 1 day, the metric period is 180 minutes.
Metrics are classified into the following types: reservedinstancenum (usage of reserved instances) and concurrency (instance usage/concurrency).

URI

GET /v2/{project_id}/fgs/functions/{func_urn}/instancereports

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. For details, see Obtaining a Project ID.
func_urn	Yes	String	Function URN. For details, see the function model description.

**Table 2** Query Parameters
Parameter	Mandatory	Type	Description
marker	No	String	Start position of the current query. The default value is 0. Default: 0 Minimum: 0 Maximum: 64
limit	No	String	Maximum number of data records returned in a request. Max.: 500. Default: 100. Default: 100 Minimum: 0 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
instanceNum	Array of SlaReportsValue objects	Elastic instance metrics.
reservedInstanceNum	Array of SlaReportsValue objects	Reserved instance metrics.

**Table 5** 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: 500

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

Example Requests

Query instance usage metrics of a function.

GET /v2/{project_id}/fgs/functions/{func_urn}/instancereports

Example Responses

Status code: 200

{
  "instanceNum" : [ {
    "timestamp" : 1596679200000,
    "value" : -1
  }, {
    "timestamp" : 1596682800000,
    "value" : 2
  }, {
    "timestamp" : 1596686400000,
    "value" : -1
  } ],
  "reservedInstanceNum" : [ {
    "timestamp" : 1596679200000,
    "value" : -1
  }, {
    "timestamp" : 1596682800000,
    "value" : 950
  }, {
    "timestamp" : 1596686400000,
    "value" : -1
  } ]
}