Querying Partition Monitoring Data¶

Function¶

This API is used to query the monitoring data of a specified partition of a stream.

GET /v2/{project_id}/streams/{stream_name}/partitions/{partition_id}/metrics

**Table 1** Path Parameters¶
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID.
stream_name	Yes	String	Name of the stream. Maximum: 60
partition_id	Yes	String	Partition ID The value can be in either of the following formats: - shardId-0000000000- 0 For example, if a stream has three partitions, the partition identifiers are 0, 1, and 2, or shardId-0000000000, shardId-0000000001, and shardId-0000000002, respectively.

**Table 2** Query Parameters¶
Parameter	Mandatory	Type	Description
label	No	String	Partition monitoring metric. (Either label or label_list must be specified. If they are both specified, label_list prevails.) total_put_bytes_per_partition: total input traffic in a partition (byte) total_get_bytes_per_partition: total output traffic in a partition (byte) total_put_records_per_partition: total number of input records in a partition total_get_records_per_partition: total number of output records in a partition Enumeration values: total_put_bytes_per_partition total_get_bytes_per_partition total_put_records_per_partition total_get_records_per_partition
label_list	No	String	List of labels separated by commas (,) to query multiple labels in batches. (Either label or label_list must be specified. If both label_list and label exist, label_list prevails.)
start_time	Yes	Long	Monitoring start time, which is a 10-digit timestamp.
end_time	Yes	String	Monitoring end time, which is a 10-digit timestamp.

**Table 3** Request header parameters¶
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	User token The token 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.

Status code: 200

**Table 4** Response body parameters¶
Parameter	Type	Description
metrics	Metrics object	Data object.

**Table 5** Metrics¶
Parameter	Type	Description
dataPoints	Array of DataPoint objects	Monitoring data.
label	String	Metric.

**Table 6** DataPoint¶
Parameter	Type	Description
timestamp	Long	Timestamp.
value	Long	Monitoring value corresponding to the timestamp.

Querying Partition Monitoring Data

GET https://{Endpoint}/v2/{project_id}/streams/{stream_name}/partitions/{partition_id}/metrics

None

Status Code	Description
200	Normal response.

last updated: 2024-12-10 14:57 UTC - commit: a4bac582277d17e53f4aebc84d2abd02bc96165c