Updated on 2023-07-06 GMT+08:00

Querying Metrics in a Specified Period

Function

This API is used to query metrics of a function in a specified period.

URI

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

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.

period

Yes

String

Time range specified to query function execution metrics.

Minimum: 0

Maximum: 0

Minimum: 0

Maximum: 0

Request Parameters

Table 2 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 a token.

Minimum: 0

Maximum: 0

Minimum: 0

Maximum: 0

Response Parameters

Status code: 200

Table 3 Response body parameters

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 4 SlaReportsValue

Parameter

Type

Description

timestamp

Integer

Timestamp.

value

Double

Value.

Example Requests

Query metrics of a function in a specified period.

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

Example Responses

Status code: 200

ok

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

Status Codes

Status Code

Description

200

ok

Error Codes

See Error Codes.